Configuration/Core/client/html/Adapt delivery email

From Aimeos documentation

Configuration | Core/client/html
Other languages:
English 100%


2017.x version

Delivery e-mails are sent out by the order/email/delivery job after the delivery status of an order has changed. The available order delivery status values are :

  • STAT_UNFINISHED (-1)
  • STAT_DELETED (0)
  • STAT_PENDING (1)
  • STAT_PROGRESS (2)
  • STAT_DISPATCHED (3)
  • STAT_DELIVERED (4)
  • STAT_LOST (5)
  • STAT_REFUSED (6)
  • STAT_RETURNED (7)

For each of these delivery status values you are able to send out an e-mail to the customers informing them about the delivery status change. For which status changes e-mails are sent is configured via the controller/jobs/order/email/delivery/standard/status setting.

E-Mail settings

Shop owners have the possibility to configure specific e-mail settings for the delivery e-mails that differ from the common settings. Each specific setting overwrites the correlated common setting for the delivery e-mails. The list of specific settings are:

Structure

Delivery e-mails consists of a HTML and a text part. They are sent in one e-mail as alternative views and the mail clients will display the one that is preferred by the customer. Like the other components, they are composed of several subparts which can be rearranged, replaced, removed or new ones added. The HTML subparts are configured via the client/html/email/delivery/html/standard/subparts setting while the text subparts can be changed with the client/html/email/delivery/text/standard/subparts option.

Aimeos-email-service-html.png

The available HTML subpart implementations are: subparts]]

The order summary subpart use the shared summary partials, so changes for the basket or checkout summary are automatically reflected in the HTML e-mails. For more information please have a look at the article about adapting the common summary subparts.


Aimeos-email-service-text.png

For the text subpart implemenations, the same subparts are available too:

Contrary to the HTML part, the the order summary doesn't use any partials shared with other components, only with the payment related e-mails. Please remember that when you adapt the account history, standard basket, checkout summary or the HTML e-mail order summary.


Templates

You can adapt the templates for the HTML/text delivery e-mails itself and the included sections by overwriting them in you own extension or configuring alternative template names:

If you want to change the HTML structure of one of the templates, please have a look at the original versions to ensure that you don't loose essential functionality.

Templates for each status

For each delivery status value, you can create a subpart template that has precedence over the common template, e.g. the html/text "intro" template can be different depending if it's used for a status e-mail that is sent because the order has been deleted, shipped or returned. This is already used for the "dispatched", "refused" and "returned" status values.

All delivery e-mail templates are in ./client/html/templates/email/delivery/ directory of the core or the overwritten ones in the same directory within your Aimeos extension. To use your own status specific templates, you need to place them in subdirectories that are named after the delivery status values, e.g.

./client/html/templates/email/delivery/3/html-intro-body-default.html

for the HTML intro body template specific for "order dispatched" e-mails. This can be done for all delivery status values, so you can adapt each type of e-mail totally to your needs.