EXT: BE Layout Template¶

What does it do?¶

This extension adds a new field to the Backend layout records, which makes it possible to select a template file for the Frontend output. It uses the FLUIDTEMPLATE object the Frontend output and decides which template file will be used by reading it from the current page's backend layout record.

What should I have?¶

All you need are TYPO3 4.7 or newer and installed Extbase and Fluid extensions.

How can I use it?¶

Install the extension, load the static TypoScript template and make sure, that you do not overwrite the TypoScript path “ page.10 ”.

How does it work?¶

The FLUIDTEMPLATE object requires a template file for the rendering process. The extension provides a special TypoScript setup, which loads the path to template files from Backend layout records. This means, a page which uses a Backend layout will be rendered with the template file which is defined in this layout record.

If no template file was defined, the UID of the record will combined with the string “Template” and the ending “.html”. The resulting filename (e.g. Template1.html) will then be used as template file.

The filename “Template0.html” will be used if a page has no backend layout.

The layout / template / partial root path can be modified by using the “Constant Editor” or by modifying them manually via setup.

It is important that you change the path to a new one in your fileadmin directory instead of making changes in the extension directory.

Screenshots¶

Install extension¶

The BE Layout Template (layouttemplate) extension can be installed through the typical TYPO3 installation process by using the Extension Manager. If one of the following steps is missing, please clear all caches in backend.

Include static template¶

After installation switch to Template module in menu and go to your root page (this is normally the first page below the absolute root, formerly known as World globe) in page tree. Now choose “Info/Modify” in the dropdown in the upper left edge of the page. Finally open “edit the whole template record”, go to “Includes”-tab and select “BE Layout Template (layouttemplate)” in the list of static templates. Don't forget to save the dataset. Warning: The setup extends / overwrites existing TypoScript configuration in path “page.10”.

Make default setup¶

Klick on the pencil in front of the point “Setup” to open the TypoScript setup. Add at least the following line into the text field:

page = PAGE

All other template configuration is made by this extension. It also provides basic fluid template variables to display the content of first ten columns in your template. See the TypoScript setup in “Configuration/TypoScript/setup.txt” in extension root path for more details.

Modify root paths¶

Now open the Constant Editor by choosing “Constant Editor” in the dropdown in the upper left edge of the page. Select the category “BE LAYOUT TEMPLATE” in the second select on this page. Now change the three first constants to paths in your fileadmin directory. Don't forget to create this folders afterwards.

Create pages¶

Now create a new page in your page tree and name it as you like. We need also a new page with type “folder” to store our Backend layouts.

Create a backend layout¶

Now switch to the list module in menu and go to the newly created folder page. Add a new record from type “Backend Layout” and name it as you like. After setting up some columns in the “Config” field, select a template file in the previously created directory below fileadmin and save the record.

Add layout to a page¶

Edit the previously created page and select the new Backend layout for current page. You can now see the result by open this page in Frontend after saving it.

plugin.tx_layouttemplate.view¶

Example configuration¶

This is an example configuration of the basic settings:

plugin.tx_layouttemplate {
  view {
    templateRootPath = fileadmin/Templates/
    partialRootPath  = fileadmin/Partials/
    layoutRootPath   = fileadmin/Layouts/
    outputFormat     = html
  }
}

Known problems¶

Actually nothing. But if you know something, give me feedback via email.

1.0.0¶

8