| 1 | <configure xmlns="http://namespaces.zope.org/zope" |
|---|
| 2 | xmlns:mail="http://namespaces.zope.org/mail"> |
|---|
| 3 | <!-- |
|---|
| 4 | |
|---|
| 5 | SMTP Settings |
|---|
| 6 | ************* |
|---|
| 7 | |
|---|
| 8 | In here we define the mailers and mail deliveries we want to be |
|---|
| 9 | used by the portal. |
|---|
| 10 | |
|---|
| 11 | They are set here (and not dynamically in the portal) to increase |
|---|
| 12 | security. Even portal users with all permissions cannot change mail |
|---|
| 13 | server credentials and related. You need filesystem access to |
|---|
| 14 | change/override the settings in here. |
|---|
| 15 | |
|---|
| 16 | In the portal you can pick one of the deliveries for use with all |
|---|
| 17 | SMTP (aka mail) related functionality. |
|---|
| 18 | |
|---|
| 19 | Each delivery (direct or queued) is bound to a certain mailer, |
|---|
| 20 | defined by a 'mail:smtpMailer' directive. |
|---|
| 21 | |
|---|
| 22 | The smtpMailer directives define real mail hosts (local or remote) |
|---|
| 23 | where mail from the portal should be processed. |
|---|
| 24 | |
|---|
| 25 | The 'mail:directDelivery' and 'mail:queuedDelivery' directives send |
|---|
| 26 | local mail to the mailer set in their 'mailer' attribute. While |
|---|
| 27 | directDelivery sends mail immediately when a request is finished |
|---|
| 28 | (see zope.sendmail for more info), queuedDelivery handles mail in a |
|---|
| 29 | background thread and sends mail independently from requests. |
|---|
| 30 | |
|---|
| 31 | By default in Kofa we have a fake mailer activated, that does not |
|---|
| 32 | send real mail to the outside world. |
|---|
| 33 | --> |
|---|
| 34 | |
|---|
| 35 | <!-- A mail server on localhost --> |
|---|
| 36 | <!-- Mail server definitions require the following attributes: |
|---|
| 37 | |
|---|
| 38 | - name: (string) name to be used by deliveries |
|---|
| 39 | |
|---|
| 40 | Mail server definitions allow the following additional attribs: |
|---|
| 41 | |
|---|
| 42 | - hostname (string) hostname or IP(?) of mail server to use |
|---|
| 43 | ('localhost' by default) |
|---|
| 44 | - port (int number) port to connect to SMTP mailer |
|---|
| 45 | (25 by default) |
|---|
| 46 | - username (string) Username to log in to mail server |
|---|
| 47 | - password (string) Password to log in to mail server |
|---|
| 48 | |
|---|
| 49 | --> |
|---|
| 50 | <mail:smtpMailer |
|---|
| 51 | name="smtp.mailserver" |
|---|
| 52 | hostname="localhost" |
|---|
| 53 | port="25" |
|---|
| 54 | /> |
|---|
| 55 | |
|---|
| 56 | <!-- The mail deliveries --> |
|---|
| 57 | <!-- Mail deliveries require the following attributes: |
|---|
| 58 | |
|---|
| 59 | - name: (string) this string will appear in portal select |
|---|
| 60 | boxes |
|---|
| 61 | - permission: (string) zope default perms only |
|---|
| 62 | - mailer: (string) name of some mailer registered above or |
|---|
| 63 | 'smtp' |
|---|
| 64 | - queuePath: (string) must exist and contain cur/, new/, and |
|---|
| 65 | tmp/ dirs. Relative paths are relative |
|---|
| 66 | to the directory this files lives in. |
|---|
| 67 | |
|---|
| 68 | --> |
|---|
| 69 | <mail:queuedDelivery |
|---|
| 70 | name="Queued SMTP on mail server" |
|---|
| 71 | permission="zope.Public" |
|---|
| 72 | mailer="smtp.mailserver" |
|---|
| 73 | queuePath="../../../var/mailqueue" |
|---|
| 74 | /> |
|---|
| 75 | |
|---|
| 76 | <mail:directDelivery |
|---|
| 77 | name="Direct SMTP on mail server" |
|---|
| 78 | permission="zope.Public" |
|---|
| 79 | mailer="smtp.mailserver" |
|---|
| 80 | /> |
|---|
| 81 | |
|---|
| 82 | </configure> |
|---|
