Extending tl_member. Andreas Fieger

Transkript

1 Extending tl_member Andreas Fieger Übersicht Was wollen wir? Wie könnten wir es erreichen? Aufwand/Folgekosten? Was wollen wir? Felder in der Mitgliederverwaltung hinzufügen (z.b. Mitgliedsnummer bei Vereins-Websites oder zusätzlich zur Website noch den Twitteraccount) Felder in der Mitgliederverwaltung entfernen (weil wir sie nicht benötigen und die Backend-Masken übersichtlicher gestalten wollen) Bereits bestehende Felder im Backend verwenden (z.b. bei Filterung oder Sortierung) Wie könnten wir es erreichen? Bestehende Erweiterung finden Eigene Programmierung (Folge-)kosten? Bestehende Erweiterung könnte später nicht mehr verfügbar oder unter neuerer Contao Version nicht mehr lauffähig sein Aufwand, das Modul zu programmieren 1

2 Eigenes Modul programmieren Gibt uns: volle Kontrolle alle Möglichkeiten und wir haben again what learned Beispiel Ein Feld hinzufügen Validierung für das Feld per Muster (RegularExpression) Fahrplan Eigener Modulordner, der alles sauber zusammen hält Konfiguration in config/ (für Module etc.) DCA (DataContainerArray) in dca/ Sprachdateien in languages/{en,de,.../ PHP-Klassen in classes/ mit Implementierung von Hooks (z.b. Reguläre Ausdrücke zur Input-Validierung) Callbacks DCA dca/tl_member.php Definition neues Feld $GLOBALS['TL_DCA']['tl_member']['fields']['twitter'] = array( 'label' => &$GLOBALS['TL_LANG']['tl_member']['twitter'], 'exclude' => true, 'search' => true, 'filter' => false, 'sorting' => false, 'inputtype' => 'text', 'eval' => array( 'mandatory'=>false,'maxlength'=>64,'tl_class'=>'w50' ), 'sql' => "varchar(64) NOT NULL default ''", 2

3 DCA dca/tl_member.php Hinzufügen zur Palette = str_replace ( 'website', 'website,twitter', Und woher weiß ich das? (nur in der Testumgebung) printf('<pre>%s</pre>', print_r(, true) // oder printf('<pre>%s</pre>', print_r($globals['tl_dca']['tl_member'], true) oder read the source Luke! (system/modules/core/dca/tl_member.php) DCA dca/tl_member.php Entfernen aus Palette // Palette veraendern um nicht gewünschte Felder zu auszublenden // Das Feld an sich beibehalten -- es wird nur nicht angezeigt! = str_replace(',company', 3

4 '', Sprachdateien // languages/{en,de,.../tl_member.php $GLOBALS['TL_LANG']['tl_member']['twitter'] = array( 'Twitter', 'Twitter Name des Users (inkl. dem führenden "@")' Hooks (I) 'eval' => array(..., 'rgxp'=>'twitteraccount',...)... // config/config.php $GLOBALS['TL_HOOKS']['addCustomRegexp'][] = array('myhooks', 'addcustomregexp'... // config/autoload.{ini,php anlegen (lassen) Hooks (II) // classes/myhooks.php public function addcustomregexp($strregexp, $varvalue, Widget $objwidget) { switch ($strregexp) { 4

5 case 'twitteraccount': if $varvalue)) { $objwidget->adderror('field '. $objwidget->label. ' should be a twitter account.') return true; break; default: return false; Hooks (III) // classes/myhooks.php public function addcustomregexp($strregexp, $varvalue, Widget $objwidget) { switch ($strregexp) { case 'twitteraccount': if (!preg_match("/^@[-_a-z0-9]+$/", $varvalue)) { $objwidget->adderror( sprintf( $GLOBALS['TL_LANG']['ERR']['twitter'], $objwidget->label ) return true; break; default: return false; // languages/{en,de,.../default.php $GLOBALS['TL_LANG']['ERR']['twitter'] = 'Field "%s" should be a twitter account.'; Ich seh nichts Datenbank aktuelisieren lassen Cache leeren 5

6 Was noch? Verwendung in ModulePersonalData (eval mit fegroup, feeditable, feviewable) Doku online und im Code! Weitere Beispiele // Liste der möglichen Filter verkürzen foreach (array('city', 'country','language','login') as $field) { $GLOBALS['TL_DCA']['tl_member']['fields'][$field]['filter'] = false; // Nach Änderungszeit sortierbar machen $GLOBALS['TL_DCA']['tl_member']['fields']['tstamp']['sorting'] = true; $GLOBALS['TL_DCA']['tl_member']['fields']['tstamp']['eval']['rgxp'] = 'datim'; $GLOBALS['TL_DCA']['tl_member']['fields']['tstamp']['flag'] = 6; // 6 = Absteigende Sortier $GLOBALS['TL_DCA']['tl_member']['fields']['tstamp']['label'] = 'Geändert am'; Verallgemeinerung Analoges für Module und andere Datenstrukturen im Template mit $this->showtemplatevars( anzeigen lassen nach Bedarf einsetzen ggf. Modul erweitern, damit das neue Feld auch verwendet wird Fragen Links (Developer Documentation) _Erweiterungen_entwickeln_für_Contao_leicht_gemacht.pdf 6

7 Danke 7