diff --git a/extension/Documentation/Manual.rst b/extension/Documentation/Manual.rst index b9881b349f8e2c79768e4065b644d4bf9541c670..5e1d19771e04405967fc372edf34fd97ceb3bbea 100644 --- a/extension/Documentation/Manual.rst +++ b/extension/Documentation/Manual.rst @@ -5510,7 +5510,7 @@ Column: _sendmail [|e:<subject encode: encode/decode/none>][E:<body encode: encode/decode/none>] [|C][d:<filename of the attachment>][|F:<file to attach>][|u:<url>][|p:<T3 uri>] -The following parameters can also be written out for ease of use: +The following parameters can also be written as complete words for ease of use: :: @@ -5529,50 +5529,62 @@ Send emails. Every mail will be logged in the table `mailLog`. Attachments are s .. -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -|**Token** | **Parameter** |**Description** |**Required**| -+==========+========================================+==================================================================================================+============+ -| f | email |**FROM**: Sender of the email. Optional: 'realname <john@doe.com>' | yes | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| t | email[,email] |**TO**: Comma separated list of receiver email addresses. Optional: `realname <john@doe.com>` | yes | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| c | email[,email] |**CC**: Comma separated list of receiver email addresses. Optional: 'realname <john@doe.com>' | | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| B | email[,email] |**BCC**: Comma separated list of receiver email addresses. Optional: 'realname <john@doe.com>' | | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| r | REPLY-TO:email |**Reply-to**: Email address to reply to (if different from sender) | | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| s | Subject |**Subject**: Subject of the email | yes | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| b | Body |**Body**: Message - see also: `html-formatting`_ | yes | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| h | Mail header |**Custom mail header**: Separate multiple header with \\r\\n | | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| F | Attach file |**Attachment**: File to attach to the mail. Repeatable. | | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| u | Attach created PDF of a given URL |**Attachment**: Convert the given URL to a PDF and attach it the mail. Repeatable. | | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| p | Attach created PDF of a given T3 URL |**Attachment**: Convert the given URL to a PDF and attach it the mail. Repeatable. | | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| d | Filename of the attachment |**Attachment**: Useful for URL to PDF converted attachments. Repeatable. | | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| C | Concat multiple F|p|u| together |**Attachment**: All following (until the next 'C') 'F|p|u' concatenated to one attachment. | | -| | | Repeatable. | | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| A | flagAutoSubmit 'on' / 'off' |If 'on' (default), add mail header 'Auto-Submitted: auto-send' - suppress OoO replies | | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| g | grId |Will be copied to the mailLog record. Helps to setup specific logfile queries | | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| x | xId |Will be copied to the mailLog record. Helps to setup specific logfile queries | | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| y | xId2 |Will be copied to the mailLog record. Helps to setup specific logfile queries | | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| z | xId3 |Will be copied to the mailLog record. Helps to setup specific logfile queries | | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| e | encode|decode|none |**Subject**: will be htmlspecialchar() encoded, decoded (default) or none (untouched) | | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ -| E | encode|decode|none |**Body**: will be htmlspecialchar() encoded, decoded (default) or none (untouched). | | -+----------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +|**Token** | **Parameter** |**Description** |**Required**| ++============+========================================+==================================================================================================+============+ +| f | email |**FROM**: Sender of the email. Optional: 'realname <john@doe.com>' | yes | +| from | | | yes | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| t | email[,email] |**TO**: Comma separated list of receiver email addresses. Optional: `realname <john@doe.com>` | yes | +| to | | | yes | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| c | email[,email] |**CC**: Comma separated list of receiver email addresses. Optional: 'realname <john@doe.com>' | | +| cc | | | yes | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| B | email[,email] |**BCC**: Comma separated list of receiver email addresses. Optional: 'realname <john@doe.com>' | | +| bcc | | | yes | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| r | REPLY-TO:email |**Reply-to**: Email address to reply to (if different from sender) | | +| reply-to | | | yes | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| s | Subject |**Subject**: Subject of the email | yes | +| subject | | | yes | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| b | Body |**Body**: Message - see also: `html-formatting`_ | yes | +| body | | | yes | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| h | Mail header |**Custom mail header**: Separate multiple header with \\r\\n | | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| F | Attach file |**Attachment**: File to attach to the mail. Repeatable. | | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| u | Attach created PDF of a given URL |**Attachment**: Convert the given URL to a PDF and attach it the mail. Repeatable. | | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| p | Attach created PDF of a given T3 URL |**Attachment**: Convert the given URL to a PDF and attach it the mail. Repeatable. | | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| d | Filename of the attachment |**Attachment**: Useful for URL to PDF converted attachments. Repeatable. | | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| C | Concat multiple F|p|u| together |**Attachment**: All following (until the next 'C') 'F|p|u' concatenated to one attachment. | | +| | | Repeatable. | | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| A | flagAutoSubmit 'on' / 'off' |If 'on' (default), add mail header 'Auto-Submitted: auto-send' - suppress OoO replies | | +| autosubmit | | | yes | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| g | grId |Will be copied to the mailLog record. Helps to setup specific logfile queries | | +| grid | | | yes | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| x | xId |Will be copied to the mailLog record. Helps to setup specific logfile queries | | +| xid | | | yes | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| y | xId2 |Will be copied to the mailLog record. Helps to setup specific logfile queries | | +| xid2 | | | yes | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| z | xId3 |Will be copied to the mailLog record. Helps to setup specific logfile queries | | +| xid3 | | | yes | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| e | encode|decode|none |**Subject**: will be htmlspecialchar() encoded, decoded (default) or none (untouched) | | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ +| E | encode|decode|none |**Body**: will be htmlspecialchar() encoded, decoded (default) or none (untouched). | | ++------------+----------------------------------------+--------------------------------------------------------------------------------------------------+------------+ * **e|E**: By default, QFQ stores values 'htmlspecialchars()' encoded. If such values have to send by email, the html entities are unwanted. Therefore the default setting for 'subject' und 'body' is to decode the values via 'htmlspecialchars_decode()'.