Die Datei „ext_conf_template.txt“ enthält ein Template, das die Konfigurationsmöglichkeiten des Benutzers der Extension bei der Installation definiert. Die Syntax entspricht der des Constant Editors für TypoScript. Aber Achtung: Anders als im Constant Editor kann hier als Kategorie nur „basic“ ausgewählt werden. Die Unterkategorien entsprechen denen des Constant Editors. Eine Angabe der Sortierung wird ignoriert, kann also weggelassen werden. Der Extension Manager erzeugt aus diesen Angaben eine Maske mit den Konfigurationsoptionen, die beim Installieren der Extension ausgewählt werden können und in die Datei „localconf.php“ als serialisiertes Array geschrieben werden. Betrachten wir als Beispiel die Extension „Page Template Selector“ von Robert Lemke (rlmp_tmplselector).

Konfigurationsmöglichkeit im Page Template Selector basierend auf Einträgen in ext_conf_template.txt

Der Benutzer kann bei der Installation (und bei Bedarf auch noch später) auswählen, ob die verschiedenen Templates auf Dateien oder TypoScript basieren sollen. Sie können solcherlei Konfigurationsmöglichkeiten recht einfach zur Verfügung stellen (Listing 4).

# cat=basic//; type=string; label=Template Selector Mode: You may use the Template Selector either with external HTML files or with pure TypoScript. Values: file, ts
templateMode = file

Neben der Zuordnung zu einer Kategorie können Sie den Typ des Felds (type=string) und beschreibenden Text (label=...) definieren. Die hervorgehobene Überschrift wird durch den Doppelpunkt von der tatsächlichen Beschreibung getrennt. Den Namen für die Option können Sie frei vergeben – sinnvoll ist ein Name in englischer Sprache. Als Standardwert ist im Beispiel „file“ vorgegeben, wodurch für die Auswahl der Templates Dateien aus einem in TypoScript zu definierenden Verzeichnis verwendet werden. TYPO3 speichert die Daten serialisiert in „$TYPO3_CONF_VARS“ (Listing 5).

$TYPO3_CONF_VARS['EXT']['extConf']['rlmp_tmplselector'] = 'a:1:{s:12:"templateMode";s:4:"file";}';

Ein sehr umfangreiches Einsatzbeispiel finden Sie in der Extension „“tt_news“ von Rupert Germann. Aufgrund der vielen Konfigurationsmöglichkeiten sind dabei die einzelnen Werte gruppiert dargestellt. Dies können Sie durch eine entsprechende Auswahl vorgefertigter Unterkategorien für Ihre Parameter erreichen – beispielsweise „cat=basic/enable/120“. Diese Unterkategorien für die Strukturierung der Datei „ext_conf_template.txt“ sind hart gecoded in der „t3lib/class.t3lib_tsparser_ext.php“ hinterlegt (Listing 6).