Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
server:mail [2022/02/25 15:23] – [sbbs.ini] NewMailNotice and ForwardNotice have been replaced with text.dat strings digital man | server:mail [2023/12/19 22:10] – [External Mail Processors] Migrated content from ctrl/modopts.ini - needs update and more info digital man | ||
---|---|---|---|
Line 16: | Line 16: | ||
The SMTP server also supports the SEND, SAML and SOML commands for delivering instant messages (a.k.a. telegrams) to users of the BBS. | The SMTP server also supports the SEND, SAML and SOML commands for delivering instant messages (a.k.a. telegrams) to users of the BBS. | ||
+ | |||
+ | ==== Recipients ==== | ||
+ | When receiving email messages via SMTP, the Synchronet mail server can match recipient names to a BBS user account by their alias or optionally, their real name. | ||
+ | |||
+ | === Special Characters === | ||
+ | Non-alphanumeric characters are ignored when matching recipient names to BBS user aliases. So for example, the following will all match the user " | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | |||
+ | === Real Names === | ||
+ | When matching recipient names to BBS real names (if so enabled by the sysop by setting SCFG-> | ||
+ | |||
+ | === Special Aliases === | ||
+ | Recipient names configured in '' | ||
+ | |||
+ | === User Number === | ||
+ | Receiving by user account number is also optionally supported, not not encouraged and disabled by default. | ||
==== Special Prefixes ==== | ==== Special Prefixes ==== | ||
Line 96: | Line 115: | ||
{{: | {{: | ||
==== External Mail Processors ==== | ==== External Mail Processors ==== | ||
- | FIXME | + | |
+ | === Configuration === | ||
+ | |||
+ | The mail processors are configured in the file '' | ||
+ | |||
+ | Each mail processor is specified in a separate " | ||
+ | mail processor name (or command-line) enclosed in square brackets (" | ||
+ | followed by a list of optional "key = value" pairs. | ||
+ | |||
+ | If no " | ||
+ | will be used as the command-line to execute. | ||
+ | |||
+ | Non-JavaScript mail processors (i.e. native executables), | ||
+ | " | ||
+ | |||
+ | For a mail processor to only process mail received for specific name(s), | ||
+ | it must have a " | ||
+ | Example: "To = listserver, listserv" | ||
+ | process mail received for either " | ||
+ | If no " | ||
+ | incoming (SMTP) e-mail messages. | ||
+ | If a " | ||
+ | " | ||
+ | forwarded (depending on the system configuration). | ||
+ | |||
+ | The " | ||
+ | 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 '' | ||
+ | |||
+ | ^ Key ^ Default | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | |||
+ | |||
+ | === JavaScript Variables === | ||
+ | |||
+ | The filenames referenced below may all be modified or created by the mail processor. | ||
+ | |||
+ | Additional (read-only) variables available to JavaScript mail processors: | ||
+ | |||
+ | ^ Variable | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | |||
+ | * See '' | ||
+ | |||
+ | JavaScript mail processors may be implemented as either a single " | ||
+ | string or an external JavaScript file (e.g. '' | ||
+ | |||
+ | External JavaScript mail processors (.js files) are loaded from the '' | ||
+ | or '' | ||
+ | If no file extension is specified on the command-line, | ||
+ | |||
+ | === Command-line Specifiers === | ||
+ | |||
+ | Command-line specifiers (variables) available for use in command-lines | ||
+ | (native or JavaScript mail processor): | ||
+ | |||
+ | ^ Specifier ^ Description ^ | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
===== SendMail ===== | ===== SendMail ===== |