zwiki.org HowToSetUpMailOut

home contents changes issues index options help subscribe

To enable mail-out:

Add a mail_replyto string property on your wiki folder. Put noreply@yourdomain, or the wiki's mail-in address here. (You probably don't want your email address here, you might get duplicates when you subscribe.)
Make sure you have a working MailHost (or SecureMailHost?, or MaildropHost?..) object in your wiki folder or above. Use the ZMI add menu to add one if needed. Plone sites will already have one.

Your wiki will now show the subscribe link. Subscribe to a page and add a comment there. You should receive the comment by mail. If not, Watch your zope event log and/or SMTP server's log for problems.

Tips

to mail out all edits, not just comments and new pages, set a mailout_policy string property on the folder to edits. The default is comments.

You can use a mail_from property, as an alternative to mail_replyto, to override (and hide) the original sender's From address. This can be useful eg to keep newbie replies on-list.

the contents of a mail_subject_prefix folder property will appear in mail-out subjects before the page name. Subjects are already quite long, but a short prefix can be helpful if you subscribe to several wikis.

For zope versions before 2.6: install the MailHostFix ? product so that bcc delivery works. Otherwise all recipients will appear in the mailout headers, and you will get proliferating replies, etc.

How it works

A subscriber_list property holding a list of email addresses or CMF member ids is kept on each page and on the wiki folder. A user can add or remove themself by using the subscribe link (this is the subscribeform template, if you want to customize it). A zope manager can also edit the subscriber lists using the ZMI properties tab.

Page comments (but not edits, by default) are mailed out to the page subscribers and wiki subscribers. Wiki subscribers also receive page creation notifications.

Additional junk-reducing measures: comments and new pages which contain no text at all are not mailed out. Comments to pages named TestPage or SandBox are mailed out only to page subscribers.

comments:

Fields to fill --cast, Fri, 16 Feb 2007 17:47:18 +0000 reply
Hi,I´m Setting up Mailout, but At ZMI there are some fields that a don´t Know how to Fill:

Id -> MailHost --by default

Title -> ?????

SMTP Host -> ???

SMTP -> 25

SMTP UserId? -> ¿? --What are talking about these fields??

SMTP Password -> ¿?

--I don´t have a mail serve, so I want my PLONE-ZWiki Server Machine to be the server, can this be possible???

Thanks

Note that SecureMailHost? and MailDropHost work too --betabug, Fri, 23 Feb 2007 10:37:27 +0000 reply
Zwiki finds and uses the standard MailHost object, as well as "Secure Mail Host" (e.g. installed by Plone) and "MailDrop? Host" objects to send out mail.