Skip to content

Latest commit

 

History

History
72 lines (52 loc) · 3.94 KB

README.md

File metadata and controls

72 lines (52 loc) · 3.94 KB
Raw

OpenEuropa Content Event companion module

This module is a theming companion module to the OpenEuropa Content Event module. It provides the logic needed to theme the Event content type.

Installation

Make sure you have read the OpenEuropa Content Event module's README.md before enabling this module.

After enabling this module make sure you assign the following permissions to the anonymous user role, so visitors can correctly access all event information.

  • Venue: View any published entity
  • Organisation: View any published entity
  • Contact: View any published entity
  • Programme Item: View any published entity
  • View published SKOS Concept entities

Required contrib modules

This module requires the following contrib modules:

Shipped configuration

The modules ships configurations for several date formats that are made for presenting event dates in different context.

List of shipped date formats:

  • Event date, e.g. 27 January 2020
  • Event date with hour, e.g. 27 January 2020, 11:10
  • Event date with hour and timezone, e.g. 27 January 2020, 11:10 CET
  • Event long date with hour, e.g. Monday 27 January 2020, 11:10
  • Event programme date, e.g. 27 Jan 2020
  • Event programme date with hour, e.g. 27 Jan 2020, 09:00 AM
  • Event programme hour, e.g. 09:00 AM

Overridden configuration

Installing this module will override the default event content type view mode, shipped by the OpenEuropa Content Event module. This is necessary in order to guarantee that fields and formatter settings are displayed correctly.

If you want to customize how the event looks like create the full view mode and take over.

Extra fields

This module ships with a set of extra field plugin definitions which are used to display complex rendering business logic. For example, the event registration button has several states depending on the current time. All this logic is encapsulated in this extra field.

You can reuse these extra fields in your own view modes.

List of Extra field definitions:

  • Contacts provides Contact entities as renderable arrays divided by their bundles.
  • Description conditionally renders the Description or Report title, with their respective content. This section is accompanied by the featured media and its legend.
  • Details provides event details including Topic, Location, Dates, and Livestreaming availability information.
  • Organiser provides organiser information, whether a simple organiser name or a label to a department OP (SKOS vocabulary).
  • RegistrationButton provides the registration button and related text, changing depending on the event date.
  • Summary provides the event short summary or the report short summary, depending on whether the event date is in the past or in the future.
  • Programme provides timeline about event programme, such as title, a description and start/end dates.