Introduction

For every booking action a notification mail will be sent to the author, user groups and the attendee. In DPCalendar it is possible to define what should be sent together with the various mails and which text. There are settings available in the DPCalendar options where you can control all of that in an easy way. For example you can control which attachments should be sent out and the content of the mails. The mails are generated with mail templates, to have them available in every language. These mails can be configured in the Joomla "Mail templates" configuration.

Variables

We are using the mustache templating system to inject and render variables in the language strings. Means you can use a variable like {{bookingUid}} in the string and it will be replaced with the real value. More information can be found in the Output rendering article. For every mail template below are the following variables available:

• events The array of events. You can iterate over them like {{#events}}{{title}}{{/events}}.
• booking The booking object. You can access the fields like {{#booking}}{{price}}{{/booking}}. The {{book_date_formatted}} is a special variable of the booking object which contains the formatted value of the booking date.
• bookingDetails An HTML string which contains the details of a booking.
• bookingLink The link to the booking.
• bookingCancelLink The link to cancel the booking.
• bookingUid The UID of the booking.
• bookingStatusLabel The label of the booking status.
• sitename The site name from the global Joomla configuration.
• user The user name value from the booking.
• tickets An array of tickets. You can iterate over them like {{#tickets}}{{name}}{{/tickets}}.
• countTickets The amount of tickets.
• field-[*] The booking custom fields objects. You can directly access every field with the prefix field- and then the name. For example when the field has the name XYZ, you can use the way {{#field-XYZ}}{{value}}{{/field-XYZ}} to render the value of it.

Confirmation mail

After a booking is created a confirmation mail is sent out to the attendee. The subject and mail body is compiled of the mail template with the id "com_dpcalendar.booking.user.new". While there is a setting in the DPCalendar options to edit the body trough a wisywig editor. But then it is not possible anymore to use a different text for users with different languages. Every user will get the mail in the same language.

Additionally an ics file is sent as attachment which can be imported in any calendar application. For example GMail has a feature to directly import the event into Google calendar. The tickets as PDF files are also sent as attachments when enabled in the DPCalendar options.

Paid status mail

After a booking is payed a confirmation mail is sent out to the attendee. The subject and mail body is compiled of the mail template with the id "com_dpcalendar.booking.user.pay". While there is a setting in the DPCalendar options to edit the body trough a Wisywig editor. But then it is not possible anymore to use a different text for users with different languages. Every user will get the mail in the same language.

Additionally the invoice file as PDF is sent as attachment. It can be used as confirmation for the accountant or to be printed out for further reference.

Notification mails

In the DPCalendar options the site admin can define which user groups should get a notification when a booking is created/changed/deleted. The subject and mail body is compiled of the mail template with the id "com_dpcalendar.booking.new/edit/delete". More information can be found in the article Notifications If enabled in the DPCalendar options, then the author of the event will also get a notification mail.

Invite mail

When an invitation is sent out a mail is generated. The subject and mail body is compiled of the mail template with the id "com_dpcalendar.booking.user.invite". There are various parameters available. The most important ones are the acceptUrl and declineUrl which do contain an url to accept the booking or decline it.

Waiting list mail

When a booking is added to the waiting list a mail is sent out. The subject and mail body is compiled of the mail template with the id "com_dpcalendar.booking.user.wait".