[Disclaimer: Ja, TYPOlight heißt schon einige Zeit Contao – die Installation, die ich hier vor mir habe, heißt aber noch TYPOlight. Aktuell ist 3.3.3, Beta ist 4.0, ich habe 2.8.1. Eine Übersicht über alle Versionen gibt es hier.]
Es gibt eine Doku zum Hinzufügen von Feldern. Mein Problem damit: Die Anleitung bezieht sich auf die Mitgliederverwaltung. Die Mitgliederverwaltung hat aber eine eigene Tabelle (tl_member) in der Datenbank, sowie eine eigene Palette. Interessanter ist es, eine neues Feld bsplw. dem Content Element “Image” hinzuzufügen, den alle Content Elemente teilen sich die Tabelle tl_content, sowie eine gemeinsame Palette. Wie bekommt man ein Feld, das nur für Images angezeigt wird?
Analog zum oben verlinkten Beispiel: Über ein Modul, und zwar mit folgender Dateistruktur:
- tl_content_custom/
- config/
- config.php
- database.php
- dca/
- tl_content.php
- languages/
- de/
- tl_content.php
- en/
- tl_content.php
- de/
- templates/
- ce_image_custom.tpl
- ContentImageCustom.php
- config/
Im ersten Schritt hängt man sich in das CMS:
In config/config.php registriert man eine eigene Klasse für den Typ “Image”:
|
1 |
$GLOBALS['TL_CTE']['images']['image'] = 'ContentImageCustom'; |
In config/database.sql definiert man die zusätzlich benötigten Felder der Tabelle tl_content – und man darf sich nicht daran stören, dass das in einem CREATE TABLE passiert:
|
1 2 3 4 |
CREATE TABLE `tl_content` ( `is_retina` char(1) NOT NULL default '', PRIMARY KEY (`id`) ) ENGINE=MyISAM DEFAULT CHARSET=utf8; |
Die Felder werden dann über http://mydomain.tld/typolight/install.php unter dem Punkt “Tabellen aktualisieren” aktualisiert; dort wird das CREATE in ein ALTER geändert.
In dca/tl_content.php deklariert man, wann das neue Feld angezeigt wird (“dca” steht für “Data Container Array“), also dass es nur für Images verwendet werden soll. Dazu ergänzt man “die Palette” und “die Felder”. Die Palette ist quasi ein Sub-Set aller für Content-Elemente verfügbaren Felder. Wenn wir also das Content Element “Image” nur um vorhandene Felder erweitern wollten, dann bräuchten wir die Felder nicht ergänzen. Das ist hier nicht der Fall (wir haben oben ein neues Feld in die Datenbank eingefügt), deshalb konfigurieren wir das neue Feld is_retina und hängen es (ja: per str_replace ^^) an die kommaseparierte Liste von erlaubten Feldern für den Typ “Image”. Dabei kann man sich an /system/modules/backend/dca/tl_content.php orientieren, dort sind die Original-Deklarationen der Felder und Paletten zu finden.
|
1 2 3 4 5 6 7 8 9 10 11 |
// Anpassung der Palette für is_retina $GLOBALS['TL_DCA']['tl_content']['palettes']['image'] = str_replace('caption', 'caption,is_retina', $GLOBALS['TL_DCA']['tl_content']['palettes']['image']); // Hinzufügen der Feld-Konfiguration für is_retina $GLOBALS['TL_DCA']['tl_content']['fields']['is_retina'] = array ( 'label' => &$GLOBALS['TL_LANG']['tl_content']['is_retina'], 'exclude' => true, 'inputType' => 'checkbox', 'eval' => array('mandatory'=>false, 'tl_class'=>'w50 m12') ); |
In languages/de/tl_content.php und analog in languages/en/tl_content.php kommen alle benötigten (=in der Feldkonfiguration referenzierten) Texte, das ist hier nur einer:
|
1 |
$GLOBALS['TL_LANG']['tl_content']['is_retina'] = array('ist ein Retinabild', 'Bitte legen Sie fest, ob es sich um ein Retinabild handelt.'); |
Im zweiten Schritt erstellt man dann endlich die eigene Logik. In config/config.php haben wir die Klasse ContentImageCustom referenziert (s.o.). Die wird jetzt direkt im Modulordner angelegt; von dort wird sie automatisch geladen. Der Einfachheit halber erweitern wir ContentImage, und der einzig nötige Code ist die Referenzierung unseres eigenen Templates, in dem wir dann auf das neue Feld reagieren:
|
1 2 3 4 |
class ContentImageCustom extends ContentImage { protected $strTemplate = 'ce_image_custom'; } |
Das genannte Template ist templates/ce_image_custom.tpl, und darin sieht’s dann so aus:
|
1 |
<?php echo $this->is_retina ? 'retina' : 'not retina'; ?> |
(Das ist natürlich nur ein Snippet; insgesamt habe ich den Code von /system/modules/frontend/templates/ce_image.tpl geklaut, und mit obigem Snippet erweitert.)
HTH