TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:21 +02:00
commit be71cfa708
199 changed files with 4138 additions and 0 deletions
@@ -0,0 +1,75 @@
+:navigation-title: Overriding templates
+
+.. include:: /Includes.rst.txt
+
+.. _overriding-fluid-templates:
+
+==============================
+Overriding the Fluid templates
+==============================
+
+At :ref:`typoscript` we have described the way content elements are rendered.
+
+By default these settings are done in the :file:`setup.typoscript` file which can be found in the
+:file:`EXT:fluid_styled_content/Configuration/TypoScript/` folder.
+
+.. _overriding-fluid-templates-using-site-sets:
+
+Using the site settings
+=======================
+
+..  versionadded:: 13.1
+    You can now use :ref:`site settings <t3coreapi:sitehandling-settings>` to
+    override the template paths.
+
+In order to override the templates used in `fluid_styled_content` you need a
+custom :ref:`site package <t3sitepackage:start>`.
+
+You can override the default template paths from the
+:ref:`site-set-fluid-styled-content` in your site configuration:
+
+..  literalinclude:: _site-settings.yaml
+    :caption: EXT:site_package/Configuration/Sets/SitePackage/settings.yaml
+
+Now copy the Fluid templates that you want to override into your site package at
+the path configured in the site settings.
+
+.. _overriding-fluid-templates-using-lib-fluidcontent:
+
+Using lib.contentElement
+========================
+
+..  versionchanged:: 13.1
+    It is recommended to use
+    :ref:`site settings <overriding-fluid-templates-using-site-sets>` instead of
+    :typoscript:`lib.contentElement` to override the template paths.
+
+This option gives you the ability to add another `templateRootPath` and can be defined
+the same as `partialRootPaths` and `layoutRootPaths`:
+
+.. code-block:: typoscript
+
+   lib.contentElement {
+      templateRootPaths {
+         200 = EXT:your_extension_key/Resources/Private/Templates/
+      }
+      partialRootPaths {
+         200 = EXT:your_extension_key/Resources/Private/Partials/
+      }
+      layoutRootPaths {
+         200 = EXT:your_extension_key/Resources/Private/Layouts/
+      }
+   }
+
+A content element is using a `templateName`, which is defined in :file:`setup.typoscript`. You
+can override this value, but the template from the extension *fluid_styled_content* will
+not be loaded as its name is still the default value.
+
+.. code-block:: typoscript
+
+   tt_content {
+      bullets {
+         templateName = ChangedName
+      }
+   }
+