Using site configuration in TypoScript and Fluid templates

getText

Site configuration can be accessed via the site property in TypoScript.

Example:

page.10 = TEXT
page.10.data = site:base
page.10.wrap = This is your base URL: |

Where site is the keyword for accessing an aspect, and the following parts are the configuration key(s) to access.

data = site:customConfigKey.nested.value

To access the current siteLanguage use the siteLanguage prefix:

page.10 = TEXT
page.10.data = siteLanguage:navigationTitle
page.10.wrap = This is the title of the current site language: |

page.10 = TEXT
page.10.dataWrap = The current site language direction is {siteLanguage:direction}

Tip

Accessing site configuration is possible in TypoScript, which enables to store site specific configuration options in one central place (the site configuration) and allows usage of that configuration from different contexts. While this sounds similar to using TypoScript constants, site configuration values may also be used from backend or CLI context as long as the rootPageId of a site is known.

Site configuration can also be used in TypoScript conditions and as TypoScript constants.

FLUIDTEMPLATE

You can use the SiteProcessor in the FLUIDTEMPLATE content object to fetch data from the site entity:

tt_content.mycontent.20 = FLUIDTEMPLATE
tt_content.mycontent.20 {
    file = EXT:myextension/Resources/Private/Templates/ContentObjects/MyContent.html

    dataProcessing.10 = TYPO3\CMS\Frontend\DataProcessing\SiteProcessor
    dataProcessing.10 {
        as = site
    }
}

In the Fluid template the properties of the site entity can be accessed with:

<p>{site.rootPageId}</p>
<p>{site.configuration.someCustomConfiguration}</p>

Specific Site settings can be accessed via:

<p>{site.configuration.settings.mySettingKey}</p>
<p>{site.settings.all.mySettingKey}</p>

Non-Extbase Fluid view

Deprecated since version 13.3

Using the StandaloneView is deprecated. Switch to a ViewInterface instance provided by the The Site object.

In a non-Extbase Fluid view (\TYPO3\CMS\Core\View\ViewInterface ), created manually by the Using the generic view factory (ViewFactoryInterface), you can use the PHP API to access the site settings (see The Site object), then assign that object to your Fluid standalone template, and finally access it through the same notation in the Fluid template of a FLUIDTEMPLATE.