Newsletter documents are the way to create and send newsletters directly within Pimcore. They are based on the normal Pimcore documents and therefore support everything as pages do - starting from MVC pattern and template creation to document composing within Pimcore backend with areas, drag&drop etc.
Newsletter documents provide following additional settings compared to default documents:
- Subject: Subject of the newsletter.
- From: From-Address of the newsletter. As fallback, Pimcore system settings are used.
- Add Tracking Parameters to Links: Adds tracking parameters to all links within the newsletter.
- Tracking Parameter 'Source', 'Medium', 'Name': Values for the tracking parameters.
- Sending Mode:
- Single (Render every Mail individually): Document is rendered for each recipient - necessary for individual newsletters.
- Batch (Render Mail only once): Document is rendered once - no individual newsletters possible, but faster.
The Newsletter Sending Panel provides the functionality for sending the newsletter.
Address Source Adapter
The Address Source Adapter is responsible for extracting the email addresses the newsletter should be sent to. It has to be selected before another action can take place. Currently following adapters ship with Pimcore. It is easily possible to integrate custom adapters - see section below.
- Default Object List: Extracts email addresses based on Pimcore objects.
- CSV List: Uses a CSV as source for email addresses.
- Column from a report: Uses a custom report as source for email adresses.
Once a Address Source Adapter is selected, a test sending to a specified email address can be made with the button
Sending the Newsletter
Send Newsletter Now the newsletter is sent to all recipients. The sending itself is done based on the system
settings of Pimcore. There you also can configure an external SMTP sending service for mass mail sending.
Creating a Custom Address Source Adapter
It is easily possible to implement custom address source adapter. Following files have to be created:
pimcore.document.newsletters.addressSourceAdapters, named like the adapter (e.g.
pimcore.document.newsletters.addressSourceAdapters.myAdapter) and implement the methods
getValues. As sample see csvList
- PHP Class: This class is the server side implementation of the adapter. It is responsible for retrieving and preparing
the email addresses. It needs to implement the interface
AddressSourceAdapterInterface. As sample see csvList.
- Register your Adapter Source Factory as Service. If you are using a very simple Adapter Source, you can use the DefaultFactory
app.document.newsletter.factory.myAdapter: class: Pimcore\Document\Newsletter\DefaultAddressSourceAdapterFactory arguments: - 'App\Document\Newsletter\AddressSourceAdapter\MyAdapter'
- If you are using a more complex Source Adapter, you can create your own Factory by implementing the interface Pimcore\Document\Newsletter\AddressSourceAdapterFactoryInterface
- Add your Adapter Factory to the configuration:
pimcore: newsletter: source_adapters: myAdapter: app.document.newsletter.factory.myAdapter