I may be wrong, but I think some of the documentation in the module's install file is incorrect.

I was unable to correctly install it using the install file text, but I succeeded after using the documentation on civicspace (http://civicspacelabs.org/home/node/360 - slightly altered below to add text regarding the actual mailing list) - most important are the changes to the primary and secondary address:

  • To use the listhandler module, you also need to enable the mailhandler module and you must have a mailing list manager (such as mailman, ezmlm) installed and set up. Enabling the mailalias module is considered a good idea.
  • Configure a mailbox per mailing list in admin > mailhandler > add mailbox.
    • Specify the mailing list's sending address as the email address which is a subscriber to your mailing list, eg forum_handler@example.com.
    • Specify the mailing list's address as second address, eg. mailing_list@drupal.org
    • Configure a POP, IMAP mailbox, or an mbox INBOX which is subscribed to the mailing list to go with the first address.
    • Disable "security" and "send error replies."
    • From header: A header by that mails from that list can be uniquely determined. Sender is usually a good choice. This depends on the mailing list software.
    • Then give as a mailhandler default command:
      tid: 123, where 123 would be the numeric category id of the forum you created above. It is the number at the end of the url when you are viewing all the posts in your forum.
  • Listhandler creates accounts for posters to your lists that do not have an account on your site. In admin > listhandler > settings you can choose if those accounts are open or blocked my default.
  • While there you should enter an email address that can be used as a From address for comments by anonymous users that get sent to your list.
  • Try sending emails by posting forum topics and comments. Watch your mailing list's bounces. Security settings on many mailing list managers do not belive that the web server is in fact not a subscriber to the list which can post, despite your configurations. Keep tweaking settings until you can get the mail to go from the forum to the list. If things don't seem to be working try changing the second email address to an email address which you read to see what is going through.
  • Try posting forum topics by sending mails. Remember that the email is only checked and processed every time cron.php runs. Send a mail to the mailing list and confirm that it made it to the mailbox you configured in the mailhandler. Visit cron.php and see if there were any errors. Check your website's logs. When it works you should see what you posted by email in the forum as a new topic or a reply to the correct topic or comment.

Comments

philipnet’s picture

Title: Correct/Complete Documentation » Update Documentation
Version: 4.6.x-1.x-dev » 5.x-1.x-dev
Assigned: Unassigned » philipnet
Priority: Critical » Normal

I've updated the README.txt file /heavily/ but this report has a few useful items that can be added.

philipnet’s picture

Status: Active » Closed (fixed)

Updates made to README.txt.
The Handbook page still requires updating, but I want a beta release of Listhandler first.

P.