Release notes

• From version 1.4.0 the plugin is compatible with the Shopware Plugin Store. Unfortunately, the necessary changes are not backwards compatible, so that BEFORE installing version 1.4.0 or higher, all older versions up to 1.3.9 must be uninstalled manually.

• From version 1.4.13, the "Update transaction types" function in the UI should be used so that the manufacturer number can also be transferred.

...

The module is used in the XQueue example instance http://dev-shop1000.maileon.com/shopware/ (Illustration 1).

...

Commissioning name of the module

...

The advantage of this approach is clear: easy installation and very simple information and update options (Illustration 2).

...

Via "Settings" "Plugin Manager" "Installed" "Upload Plugin" can be added to Shopware (Illustration 3 and Illustration 4).

...

Image RemovedImage Added

Illustration 4 shows the Plugin Manager after the module has been successfully added. The module can already be configured via the red marked "Edit" button or first installed and activated via the green + symbol. Illustration 5 shows the module after successful activation.

...

Configure module

The module now only needs to be configured by clicking on the "Edit" button.

...

Illustration 6 shows the configuration page on which the API key and a permission must first be entered. The API key can be created and viewed in the Maileon account under "Settings" "API Keys". Since version 1.1.0, the plugin is sub/language shop-capable. In the settings, there is then a configuration for each subshop, as can be seen in Illustration 6.

...

If required, the menu item "Marketing" - "Maileon Manager" (Illustration 7) can also be used to view current newsletter subscribers and synchronise all subscribers (also from before the module was installed) with Maileon. Furthermore, the manager shows the settings for the webhooks that have to be set up in Maileon and allows the transaction types to be created manually in Maileon. Otherwise, these would only be generated the first time they are used. However, if you want to have all or individual mailings generated before testing, such as an order confirmation mail, then it is advisable to create the transaction type in advance in order to gain access to its variables in the template.

...

Import all applicants into Maileon

...

1. email (required): The email address of the contact must be entered here.

2. code (required): For security reasons, the secret code is inserted here. To prevent this code from being read, it is recommended to use an SSL-encrypted connection.

3. reg_date (required if hash param is not set and DOI process is enabled in Shopware basic settings)

4. hash (not required): Since version 1.4.4 it is possible to add a parameter 'hash'. If the parameter is not present, then the plugin works as before, but if the parameter is set, then DOI confirmers are only registered in Shopware if the hash is correct. This function is useful if several physically separated shops are to be controlled from one Maileon account. In this case, a webhook is called on each shop but only the shop to which the contact really belongs will register it.

...

Unsubscribe

A new webhook must now be added for the "Unsubscriber" event. For this, the URL and the webhook ID from the "Maileon Manager" (point 5 in the installation chapter) must be used.

...

1. email: The email address of the contact must be entered here.

2. code: For security reasons, the secret code is inserted here. To prevent this code from being read, it is recommended to use an SSL-encrypted connection.

...

Using the plugin from within other plugins

...

• Version 1.4.0, 21.09.2021

  • Updated code to be compatible with Shopware plugin store. Installing 1.4.0 requires complete uninstallation of previous versions

• Version 1.3.9, 17.09.2021

  • Changed to composer version of Maileon PHP API client

  • Bugfix: Handle if article model not found at order transactions

  • Bugfix: DOI confirm webhook processes data now correctly, if captcha is enabled

...

• Version 1.3.0, 08.02.2021

  • Change permission logic (added explicit initial permission and DOI, DOI+ process)

  • Add extended order transaction types (v1.0)
    BE AWARE: This update creates new transaction types. Mails bound to the old type WILL NOT be sent anymore. Make sure to first create the types, e.g. from a staging system, create the mails and then install this update on your live system.

  • Add functionality to create all transaction types at Maileon by clicking one button in the Shopware settings

...