Vorhandene Module erweitern: Unterschied zwischen den Versionen
Aus Contao Community Documentation
K (→Erweiterung der vorhandenen Sprachdateien) |
K |
||
| (8 dazwischenliegende Versionen von einem Benutzer werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
| − | |||
[[Category:Dev_HOWTOS]]{{AppliesTo | [[Category:Dev_HOWTOS]]{{AppliesTo | ||
| − | |Version=2.9 RC1 | + | |Version=2.9 RC1 / 3.0 |
}} | }} | ||
=Vorwort= | =Vorwort= | ||
| Zeile 13: | Zeile 12: | ||
=Kurzanleitung für Contao 3= | =Kurzanleitung für Contao 3= | ||
# ''TL_ROOT/system/modules/calendarFreeEntry'' - neues Modulverzeichnis mit nötiger Verzeichnis- und Dateistruktur erstellen | # ''TL_ROOT/system/modules/calendarFreeEntry'' - neues Modulverzeichnis mit nötiger Verzeichnis- und Dateistruktur erstellen | ||
| + | # ''TL_ROOT/system/modules/calendarFreeEntry/config/autoload.php'' - Autoloader Datei erstellen | ||
# ''TL_ROOT/system/modules/calendarFreeEntry/dca/tl_calendar_events.php'' – Data Container Array erweitern inkl. Datenbankfeld ''freeEntry'' | # ''TL_ROOT/system/modules/calendarFreeEntry/dca/tl_calendar_events.php'' – Data Container Array erweitern inkl. Datenbankfeld ''freeEntry'' | ||
# ''TL_ROOT/system/modules/calendarFreeEntry/languages'' – Sprachdateien um neues Feld ''freeEntry'' erweitern | # ''TL_ROOT/system/modules/calendarFreeEntry/languages'' – Sprachdateien um neues Feld ''freeEntry'' erweitern | ||
| Zeile 19: | Zeile 19: | ||
=Detailanleitung für Contao 3= | =Detailanleitung für Contao 3= | ||
| − | |||
==Erstellen des neuen Modulverzeichnis mit nötiger Verzeichnis- und Dateistruktur== | ==Erstellen des neuen Modulverzeichnis mit nötiger Verzeichnis- und Dateistruktur== | ||
| Zeile 25: | Zeile 24: | ||
<source lang="text"> | <source lang="text"> | ||
| − | TL_ROOT/system/modules/calendarFreeEntry | + | TL_ROOT/system/modules/calendarFreeEntry/config/ |
| + | TL_ROOT/system/modules/calendarFreeEntry/config/autoload.php | ||
TL_ROOT/system/modules/calendarFreeEntry/dca | TL_ROOT/system/modules/calendarFreeEntry/dca | ||
TL_ROOT/system/modules/calendarFreeEntry/dca/tl_calendar_events.php | TL_ROOT/system/modules/calendarFreeEntry/dca/tl_calendar_events.php | ||
| Zeile 36: | Zeile 36: | ||
TL_ROOT/system/modules/calendarFreeEntry/templates/event_list_freeEntry.html5 | TL_ROOT/system/modules/calendarFreeEntry/templates/event_list_freeEntry.html5 | ||
TL_ROOT/system/modules/calendarFreeEntry/templates/event_list_freeEntry.xhtml | TL_ROOT/system/modules/calendarFreeEntry/templates/event_list_freeEntry.xhtml | ||
| + | </source> | ||
| + | |||
| + | ==Anlegen der autoload.php== | ||
| + | Dazu die Datei TL_ROOT/system/modules/calendarFreeEntry/config/autoload.php öffnen und folgenden Inhalt einfügen: | ||
| + | |||
| + | <source lang="php"> | ||
| + | <?php | ||
| + | |||
| + | /** | ||
| + | * Register the templates | ||
| + | */ | ||
| + | TemplateLoader::addFiles(array | ||
| + | ( | ||
| + | 'event_list_freeEntry' => 'system/modules/calendarFreeEntry/templates', | ||
| + | )); | ||
| + | |||
</source> | </source> | ||
| Zeile 82: | Zeile 98: | ||
==Erweiterung des vorhandenen Templates== | ==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. (jeweils die html5 und xhtml Version) 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 auf die Inhalte der Sprachdateien zugegriffen werden kann, muss die Sprachdatei zuerst 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.html5'' und ''TL_ROOT/system/modules/calendar/templates/event_list.xhtml'' in ''TL_ROOT/system /modules/calendarFreeEntry/templates'' kopieren, in ''event_list_freeEntry.html5'' bzw. ''event_list_freeEntry.xhtml'' umbenennen und entsprechend erweitern: | ||
| + | |||
| + | event_list_freeEntry.html5 | ||
| + | <source lang="php"> | ||
| + | |||
| + | <?php $this->loadLanguageFile('tl_calendar_events'); ?> | ||
| + | <?php if ($this->header): ?> | ||
| + | <div class="header<?php echo $this->classHeader; ?>"> | ||
| + | <time datetime="<?php echo $this->datetime; ?>" class="date"><?php echo $this->firstDate; ?></time><?php if ($this->firstDay): ?> <span class="day">(<?php echo $this->firstDay; ?>)</span><?php endif; ?> | ||
| + | </div> | ||
| + | |||
| + | <?php endif; ?> | ||
| + | <div class="event layout_list<?php echo $this->classList; ?>"> | ||
| + | <h2><a href="<?php echo $this->href; ?>" title="<?php echo $this->title; ?> (<?php if ($this->day): echo $this->day; ?>, <?php endif; echo $this->date; if ($this->time): ?>, <?php echo $this->time; endif; ?>)"<?php echo $this->target; ?>><?php echo $this->link; ?></a></h2> | ||
| + | <?php if ($this->time || $this->span): ?> | ||
| + | <p class="time"><?php echo $this->time . $this->span; ?></p> | ||
| + | <?php endif; ?> | ||
| + | <?php if ($this->freeEntry): ?> | ||
| + | <p class="freeEntry"><?php echo $GLOBALS['TL_LANG']['tl_calendar_events']['freeEntry'][0]; ?></p> | ||
| + | <?php endif; ?> | ||
| + | <div class="ce_text"> | ||
| + | <?php echo $this->details; ?> | ||
| + | </div> | ||
| + | </div> | ||
| + | |||
| + | </source> | ||
| + | |||
| + | event_list_freeEntry.xhtml | ||
| + | <source lang="php"> | ||
| + | |||
| + | <?php $this->loadLanguageFile('tl_calendar_events'); ?> | ||
| + | <?php if ($this->header): ?> | ||
| + | <div class="header<?php echo $this->classHeader; ?>"> | ||
| + | <span class="date"><?php echo $this->firstDate; ?></span><?php if ($this->firstDay): ?> <span class="day">(<?php echo $this->firstDay; ?>)</span><?php endif; ?> | ||
| + | </div> | ||
| + | |||
| + | <?php endif; ?> | ||
| + | <div class="event layout_list<?php echo $this->classList; ?>"> | ||
| + | <h2><a href="<?php echo $this->href; ?>" title="<?php echo $this->title; ?> (<?php if ($this->day): echo $this->day; ?>, <?php endif; echo $this->date; if ($this->time): ?>, <?php echo $this->time; endif; ?>)"<?php echo $this->target; ?>><?php echo $this->link; ?></a></h2> | ||
| + | <?php if ($this->time || $this->span): ?> | ||
| + | <p class="time"><?php echo $this->time . $this->span; ?></p> | ||
| + | <?php endif; ?> | ||
| + | <?php if ($this->freeEntry): ?> | ||
| + | <p class="freeEntry"><?php echo $GLOBALS['TL_LANG']['tl_calendar_events']['freeEntry'][0]; ?></p> | ||
| + | <?php endif; ?> | ||
| + | <div class="ce_text"> | ||
| + | <?php echo $this->details; ?> | ||
| + | </div> | ||
| + | </div> | ||
| + | |||
| + | </source> | ||
| + | |||
| + | Dies waren die letzten Dateien, die erstellt / bearbeitet werden mussten. 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. | ||
| + | |||
| + | [[Datei:moduleext_ftp.png|FTP]] | ||
| + | |||
| + | ==Datenbank-Update, Systemwartung, Veranstaltung eintragen, Test== | ||
| + | Über ''<nowiki>http://www.meinedomain.de/contao/install.php</nowiki>'' ein Datenbank-Update durchführen (vorgeschlagene Änderungen per Haken aktivieren => Update Database). | ||
| + | |||
| + | [[Datei:moduleext_updatedb.png|Datenbank-Update durchführen]] | ||
| + | |||
| + | 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. | ||
| + | |||
| + | [[Datei:moduleext_template.png|Erstelltes Template auswählen]] | ||
| + | |||
| + | Nun noch wegen der manuellen Installation des Moduls den internen Contao Cache löschen, dazu unter System-Systemwartung alle "Seitencache leeren" und "Internen Cache leeren" markieren und auf "Daten bereinigen" klicken. | ||
| + | |||
| + | 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. | ||
| + | |||
| + | [[Datei:moduleext_editevent.png|Event bearbeiten]] | ||
| + | |||
| + | 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. | ||
| + | |||
| + | [[Datei:moduleext_fe.png|Frontend Ausgabe]] | ||
=Kurzanleitung für Contao 2= | =Kurzanleitung für Contao 2= | ||
Aktuelle Version vom 8. Dezember 2012, 18:41 Uhr
| betrifft | |
|---|---|
| Contao Version | 2.9 RC1 / 3.0 |
Inhaltsverzeichnis
- 1 Vorwort
- 2 Anforderung
- 3 Kurzanleitung für Contao 3
- 4 Detailanleitung für Contao 3
- 4.1 Erstellen des neuen Modulverzeichnis mit nötiger Verzeichnis- und Dateistruktur
- 4.2 Anlegen der autoload.php
- 4.3 Erweiterung des vorhandenen Data Container Arrays (DCA)
- 4.4 Erweiterung der vorhandenen Sprachdateien
- 4.5 Erweiterung des vorhandenen Templates
- 4.6 Datenbank-Update, Systemwartung, Veranstaltung eintragen, Test
- 5 Kurzanleitung für Contao 2
- 6 Detailanleitung für Contao 2
- 6.1 Erstellen des neuen Modulverzeichnis mit nötiger Verzeichnis- und Dateistruktur
- 6.2 Erweiterung der vorhandenen Datenbanktabelle tl_calendar_events
- 6.3 Erweiterung des vorhandenen Data Container Arrays (DCA)
- 6.4 Erweiterung der vorhandenen Sprachdateien
- 6.5 Erweiterung des vorhandenen Templates
- 6.6 Datenbank-Update, Veranstaltung eintragen, Test
- 7 Credits
- 8 Verwandte Themen
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 für Contao 3
- TL_ROOT/system/modules/calendarFreeEntry - neues Modulverzeichnis mit nötiger Verzeichnis- und Dateistruktur erstellen
- TL_ROOT/system/modules/calendarFreeEntry/config/autoload.php - Autoloader Datei erstellen
- TL_ROOT/system/modules/calendarFreeEntry/dca/tl_calendar_events.php – Data Container Array erweitern inkl. Datenbankfeld freeEntry
- TL_ROOT/system/modules/calendarFreeEntry/languages – Sprachdateien um neues Feld freeEntry erweitern
- TL_ROOT/system/modules/calendarFreeEntry/templates – Erweiterung der Templates um Laden der Sprachdatei, Prüfung des Feldes freeEntry und abhängiger Ausgabe
- http://www.meinedomain.de/contao/install.php - Datenbank-Update durchführen, Template in der Eventliste ändern, Termin einstellen, testen
Detailanleitung für Contao 3
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/config/ TL_ROOT/system/modules/calendarFreeEntry/config/autoload.php 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.html5 TL_ROOT/system/modules/calendarFreeEntry/templates/event_list_freeEntry.xhtml
Anlegen der autoload.php
Dazu die Datei TL_ROOT/system/modules/calendarFreeEntry/config/autoload.php öffnen und folgenden Inhalt einfügen:
<?php /** * Register the templates */ TemplateLoader::addFiles(array ( 'event_list_freeEntry' => 'system/modules/calendarFreeEntry/templates', ));
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 //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', 'sql' => "char(1) NOT NULL default ''" );
Anschliessend speichern und schliessen.
Erweiterung der vorhandenen Sprachdateien
TL_ROOT/system/modules/calendarFreeEntry/languages/de/tl_calendar_events.php
<?php $GLOBALS['TL_LANG']['tl_calendar_events']['freeEntry'][0] = 'Free entry'; $GLOBALS['TL_LANG']['tl_calendar_events']['freeEntry'][1] = 'Zeigen Sie den Termin mit kostenlosen Eintritt an.';
TL_ROOT/system/modules/calendarFreeEntry/languages/en/tl_calendar_events.php
<?php $GLOBALS['TL_LANG']['tl_calendar_events']['freeEntry'][0] = 'Free entry'; $GLOBALS['TL_LANG']['tl_calendar_events']['freeEntry'][1] = '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. (jeweils die html5 und xhtml Version) 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 auf die Inhalte der Sprachdateien zugegriffen werden kann, muss die Sprachdatei zuerst 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.html5 und TL_ROOT/system/modules/calendar/templates/event_list.xhtml in TL_ROOT/system /modules/calendarFreeEntry/templates kopieren, in event_list_freeEntry.html5 bzw. event_list_freeEntry.xhtml umbenennen und entsprechend erweitern:
event_list_freeEntry.html5
<?php $this->loadLanguageFile('tl_calendar_events'); ?> <?php if ($this->header): ?> <div class="header<?php echo $this->classHeader; ?>"> <time datetime="<?php echo $this->datetime; ?>" class="date"><?php echo $this->firstDate; ?></time><?php if ($this->firstDay): ?> <span class="day">(<?php echo $this->firstDay; ?>)</span><?php endif; ?> </div> <?php endif; ?> <div class="event layout_list<?php echo $this->classList; ?>"> <h2><a href="<?php echo $this->href; ?>" title="<?php echo $this->title; ?> (<?php if ($this->day): echo $this->day; ?>, <?php endif; echo $this->date; if ($this->time): ?>, <?php echo $this->time; endif; ?>)"<?php echo $this->target; ?>><?php echo $this->link; ?></a></h2> <?php if ($this->time || $this->span): ?> <p class="time"><?php echo $this->time . $this->span; ?></p> <?php endif; ?> <?php if ($this->freeEntry): ?> <p class="freeEntry"><?php echo $GLOBALS['TL_LANG']['tl_calendar_events']['freeEntry'][0]; ?></p> <?php endif; ?> <div class="ce_text"> <?php echo $this->details; ?> </div> </div>
event_list_freeEntry.xhtml
<?php $this->loadLanguageFile('tl_calendar_events'); ?> <?php if ($this->header): ?> <div class="header<?php echo $this->classHeader; ?>"> <span class="date"><?php echo $this->firstDate; ?></span><?php if ($this->firstDay): ?> <span class="day">(<?php echo $this->firstDay; ?>)</span><?php endif; ?> </div> <?php endif; ?> <div class="event layout_list<?php echo $this->classList; ?>"> <h2><a href="<?php echo $this->href; ?>" title="<?php echo $this->title; ?> (<?php if ($this->day): echo $this->day; ?>, <?php endif; echo $this->date; if ($this->time): ?>, <?php echo $this->time; endif; ?>)"<?php echo $this->target; ?>><?php echo $this->link; ?></a></h2> <?php if ($this->time || $this->span): ?> <p class="time"><?php echo $this->time . $this->span; ?></p> <?php endif; ?> <?php if ($this->freeEntry): ?> <p class="freeEntry"><?php echo $GLOBALS['TL_LANG']['tl_calendar_events']['freeEntry'][0]; ?></p> <?php endif; ?> <div class="ce_text"> <?php echo $this->details; ?> </div> </div>
Dies waren die letzten Dateien, die erstellt / bearbeitet werden mussten. 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, Systemwartung, Veranstaltung eintragen, Test
Über http://www.meinedomain.de/contao/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.
Nun noch wegen der manuellen Installation des Moduls den internen Contao Cache löschen, dazu unter System-Systemwartung alle "Seitencache leeren" und "Internen Cache leeren" markieren und auf "Daten bereinigen" klicken.
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.
Kurzanleitung für Contao 2
- TL_ROOT/system/modules/calendarFreeEntry - neues Modulverzeichnis mit nötiger Verzeichnis- und Dateistruktur erstellen
- TL_ROOT/system/modules/calendarFreeEntry/config/database.sql – Datenbanktabelle um neues Feld freeEntry erweitern
- TL_ROOT/system/modules/calendarFreeEntry/dca/tl_calendar_events.php – Data Container Array erweitern
- TL_ROOT/system/modules/calendarFreeEntry/languages – Sprachdateien um neues Feld freeEntry erweitern
- TL_ROOT/system/modules/calendarFreeEntry/templates – Erweiterung Template um Laden der Sprachdatei, Prüfung des Feldes freeEntry und abhängiger Ausgabe
- http://www.meinedomain.de/contao/install.php - Datenbank-Update durchführen, Template in der Eventliste ändern, Termin einstellen, testen
Detailanleitung für Contao 2
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 auf die Inhalte der Sprachdateien zugegriffen werden kann, muss die Sprachdatei zuerst 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
