Enhanced Fluid based backend element previews

Installs: 8 595

Dependents: 0

Suggesters: 0

Security: 0

Stars: 7

Watchers: 8

Forks: 0

Open Issues: 0


1.0.1 2023-01-19 10:25 UTC


About this extension

This extension adds a hook for rendering content element previews for TYPO3's backend view in the page module, adding the ability to use Fluid Partials and Layouts to enable consistent preview markup.


Use composer to add this content element to your project

composer require b13/backendpreviews

and install the extension using the Extension Manager in your TYPO3 backend.

Add configuration

Add this to your PageTsConfig to include the default Fluid Templates provided with this extension:

@import 'EXT:backendpreviews/Configuration/PageTs/PageTs.tsconfig'

You can add your own paths to the setup using PageTsConfig in your own site-extension:

mod.web_layout.tt_content.preview.view {
  layoutRootPaths.10 = EXT:site_example/Resources/Private/Contenttypes/Backend/Layouts
  partialRootPaths.10 = EXT:site_example/Resources/Private/Contenttypes/Backend/Partials
  templateRootPaths.10 = EXT:site_example/Resources/Private/Contenttypes/Backend/Templates

By default, we will try to find a template to render a preview based on the CType of the element, meaning for CType mytype we will try to find a template named Mytype.html in one of the paths defined in the templateRootPaths-Array.

You can set a different templateName explicitly like this:

mod.web_layout.tt_content.preview.template.mytype = Myowntemplate


As TYPO3 Core, backendpreviews is licensed under GPL2 or later. See the LICENSE file for more details.

Background, Authors & Further Maintenance

EXT:backendpreviews was initially created by David Steeb in 2021 for b13, Stuttgart. We use this as a basis to add consistent previews for our custom content element types.

Find more TYPO3 extensions we have developed that help us deliver value in client projects. As part of the way we work, we focus on testing and best practices to ensure long-term performance, reliability, and results in all our code.