Easy Newsletter Documentation

back to the plugin

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 Single page: advanced settings

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.

Registration form: individual confirmation page and redirect

With the Shortcode [easyNewsletter] You can specify which sign-in page is used after a successful login. For example, you can use different „Thank you, please confirm your email“ texts for different newsletters or informational emails.

Standard behavior

[easyNewsletter category="Newsletter"]

After registration, the content of the standard page created by the plugin, the „Easy Newsletter Registration Success Page“, is displayed directly at the location of the form.

Display own confirmation page in the form

[easyNewsletter category="Newsletter" registration_success_page_id="1824"]

The content of the published WordPress page with the ID 1824 will be displayed directly instead of the form.

Continue to the standard confirmation page

[easyNewsletter category="Newsletter" redirect="true"]

After registration, the visitor is redirected to the standard confirmation page created by the plugin.

Forward to an individual confirmation page

[easyNewsletter category="Newsletter" registration_success_page_id="1824" redirect="true"]

After logging in, the visitor is taken to the published WordPress page with the ID 1824 forwarded.

• registration_success_page_idThe ID of a published WordPress page with your own note or confirmation text. If no valid ID is provided, Easy Newsletter uses the standard confirmation page.
• redirectWith redirect="true" a redirect to the selected confirmation page occurs. Without this attribute or with redirect="false" its content is displayed directly in the form area.
• You can find the page ID in the WordPress dashboard under „Pages“ when you open the page you want to edit. It is located in the URL after post=.

Webfonts in the newsletter

Easy Newsletter can use the webfonts of your theme for the newsletter. Email programs that support webfonts and can load external content will retrieve the font files from your website. Other programs will display the replaced font that has been stored. The display may therefore differ from the website design despite proper configuration.

Share script files for external integration

To load from a different origin, a CORS authorization may be required. CORS stands for Cross-Origin Resource Sharing. The release is delivered by the server with the font file; a entry in the newsletter CSS is not sufficient for this purpose.

On an Apache web server, you can add the following rule to the .htaccess Insert it in the directory of the required font files. Back up an existing file first and add it, rather than replacing its contents. The rule sets the Apache module mod_headers and the permission for corresponding settings in the .htaccess ahead of time.

# Share webfonts for external integration

    
        Header set Access-Control-Allow-Origin "*"

The rule applies to WOFF, WOFF2, TTF, and OTF. The asterisk allows the inclusion of any font from any source. Therefore, limit the rule to the required font directory as much as possible: Other websites could also include these publicly accessible font files and consume bandwidth.

Alternatively, the rule can be set in the WordPress main file. .htaccess outside of # BEGIN WordPress and # END WordPress supplement. It then applies to appropriate font files below this directory. With Nginx, a CDN, or restricted hosting settings, the release must be configured with the hosting provider if necessary. Easy Newsletter does not automatically change your server configuration.

Check for release

After the change, check the font file that is actually being used, for example in the network tools of your browser. The response should be successful and exactly one header Access-Control-Allow-Origin: * included. An existing CORS configuration should not be supplemented by a second header. If empty, empty the CDN or browser cache, and then send a test email. If the header is missing, ask your hosting provider; if a server error occurs, restore the secured file.

The CORS permission does not replace the web font support of the email program and does not bypass the blocking of external content.

Observe copyright and data protection

Before using it, check whether your specific font license allows its use in HTML newsletters. When uploading, IP addresses and other connection data may be required from the hosting provider; some email programs download files via a proxy. Please consider the actual processing in your privacy information. The technical CORS authorization is not a legal authorization for the use of the font or for tracking.