Wikizone - Benutzerbeiträge [de]

TypoScript Einstellungen in Extensions auslagern

2008-08-09T19:35:56Z

91.47.0.125: /* Komfortable Eingabe für den Benutzer im Constants Editor */

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>

weitere Beispiele
<pre>
#cat=gbt3.basic/template; type=options[doc,doc2,doc3,doc4,doc_custom]; label= Wrapper ID: yui uses this id to set basic layout (with, fixed...), Or specify a own width (widht in em = px/13 or /13.3333 for IE)
wrapperid = doc2
</pre>

TypoScript Einstellungen in Extensions auslagern

2008-08-09T19:21:59Z

91.47.0.125:

TypoScript Einstellungen in Extensions auslagern

2008-08-09T19:21:06Z

91.47.0.125:

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>