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 out of language strings, to have them available in every language. These language strings can be overridden in the language manager of Joomla on Extensions -> Language -> Overrides. Keep in mind that you have to use the administrator language location part and then enable for both locations. You will find more information about language overrides in Multilanguage.

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 language string 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.
• 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 is compiled of the language string COM_DPCALENDAR_NOTIFICATION_EVENT_BOOK_USER_SUBJECT and the body from COM_DPCALENDAR_NOTIFICATION_EVENT_BOOK_USER_BODY. 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 is compiled of the language string COM_DPCALENDAR_NOTIFICATION_EVENT_BOOK_USER_PAYED_SUBJECT and the body from COM_DPCALENDAR_NOTIFICATION_EVENT_BOOK_USER_PAYED_BODY. 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 is compiled of the language string COM_DPCALENDAR_NOTIFICATION_EVENT_BOOK_SUBJECT and the body from COM_DPCALENDAR_NOTIFICATION_EVENT_BOOK_BODY. 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 is compiled of the language string COM_DPCALENDAR_NOTIFICATION_EVENT_BOOK_USER_INVITE_SUBJECT and the body from COM_DPCALENDAR_NOTIFICATION_EVENT_BOOK_USER_INVITE_BODY. 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 is compiled of the language string COM_DPCALENDAR_NOTIFICATION_EVENT_BOOK_USER_WAITING_SUBJECT and the body from COM_DPCALENDAR_NOTIFICATION_EVENT_BOOK_USER_WAITING_BODY.