: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
      }
   }