diff --git a/README.md b/README.md index 8aad1be20a4a8e62860556d12f519f25b46552b6..8894b84dad1bc3418cd6d5bf1572fbfb381d9b51 100644 --- a/README.md +++ b/README.md @@ -212,6 +212,38 @@ With the **Mail Queue** mode, you can see the current content of your mailing qu Additionally you can now filter the mail queue or export it to a csv file. +## Blacklisting templates +It is possible to exlude certain templates for all or specific domains. Excluded templates are not shown in the backend module +and their mails are never send. +Mails from these templates are still logged and you can search for them in the backend module. + +### Blacklisting templates for all domains +In the extension configuration setting **general.excludeTemplatesAllDomains**, you can specify which templates should be excluded for all domains with a comma seperated list. + +Example: + + sg_comments.approved, sg_comments.declined + +The templates "approved" and "declined" of the extension sg_comments are blacklisted for every domain. + +### Blacklisting templates for certain domains +In the extension configuration setting **general.excludeTemplates**, ou can specify which templates should be excluded for which domains with a Semicolon separated list of comma separated list. + +The comma seperated lists contain the page id and the templates to be excluded. + +Example: + + 1, sg_comments.approved, sg_example.welcome;10, sg_comments.declined + +The template "approved" of the extension sg_comments and the template "welcome" of the extension sg_example are blacklisted for the domain with the page id 1. + +The template "declied" of the extension sg_comments is blacklisted for the domain with the page id 10. + +If the page ids are missing or not correspond to a site root, the configuration has simply no effect. + +### Searching for emails from blacklisted templates +In the backend module mode "Queue" you can filter for "Blacklisted" mails. Note: you shouldn't select a template filter to see the blacklisted mails. + ## Known Facts ### Countries aren't respected yet. Currently just languages are used.