title.md

TYPO3 extension: tw_base

Collection of building blocks and viewhelpers for TYPO3 projects by tollwerk

Page title viewhelper

The page title viewhelper utilizes the FlexPageTitleProvider to set a custom page title from within a Fluid template:

<base:page.title title="Custom title"/>

For the custom page title to be used you need to register it as title provider in TypoScript, preferrably with a higher priority than the default "record" title provider:

config.pageTitleProviders {
    flex {
        provider = Tollwerk\TwBase\Domain\Provider\FlexPageTitleProvider
        before = record
    }
}

HINT: The "flex" key is chosen arbitrarily.

The title string provided to the viewhelper may also contain a placeholder "%s". In that case you also have to provide the replace argument listing one ore more keys of registered title providers that will be evaluated in the given order. The first title provider returning a non-empty value will be used to replace the placeholder:

<base:page.title title="Custom title | %s" replace="blog record"/>

<!-- equivalent to: -->

<base:page.title title="Custom title | %s" replace="{0: 'blog', 1: 'record'}"/>

Internally, the viewhelper uses the PageTitleUtility to do its magic. You may also use this utility directly from within an Extbase controller or any other PHP context:

PageTitleUtility::setPageTitle('Custom title | %s', ['blog', 'record']);