heimrichhannot/contao-events-bundle

This bundle offers useful functionality concerning the entities "tl_calendar" and "tl_calendar_events" of the Contao CMS.

1.9.4 2024-11-12 14:07 UTC

Requires

• php: ^7.1 || ^8.0
• contao/calendar-bundle: ^4.9
• contao/core-bundle: ^4.9
• heimrichhannot/contao-utils-bundle: ^2.216
• symfony/event-dispatcher-contracts: ^1.0 || ^2.0 || ^3.0

Requires (Dev)

• contao/manager-plugin: ^2.0
• contao/test-case: 1.1.*
• friendsofphp/php-cs-fixer: ^2.2
• php-http/guzzle6-adapter: ^1.1
• php-http/message-factory: ^1.0.2
• phpunit/php-token-stream: ^1.4|^2.0|^3.0
• phpunit/phpunit: >=6.0 <6.5
• phpunit/phpunit-mock-objects: ^4.0|^5.0
• satooshi/php-coveralls: ^2.0
• symfony/phpunit-bridge: ^3.2

LGPL-3.0-or-later

README

This bundle offers useful functionality concerning the entities tl_calendar and tl_calendar_events of the Contao CMS.

Features

• adds support for sub events (e.g. workshops, sessions, ...) for a given calendar event in 2 different flavors:
  • via a new (and auto-generated) entity tl_calendar_sub_events
  • via declaring the parent-child-relation in tl_calendar_events instances
• adds an Item class for the generic reader bundle heimrichhannot/contao-list-bundle and the generic list bundle heimrichhannot/contao-list-bundle
• adds a dateAdded field for tl_calendar_events
• adds the feature operation to tl_calendar_events (and tl_calendar_sub_events if used) as already existing in tl_news
• adds some new fields (see below)
• Calendar event coordinates

Installation

Install via composer: composer require heimrichhannot/contao-events-bundle and update your database.

Configuration

Sub events

You can activate sub events in the global Contao settings. Here you have the following 2 options. Which one you take depends on if the sub events can be a separate entity (tl_calendar_sub_events) or need to be instances of tl_calendar_events.

In both cases, activate the appropriate checkbox in the global contao settings. Afterwards clear the cache and update the database.

Realization as an entity "tl_calendar_sub_events"

The tl_calendar_sub_events dca is created by copying the dca of tl_calendar_events and resetting some callbacks. See tl_calendar_sub_events.php for more details on that.

Realization using a parent-child-relation

A new field parentEVent is added to tl_calendar_events

Coordinates

Can be disabled in settings.

New fields

• dateAdded (auto-generated)
• website
• coordinates
• city
• postal
• street
• locationAdditional
• shortTitle
• featured
• subTitle