You are here

Home » API reference » Mailhandler 5

README.txt in Mailhandler 5

Same filename and directory in other branches
  1. 6.2 README.txt
  2. 6 README.txt
  3. 7.2 README.txt
  4. 7 README.txt
Readme
------

The Mailhandler module allows registered users to create or edit nodes and comments via email. Authentication
is usually based on the From: email address. Users may post taxonomy terms, teasers, and other node parameters using the Commands capability. 

See the 'more help' page within this module for more info - 'admin/help/mailhandler'.

Requirements
------------

The IMAP dynamic extension must be enabled. On Windows PHP installations, this is as easy as uncommenting 
the line containing "extension=php_imap.dll" in php.ini. For other OS, you may need to recompile PHP
if you don't have this extension already.

Installation
------------

1. Activate this module as usual

2. Add a mailbox in the Admin page. You'll need a corresponding Folder, POP, or IMAP mailbox
dedicated to inbound Drupal mail. Additional mailboxes may be useful for specialized situations.


Admin Usage
------------

1. Send a few emails to a Mailhandler email address from an email address which is registered on your site.
Then visit cron.php to kickoff a pull from your mail server and processing of pending email. Alternatively,
follow the 'retrieve' link for your newly created mailbox. You should see new blog nodes on
your site or receive error message replies via email.

2. You may add extra security to to a Mailhandler mailbox if desired on the Admin page.

3. Install mailalias.module if you want to assist users who might contribute from multiple email addresses.

4. Consider installing the Marksmarty module and using its filter in the input format that you assign in your mailbox form. This filter does a nice job of prettying up plain text email for presentation on the Web.

Developer Usage
-----------------------------

See the API link located in the Help

Credits
----------

- this borrows from Julian Bond's excellent Blogmail module for Drupal 3. Gerhard contributed IMAP Folder support.

File

README.txt
View source 
  1. Readme

  2. ------

  3. 

  4. The Mailhandler module allows registered users to create or edit nodes and comments via email. Authentication

  5. is usually based on the From: email address. Users may post taxonomy terms, teasers, and other node parameters using the Commands capability. 

  6. 

  7. See the 'more help' page within this module for more info - 'admin/help/mailhandler'.

  8. 

  9. Requirements

  10. ------------

  11. 

  12. The IMAP dynamic extension must be enabled. On Windows PHP installations, this is as easy as uncommenting 

  13. the line containing "extension=php_imap.dll" in php.ini. For other OS, you may need to recompile PHP

  14. if you don't have this extension already.

  15. 

  16. Installation

  17. ------------

  18. 

  19. 1. Activate this module as usual

  20. 

  21. 2. Add a mailbox in the Admin page. You'll need a corresponding Folder, POP, or IMAP mailbox

  22. dedicated to inbound Drupal mail. Additional mailboxes may be useful for specialized situations.

  23. 

  24. 

  25. Admin Usage

  26. ------------

  27. 

  28. 1. Send a few emails to a Mailhandler email address from an email address which is registered on your site.

  29. Then visit cron.php to kickoff a pull from your mail server and processing of pending email. Alternatively,

  30. follow the 'retrieve' link for your newly created mailbox. You should see new blog nodes on

  31. your site or receive error message replies via email.

  32. 

  33. 2. You may add extra security to to a Mailhandler mailbox if desired on the Admin page.

  34. 

  35. 3. Install mailalias.module if you want to assist users who might contribute from multiple email addresses.

  36. 

  37. 4. Consider installing the Marksmarty module and using its filter in the input format that you assign in your mailbox form. This filter does a nice job of prettying up plain text email for presentation on the Web.

  38. 

  39. Developer Usage

  40. -----------------------------

  41. 

  42. See the API link located in the Help

  43. 

  44. Credits

  45. ----------

  46. 

  47. - this borrows from Julian Bond's excellent Blogmail module for Drupal 3. Gerhard contributed IMAP Folder support.