DownloadPHP 7.4PHP 8Joomla 3.10Joomla 4.4Joomla 5
The Event menu item shows a single event details page. On the top are share buttons rendered to help promoting your site on different social media networks. Beside them are action buttons displayed which do allow to export the event to Google calendar or as .ics file. If the visitor wants to send the event page, there is an E-Mail button available which opens a new window to send the link to a friend. For those who like to print out the details page, we have a optimized print view, which can be opened directly through the print button.
If you are logged in as admin then you will see some more action buttons which do allow you to manage the event.
Every event has an author which acts as organizer. If a contact exists for the user, then DPCalendar does link automatically to the contact. Beside the author there is a hosts field. This field is a list of users which can be seen as hosts of the event. A host can be the speaker, responsible person, teacher or support staff.
If bookings are activated for the event and the visitor has the permission to book the event, then a link will be shown to guide the visitor to the booking form. The booking part of the event detail age does show all the relevant booking information like the different prices, discounts and the capacity.
The show booking form parameter renders a booking form within the event details view when activated. So you skip an additional step.
For every location where the event is happening a map is shown and the location details like the address and description. It is also possible to show all the locations in a single map to have a compact event details view. In both views you can navigate to the location view which shows the full information panel including a resource view for the location.
How to setup the map providers and more is documented in the maps Introduction article.
The schedule of the event is shown as a timeline. Like that the event author has the option to provide additional context for the event, where attendees get a better insight what is happening during the event.
The different blocks like the image, information panel, location part or buttons are built stacked when inspecting the HTML markup. With CSS grid we are positioning them the way we want. This means for the site admin, that it is easy possible to rearrange them with just CSS to perfectly fit your template, no template overrides are needed. You can then also define trough media queries your layout to have it optimized for every screen size. For example when you want to move the map below the description, use the following CSS code in your template's custom.css file (or what way your template offers to add your own CSS):
.com-dpcalendar-event__locations {
grid-column: 1 / 4;
grid-row: 10/11;
}
In Joomla is the page heading defined in the menu item. Events are normally created under the url of a list or calendar menu item. So the page heading setting is inherited. Means the list and the event details page will have the same page heading (normally rendered with the h1 tag). This is a SEO issue as you loose the h1 title in the event details page. The show page heading setting in the event view overrides this setting. Like that you can have a page heading in the list or calendar menu item and at the same time the title is rendered in the event details page with h1 as well.
If the author, host or booking admin is logged in and visits the event details page, it is possible to send a mail to the event attendees. When clicking on the "Send mail to ticket holders" link then a new page opens which shows an form to input a subject and mail text. Additionally it is also possible to select the individual ticket holders where the mail is sent to. It is also possible to send a test mail to the currently logged in user first.
The form is filled with a default text which is created from the language strings. As subject is "COM_DPCALENDAR_FIELD_MAILTICKETS_SUBJECT_DEFAULT" used and as mail text "COM_DPCALENDAR_FIELD_MAILTICKETS_MESSAGE_DEFAULT". If these ones should be different, a language override can be created in the Joomla language manager. To reference the events in the mail use the variables from the Output rendering article. The data is stored in the session, so when the publisher comes back to the form the last entered text is displayed in the form.
The settings can be configured globally in the DPCalendar options or per menu item. If the value is empty in the menu item, then it will be inherited from the global options.
Comments (0)