Synchronet v3.19b-Win32 (install) has been released (Jan-2022).

You can donate to the Synchronet project using PayPal.

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revisionBoth sides next revision
server:mail [2023/12/19 22:10] – [External Mail Processors] Migrated content from ctrl/modopts.ini - needs update and more info digital manserver:mail [2023/12/19 22:35] – [External Mail Processors] Fix the inverted description of the PassThru key and other cosmetic improvements digital man
Line 118: Line 118:
 === Configuration === === Configuration ===
  
-The mail processors are configured in the file ''[[dir:ctrl]]/[[config:mailproc.ini]]''.+The mail processors are configured in the ''[[dir:ctrl]]/[[config:mailproc.ini]]'' file.
  
 Each mail processor is specified in a separate "section", comprised of the Each mail processor is specified in a separate "section", comprised of the
 mail processor name (or command-line) enclosed in square brackets ("[]"),  mail processor name (or command-line) enclosed in square brackets ("[]"), 
 followed by a list of optional "key = value" pairs. followed by a list of optional "key = value" pairs.
- 
-If no "Eval" or "Command" key value is specified, the mail processor name 
-will be used as the command-line to execute. 
- 
-Non-JavaScript mail processors (i.e. native executables), must have the  
-"native" key set to "true" (e.g. "native = true"). 
- 
-For a mail processor to only process mail received for specific name(s), 
-it must have a "To" key with a comma-separated list of destination names. 
-Example: "To = listserver, listserv" would cause a mail processor to only 
-process mail received for either "listserver" or "listserv". 
-If no "To" value is specified, then the mail processor will process *all* 
-incoming (SMTP) e-mail messages. 
-If a "To" value is specified, but is not a valid user name, then the  
-"PassThru" key must be set to "true" or the mail may be rejected or 
-forwarded (depending on the system configuration). 
- 
-The "From" key is similar to the "To" key: 
-a list of zero or more strings to be used to determine which  
-sender addresses the mail processor should be executed for. 
- 
-Each of the strings in these lists may use the Synchronet .can-style wildcards. 
  
 Supported ''[[dir:ctrl]]/[[config:mailproc.ini]]'' keys (for each mail processor) with default values: Supported ''[[dir:ctrl]]/[[config:mailproc.ini]]'' keys (for each mail processor) with default values:
Line 161: Line 139:
 | ''Eval''               | //none//     | The JavaScript expression to invoke | | ''Eval''               | //none//     | The JavaScript expression to invoke |
  
 +If no ''Eval'' or ''Command'' key value is specified, the mail processor name
 +will be used as the command-line to execute.
 +
 +Non-JavaScript mail processors (i.e. native executables), must have the 
 +''native'' key set to ''true''.
 +
 +For a mail processor to only process mail received for specific name(s),
 +it must have a ''To'' key with a comma-separated list of destination names.
 +
 +Example: ''To = listserver, listserv'' would cause a mail processor to only
 +process mail received for either ''listserver'' or ''listserv''.
 +
 +If no ''To'' value is specified, then the mail processor will process **all**
 +incoming (SMTP) e-mail messages.
 +
 +== Pass-through ==
 +
 +If a ''To'' value is specified, but is not a valid user name, then the 
 +''PassThru'' key must be set to ''false'' or the mail may be rejected or
 +forwarded (depending on the system configuration).
 +
 +The ''From'' key is similar to the ''To'' key:
 +a list of zero or more strings to be used to determine which 
 +sender addresses the mail processor should be executed for.
 +
 +The strings in the to/from lists may use the Synchronet ''.can'' style comparison patterns.
  
 === JavaScript Variables === === JavaScript Variables ===

Trace: