.. _topics-templates:

===========================
Templates, Tags and Filters
===========================

.. admonition:: About this document

   This document describes the templates, template tags and filters provided by
   the library.

.. contents::
   :depth: 3

See also the `modules documentation`_ and the `documentation index`_.

.. _`modules documentation`: modules.html
.. _`documentation index`: index.html

Template files
==============

It's possible to override any template by providing an equally named file
inside a ``forms`` subdirectory somewhere in ``TEMPLATE_DIRS`` where Django can
find it.

Template reference
------------------

``forms/form.html``
~~~~~~~~~~~~~~~~~~~

Template used to render a form by ``softwarefabrica.django.forms.extended``.

``forms/field.html``
~~~~~~~~~~~~~~~~~~~~

Template used to render a single field, included by ``forms/form.html``.

``js/Related.js``
~~~~~~~~~~~~~~~~~

Javascript code required by the ``SelectPopupWidget``,
``SelectMultiplePopupWidget``, and ``RelatedItemWidget`` widgets (and
corresponding fields).

``widgets/date.html``
~~~~~~~~~~~~~~~~~~~~~

Template used to render the ``DateWidget`` widget.

``widgets/datetime.html``
~~~~~~~~~~~~~~~~~~~~~~~~~

Template used to render the ``DateTimeWidget`` widget.

``widgets/relateditem.html``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Template used to render the ``RelatedItemWidget`` widget.

``widgets/select-popup.html``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Template used to render the ``SelectPopupWidget`` and
``SelectMultiplePopupWidget`` widgets.

Template tags and filters
=========================

There are no template tags or filters at this moment.

Tag reference
-------------

None.

Filter reference
----------------

None.
