Menu

#617 Menu item event

Parent Category:
DPCalendar
Category:
Menu items
Last Updated:
Allon Moritz, Tuesday, 07 November 2023 13:27
Created:
Wednesday, 22 February 2012 10:15
Hits:
11296

DownloadPHP 7.4PHP 8Joomla 3.10Joomla 4.4Joomla 5

Introduction

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.

Event detail page

Admin actions

If you are logged in as admin then you will see some more action buttons which do allow you to manage the event.

  • Delete Series
    Delete the whole series of events this event belongs to.
  • Delete
    Delete the event.
  • Edit Event
    Opens the edit form page.
  • Bookings
    Opens the bookings list which shows all the bookings they have a ticket for this event.
  • Tickets
    Opens the tickets list which shows all tickets of this event.
  • Invite
    Invite other users or whole groups for the event.
  • Send mail to ticket holders
    Send a custom mail to ticket holders. More information can be found in the respective chapter below.
Event detail page actions

Author and hosts

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.

Booking part

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.

Event detail page booking part

Location map

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.

Event detail page maps

Schedule

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.

Event detail page maps

Layout

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;
}
Event details page layout

Headings

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.

Mail to ticket holders

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.

Event detail page send mail to ticket holders

Options

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.

Date Format [Type: Text] [Default: d.m.Y]
The format of the date for an event (check http://www.php.net/date for details).
Time Format [Type: Text] [Default: H:i]
The format of the time for an event (check http://www.php.net/date for details).
Automatic Redirect [Type: Radio] [Default: No]
When the event has a url, should the visitor be redirected to it when opening the event details page?
The following options are available:
  1. No
  2. Yes
Show Calendar [Type: List] [Default: Yes]
Should the calendar of the event be shown?
The following options are available:
  1. No
  2. Yes
  3. Link to date
Show Date [Type: Radio] [Default: Yes]
Should the date of the event be shown?
The following options are available:
  1. No
  2. Yes
Show Location [Type: List] [Default: Yes and expand]
Should the location of the event be shown?
The following options are available:
  1. No
  2. Yes
  3. Yes and expand
Show Url [Type: Radio] [Default: Yes]
Should the url of the event be shown?
The following options are available:
  1. No
  2. Yes
Show Author [Type: Radio] [Default: Yes]
Should the author of the event be shown?
The following options are available:
  1. No
  2. Yes
Show Hosts [Type: Radio] [Default: Yes]
Should the hosts of the event be shown?
The following options are available:
  1. No
  2. Yes
Show Booking Form [Type: List] [Default: No]
Should the booking form be shown inline?
The following options are available:
  1. No
  2. Yes
  3. Yes and expand
Show Booking Panel [Type: Radio] [Default: Yes]
Should the booking panel of the event be shown?
The following options are available:
  1. No
  2. Yes
Show Price [Type: Radio] [Default: Yes]
Should the price of the event be shown?
The following options are available:
  1. No
  2. Yes
Show Capacity [Type: Radio] [Default: Yes]
Should the capacity of the event be shown?
The following options are available:
  1. No
  2. Yes
Show Capacity Used [Type: Radio] [Default: Yes]
Should the used capacity of the event be shown?
The following options are available:
  1. No
  2. Yes
Show Series Information [Type: Radio] [Default: Yes]
Should the series information of the event be shown?
The following options are available:
  1. No
  2. Yes
Show Tickets [Type: List] [Default: No]
Should the tickets of the event be shown?
The following options are available:
  1. No
  2. Yes
  3. Limited
Show Print Button [Type: Radio] [Default: Yes]
Should the print button be shown.
The following options are available:
  1. No
  2. Yes
Show Mail Button [Type: Radio] [Default: Yes]
Should the mail button be shown.
The following options are available:
  1. No
  2. Yes
Show Copy Links [Type: Radio] [Default: Yes]
Should the copy links of the event be shown?
The following options are available:
  1. No
  2. Yes
Show Map [Type: Radio] [Default: Yes]
Should the map of the event be shown?
The following options are available:
  1. No
  2. Yes
Map Zoom [Type: Text] [Default: 4]
The initial zoom level of the map.
Map Latitude [Type: Text] [Default: 47]
The initial latitude of the map.
Map Longitude [Type: Text] [Default: 4]
The initial longitude of the map.
Content Before [Type: Textarea]
This text will be displayed before the component output (can contain HTML and supports content plugins).
Content After [Type: Textarea]
This text will be displayed after the component output (can contain HTML and supports content plugins).
Count Clicks [Type: Radio] [Default: Yes]
If set to yes, the number of times the event has been clicked will be recorded.
The following options are available:
  1. No
  2. Yes
Page Heading [Type: List] [Default: No]
Should the page heading be used or not. Overwrites the menu item setting if defined.
The following options are available:
  1. Inherit
  2. No
  3. Yes
Prefix Meta Description [Type: List] [Default: Yes]
Should the meta description get the event title and date as prefix.
The following options are available:
  1. No
  2. Yes
  3. Only when empty
Custom CSS [Type: Textarea]
Custom CSS code which will be added to the HTML document.

Comments (0)

We use cookies on our website. Some of them are essential for the operation of the site, while others help us to improve this site and the user experience (tracking cookies). You can decide for yourself whether you want to allow cookies or not. Please note that if you reject them, you may not be able to use all the functionalities of the site.