Setup + Configuration
11 min
prerequisites before you can use the newsletter plugin, it needs to be activated by purple contact your project manager or customer success team to request activation of the newsletter plugin in your hub initial configuration 1\ access newsletter settings after the plugin is activated navigate to all settings in your purple hub look for the new entry called newsletters click to open the newsletter settings page 2\ configure service provider the newsletter plugin currently supports multiple email service providers, of which one can be selected each of them requires its own credentials to configure inxmail professional select inxmail professional from the service provider dropdown enter the following required credentials base url the endpoint where the inxmail professional api can be found client id your inxmail client identifier client secret your inxmail client secret key these credentials enable the newsletter module to interact with the inxmail professional api for sending newsletters to configure maileon select maileon from the service provider dropdown enter the following required credentials account name your maileon client identifier base url the endpoint where the maileon api can be found api key your maileon client secret key these credentials enable the newsletter module to interact with the maileon api for sending newsletters also configurable mailchimp activecampaign constant contact 3\ continue reading label this setting moved to the page post inserter block customization docid\ r3il7z av9dcvfg01mpyl 4\ save configuration after entering all required information, save your settings the system is now ready to create and send newsletters 5\ usage without configuring a service provider please note if you want to try out the newsletter plugin without selecting a service provider, please change the dropdown from ' select service provider ' to 'manual / other ' otherwise the layouts will not be displayed and certain functionality will not behave correctly inxmail unsubscribe link inxmail requires unsubscribe links to use a special link code (a so called doo link), for example \[%url\ verify opt out;https //your site com/unsubscribe successful;;;"unsubscribe newsletter"] this code cannot be entered as a link target in the editor directly instead, configure it once and use a placeholder in your newsletter content in the newsletter settings, paste the link code provided by inxmail into the inxmail unsubscribe link field and save in your newsletter (typically in the footer of your layout), select the text or button that should act as the unsubscribe link and set its link target to exactly \#newspack unsubscribe when the newsletter is sent to inxmail, this placeholder link is automatically replaced with the configured link code the preview and test emails already show the replaced link, so you can verify it before sending maileon unsubscribe & online version links maileon provides ready made merge tags for the unsubscribe link and the online (web) version link unlike inxmail, you do not need to configure any code in the newsletter settings — you only link to the tag in your layout in your newsletter layout, select the text or button that should act as the link, then set its link target to one of \[\[unsubscribe]] — the recipient's personal unsubscribe link \[\[online version]] — a link to open the newsletter in the browser when the newsletter is sent, maileon automatically replaces each tag with the correct per recipient link open tracking is also added automatically, so you don't need to insert anything for it you might need to switch the block to "code editing" to insert such a placeholder as a link to help with this, insert a link with some other target first, then switch to code editor, and then replace the link href with the placeholder above in the editor preview these tags appear as plain text (for example \[\[unsubscribe]] ) and the links will not work yet — this is expected they only resolve once maileon sends the email, so always verify them with a real test send link management make sure to also set up frontend links in purple hub docid\ wz7w 0fokon0mlpxupgvv , so that the newsletter can use the correct links to published articles when sending an e mail that contains links