76 lines
2.3 KiB
ReStructuredText
76 lines
2.3 KiB
ReStructuredText
: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
|
|
}
|
|
}
|
|
|