Mail In Test

Test of MailInContrib.

• Send mail to wiki@copswiki.org
• You must use a valid email address that is coupled with a valid user name.
• Place topic name in subject. This topic name is Sandbox.MailInTest
• Email is placed below the following line.

---

* Sandbox.MailInTest: This is a test of the MailInContrib. This email is supposed to be added to the topic |Sandbox.MailInTest. --Ray|

--

---

Raymond Lutz, Immediate Past President East County Democratic Club P.O. Box 252 El Cajon, CA 92022 USA Voice 619-820-5321 http//www.ecdcweb.org

-- Daily Razor - 2009-03-09 - 12:00

• **: This is a test of the MailInContrib. This email is supposed to be added

to the topic |Sandbox.MailInTest. --Ray|

--

---

Raymond Lutz, Immediate Past President East County Democratic Club P.O. Box 252 El Cajon, CA 92022 USA Voice 619-820-5321 http//www.ecdcweb.org

-- Daily Razor - 2009-03-07 - 16:00

• **: This is a test of the MailInContrib. This email is supposed to be added

to the topic |Sandbox.MailInTest. --Ray|

--

---

Raymond Lutz, Immediate Past President East County Democratic Club P.O. Box 252 El Cajon, CA 92022 USA Voice 619-820-5321 http//www.ecdcweb.org

-- Daily Razor - 2008-12-09 - 17:00

---

---

Mail In Contrib.spec

MailInContrib

*PERL* The configuration is in the form of an (perl) array of mailbox specifications. Each specification defines a number of fields:

• onError - what you want TWiki to do if an error occurs while processing a mail (comma-separated list of options). Available options:
  • reply - reply to the sender
  • delete - delete the mail from the inbox
  • log - log the error to the TWiki warning log
  Note: if you don't specify delete, TWiki will continue to try to process the mail each time the cron job runs.
• topicPath - where you want TWiki to look for the name of the target topic (comma-separated list of options). Available options:
  • to - look in the To: e.g. Web.TopicName@example.com or "Web Topic Name?" <web.topicname@example.com>
  • subject - look in the Subject: e.g "Web.TopicName: mail for TWiki" If "to" and "subject" are both enabled, but a valid topic name is not found in the To:, the Subject: will still be parsed to try and get the topic.
• folder - name of the mail folder
  Note: support for POP3 requires that the Email::Folder::POP3 module is installed. Support for IMAP requires Email::Folder::IMAP etc. Folder names are as described in the documentation for the relevant Email::Folder type e.g. for POP3, the folder name might be: pop://me:123@mail.isp.com:110/
• user - name of the default user.
  The From: in the mail is parsed to extract the senders email address. This is then be looked up in the TWiki users database to find the wikiname. If the user is not found, then this default user will be used. If the default user is left blank, then the user must be found from the mail. The identity of the sending user is important for access controls. This must be a user login name.e.g. 'guest'
• onSuccess - what you want TWiki to do with messages that have been successfully added to a TWiki topic (comma-separated list of options) Available options:
  • reply - reply to the sender
  • delete - delete the mail from the inbox
• defaultWeb - name of the web to save mails in if the web name isn't specified in the mail. If this is undefined or left blank, then mails must contain a full web.topicname or the mail will be rejected.
• onNoTopic - what do you want TWiki to do if it can't find a valid topic name in the mail (one option). Available options:
  • error - treat this as an error (overrides all other options)
  • spam - save the mail in the spambox topic. Note: if you clear this, then TWiki will simply ignore the mail..
• spambox - optional required of onNoTopic = spam. Name of the topic where you want to save mails that don't have a valid web.topic. You must specify a full web.topicname

EXAMPLE

$TWiki::cfg{MailInContrib} = [
 {
   folder => 'pop://example_user:password@example.com/Inbox',
   onError => 'log',
   onNoTopic => 'error',
   onSuccess => 'log delete',
   topicPath => 'to subject',
 },
];

---

Here is the current setting

$TWiki::cfg{MainInContrib} =                      [
                                                    {
                                                      'onError' => 'log reply',
                                                      'topicPath' => 'subject',
                                                      'onSuccess' => 'log delete',
                                                      'onNoTopic' => '',
                                                      'folder' => 'pop://wiki+copswiki.org:degobah@copswiki.org'                                           
                                                    }
                                                  ];

-- Raymond Lutz - 2008-12-09