DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Template Selector

It is possible to provide selectable template layouts to the editors, eg. a “list layout” and a “tile layout”, or different searchbox layouts.

../_images/template-layout-selector.png

Usage

Register your new templateLayout in the Page TSConfig. It will then appear in the plugin and the editor will be able to select ist.

TCEFORM {
    tt_content {
        pi_flexform.ke_search_pi1.view.templateLayout.addItems {
            20 = Custom search box 1
        }
    }
}

Register your own template paths, see Use your own Templates.

Add the new layout inside a condition which checks for the setting “conf.templateLayout”.

<f:layout name="General"/>
<f:section name="content">
    <f:if condition="{conf.templateLayout}">
        <f:if condition="{conf.templateLayout} == 10">
            <f:render section="defaultLayout" arguments="{_all}"/>
        </f:if>
        <f:if condition="{conf.templateLayout} == 20">
            <f:render section="customLayout" arguments="{_all}"/>
        </f:if>
    </f:if>
</f:section>

<f:section name="defaultLayout">
    ... default template code
</f:section>

<f:section name="customLayout">
    ... custom template code
</f:section>