Plugin: smart newsletter

Version

5.5.0 or newer

Table of contents

Some hosters have a specific limit per day for e-mail delivery, so you should consult with your hosting partner beforehand if this limit is sufficient for your needs.

In this article we will explain the features of the premium plugin Smart Newsletter.

Installation

The plugin "Smart Newsletter" has to be installed as usual, similar to known plugins. After you've installed the plugin, you have to reload your backend, so the plugin components can be integrated in the menus. It may be needed to clear the config cache and then reload the site. Afterwards the plugin can be found at Marketing > Newsletter Manager.

Overview

After you open the newsletter manager, you will see the newsletter overview. This table includes the main information of all newsletters, which are present in the shop and provides a couple of actions you can trigger directly from the table.

  • Date (1): The date on which the newsletter was initially created.
  • Shipping date (2): The date, when the newsletter sending was finished.
  • Subject (3): The subject of the newsletter, which was set during the creation of the newsletter.
  • Status (4): Shipping status of the newsletter. If the newsletter is ready for shipment, the percentage of already sent mails will be displayed here.
  • Recipients (5): Amount of recipients for this newsletter.
  • Letters read (6): Amount of newsletters, which were actually read by it's recipient.
  • Clicks (7): Amount of clicks the newsletter generated; How often recipients clicked the newsletter to access the shop.
  • Turnover (8): Total turnover generated by recipients, who clicked the newsletter.
  • Released (9): Shows, if the newsletter is marked as "Ready for sending", important for sending the newsletter via cronjob.
  • Delivery time (10): Immediately, if the newsletter is already ready for sending or Date, when sending is planned for the future.
  • Edit newsletter (11): Opens the selected newsletter in the editor.
  • Delete newsletter (12): Deletes the selected newsletter.
  • Send newsletter (13): Immediately sends the newsletter, only available if no planned date is set and the newsletter is not marked as "ready for sending".
  • Duplicate newsletter (14): Duplicates the selected newsletter.

Designer

  • Mail address (1): The mail address, to which you can send a test newsletter.
  • Send test mail (2): Sends a test mail to the mail address you entered.
  • Preview (3): Opens a backend preview of the current newsletter in your backend.
  • Back to overview (4): Closes the "Create newsletter"-window, any unsaved progress will be lost.
  • Save (5): Saves the newsletter, if the option is not available, crucial settings, e.g. the subject of the newsletter, are still missing, switch to the "Settings"-Tab to enter this data in order to save your newsletter.

Available Elements

HTML element

With the HTML element you are able to add content to your newsletter. The extendable sidebar on the right of the window shows all available variables, e.g. to personalize the newsletter.

The following variables are available:

  • $sUser.email: E-mail address of the recipient
  • $sUser.salutation: Salutation of the recipient
  • $sUser.firstname: Firstname of the recipient
  • $sUser.lastname: Lastname of the recipient
  • $sUser.street: Street and No. of the recipient
  • $sUser.zipcode: Zipcode of the recipient
  • $sUser.city: City of the recipient

Examples of use:

Variable/ExampleExplanation
{if $sUser.salutation == 'mr'}Mister{/if}{if $sUser.salutation == 'ms'}Miss{/if}Use of the correct salutation
{if $sUser.city !=""}How is it going in {$sUser.city}?{/if}Use of the city in a sentence. The sentence will only be shown, if there is a value available for the city.
You are registered to out newsletter with th e-mail address {$sUser.newsletter}.Note for the registrated e-mail address, which receives the newsletter

Here you can select a banner (1) and link it (2), you can also set a heading (3), which is displayed above the image and define if the link is opened in a new window or the existing one (4).

Product group

You can select from four different item types:

  • Random: Shows a random item.
  • Top selling product: Shows one of the topseller items.
  • New product: Shows a new item (This depends on the setting, how long new items are highlighted as new).
  • Chosen product: Shows the item you select.

Using this element, you can use one or more links in the newsletter and set a description (1) and a link target (2) per link.

Voucher

You can add individual vouchers, which are added to the newsletter automatically. You should make sure, that your voucher has enough free codes. You can also modify the text (1) for the voucher element, add an image (2) or a link (3).

Suggest

The suggest shows individual items depending on the recipient, based on their search and order history in your shop. Note that this feature only works for registered customers, not registered customers will see random items. You can define, how many products are suggested (1).

In addition you can also create your own elements for extending the newsletter.

Settings

  • Subject (1): Subject of the newsletter.
  • Sender (2): The e-mail-address that is used as the sender of the newsletter.
  • Customer group (3): Customer group the newsletter is associated with.
  • Select language (4): Select the Language of the newsletter.
  • Send at (5): Planned date, when the newsletter will be send.
  • Shipping type (6): Defines if the newsletter is send as plaintext or HTML and plaintext.
  • Published (7): Defines, if the newsletter is listed at "yourshop.com/newsletterlisting".
  • Ready for sending (8): Marks the newsletter to be available for sending via cronjob
  • Select newsletter recipients (9): Used to select, who the newsletter should be send to. You can select from customer groups, custom recipient groups and Customer Streams.

Analytics

In the tab "Analytics" you find a graph and a table showing different analytics regarding the newsletters you've sent.

The graph shows the following values for the newsletters you've sent, so you can compare, how your different newsletters performed:

  • Buy Rate: Shows the percentage of orders in comparison to the amount of sent newsletters.
  • Read Rate: Shows the percentage of newsletters, which were read by the recipients in comparison to the amount of sent newsletters.
  • Click to Order Rate: Shows the percentage of orders resulting from clicks.
  • Click Rate: Shows the percentage of newsletters, which were clicked by the recipients in comparison to the amount of sent newsletters.

The table underneath the graph shows the absolute numbers for your newsletter, such as the amount of recipients, the revenue, number of orders, conversion rate and how many recipients read and clicked the newsletter.

The tab Orders shows all orders which were placed after a newsletter recipient clicked the newsletter to enter the shop, showing the customers name, time of the order, order and payment state, the sum and options to access the order and the customer.

Administration

The administration tabs contains three tabs, which contain useful settings and information regarding the newsletters in Shopware.

Sender

Here you can create, edit and delete newsletter senders, which can be selected when creating a newsletter. You can set, which e-mail address is shown as the sender and which name will be displayed for this sender.

Recipient groups

In this tab you can create and delete custom recipient groups for your newsletters. Only custom recipient groups will be shown here, but not the recipient groups based on the customer groups.

Recipients

This lists every newsletter recipient of your shop. You can add (1) and delete (2) recipients or search for specific recipients. You can see, when the recipient confirmed the double opt-in and which newsletter is the last one the recipient received. By double clicking a recipient you can modify the e-mail address and recipient group. If you change the recipient group, you can only select the custom recipient groups.

Alternating smtp emailing

You can configure a separate emailing using a differing smtp server by using this change in the cofig.php:


'newsletterMail' => array (
    'name' => '',
    'type' => 'smtp',
    'auth' => 'login',
    'username' => '',
    'password' => '',
    'host' => '',
    'port' => '',
    'ssl' => ''
), 

Here a complete example:


<?php
return array(
    'db' => array(
        'username' => 'root',
        'password' => 'root',
        'dbname' => 'shopware',
        'host' => 'localhost',
        'port' => ''
    ),
    'newsletterMail' => array (
        'name' => '',
        'type' => 'smtp',
        'auth' => 'login',
        'username' => '',
        'password' => '',
        'host' => '',
        'port' => '',
        'ssl' => ''
    ),
); 

Please mind that you must not do empty elements in this because those will not automatically be changed to "NULL". You must either fill all elements or just leave out the option that does not get a value.

This setting only changes the emailing of the intelligent newsletter. All other components of the shops ware using the basic mailer settings.

Time managed newsletter sending

The plugin allows you a time manages sending of your newsletter.

In the newsletter settings you find an option Send at (1). There you can easily define a time when you want to send the newsletter. For this you also have to activate ready for sending (2) for the newsletter to be send when calling myshop.de/backend/Newsletter/cron.

The newsletter will only be send when the defined date and time have been reached. If the date or time is in the future this newsletter will not be used by the cronjob.