Bearbeiten von „TypoScript Einstellungen in Extensions auslagern“

Stichworte:

=== TypoScript für Constants und Setup ===

==== Die alte Methode ====
im Hauptordner der Extension:

 ext_typoscript_constants.txt
 ext_typoscript_setup.txt

Der Inhalt dieser Dateien wird automatisch eingebunden. Dies ist eigentlich die "alte Art" TypoScript einzubinden. Sie hat aber den Vorteil das man nur hierüber Einstellungen von anderen Plugins die ebenfalls so arbeiten überschreiben kann.

 ext_emconf.php

In dieser Datei kann man festlegen daß sie erst am Schluss nachdem alle anderen Extensions geladen wurden ausgeführt wird. Somit hat man die Möglichkeit die Einstellungen die in den anderen Extensions gemacht wurden wieder zu überschreiben. Damit das klappt setzt man die Eigenschaft:

 ...
 'priority' => 'bottom',
 ...

==== Die neue Methode ====
In neueren Extensions funktioniert das Einbinden von Statischem TypoScript etwas anders:
Es gibt es im Extension Verzeichnis einen Ordner mit dem Namen 

 static

In diesem Ordner werden die Dateien 
 constants.txt
 setup.txt
manchmal auch
 editorcfg.txt
Abgelegt.

Wenn die TypoScripte auf diese Weise in der Extension vorliegen, stehen Sie im Haupttemplate der Website im Feld static Templates zur Verfügung und können bzw. müssen dort ausgewählt werden.

Zur Verfügung stehen Sie aber nur dann, wenn sie auch in der Datei ext_tables.php eingebunden werden. Das funktioniert mit folgender Funktion (Beispiel aus der Extension css_styled_content):

 t3lib_extMgm::addStaticFile($_EXTKEY,'static/','CSS Styled Content');

Praktischerweise erledigt dies schon der Extensionmanager automatisch.

=== TSConfig ===

Hierbei gibt es keine Dateien deren Inhalt automatisch übernommen wird. Deshalb müssen wir selbst dafür sorgen:
Wir erstellen zwei Dateien
 
 tsconfig_page.txt
 tsconfig_user.txt

in der Datei

 ext_localconf.php

nutzen wir die Funktionen addPageTSConfig und addUserTSConfig um den benötigten Code hinzuzufügen

<pre>
<?php
if (!defined ('TYPO3_MODE'))     die ('Access denied.');

// add default page TSconfig
t3lib_extMgm::addPageTSConfig('<INCLUDE_TYPOSCRIPT: source="FILE:EXT:meineExtension/tsconfig_page.txt">');
// add default user TSconfig
t3lib_extMgm::addUserTSConfig('<INCLUDE_TYPOSCRIPT: source="FILE:EXT:meineExtension/tsconfig_user.txt">');

//you need to allow explicitly the available content elements for users
$TYPO3_CONF_VARS['BE']['explicitADmode'] = 'explicitAllow';
?>
</pre>


== Komfortable Eingabe für den Benutzer im Constants Editor ==
Konstanten für Constant-Editor bereitstellen

Zusammenfassung aus: http://www.easy-office4you.de/constant-editor.html Datum des Zugriffs: 9.8.2008

Beispiele:
<pre>
#cat=meinText/typo/a; type=string; label=Mein Text
meinText.meineTextEingabe = Hallo Welt!

#cat=meinText/enable/b; type=boolean; label=Mein Text2
meinText.Text2 = 1

#cat=Kategorie/Subkategorie/Buchstabe; type=Feldtyp; label=Label
Kategorie.Label = Wert
</pre>

Konstanten
Die Kategorie ist frei wählbar. Sinnvoll ist es natürlich, hier einen Wert einzugeben, der sich auf das entsprechende Plugin bezieht, also z.B.

cat=plugin.meinPlugin

Hinter die Kategorie kann ein / folgen und danach eine Subkategorie, z.B.

 enable, dims, file, typo, color, links oder language

Danach folgt ein / und ein Buchstabe, der die darzustellende Reihenfolge im Constant-Editor bestimmt.

Feldtyp

Mögliche Feldtypen:
<pre>
	int
	int+
	color
	wrap
	offset
	options
	coolean
	comment
	file
	string
</pre>