Der TYPO3 Konstanteneditor is ein wertvolles Tool, mit dem man seine TYPO3 Extensions verständlicher und einfacher zu konfigurieren gestalten kann.

Konstanten, die in Extensions definiert werden, erscheinen jedoch nicht automatisch im Konstanteneditor. Man nutzt eine spezielle Syntax in den Kommentaren, um die Konstanten im Konstanteneditor erscheinen zu lassen.

Ich finde diese Tatsache relativ schlecht dokumentiert. Ich habe mir daher verschiedene Extensions angesehen und auch den Sourcecode erforscht.

Stellt man in einer eigenen Extensions bei der Definition der einen Kommentar der folgenden Form vor die Definition einer Konstante, dann erscheint dieser später im Konstanteneditor:

lot3blog {
  # cat=plugin.tx_lot3blog/file/010; type=string; label= Blog homepage: the URL to your blog homepage
  baseURL = www.beispiel.com
}

Dieser Kommentar besteht aus drei Teilen: Dem Konstantentyp (type), der Konstantenkategorie(cat) und dem Beschreibungstext(label).

Die Markierung eines Konstanten mit dieser Syntax funktioniert (nach meinen Versuchen) nur aus Extensions heraus und leider nicht aus den TYPO3 Konstanten der Seite.

TYPO3 Konstanten Typen

Der Konstanten Typ, der bei der Definition der Konstante angegeben wurde, entscheidet über die Eingabehilfen, die im Konstanteneditor zur Verfügung gestellt werden. Wird kein Konstantentyp angegeben, so wird der Standart, string, verwendet.

Folgende Konstantentypen gibt es (ermittelt aus dem Quellcode der class.t3lib_tsparser_ext.php ):

string, int, int+, color, wrap, offset, options, boolean, comment, file, user, small 

Beispiele:

# cat=basic/xxx/010; type=string; label= string: mein String
t1 = Ich bin ein String

# cat=basic/xxx/011; type=int; label= int: (Ganzzahl, auch negativ)
t2 = -99

# cat=basic/xxx/012; type=int+; label= int+: (Ganzzahl, nur positiv)
t3 = 88

# cat=basic/xxx/013; type=offset; label= offset: (x und y werte)
t4 = 88, 55

# cat=basic/xxx/010; type=color; label= color: eine Farbe
t5 = ff0000

# cat=basic/xxx/011; type=wrap; label= wrap: ein Wrap
t51 = <b>|</b>

# cat=basic/xxx/011; type=options[de, en, fr, zh]; label= options[de, en, fr, zh] Optionen
t7 = de

# cat=basic/xxx/010; type=boolean; label= enable: Option anschalten
t8 = 1

# cat=basic/xxx/010; type=file[png, jpg, gif]; label= file[png, jpg, gif] eine Datei
t9 = fileadmin/clear.gif

# cat=basic/xxx/010; type=small; label= small
t10 = xyz 

Den Output dieses Codes könnt Ihr rechts im Bild sehen.

TYPO3 Konstanten Kategorien

Die Konstanten Kategorie Sektion besteht aus bis zu 3 Teilen: Der Hauptkategorie, der Unterkategorie und einer Sortierung.

Die Hauptkategie entscheided darüber, auf welcher Seite des Konstanteneditors die Konstante stehen soll. Es gibt folgende Standartkategorien:

• 'basic': Die wichtigsten Konstanten für das Template Layout. Konstanten, die auf jeden Fall definiert werden sollten, kommen hier hin
• 'menu': Konstanten zur Menükonfiguration
• 'content' Konstanten, die Contentelemenet Definieren
• 'page': generelle Seitendefinitionen: Metatags, Linktargets, etc
• 'advanced': Selten genutze, erweiterte Funktionen
• 'all': Alle Funktionen

Des weiteres kann man Kategorien für seine eigenen Plugins definieren oder die Kategorien vorhandener Extensions nutzen. Dazu verwendet man einen Kategorienamen der folgenden Form: plugin.tx_lot3blog.

Unterkategorien

Es gibt eine Reihe von vordefinierten Unterkategorien. Ich konnte leider nicht herausfinden, ob es Möglich ist, weitere Unterkategorien zu definierten. Die Unterkategorien werden im TYPO3 Konstanten Editor als Zwischenüberschriften dargestellt und gruppieren die Konstanten.

Folgende Unterkategorien gibt es:

• 'enable': Zum An-Abschalten von Funktionen
• 'dims': Dimensionen, Breiten, Längen, ...
• 'file': Dateien
• 'typo': Typographie, Schriftsatz
• 'color': Farben
• 'links': Links und Targets
• 'language': Sprachspezifische Konstanten

Zu den verschiedenen Content-Elementen gibt es spezifische Unterkategorien:

cheader, cheader_g, ctext, cimage, cbullets, ctable, cuploads, cmultimedia, cmailform, csearch, clogin, csplash, cmenu, cshortcut, clist, cscript, chtml 

Genauere Informationen gibt es in den entsprechenden Sourcedateien:

t3lib/class.t3lib_tsparser_ext.php 

Hilfreiche Links zu Konstantendefinition in TYPO3

• TYPO3 Wiki: TypoScript Constants 
• TYPO3-german: auswahl im constant editor
• Wo ist die hochgeladene File aus dem Constant Editor?