Frontend TypoScript conditions criteria

The current application context as a string. See Application context.

Example:

[applicationContext == "Development"]
    # ...
[END]

# Any context that is "Production" or starts with "Production"
# (for example, Production/Staging").
[applicationContext matches "/^Production/"]
    # ...
[END]

All data of the current page record as array.

Example:

# Check single page UID
[traverse(page, "uid") == 2]
    # ...
[END]

# Check list of page UIDs
[traverse(page, "uid") in [17,24]]
    # ...
[END]

# Check list of page UIDs NOT in
[traverse(page, "uid") not in [17,24]]
    # ...
[END]

# Check range of pages (example: page UID from 10 to 20)
[traverse(page, "uid") in 10..20]
    # ...
[END]

# Check the page backend layout
[traverse(page, "backend_layout") == 5]
    # ...
[END]
[traverse(page, "backend_layout") == "example_layout"]
    # ...
[END]

# Check the page title
[traverse(page, "title") == "foo"]
    # ...
[END]

Object with tree information.

Object with backend information.

Object with frontend information.

Object with workspace information.

Object with TYPO3-related information.

Parameter

String

type

String | Integer

Get the current date in the given format. See the PHP date function as a reference for the possible usage.

Example:

# True, if the day of the current month is 7
[date("j") == 7]
    # ...
[END]

# True, if the day of the current week is 7
[date("w") == 7]
    # ...
[END]

# True, if the day of the current year is 7
[date("z") == 7]
    # ...
[END]

# True, if the current hour is 7
[date("G") == 7]
    # ...
[END]

Parameter

String, String

type

Boolean

This function has two parameters: The first parameter is the string to search in, the second parameter is the search string.

Example:

# Search a string with * within another string
[like("fooBarBaz", "*Bar*")]
    # ...
[END]

# Search string with single characters in between, using ?
[like("fooBarBaz", "f?oBa?Baz")]
    # ...
[END]

# Search string using regular expression
[like("fooBarBaz", "/f[o]{2,2}[aBrz]+/")]
    # ...
[END]

Parameter

Array, String

type

Mixed

This function gets a value from an array with arbitrary depth and suppresses a PHP warning when sub-arrays do not exist. It has two parameters: The first parameter is the array to traverse, the second parameter is the path to traverse.

In case the path is not found in the array, an empty string is returned.

Example:

# Traverse query parameters of current request along tx_news_pi1[news]
[request && traverse(request.getQueryParams(), 'tx_news_pi1/news') > 0]

# Traverse page properties for current page
[traverse(page ?? [], "pid") == 65]

Parameter

String

type

Boolean

Compares against the current TYPO3 branch.

Example:

# True, if the current TYPO3 version is 13.4.x
[compatVersion("13.4")]
    # ...
[END]

# True, if the current TYPO3 version is 13.4.0
[compatVersion("13.4.0")]
    # ...
[END]

Provides access to TypoScriptFrontendController $GLOBALS['TSFE'] . This function can directly access methods of TypoScriptFrontendController. This class is target of a mid-term refactoring. It should be used with care since it will eventually vanish in the future.

Using the getTSFE() function, developers have to ensure that "TSFE" is available before accessing its properties. A missing "TSFE", for example, in backend context, does no longer automatically evaluate the whole condition to false. Instead, the function returns null, which can be checked using either [getTSFE() && getTSFE().id == 17] or the null-safe operator [getTSFE()?.id == 17].

Example:

# True, if the current page UID is 17. Use the page variable instead
[getTSFE()?.id == 17]

PHP function getenv.

Example:

[getenv("VIRTUAL_HOST") == "www.example.org"]
    # ...
[END]

Provides access to the current state of feature toggles.

Example:

# True, if the feature toggle for enforcing the Content Security Policy
# in the frontend is enabled
[feature("security.frontend.enforceContentSecurityPolicy") === true]
    # ...
[END]

Parameter

String

type

Boolean

Value or constraint, wildcard or regular expression possible; special value: "devIP" (matches the devIPmask).

Example:

[ip("172.18.*")]
    page.10.value = Your IP matches "172.18.*"
[END]

[ip("devIP")]
    page.10.value = Your IP matches the configured devIp
[END]

Allows to fetch information from current request.

Parameter

String

type

Mixed

Allows to access values of the current session. Available values depend on values written to the session, for example, by extensions. Use | to dig deeper into the structure for stored values.

Example:

# Match, if the session has the value 1234567 in the structure :php:`$foo['bar']`:
[session("foo|bar") == 1234567]
    # ...
[END]

Parameter

String

type

Mixed

Get a value from the site configuration, or null, if no site was found or the property does not exists.

Available information:

site("identifier")

Returns the identifier of the current site as a string.

site("base")

Returns the base of the current site as a string.

site("rootPageId")

Returns the root page UID of the current site as an integer.

site("languages")

Returns an array of the available languages for the current site. For deeper information, see siteLanguage().

site("allLanguages")

Returns an array of available and unavailable languages for the current site. For deeper information, see siteLanguage().

site("defaultLanguage")

Returns the default language for the current site. For deeper information, see siteLanguage().

site("configuration")

Returns an array with the available configuration for the current site.

Example:

# Site identifier
[site("identifier") == "my_site"]
    # ...
[END]

# Match site base host
[site("base").getHost() == "www.example.org"]
    # ...
[END]

# Match base path
[site("base").getPath() == "/"]
    # ...
[END]

# Match root page UID
[site("rootPageId") == 1]
    # ...
[END]

# Match a configuration property
[traverse(site("configuration"), "myCustomProperty") == true]
    # ...
[END]

Site settings can also be used in the conditions in TypoScript constants:

my.constant = my global value
[traverse(site('configuration'), 'settings/some/setting') == 'someValue']
  my.constant = another value, if condition matches
[global]

Parameter

String

type

Mixed

Get a value from the site language configuration, or null if no site was found or property not exists.

Available information:

siteLanguage("languageId")

Returns the language ID as an integer.

siteLanguage("locale")

Returns the current locale as a string, for example en-GB or de-DE.

siteLanguage("base")

Returns the configured base URL as a string.

siteLanguage("title")

Returns the internal human-readable name for this language as a string.

siteLanguage("navigationTitle")

Returns the navigation title as a string.

siteLanguage("flagIdentifier")

Returns the flag identifier as a string, for example gb.

siteLanguage("typo3Language")

Returns the language identifier used in TYPO3 XLIFF files as a string, for example default or the two-letter language code.

siteLanguage("hreflang")

Returns the language information for the hreflang tag as a string.

siteLanguage("fallbackType")

Returns the language fallback mode as a string, one of fallback, strict or free.

siteLanguage("fallbackLanguageIds")

Returns the list of fallback languages as a string, for example 1,0.

Example:

[siteLanguage("locale") == "de-CH"]
    page.10.value = This site has the locale "de_CH" or "de_CH.utf8"
[END]

[siteLanguage("title") == "Italy"]
    page.10.value = This site has the title "Italy"
[END]