Snippets + Wiki

Diese Seite ist nicht editierbar. Du kannst den Quelltext sehen, jedoch nicht verändern. Kontaktiere den Administrator, wenn du glaubst, dass hier ein Fehler vorliegt.
====== TypoScript-Condition Cheatsheet ======

===== Conditions: Allgemeines =====

In TYPO3 9.4 wurde die //symfony expression language// eingeführt. Die alten, „klassischen“ Conditions gelten damit als deprecated und werden in TYPO3 v10 entfernt.

==== "Klassische" Conditions bis TYPO3 v9 ====

<code typoscript>
// Beides muss zutreffen:
[Condition 1] && [Condition 2]
[Condition 1] AND [Condition 2]

// Eines von beiden muss zutreffen:
[Condition 1][Condition 2] 
[Condition 1] || [Condition 2] 
[Condition 1] OR [Condition 2] 

// Entweder Firefox ODER der Internet Explorer 8+:
[browser = firefox] || [browser = msie] && [version => 8]

// Weitere Auswahlmöglichkeiten dank 'ELSE':
[browser = msie]
page.10.value = Internet Explorer
[ELSE]
page.10.value = Kein Internet Explorer!
[END]

// Bedingung verneinen:
[Condition]
[else]
page.10.value = Füge direkt nach der Bedingung ein [else] ein.
[end]
</code>

<WRAP center round info 100%>
Anmerkung: die ''browser''-Conditions sind schon lange aus TYPO3 entfernt, sie dienen nur als nachvollziehbares Beispiel.
</WRAP>

==== Conditions mit symfony expression language ab TYPO3 9.4 ====

Mit der neuen Syntax können Conditions innerhalb der selben Klammer verknüpft werden. Die alte Schreibweise in zwei Blöcken ist zumindest in TYPO3 v9 weiterhin möglich, womöglich aber ebenfalls deprecated. Ich empfehle daher die neue Schreibweise.

<code typoscript>
// Beides muss zutreffen:
[Condition 1 && Condition 2]

// Eines von beiden muss zutreffen:
[Condition 1 || Condition 2] 

// Entweder eingeloggt ODER auf der englischen Version der Seite mit ID 75:
[frontend.user.isLoggedIn == 1 || getTSFE().id == 75 && siteLanguage("title") == "English"]

// Weitere Auswahlmöglichkeiten dank 'ELSE':
[loginUser('*')]
page.10.value = Der Nutzer ist angemeldet.
[ELSE]
page.10.value = Der Nutzer ist nicht angemeldet.
[END]

// Bedingung verneinen:
[frontend.user.isLoggedIn != 1]

// Neu: Zahlenraum zwischen 18 und 45:
[page["uid"] in 18..45]
</code>

<WRAP center round tip 100%>
Es gibt noch einige Möglichkeiten mehr, um Bedingungen abzufragen:\\ [[https://docs.typo3.org/typo3cms/TyposcriptReference/Conditions/Reference.html|Offizielle Condition-Dokumentation]]\\
Derzeit ist diese Dokumentation noch ausbaufähig.
</WRAP>

----

===== Conditions: Beispiele =====

==== Application Context ====
<code typoscript>
// "Klassische" Condition bis TYPO3 v9:
[applicationContext = Staging]
[applicationContext = Production/Staging]

// Ab TYPO3 9.4 - doppeltes Gleichheitszeichen und Anführungszeichen:
[applicationContext == "Development"]
[applicationContext == "Production/Staging"]

</code>

==== Sprachwahl ====
<code typoscript>
// "Klassische" Condition bis TYPO3 v9:
[globalVar = GP:L = 1]

// Ab TYPO3 9.4 - muss übereinstimmen mit Site Configuration:
[siteLanguage("locale") == "en_US.UTF-8"]
[siteLanguage("title") == "English"]

</code>

==== Mit Get-Parameter: z.B. &print=1 ====
<code typoscript>
// "Klassische" Condition bis TYPO3 v9:
[globalVar = GP:print > 0]

// Ab TYPO3 9.4:
[request.getQueryParams() ['print'] > 0]
[traverse(request.getQueryParams(), 'tx_news_pi1/news') > 0]
</code>

Die erweiterte und empfohlene Condition mit ''traverse'' prüft zunächst, ob das Array (hier: //tx_news_pi1/news//) existiert. Dies verhindert Log-Einträge mit //"RuntimeException: Unable to get an item on a non-array"//, wenn das Array fehlt.
==== Einzelne Seite OHNE Unterseiten ====
<code typoscript>
// "Klassische" Conditions bis TYPO3 v9:
[globalVar = TSFE:id=17, TSFE:id=24] 
// ODER 
[globalVar = TSFE:page|pid=17, TSFE:page|pid=24]

// Ab TYPO3 9.4:
[traverse(page, "uid") == 17]
[traverse(page, "uid") in [17,24]]
[getTSFE().id == 17]
[getTSFE().id in [17,24]]
</code>

==== Seiten-ID UND deren Unterseiten ====
<code typoscript>
// "Klassische" Condition bis TYPO3 v9:
[PIDinRootline = 17, 24]

// Ab TYPO3 9.4:
[17 in tree.rootLineIds || 24 in tree.rootLineIds]
</code>

==== NUR Unterseiten der angegebenen Seiten-ID, nicht die gewählte Seite selbst ====
<code typoscript>
// "Klassische" Condition bis TYPO3 v9:
[PIDupinRootline = 17, 24]

// Ab TYPO3 10.3:
[17 in tree.rootLineParentIds || 24 in tree.rootLineParentIds]
</code>

==== Ebene auf der rootline. 0 ist root ====
<code typoscript>
// "Klassische" Condition bis TYPO3 v9:
[treeLevel = 0,2]
</code>

==== Domain ====
<code typoscript>
// "Klassische" Conditions bis TYPO3 v9:
[globalString = IENV:HTTP_HOST = subdomain*]
[globalString = IENV:HTTP_HOST = www.example.org]

// Ab TYPO3 9.4:
[request.getNormalizedParams().getHttpHost() == 'www.example.org']
[like(request.getNormalizedParams().getHttpHost(), '*.test')]
</code>

==== Protokoll ====

<code typoscript>
// Ab TYPO3 9.4:
[request.getNormalizedParams().isHttps() == false]
</code>
==== Seiteneigenschaften abfragen (nur FE) ====
<code typoscript>
// "Klassische" Condition bis TYPO3 v9:
[globalVar = TSFE:page|backend_layout = 1]

// Ab TYPO3 9.4:
[traverse(page, "backend_layout") == 'pagets__2_columns_33_66']
</code>

==== Seiteneigenschaften abfragen (FE und BE) ====
<code typoscript>
// "Klassische" Condition bis TYPO3 v9:
[page|backend_layout = 1]

// Ab TYPO3 9.4:
[tree.pagelayout == 1]
[tree.pagelayout == "pagets__1Column"]
</code>

==== Benutzergruppen ====
<code typoscript>
// "Klassische" Conditions bis TYPO3 v9:
[usergroup = *]
[usergroup = 1,2]

// Ab TYPO3 9.4:
[usergroup("1,2")]
</code>

==== Frontend-Benutzer ====
<code typoscript>
// "Klassische" Conditions bis TYPO3 v9:
[loginUser = *]
[loginUser = 1,2]


// Ab TYPO3 9.4:
// Als beliebiger Frontend-Benutzer angemeldet:
[loginUser('*')]
[frontend.user.isLoggedIn == 1]

//Als ein bestimmter Frontend-Benutzer angemeldet:
[frontend.user.userId == 2]

// Als einer von mehreren aufgeführten Frontend-Benutzern angemeldet:
[loginUser('1,2')]
[frontend.user.userId in [1,2]]

// Aktuell nicht am Frontend angemeldet:
[loginUser('*') == false]
</code>

==== Benutzername ====
<code typoscript>
// "Klassische" Condition bis TYPO3 v9:
[globalString = TSFE:fe_user|user|username = johndoe]
</code>

==== Frontendbenutzer im Backend eingeloggt? ====
<code typoscript>
// "Klassische" Condition bis TYPO3 v9:
[globalVar = TSFE : beUserLogin > 0]

// Ab TYPO3 9.4:
[getTSFE().isBackendUserLoggedIn()]
</code>

Zwischenzeitlich gab es einen Bug, wodurch man die Symfony Condition erweitern musste (''[getTSFE() && getTSFE().isBackendUserLoggedIn()]''). Dieser ist aber nun in TYPO3 v9 und v10 behoben.

Seit TYPO3 9.5.16 und 10.4.1 ist es alternativ möglich, die verschiedenen ''[backend.user.*]'' Conditions im Frontend zu verwenden:

<code typoscript>
[backend.user.isLoggedIn]
[backend.user.isAdmin]
[backend.user.userId == 2]
</code>

Quelle: [[https://docs.typo3.org/m/typo3/reference-typoscript/master/en-us/Conditions/Index.html#backend|Offizielle Dokumentation]] (mit Dank an Josef Glatz für den Hinweis!)
==== Auszulesende Konstante größer als 10 ====
<code typoscript>
// "Klassische" Condition bis TYPO3 v9:
[globalVar = LIT:10 < {$konstante}]

// Ab TYPO3 9.4:
[{$konstante} > 10]
</code>

==== Eigene Funktion ====
<code typoscript>
// "Klassische" Condition bis TYPO3 v9:
[userFunc = Funktionsname(Parameter)]
</code>

==== Ist Extension installiert? ====
<code typoscript>
// "Klassische" Condition bis TYPO3 v9:
[userFunc = TYPO3\CMS\Core\Utility\ExtensionManagementUtility::isLoaded('extkey')]
</code>
Quelle: [[http://mbless.de/blog/2015/02/11/typoscript-tricks.html|mbless.de]]

==== Werte aus Site Configuration auslesen ====

<code typoscript>
// Ab TYPO3 9.4:
[site("identifier") == "mysite"]
[site("base") == "http://local.test/"] 
</code>

==== Spalte in Backend-Layout abfragen (Page TSconfig, z.B. TCEFORM) ====

<code typoscript>
// "Klassische" Condition bis TYPO3 v9:
[globalVar = GP:defVals|tt_content|colPos==10]
 
// Ab TYPO3 9.4:
[request.getQueryParams()['defVals']['tt_content']['colPos'] == 10]
</code>

Quelle: [[https://forge.typo3.org/issues/91646#note-1|Oliver Hader auf TYPO3 Forge]]
Snippets + Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Seiten-Werkzeuge
