This document describes the setup and functions of the XQueue extension for Shopware 6 manual.
...
The module is used in the XQueue sample instance: http://dev-shop1000.maileon.com/shopware6
(Figure 1).
...
Updates
Important note:As of Shopware 6.4, a "hash" parameter is required to confirm newsletter subscribers, so as of plugin version 1.0.6, this parameter is written to the contact field 'Shopware_hash' when sending a DOI, and must be returned to Shopware with the webhook call. Details, see Figure 17.
If this value is not passed, login confirmers will NOT be marked as active in Shopware. marked.
Important note: We have received reports that after updating to 1.0.4 or 1.0.5, features like the test button and the import-all button does not work until you deactivate and reactivate the plugin. Therefore, we recommend disabling and re-enabling the plugin by default after an update.
...
The current module is constantly being developed and tested with current Shopware versions.
Important note: Major Shopware updates usually include changes that are not compatible with older versions. Therefore, the following list summarises which plugin versions are compatible with which Shopware versions:
Plugin 1.0.3 is compatible with Shopware 6.0 - 6.2
Plugin 1.0.4 is compatible with Shopware 6.3 - 6.3.4
Plugin 1.0.5 is compatible with Shopware 6.3.5 - 6.4.7
Plugin 1.1.x is compatible with Shopware 6.4.x
Plugin 1.2.x is compatible with Shopware 6.5.x
Plugin 1.3.x is compatible with Shopware 6.5.x
Plugin 1.4.x is compatible with Shopware 6.6.x
Install module
The module can be installed directly from the Shopware Store:
https://store.shopware.com/xqueu37905376689f/xqueue-maileon-newslettermanagement.html
...
Here you can specify whether the DOI mails are sent from Maileon or not. Recommended setting: yes.
IMPORTANT: The item does NOT suppress the DOI mails from Shopware. The DOI mail dispatch from Shopware itself can be disabled under "Settings → Business EventsFlow Builder" via the newsletter.register entry.
DOI Key
Here you can define a DOI To enable the double opt-in process, the Permission setting must be set to a value lower than Double Opt-in. Specifically, the Permission value must be None, Single Opt-in, or Confirmed Opt-in. If the Permission setting is configured as Double Opt-in or Double Opt-in Plus, the double opt-in process will not be initiated.
DOI Key
Here you can define a DOI mailing key that determines which DOI mailing should be triggered as soon as a guest or customer registers for the newsletter. The key can be configured or read out in Maileon for the corresponding DOI mailing in the basic settings.
...
For those webshops that use a Saleschannel with multiple languages and would like the data to be sent to different Maileon accounts for each language. More info: https://maileon.atlassian.net/wiki/spaces/MSI/pages/2385674241/User+documentation#Set-different-API-keys-depending-on-language.1
Webhook Token
A randomly generated secret string used to identify the calls to the webhooks from Maileon. There is one webhook for DOI confirmations and one for unsubscribes so that these changes can be applied to Shopware immediately. Further setup of the webhooks is shown in chapter "Settings to be made in Maileon".
...
When a store customer registers in his customer profile via the check mark it can be selected whether he is created directly with the target permission or whether a DOI process should be started.
Important note: This configuration setting is not available from plugin version 1.3.0, because this functionality is available from Shopware 6.5.x in the Shopware Newsletter settings. More info: https://maileon.atlassian.net/wiki/spaces/MSI/pages/2385674241/User+documentation#Settings-to-be-made-in-Maileon
...
Product properties to custom fields
As of version 1.1.2, there is an option to transfer product properties as custom fields in Maileon (Figure 7).
...
Product properties to order confirm product transactions
As of version 1.1.2, there is an option to transfer product properties as transaction variables for order transactions (Figure 9).
...
The transaction type "shopware_abandoned_carts_1.0" is then created in Maileon. The version number refers to the default definition 1.01. (https://maileon.com/support/shopping-cart-abandonment/)
As of version 1.2.4, you can also run the abandoned cart from the command line for testing. You can using the following commands:
...