See also HelpOnConfiguration.
Outgoing mails
In order to enable support for outgoing mails, you must specify the From: address with "mail_from". Furthermore, you must enable a transport, either by SMTP (use "mail_smarthost" to enable it) or by sendmail (use "mail_sendmail" to enable it). If you use "mail_smarthost" and the server requires authentication, then set "mail_login", too.
- mail_from
This value is used for the "From:" and "To:" headers in the emails sent (the "To:" has email address privacy reasons, email is not really sent to this address, but we don't want to disclose any real recipient address).
- mail_smarthost
This is the IP or domain name of an FOLDOC:SMTP enabled server. On a Unix host, you can try to use localhost; on a Windows machine this will normally be a machine in your LAN or some host of your ISP.
- mail_login
This is only needed when you use mail_smarthost and a server that requires SMTP AUTH to send mail; in that case, set this to the username and password separated by a space, i.e. "user pwd".
- mail_sendmail
- This is a local command to run to send a message. If set to e.g. '/usr/sbin/sendmail -t -i', use this sendmail command to send mail. This is only useful on machines that have a mail transport agent installed.
Incoming Mails (new in 1.6)
If you want to import mails to your MoinMoin wiki, i.e. allow it to receive and store the mails, you have to setup a few things.
First you have to setup your mail server to pipe every new mail into MoinMoin. The command is moin xmlrpc mailimport. Note that you can use the parameter --config /path/to/dir to supply the path to a directory with a suitable MoinMoin configuration file. Then you have to ensure that there is a file called mailimportconf.py in that directory. It has to look like this (there is a sample file shipped in wiki/config):
# This secret has to be known by the wiki server mail_import_secret = u"foo" # The target URL mail_import_url = u"http://localhost:81/?action=xmlrpc2"
The secret is used to let the script authenticate itself at the wiki. The URL consists of the regular wiki URL and ?action=xmlrpc2.
Now you can configure the wiki. There are the following configuration options:
- mail_import_wiki_addrs
A list of e-mail target addresses of e-mails that should go into the wiki. MoinMoin searches for these addresses to know the target pagename, it should match the address that is known to the mail server. If you use some kind of forwarding mechanism, please put the address(es) your wiki users use to address the wiki first into that list and the address(es) you forward the e-mails to after that.
- mail_import_secret
The secret that matches the mailimportconf.py configuration file. See above.
- mail_import_subpage_template
- This is the template for the pagename generated by the mail import code. See below for supported placeholders.
- mail_import_pagename_envelope
The default value of this setting is u"%s" and that just means "use the pagename unmodified". You could also configure it to be u"+ %s/" which would add a plus and a blank char in front of what we got and a slash char after what we got from the mail subject or target addr. This is to save your users some typing if you ever want the behaviour triggered by the plus and the slash.
- mail_import_pagename_search
Where (and in what order) to search for the target pagename, default is ['subject', 'to', ] to first look into the subject and then (if we didn't find anything there) to look into the target addresses.
- mail_import_pagename_regex
The pattern (regex) we search in the subject line for determining the target pagename, default is r'\[\[([^"]*)\]\]' which simply looks for something like [[Target Page Name]] (same as freelink syntax).
After you have configured the settings explained above, you should be able sending yourself mails. The actual usage is explained below.