Version vom 3. Oktober 2010, 19:27 Uhr

Vorwort

Dieses Tutorial soll neben anderen vorhandenen Tutorials beim Einstieg in die Modulprogrammierung helfen. Hier wird kein eigenständiges Modul erstellt, sondern auf ein vorhandenes Core-Modul und der Demo-Installation Music Academy aufgebaut.

Anforderung

Die Music Academy hat in diesem Jahr so viele talentierte Schüler, dass sie mit Hilfe deren musikalischer Unterstützung verschiedene Abendveranstaltungen durchführen möchte. Manche der Veranstaltungen werden mit kostenlosem Eintritt angeboten, andere Veranstaltungen sollen kostenpflichtig sein. Um den besonders kostenbewussten Musikliebhabern in der Veranstaltungsliste auf einem Blick aufzuzeigen, welche Veranstaltungen kostenfrei sind, soll diese Information in Zukunft bei jeder einzelnen Veranstaltung direkt angezeigt werden.

Zur Umsetzung der Anforderung wird das Formular zur Eingabe von Terminen um eine zusätzliche Checkbox erweitert. Diese Checkbox ist bei Veranstaltungen mit kostenlosem Eintritt zu aktivieren. Falls die Prüfung im Template ergibt, dass der Wert der Checkbox gesetzt ist, wird eine entsprechende Information im Frontend ausgegeben.

Kurzanleitung

1. TL_ROOT/system/modules/calendarFreeEntry - neues Modulverzeichnis mit nötiger Verzeichnis- und Dateistruktur erstellen
2. TL_ROOT/system/modules/calendarFreeEntry/config/database.sql – Datenbanktabelle um neues Feld freeEntry erweitern
3. TL_ROOT/system/modules/calendarFreeEntry/dca/tl_calendar_events.php – Data Container Array erweitern
4. TL_ROOT/system/modules/calendarFreeEntry/languages – Sprachdateien um neues Feld freeEntry erweitern
5. TL_ROOT/system/modules/calendarFreeEntry/templates – Erweiterung Template um Laden der Sprachdatei, Prüfung des Feldes freeEntry und abhängiger Ausgabe
6. http://www.meinedomain.de/contao/install.php - Datenbank-Update durchführen, Template in der Eventliste ändern, Termin einstellen, testen

Detailanleitung

Erstellen des neuen Modulverzeichnis mit nötiger Verzeichnis- und Dateistruktur

In dieser Anleitung wird die Extension-Erweiterung lokal erstellt und anschließend auf den Webserver hoch geladen.

TL_ROOT/system/modules/calendarFreeEntry
TL_ROOT/system/modules/calendarFreeEntry/config
TL_ROOT/system/modules/calendarFreeEntry/config/database.sql
TL_ROOT/system/modules/calendarFreeEntry/dca
TL_ROOT/system/modules/calendarFreeEntry/dca/tl_calendar_events.php
TL_ROOT/system/modules/calendarFreeEntry/languages
TL_ROOT/system/modules/calendarFreeEntry/languages/de
TL_ROOT/system/modules/calendarFreeEntry/languages/de/tl_calendar_events.php
TL_ROOT/system/modules/calendarFreeEntry/languages/en
TL_ROOT/system/modules/calendarFreeEntry/languages/en/tl_calendar_events.php
TL_ROOT/system/modules/calendarFreeEntry/templates/
TL_ROOT/system/modules/calendarFreeEntry/templates/event_list_freeEntry.tpl

Erweiterung der vorhandenen Datenbanktabelle tl_calendar_events

Dazu die Datei TL_ROOT/system/modules/calendarFreeEntry/config/database.sql öffnen und folgenden Inhalt einfügen:

--
--		Table `tl_calendar_events`
--
 
CREATE TABLE `tl_calendar_events` (
	`freeEntry` CHAR(1) NOT NULL DEFAULT '',
) ENGINE=MyISAM DEFAULT CHARSET=utf8;

Anschliessend speichern und schliessen.

Erweiterung des vorhandenen Data Container Arrays (DCA)

Dazu die Datei TL_ROOT/system/modules/calendarFreeEntry/dca/tl_calendar_events.php öffnen und folgenden Inhalt einfügen:

<?php if (!defined('TL_ROOT')) die('You can not access this file directly!');
 
//Anzeige im Backend
$GLOBALS['TL_DCA']['tl_calendar_events']['palettes']['default'] = str_replace('title,','title,freeEntry,', $GLOBALS['TL_DCA']['tl_calendar_events']['palettes']['default']);
 
//Beschreibung des Feldes
$GLOBALS['TL_DCA']['tl_calendar_events']['fields']['freeEntry'] = array
(
'label'                   => &$GLOBALS['TL_LANG']['tl_calendar_events']['freeEntry'],
'inputType'               => 'checkbox'
);
 
?>

Anschliessend speichern und schliessen.

Erweiterung der vorhandenen Sprachdateien

TL_ROOT/system/modules/calendarFreeEntry/languages/de/tl_calendar_events.php

<?php if (!defined('TL_ROOT')) die('You can not access this file directly!');
 
$GLOBALS['TL_LANG']['tl_calendar_events']['freeEntry']        = array('Free entry', 'Zeigen Sie den Termin mit kostenlosen Eintritt an.'); 
 
?>

TL_ROOT/system/modules/calendarFreeEntry/languages/en/tl_calendar_events.php

<?php if (!defined('TL_ROOT')) die('You can not access this file directly!');
 
$GLOBALS['TL_LANG']['tl_calendar_events']['freeEntry']        = array('Free Entry', 'Display the event with free entry.');
 
?>

Erweiterung des vorhandenen Templates

Damit im Template die gewünschte Information ausgegeben werden kann, wird das vorhandene Template der Kerninstallation kopiert, in das neue Modulverzeichnis eingefügt und die PHP-Logik entsprechend ergänzt. Dazu wird eine Prüfung eingebaut, die prüft, ob der Wert der Checkbox gesetzt wurde. Bei gesetztem Wert soll im Template sprachabhängig die Information ausgegeben, dass es sich um eine kostenlose Veranstaltung handelt. Damit die Inhalte der Sprachdateien zugegriffen werden kann, muss die Sprachdatei zu erst noch geladen werden. Contao wurde so konzipiert, dass ausschließlich nur die benötigten Ressourcen geladen werden, um das System auch in der Laufzeit möglichst performant zu halten.

Vorhandene Datei aus TL_ROOT/system/modules/calendar/templates/event_list.tpl in TL_ROOT/system /modules/calendarFreeEntry/templates kopieren, in event_list_freeEntry.tpl umbenennen und entsprechend erweitern:

//Load language file
<?php $this->loadLanguageFile('tl_calendar_events'); ?>
.
.
.
//Check field freeEntry
<?php if ($this->freeEntry): ?>
<p class="freeEntry"><?php echo $GLOBALS['TL_LANG']['tl_calendar_events']['freeEntry'][0]; ?></p>  
<?php endif; ?>

Dies war die letzte Datei, die erstellt / bearbeitet werden musste. Nun muss das ganze Paket in die Contao-Installation hoch geladen werden. Beim Hochladen ist darauf zu achten, dass der Ordner an die richtige Stelle kopiert wird.

Datenbank-Update, Veranstaltung eintragen, Test

Über http://www.meinedomain.de/typolight/install.php ein Datenbank-Update durchführen (vorgeschlagene Änderungen per Haken aktivieren => Update Database).

Anschließend im Backend unter Themes das MusicAcademy-Theme bearbeiten und bei den Frontend-Modulen das Modul Calendar - Event List (Eventliste) suchen und dieses ebenfalls bearbeiten. Unter dem Punkt Template-Einstellungen wählt man nun das neu erstellte Template event_list_freeEntry aus.

Wenn man nun ein neues Event erstellt oder ein vorhandenes bearbeitet, hat man unter dem Title-Feld eine neue Auswahl Free entry zur Verfügung.

Wird diese Einstellung aktiviert, so wird im Frontend in der Eventliste (.../contao_music/index.php/event-list.html?month=201001) zu den normalen Informationen zusätzlich der Eintrag Free Entry angezeigt.

Credits

Die Orginal-Anleitung wurde erstellt von manela
Div. Korrekturen und Anpassungen an die Contao-Version durch Toflar, BugBuster und manitougs