Documentation Ticketmatic
Reference Manual (EN)
Order mails
ticketmatic gives you full control over the layout and content of all transactional order mails you can use html and css to style the order mails as you like you can among others use custom fonts add headers and footers you have full control over the content of the order mails you can make part of the order mails dynamic, dependent on certain conditions you can among others display dynamic order info like order id, date and total amount, buyer info and order content display the ticket delivery links display informational messages or images display information that is context specific for example you can show a specific message if tickets were bought for a specific event or through a specific sales channel order mails can be sent automatically at several important moments in the life cycle of an order when an order is confirmed when the order tickets should be delivered electronically when payment instructions need to be sent when an order is overdue when an order is expired this corresponds to the different types of order mails that can be defined confirmation delivery paymentinstruction overdue expiry you can have multiple order mails of each type, and deciding which mail to send when is highly configurable additionally, order mails can be sent manually from the orders app getting started set up a new order mail order mails are managed in the settings app click the button below to go to the order mails module now create a new order mail click on + add button a new ticket order mail is now created with default definition go to the settings tab and fill in name and subject and select a category the subject will be used as actual subject when the order mail is sent out the category defines when the mail will be sent the <> definition tab contains the html template for the order mail this default order mail is empty and is a good base to start customizing preview and testing environment while you are editing an order mail, you will see the preview pane on the right displaying your changes in realtime you can select the example order to test how the order mail looks for that specific order you can also send a test mail to see how the mail looks in an actual mail client customizing the definition by editing the definition, you can customize the ticket layout exactly as you want adding static content add static content to the order mail by including html/css in the definition for example, this definition will create a simple thank you order mail ticketmatic dear, thank you very much for your order kind regards, ticketmatic you see that this is a regular html template, with a head and a body section in the body section we use a table to position the content of the mail include \<meta http equiv="content type" content="text/html; charset=utf 8" /> in the head section to avoid problems with special characters like the € sign styling the order mail with css you can use regular css in the head section to style the order mail ticketmatic will transform the css in the head section to inline css when sending out the actual order mails to avoid some e mail clients stripping out \<head> and \<style> tags from e mails for example, add following tag to the head section to style the previous example adding dynamic content use placeholders to add dynamic content like order id, totalamount or number of tickets when you build the order mail, you have an several objects at your disposal that contain information about the order the order mail definition is actually a twig template and you can use the features of this template language to create a truly dynamic order mail http //twig sensiolabs org/ some example placeholders placeholder description {{order id}} the id of the order {{order totalamount}} totalamount for the order {{order createdts|date("d/m/y")}} order creation time formatted as "12/03/2018" twig filters , like the date filter in the example above, allow you to modify object properties and can be used among others to format properties http //twig sensiolabs org/doc/templates html#filters click on the (?) placeholders button to retrieve a list of all objects and properties that you can use as placeholder in the html template you will get a json representation of the available object with the current preview values filled in the placeholders also contain collections of items for example the events placeholder is a collection of all events for which there are tickets in the order you can use the http //twig sensiolabs org/doc/tags/for html to loop over all events the example below shows how to use this to add a table that displays the number of tickets per event in the order dateeventnumbersubtotal {% for event in events %} {{ event date|date("d/m/y h\ i") }}{{ event name }}{{ event ticketsummary count }}€ {{ event ticketsummary price|number format(2) }} {% endfor %} this is an overview of the placeholders available for an order order \<all order placeholders> events > array of event objects with as key the eventid, for each event \<all event placeholders> tickettypeprices > array of tickettypeprice objects with as key the tickettypepriceid, for each tickettypeprice tickettypename pricetypename allocationmethod price tickets > array of ticket objects with as key the ticketid, for each ticket \<all ticket placeholders> ticketsummary count \<aggregate sum value for all numeric ticket placeholders> ticketsummary count \<aggregate sum value for all numeric ticket placeholders> ticketsummary count \<aggregate sum value for all numeric ticket placeholders> payments > array of payment objects, for each payment \<all payment placeholders> ordercosts id name amount buyer \<all contact placeholders> urls pdf orderdetail account id name shortname using the events placeholder the events placeholder contains a hierarchical representation of the order contents this structure allows you to easily display the contents of an order (tickets and/or events) in the level of detail you like in some cases you only want to show a high level summary of the order, in other cases you want to drill down to the individual ticket level there are 3 levels of detail in the object events will contain info aggregated per event tickettypeprices will contain info aggregated per tickettypeprice for a specific event tickets will contain info on the individual tickets for a specific tickettypeprice for an event on each level, you will find a ticketsummary object this object contains the summary data for the specific level you are on let's look at some examples of how to use this if you want to just display one line per event, and the number of tickets per event, you can simply loop over the events object {% for event in events %} {{ event name }} {{ ticketsummary count }} tickets \<br/> {% endfor %} the ticketsummary object contains for all numeric placeholders the sum of the lower levels so to also display to sum of the prices of the tickets per event {% for event in events %} {{ event name }} {{ ticketsummary count }} tickets, total amount € {{ ticketsummary price|number format(2) }}\<br/> {% endfor %} if you want more detail, you could display a line for each tickettypeprice per event if a customer orders 2 standard tickets and 2 reduction tickets, he would see 2 lines then to accomplish this, loop over the events, and use a nested loop over the tickettypeprices {% for event in events %} {% for tickettypeprice in event tickettypeprices %} {{ event name }} {{ tickettypeprice pricetypename }} {{ tickettypeprice ticketsummary count }} tickets, total amount € {{ tickettypeprice ticketsummary price|number format(2) }}\<br/> {% endfor %} {% endfor %} finally, you could display all the details available and show a single line per ticket to accomplish this, add another nested loop over the tickets inside the tickettypeprice loop {% for event in events %} {% for tickettypeprice in event tickettypeprices %} {% for ticket in tickettypeprice tickets %} {{ event name }} {{ tickettypeprice pricetypename }} {{ ticket id }} total amount € {{ ticket price|number format(2) }}\<br/> {% endfor %} {% endfor %} {% endfor %} there is also a ticketsummary object on the highest level, so if you simply want to display the number of tickets or another aggregate value for all tickets in the order, use {{ ticketsummary count }} tickets total amount € {{ ticketsummary price | number format(2) }} using the urls placeholder the urls placeholder contains order specific urls and allows you to link to the actual tickets also you can link to the orderdetail page where the buyer can inspect his order online the placeholder contains following properties property description pdf a link to the pdf for all the tickets in the order orderdetail a link to the orderdetail page to include a link to the pdf in an order mail, you can for example use download your e tickets as pdf note that you should use the raw filter when using the url in an tag to avoid that the url gets escaped http //twig sensiolabs org/doc/filters/raw\ html configuring when to send which order mail the order mail category defines when an order mail will be sent an order mail of category confirmation is sent when an order is confirmed an order mail of category delivery is sent when an order needs to be delivered electronically an order mail of category paymentinstruction is sent when an order will not be paid immediately an order mail of category overdue is sent when the expected payment date of an order is passed an order mail of category expiry is sent when an order is expired there can be multiple order mails of each type the configuration in delivery scenario, payment scenario and sales channel determines whether an actual mail will be sent, and which mail will be sent confirmation for each sales channel you can configure an order mail of type confirmation in the field confirmation mail template this order mail will be sent when an order is confirmed, and can be used as a general 'thank you for your order' mail you can check always send confirmation mail if you always want to send this mail regardless of other order mails that are potentially sent when the order is confirmed if you uncheck this setting, the confirmation mail will only be sent if no other order mail is sent the confirmation mail can be re sent manually from the order page (actions > resend confirmation e mail) if you leave the field confirmation mail template empty, no confirmation mail will be sent delivery for each delivery scenario you can configure an order mail of type delivery in the field mail template this order mail will be used when the order needs to be delivered note that the type field should either be e mail, automatically after payment or e mail, automatically after confirmation for the order mail to be sent paymentinstruction, overdue and expiry for each payment scenario of type deferred payment you can configure order mails for these types in the field payment instruction mail template for type paymentinstruction this template will be used when an order with this delivery scenario is confirmed to send out the payment instructions in the field overdue mail template for type overdue this order mail will be sent when the order becomes overdue (after a configurable number of days) in the field expiry mail template for type expiry this order mail will be sent when the order becomes expired (after a configurable number of days) translation for multilanguage accounts, all text on the order mail can be translated the order mail will be delivered to the buyer in his preferred language in order to translate a text, you should annotate it with a translate attribute for example some multi lingual text all annotated texts are translatable in the translate module click on translate in the top menu to access this module