Introduction

The content plugin for DPCalendar allows to integrate a list of events into any content such as an article description. Additionally it displays events in the contact details page.

Render events in content

To show events in any content, the content author can use the mustache syntax of DPCalendar as described in the Output rendering article. The following example will print the next three events from the calendar with an ID of 42. It will render a list of paragraphs, each one with the title and date of the event.

 {{#events calid=42 limit=3}}<p>{{date}} {{title}}</p>{{/events}}

Parameters

The following parameters can be used within the {{#events}} block:

• calid
  The calendar ID the events should be filtered. If you want all, including the external ones, put root. If you want an external one like your Google calendar, put g-3, where 3 is the ID of the external Google calendar in the Google plugin.
• eventid
  The single event ID which should be shown
• limit
  How many events should be shown
• my
  Should only my events be shown where I'm the author or attendee of, value has to be 0 or 1
• order
  The order field.
• orderdir
  In which order direction they should be shown, as or desc.
• tagid
  A comma separated list of tag ID's to filter for.
• featured
  If only filtered events should be included in the list.
• startdate
  The start date, can be relative like "-1 week" or an absolute ISO 8601 date like 2016-09-23.
• enddate
  The end date, can be relative like "-1 week" or an absolute ISO 8601 date like 2016-09-23.
• locationid
  A comma separated string with ids of locations.

For more information about the mustache syntax can be found in the Output rendering chapter.

Render events in contact details page

The plugin hooks into the contact details page and renders events where the linked user of the contact is the author of or the host. The events are rendered in a separate layout in the file /plugins/content/dpcalendar/tmpl/contact/events.php. If you want to change that, then you need to copy it to /templates/{your template}/html/plg_content_dpcalendar/contact/events.php and change it to your needs. Keep in mind that most styling can be done with CSS as we use the BEM Class naming strategy for easy element access.

When no contact events should be shown, then this behaviour can be disabled by an option in the plugin.

Render bookings in contact details page

When the logged in user is a DPCalendar booking admin, check the ACL chapter for more details, then there is an option in the plugin to show the bookings in the contact details page. The bookings are rendered in a separate layout in the file /plugins/content/dpcalendar/tmpl/bookings/list.php. If you want to change that, then you need to copy it to /templates/{your template}/html/plg_content_dpcalendar/bookings/list.php and change it to your needs. Keep in mind that most styling can be done with CSS as we use the BEM Class naming strategy for easy element access.

Options

Options