Easy Newsletter Documentation
Easy Newsletter: Step-by-step setup
For the initial setup of Easy Newsletter, you can read through our step-by-step guide.
Settings: Easy Newsletter
You'll find the settings in the WordPress dashboard under „Easy Newsletter“ and then „Settings“.
- Sender email address
Email address from which your newsletter is sent. - Sender's email name
Name displayed to subscribers when they receive the newsletter. - Reply to e-mail address
Email address to which replies to the newsletter will be sent. - Maximum emails sent per interval
How many emails should be sent simultaneously? The default value is 60, but this can be adjusted individually. - Interval in seconds
How long should an interval between two email sending actions be? The default value is 300. - Registration form fields
The fields can be individually selected or deselected using checkboxes and will be requested or not in the registration form accordingly.- Salutation
- Gender
- First name
- Surname
- Phone number
- Sender email address
- Currently active newsletter
Show the name of the newsletter that is currently being sent. - Currently active newsletter ID
Displays the ID of the newsletter currently being sent. - Selected mode
Here you can choose between „default“ and „user“. In „default“ mode, a custom list for newsletter recipients is used in the backend. In „user“ mode, the plugin uses the standard WordPress user list for newsletter recipients. - Sending process is running
Is active when a newsletter is sent. - Standard Notification ID
ID of the newsletter post that is sent by default when a new recipient signs up. The default value is determined and set during installation. Can be customised. - Standard unsubscribe message ID
ID of the newsletter post that is sent by default when a recipient unsubscribes. The default value is determined and set during installation. Can be customized. - Standard welcome message ID
ID of the newsletter item that is sent by default when a new recipient has successfully registered/activated. Default value is determined and set during installation. Can be adjusted. - Available subscriber category
Recipient categories can be added here, which can be used to restrict newsletter distribution. - Available subscriber roles
Recipient roles can be added here, which can be used to restrict newsletter distribution. - Custom newsletter CSS
You can add custom CSS here. The CSS you add here will then be automatically applied to all newsletters. - Role Key for New Subscribers
Define the role key for new subscribers. The default is `en_user_subscriber`. This is used in the „user“ mode for a new user role in the default WordPress user list. - Registration, Page ID
ID of the page containing the registration page content. Default is determined and set during installation. Can be customised. - Registration successful, page ID
ID of the page displayed to the user upon successful registration. Default value is determined and set during installation. Can be customised. - Confirmation successful, page ID
ID of the page displayed to the user upon successful confirmation. Default value is determined and set during installation. Can be customised. - Confirmation declined, page ID
ID of the page displayed to the user when confirmation was rejected. Default is determined and set during installation. Can be customised. - Logged out, page ID
ID of the page that is shown to the user when they wish to unsubscribe from the newsletter. The default value is determined and set during installation. Can be customised. - unsubscribedConfirmedPageID
ID of the page shown to the user when they have successfully unsubscribed from the newsletter. Default is determined and set during installation. Can be customised. - Registration form, page ID
ID of the page containing the registration form. Default is determined and set during installation. Can be customised. - unsubscribeFormPageID
ID of the page containing the logout form. Default value is determined and set during installation. Can be customised. - lastSentNewsletterID
ID of the last newsletter sent - lastEditedNewsletterID
Last edited newsletter ID - Stop newsletter dispatch„
Press the button to stop sending the newsletter. - File Upload
Upload existing contacts here as a CSV file. For your contacts to be imported successfully, your CSV file must contain the following columns. It is important that the columns are arranged in the following order: Salutation, Gender, First Name, Last Name, Phone Number, Email Address, and then the following columns: Optional custom fields.- Select file – Select the file you wish to upload.
- Import CSV – Clicking the button will upload the file.
All Newsletters
You can find the newsletters in the WordPress dashboard under Easy Newsletter and then „All Newsletters“.
- Create button„
Click the button to create a new newsletter - Default – Welcome
Welcome email, which is sent as soon as people have successfully signed up for the newsletter. Text and content can be freely adapted. - Default – Unsubscribed
Unsubscribe confirmation email, sent once people unsubscribe from the newsletter. Text and content are freely selectable. The unsubscribe link should not be changed. - Default – Activation
Registration email, which is sent as soon as someone signs up for the newsletter. Text and content can be freely chosen. The registration link should not be changed.
Newsletter single page
You'll find the newsletter single page in the WordPress dashboard under Easy Newsletter „All Newsletter“ and then you can click the „Create“ button.
- Send newsletter button„
Click the „Send Newsletter“ button to send the newsletter. A pop-up will appear, displaying the number of recipients the newsletter will be sent to. If you are sure you want to send the newsletter, confirm the sending by clicking “Yes”. If anything is still not right, you can cancel the sending by clicking “No”. - Button „Send Test Email“
Send a test email to the test email address you have on file. - Save draft
Save your newsletter as a draft. - Preview
View the preview of your newsletter. The preview is identical to the code that is also used in the emails when sending newsletters. - Publish button„
Saves your newsletter. It can then be found via the frontend.
Newsletter single page Sidebar: Newsletter Settings
You can find the newsletter settings in the sidebar of your editor under „Newsletter Settings“ on the individual newsletter pages.
- Subject
You can enter your subject line for your newsletter here. - Newsletter Excerpt
Hier ist ein Vorschautext für deinen Newsletter: Bleiben Sie auf dem Laufenden mit unserem neuesten Newsletter! Darin finden Sie die neuesten Nachrichten, exklusive Angebote und spannende Einblicke, die Sie nicht verpassen sollten. Melden Sie sich jetzt an, um nichts zu verpassen!. - Test Email Address
Set up which email address test newsletters should be sent to.
Newsletter Einzelseite: erweiterte Einstellungen
Further newsletter settings, such as custom meta fields, conditions, newsletter attachments and custom HTML injections, can be found at the end of the individual newsletter page.
- Newsletter Attachment (Button „Save New Attachment“)
- Custom MetaFields Conditions
- Add custom HTML injection
Pages
In the WordPress Dashboard, under „Pages,“ you'll find seven created pages that are required for the plugin. The content on each page is in English by default, but can be translated and adapted via the editor.
- Newsletter confirmation denied page
Confirmation was refused. - Easy Newsletter Confirmation Success Page
The confirmation has been confirmed. - Easy Newsletter Registration Form Page
Registration page - Easy Newsletter Registration Success Page
Your newsletter subscription was successful. - Easy Newsletter Unsubscribed Confirmed Page
You have been unsubscribed from the newsletter. - Easy Newsletter Unsubscribe Page
Unsubscribe page for the newsletter. - Easy Newsletter Form
Adapt the registration form for your newsletter here. Copy the shortcode and paste it onto the desired pages on your website. The registration form will then be displayed there.
Anmeldeformular: individuelle Bestätigungsseite und Weiterleitung
Mit dem Shortcode [easyNewsletter] kannst du festlegen, welche Hinweis-Seite nach einer erfolgreichen Anmeldung verwendet wird. So können beispielsweise für unterschiedliche Newsletter oder Infobriefe eigene „Danke, bitte bestätige deine E-Mail“-Texte verwendet werden.
Standardverhalten
[easyNewsletter category="Newsletter"]
Nach der Anmeldung wird der Inhalt der vom Plugin angelegten Standard-Seite „Easy Newsletter Registration Success Page“ direkt an der Stelle des Formulars angezeigt.
Eigene Bestätigungsseite im Formular anzeigen
[easyNewsletter category="Newsletter" registration_success_page_id="1824"]
Der Inhalt der veröffentlichten WordPress-Seite mit der ID 1824 wird direkt anstelle des Formulars angezeigt.
Auf die Standard-Bestätigungsseite weiterleiten
[easyNewsletter category="Newsletter" redirect="true"]
Nach der Anmeldung wird der Besucher auf die vom Plugin angelegte Standard-Bestätigungsseite weitergeleitet.
Auf eine individuelle Bestätigungsseite weiterleiten
[easyNewsletter category="Newsletter" registration_success_page_id="1824" redirect="true"]
Nach der Anmeldung wird der Besucher auf die veröffentlichte WordPress-Seite mit der ID 1824 weitergeleitet.
registration_success_page_id: Die ID einer veröffentlichten WordPress-Seite mit deinem individuellen Hinweis- oder Bestätigungstext. Wird keine gültige ID angegeben, verwendet Easy Newsletter die Standard-Bestätigungsseite.redirect: Mitredirect="true"erfolgt eine Weiterleitung auf die gewählte Bestätigungsseite. Ohne dieses Attribut oder mitredirect="false"wird ihr Inhalt direkt im Formularbereich ausgegeben.- Die Seiten-ID findest du im WordPress-Dashboard unter „Seiten“, wenn du die gewünschte Seite zum Bearbeiten öffnest. Sie steht in der URL hinter
post=.
Webfonts im Newsletter
Easy Newsletter kann die Webfonts deines Themes für den Newsletter übernehmen. E-Mail-Programme, die Webfonts unterstützen und externe Inhalte laden dürfen, rufen die Schriftdateien von deiner Website ab. Andere Programme zeigen die hinterlegte Ersatzschrift an. Die Darstellung kann deshalb trotz korrekter Einrichtung vom Website-Design abweichen.
Schriftdateien für externe Einbindung freigeben
Für das Laden von einer anderen Herkunft kann eine CORS-Freigabe erforderlich sein. CORS steht für Cross-Origin Resource Sharing. Die Freigabe wird vom Server mit der Schriftdatei ausgeliefert; ein Eintrag im Newsletter-CSS reicht dafür nicht aus.
Auf einem Apache-Webserver kannst du die folgende Regel in die .htaccess im Verzeichnis der benötigten Schriftdateien einfügen. Sichere eine vorhandene Datei vorher und ergänze sie, statt ihren Inhalt zu ersetzen. Die Regel setzt das Apache-Modul mod_headers und die Erlaubnis für entsprechende Einstellungen in der .htaccess voraus.
# Webfonts für externe Einbindung freigeben
<IfModule mod_headers.c>
<FilesMatch "\.(woff2?|ttf|otf)$">
Header set Access-Control-Allow-Origin "*"
</FilesMatch>
</IfModule>
Die Regel gilt für WOFF, WOFF2, TTF und OTF. Das Sternchen erlaubt die Einbindung von jeder Herkunft. Begrenze die Regel deshalb möglichst auf das benötigte Font-Verzeichnis: Auch andere Websites könnten diese öffentlich erreichbaren Schriftdateien damit einbinden und Bandbreite verbrauchen.
Alternativ lässt sich die Regel in der WordPress-Hauptdatei .htaccess außerhalb von # BEGIN WordPress and # END WordPress ergänzen. Sie gilt dann für passende Schriftdateien unterhalb dieses Verzeichnisses. Bei Nginx, einem CDN oder eingeschränkten Hosting-Einstellungen muss die Freigabe gegebenenfalls beim Hosting-Anbieter eingerichtet werden. Easy Newsletter verändert deine Serverkonfiguration nicht automatisch.
Freigabe überprüfen
Prüfe nach der Änderung eine tatsächlich verwendete Schriftdatei, zum Beispiel in den Netzwerk-Werkzeugen deines Browsers. Die Antwort sollte erfolgreich sein und genau einen Header Access-Control-Allow-Origin: * enthalten. Eine bereits vorhandene CORS-Konfiguration sollte nicht durch einen zweiten Header ergänzt werden. Leere gegebenenfalls den CDN- oder Browser-Cache und versende anschließend eine Test-E-Mail. Fehlt der Header, frage deinen Hosting-Anbieter; bei einem Serverfehler stelle die gesicherte Datei wieder her.
Die CORS-Freigabe ersetzt keine Webfont-Unterstützung des E-Mail-Programms und umgeht keine Sperre für externe Inhalte.
Schriftlizenz und Datenschutz beachten
Prüfe vor der Verwendung, ob deine konkrete Schriftlizenz die Nutzung in HTML-Newslettern erlaubt. Beim Nachladen können IP-Adressen und weitere Verbindungsdaten beim Hosting-Anbieter anfallen; manche E-Mail-Programme rufen Dateien über einen Proxy ab. Berücksichtige die tatsächliche Verarbeitung in deinen Datenschutzinformationen. Die technische CORS-Freigabe ist keine rechtliche Freigabe für die Nutzung der Schrift oder für Tracking.