.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

.. include:: ../../../_IncludedDirectives.rst

Changing & editing templates
============================
EXT:|extension_key| is using fluid as template engine. If you are using fluid
already, you might skip this section.

This documentation won't bring you all information about fluid but only the
most important things you need for using it. You can get
more information in books like the one of `Jochen Rau und Sebastian
Kurfürst <http://www.amazon.de/Zukunftssichere-TYPO3-Extensions-mit-
Extbase-Fluid/dp/3897219654/>`_ or online, e.g. at
`http://wiki.typo3.org/Fluid <http://wiki.tpyo3.org/Fluid>`_ or many
other sites.

Changing paths of the template
------------------------------
You should never edit the original templates of an extension as those changes will vanish if you upgrade the extension.
As any extbase based extension, you can find the templates in the directory ``Resources/Private/``.

If you want to change a template, copy the desired files to the directory where you store the templates.
This can be a directory in ``fileadmin`` or a custom extension. Multiple fallbacks can be defined which makes it far easier to customize the templates.

.. code-block:: typoscript

  plugin.tx_events2 {
    view {
      templateRootPaths >
      templateRootPaths {
        0 = EXT:events2/Resources/Private/Templates/
        1 = fileadmin/templates/ext/events2/Templates/
      }
      partialRootPaths >
      partialRootPaths {
        0 = EXT:events2/Resources/Private/Partials/
        1 = fileadmin/templates/ext/events2/Partials/
      }
      layoutRootPaths >
      layoutRootPaths {
        0 = EXT:events2/Resources/Private/Layouts/
        1 = fileadmin/templates/ext/events2/Layouts/
      }
    }
  }

Change the templates using TypoScript constants
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
You can use the following TypoScript in the **constants** to change
the paths

.. code-block:: typoscript

  plugin.tx_events2 {
    view {
      templateRootPath = fileadmin/templates/ext/events2/Templates/
      partialRootPath = fileadmin/templates/ext/events2/Partials/
      layoutRootPath = fileadmin/templates/ext/events2/Layouts/
    }
  }

Change path of the paginate widget
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The path of the paginate widget can be changed by using a configuration like below.

.. code-block:: typoscript

  plugin.tx_events2 {
    view {
      widget.JWeiland\Events2\ViewHelpers\Widget\PaginateViewHelper.templateRootPath = {$plugin.tx_events2.view.templateRootPath}
    }
  }