Adjust the mails
The plugin never sends mail by itself. It starts three Flow Builder triggers, and on installation it adds a mail template and a Flow for each, in English and German. You change the wording in the mail templates and the recipients and conditions in the Flows.
The three mails
| Flow (as installed) | Trigger | Default recipient | Mail template |
|---|---|---|---|
| Edit window opened | ssd_order_editing.window.opened | The customer | Edit window opened. Subject: "You can still change order …" |
| Order change committed | ssd_order_editing.change.committed | The customer | Order change committed. Subject: "Your changes to order … are confirmed" |
| Refund due after order change | ssd_order_editing.refund.due | Your shop's administrator users | Refund due after order change. Subject: "Refund due on order …" |
In the Flow list, the triggers appear as Order Editing: Edit window opened, Order Editing: Order change committed and Order Editing: Refund due after a change.
Change the text of a mail
- Open Settings > Email templates.
- Open the template, for example Edit window opened.
- Edit subject and content for each language, then save.
The templates can use these variables in addition to order:
| Trigger | Variables |
|---|---|
| Edit window opened | windowMinutes (the window length), closesAt (the closing time), guestOrder |
| Order change committed | changes (the list of changes), amountDelta (how much the total moved), guestOrder |
| Refund due | refundAmount |
The shipped templates say how many minutes the customer has instead of naming a clock time. A mail is rendered without the customer's time zone, so a clock time could be wrong by several hours. If you add closesAt, format it for your shop's time zone yourself.
The link in the mails
The shipped templates choose the link by the kind of customer:
- Customers with an account get a direct link to Change your order (in the window mail) or to their order list (in the confirmation mail). If they are not logged in, they log in first and then land on the right page.
- Guest customers get a link to your shop's guest order page. They confirm their mail address and the postcode of their billing address there, and then see the order with the Change order button.
Change who gets a mail
- Open Settings > Flow Builder.
- Open the Flow, for example Refund due after order change.
- Open the Send email action and change the recipient, for example to a custom address for your accounting team.
- Save the Flow.
You can also add conditions or further actions to these Flows, or deactivate a Flow you do not want.
If no mails arrive after installation
A Flow that an installation writes has to be indexed once before Shopware runs it, and installing a plugin does not index it by itself. Until that happens, the three Flows are listed in the Flow Builder but send nothing. Any one of these indexes them:
- finish your deployment with
bin/console system:update:finish. Shopware's own deployment scripts already do this, so on most shops the Flows work right away - open the Flow under Settings > Flow Builder and save it once — saving indexes that Flow immediately
- rebuild the indexes under Settings > System > Caches & indexes (this one runs through the message queue, so a worker has to be running)
- run
bin/console dal:refresh:index --only=flow.indexer
A running message queue worker on its own does not index them.
What happens on uninstall
Uninstalling the plugin leaves the three mail templates and Flows in your shop, so your edits are not lost. Their triggers no longer exist, so the Flows no longer run. Delete them by hand if you do not need them.