Achtung: Bei der Migration von Version 3.x nach 4.x gab es mehrere Änderungen in der Benennung der Modul-Typen und Template-Namen. Dies bitte bei einer allfälligen Migration berücksichtigen.
Mit dieser Erweiterung für Contao CMS werden Events über ein Anmeldeformular buchbar. Das Anmeldeformular kann im Contao Formulargenerator erstellt werden. Die Erweiterung stellt während des Installationsprozesses ein Sample Anmeldeformular bereit, welches Grundansprüchen genügen sollte. Die Werte des Formulars werden in der Datenbank in tl_calendar_events_member abgelegt und sind im Backend einsehbar und über eine CSV-Datei exportierbar.
Event-Organisator und Teilnehmer können bei Event-Anmeldung und Event-Abmeldung über das Notification Center benachrichtigt werden.
Mit einem Frontend Modul lässt sich auf einer Event-Reader Seite ein Event-Anmeldeformular einblenden. Verlinken Sie in den Moduleinstellungen mit dem entsprechenden Formular aus dem Contao Formulargenerator. Wichtig! Das Anmeldeformular zieht den Eventnamen aus der Url. Der Event-Alias oder die Event-Id müssen deshalb zwingend als Parameter in der Url enthalten sein. Das Anmeldeformular sollte deshalb idealerweise immer in Kombination mit dem Event-Reader-Modul eingebunden werden.
Mit einem weiteren Frontend Modul können zu einem Event bereits angemeldete Personen aufgelistet werden. Wichtig! Das Auflistungsmodul zieht den Eventnamen aus der Url. Der Event-Alias oder die Event-Id müssen deshalb zwingend als Parameter in der Url enthalten sein. Das Mitgliederauflistungs-Modul sollte deshalb idealerweise immer in Kombination mit dem Event-Reader-Modul eingebunden werden.
Die Erweiterung stellt auch eine Möglichkeit sich von einem Event wieder abzumelden. Via Notification Center kann dem Teilnehmer ein Abmeldelink (##event_unsubscribeHref##) zugeschickt werden. Erstellen Sie das entsprechende Modul und binden Sie es auf einer neuen Seite in der Seitenstruktur ein. Diese Seite sollten Sie sinnvollerweise in der Navigation nicht anzeigen lassen. In der Kalendereinstellung legen Sie anschliessend fest, auf welcher Seite das Event-Abmeldeformular liegt.
- Kalender und Events anlegen.
- "Eventliste" und "Eventleser" Frontend-Module anlegen.
- Falls nicht schon geschehen, E-Mail-Gateway (Notification Center) anlegen.
- Benachrichtigung des Typs "Event-Buchungsbestätigung" anlegen (Notification Center)
- Im Contao Formulargenerator die benötigten Felder bereitstellen.
- Im Formular (Formulargenerator) die Weiterleitungsseite einrichten.
- Das Frontend Modul "Event-Buchungsformular" erstellen und in den Modul-Einstellungen das bei Punkt 5 erstellte Formular auswählen. Danach noch die bei Punkt 4 erstellte Benachrichtigung auswählen.
- Die 3 erstellten Module (Eventliste, Eventleser und Event-Buchungsformular) in der Contao Seitenstruktur einbinden (Wichtig! Event-Buchungsformular und Eventleser gehören auf die gleiche Seite).
- Optional das Frontend Modul "Event-Abmeldeformular" mit dazugehörender Benachrichtigung "Event-Abmeldung" erstellen und dieses in einer extra dafür erstellten Seite einbinden.
- Optional das Frontend Modul "Event-Mitglieder-Auflistung" erstellen und auf der Seite mit dem Eventleser Modul einbinden.
- Bei den Events die Buchungs-, Benachrichtigungs- und Abmeldeoptionen konfigurieren.
- In der Kalendereinstellung die Seite mit dem "Event-Abmeldeformular" festlegen.
Versenden Sie beim Absenden des Formulars eine oder mehrere Nachrichten an den Teilnehmer oder eine Kopie an den Eventorganisator und nutzen Sie dabei die Simple Tokens.
Mit ##event_unsubscribeHref## kann ein tokengesicherter Event-Abmeldelink mitgesandt werden. Dazu muss aber im Event die Event-Abmeldung erlaubt werden.
Auch sollte das dafür nötige Frontend Modul "Event-Abmeldeformular" erstellt und in einer Seite eingebunden worden sein.
Teilnehmer: ##member_gender## (Männlich, Weiblich oder Divers), ##member_salutation## (Übersetzt: Herr oder Frau), ##member_email##, ##member_firstname##, ##member_street##, etc. (Feldnamen aus tl_calendar_events_member)
Event: ##event_title##, ##event_street##, ##event_postal##, ##event_city##, ##event_unsubscribeLimitTstamp##, etc. (Feldnamen aus tl_calendar_events)
Organisator/Email-Absender: ##organizer_name##, ##organizer_email, etc. (Feldnamen aus tl_user)
Beim ersten Aufruf der Seite nach der Installation der Erweiterung wird automatisch ein Beispielformular mit allen benötigten Feldern generiert.
Wichtig!!! Im Formular muss die Checkbox "Aktiviere Event-Buchungsformular-Funktion" aktiviert sein. Weitere Einstellungen müssen keine zwingend gemacht werden.
Folgende Felder können im Formular erstellt werden:
firstname,lastname,gender,dateOfBirth,street,postal,city,phone,email,escorts,notes
Werden weitere Felder gewünscht, so müssen diese im Projekt-ROOT unter contao/dca/tl_calendar_events_member.php definiert werden.
Danach Cache neu aufbauen und via Installtool die Felder in der Datenbank anlegen.
<?php
// Put this in TL_ROOT/contao/dca/tl_calendar_events_member.php
use Contao\CoreBundle\DataContainer\PaletteManipulator;
// Add additional field to tl_calendar_events_member
$GLOBALS['TL_DCA']['tl_calendar_events_member']['fields']['foodHabilities'] = [
'exclude' => true,
'search' => true,
'sorting' => true,
'inputType' => 'select',
'options' => ['vegetarian', 'vegan'],
'eval' => ['includeBlankOption' => true, 'tl_class' => 'w50'],
'sql' => "varchar(255) NOT NULL default ''",
];
// Add a new legend and custom field to the default.
Contao\CoreBundle\DataContainer\PaletteManipulator::create()
->addLegend('food_legend', 'personal_legend', PaletteManipulator::POSITION_AFTER)
->addField(['foodHabilities'], 'food_legend', PaletteManipulator::POSITION_APPEND)
->applyToPalette('default', 'tl_calendar_events_member');Aktivieren Sie beim Event die Buchungsbestätigung mit dem Notification Center, wählen Sie eine Benachrichtigung aus und legen Sie einen Absender mit einer gültigen E-Mail-Adresse (tl_user) fest.
Folgende zusätzliche Template Variablen sind in allen Kalender-Templates einsetzbar:
| Tag | type | Erklärung |
|---|---|---|
$this->canRegister |
bool | Zeigt, ob eine Registrierung möglich ist. |
$this->isFullyBooked |
bool | Zeigt, ob der Event ausgebucht ist. |
$this->bookingCount |
int | Zeigt, die Anzahl Registrierungen an. |
$this->bookingMin |
int | Zeigt, die minimal verlangte Teilnehmerzahl an. |
$this->bookingMax |
int | Zeigt, die maximale Teilnehmerzahl an. |
$this->bookingStartTimestamp |
int | Zeigt, die Buchungsstartzeit (timestamp) an. |
$this->bookingStartDate |
int | Zeigt, die Buchungsstartzeit (date) an. |
$this->bookingStartDatim |
int | Zeigt, die Buchungsstartzeit (datim) an. |
$this->bookingEndTimestamp |
int | Zeigt, die Buchungsendzeit (timestamp) an. |
$this->bookingEndDate |
int | Zeigt, die Buchungsendzeit (date) an. |
$this->bookingEndDatim |
int | Zeigt, die Buchungsendzeit (datim) an. |
$this->hasLoggedInUser |
bool | Zeigt an, ob ein Mitglied angemeldet ist. |
$this->loggedInUser |
null | FrontendUser |
Array
(
[admin_email] => [email protected]
[member_id] => 26
[member_pid] => Testevent 2
[member_tstamp] => 08.09.2021 21:26
[member_addedOn] => 08.09.2021 21:26
[member_notes] => Tomorrow never dies!
[member_firstname] => James
[member_lastname] => Bond
[member_gender] => Männlich
[member_dateOfBirth] => 12. März 1976
[member_street] => Casino Royale
[member_postal] => 66666
[member_city] => London
[member_phone] => 23123
[member_email] => [email protected]
[member_escorts] => 0
[member_bookingToken] => d47636dd-7606-4f0b-ad8d-82461abde483
[member_notificationSent] => nein
[member_subscriptionAccepted] => nein
[member_notificationSentDatim] =>
[member_salutation] => Herr
[event_id] => 3
[event_pid] => Events
[event_tstamp] => 08.09.2021 14:04
[event_title] => Testevent 2
[event_alias] => testevent-2
[event_author] => Eve Moneypenny
[event_addTime] => nein
[event_startTime] => 00:00
[event_endTime] => 23:59
[event_startDate] => 16. September 2021
[event_endDate] => 8. September 2021
[event_location] =>
[event_teaser] =>
[event_addImage] => nein
[event_overwriteMeta] => nein
[event_singleSRC] =>
[event_alt] =>
[event_imageTitle] =>
[event_size] =>
[event_imagemargin] =>
[event_imageUrl] =>
[event_fullsize] => nein
[event_caption] =>
[event_floating] => oberhalb
[event_recurring] => nein
[event_repeatEach] =>
[event_repeatEnd] => 0
[event_recurrences] => 0
[event_addEnclosure] => nein
[event_enclosure] =>
[event_source] => Standard
[event_jumpTo] => 0
[event_articleId] => 0
[event_url] =>
[event_target] => nein
[event_cssClass] => upcoming
[event_noComments] => nein
[event_published] => ja
[event_start] =>
[event_stop] =>
[event_address] =>
[event_description] =>
[event_pageTitle] =>
[event_unsubscribeLimit] => 0
[event_enableDeregistration] => ja
[event_eventBookingNotificationSender] => Eve Moneypenny
[event_eventBookingNotificationCenterIds] => Event Buchungs Benachrichtigung
[event_enableNotificationCenter] => ja
[event_maxEscortsPerMember] => 0
[event_maxMembers] => 11
[event_bookingStartDate] => 7. Juni 2021
[event_bookingEndDate] => 15. September 2021
[event_addBookingForm] => ja
[event_city] =>
[event_postal] =>
[event_street] =>
[event_enableMultiBookingWithSameAddress] => ja
[event_unsubscribeLimitTstamp] => 12.08.2021 16:40
[event_featured] => nein
[event_robots] =>
[event_minMembers] => 0
[event_includeEscortsWhenCalculatingRegCount] => nein
[organizer_id] => 1
[organizer_tstamp] => 09.06.2021 16:08
[organizer_username] => eve.moneypenny
[organizer_name] => Eve Moneypenny
[organizer_email] => [email protected]
[organizer_language] => de
[organizer_backendTheme] => flexible
[organizer_fullscreen] => nein
[organizer_uploader] =>
[organizer_showHelp] => ja
[organizer_thumbnails] => ja
[organizer_useRTE] => ja
[organizer_useCE] => ja
[organizer_pwChange] => nein
[organizer_admin] => ja
[organizer_groups] =>
[organizer_inherit] => Nur Gruppenrechte verwenden
[organizer_modules] =>
[organizer_themes] =>
[organizer_pagemounts] =>
[organizer_alpty] =>
[organizer_filemounts] =>
[organizer_fop] =>
[organizer_imageSizes] =>
[organizer_forms] =>
[organizer_formp] =>
[organizer_amg] =>
[organizer_disable] => nein
[organizer_start] =>
[organizer_stop] =>
[organizer_dateAdded] => 09.06.2021 16:08
[organizer_lastLogin] => 08.09.2021 13:47
[organizer_currentLogin] => 08.09.2021 21:13
[organizer_locked] => 01.01.1970 01:00
[organizer_faqs] =>
[organizer_faqp] =>
[organizer_news] =>
[organizer_newp] =>
[organizer_newsfeeds] =>
[organizer_newsfeedp] =>
[organizer_newsletters] =>
[organizer_newsletterp] =>
[organizer_calendars] =>
[organizer_calendarp] =>
[organizer_calendarfeeds] =>
[organizer_calendarfeedp] =>
[organizer_useTwoFactor] =>
[organizer_secret] =>
[organizer_trustedTokenVersion] => 0
[organizer_backupCodes] =>
[organizer_loginAttempts] => 0
[organizer_fields] =>
[organizer_elements] =>
[organizer_activation] =>
[organizer_rsts_permissions] =>
[organizer_rsts_sliders] =>
[organizer_senderName] => Eve Moneypenny
[organizer_senderEmail] => [email protected]
[event_unsubscribeHref] => https://mi6.com/events-stornierungsformular.html?bookingToken=d47636dd-7606-4f0b-ad8d-82461abde483
)
Vor allem das Modul "Buchungsformular" lässt sich sehr gut erweitern. An verschiedenen Stellen im Code lassen sich via Hooks Funktionalitäten wie Lego-Bausteine hinzufügen oder durch Deaktivierung eines Hooks unerwünschte Funktionalitäten entfernen. Um sich einen Überblick über die verschiedenen Hooks zu verschaffen, genügt ein Blick in den Buchungs-Controller.
<?php
// src/EventListener/DoSomething.php
declare(strict_types=1);
namespace App\EventListener;
use Contao\CoreBundle\ServiceAnnotation\Hook;
use Markocupic\CalendarEventBookingBundle\Controller\FrontendModule\CalendarEventBookingEventBookingModuleController;
/**
* @Hook(DoSomething::HOOK, priority=DoSomething::PRIORITY)
*/
final class DoSomething
{
public const HOOK = 'calEvtBookingPostBooking';
public const PRIORITY = 1200;
/**
* @var EventRegistration
*/
private $eventRegistration;
public function __invoke(CalendarEventBookingEventBookingModuleController $moduleInstance, array $arrDisabledHooks = []): void
{
if (\in_array(self::class, $arrDisabledHooks, true)) {
return;
}
$objEvent = $moduleInstance->getProperty('objEvent');
$objEventMember = $moduleInstance->getProperty('objEventMember');
$objForm = $moduleInstance->getProperty('objForm');
// Do something
}
}Mit etwas Javascript Code, den man im Buchungs-Template einbindet, lässt sich durch Deaktivierung des Absende-Buttons beim ersten Absenden des Formulars, eine mehrfache Anmeldung durch Doppelklick o.Ä unterbinden.
<script>
/**
* vendor/markocupic/calendar-event-booking-bundle/src/Resources/contao/templates/modules/mod_calendar_event_booking_event_booking_module.html5
* Prevent sending forms multiple times
*/
document.addEventListener("DOMContentLoaded", function(event) {
let elForms = document.querySelectorAll('.mod_calendar_event_booking_event_booking_module form');
if(elForms.length){
elForms.forEach((elForm, index, nodeList) => {
elForm.addEventListener('submit', (event) => {
let elBtn = elForm.querySelector('.submit[type="submit"]');
if(elBtn)
{
elBtn.disabled = true;
}
});
});
}
});
</script>