########
Settings
########

The django-formrenderingtools settings are prefixed with "FORMRENDERINGTOOLS\_".

It is recommended not to change the following settings if you are aware of the
"convention over configuration" practice.

In fact, these settings were originally created for the developer convenience
and to enable tests.

*******************************
FORMRENDERINGTOOLS_TEMPLATE_DIR
*******************************

By default:

.. code-block:: python

  FORMRENDERINGTOOLS_TEMPLATE_DIR_TEMPLATE_DIR = 'form_layouts'

By default, the "form_layouts" template tag library searches for templates
within the "form_layouts/" folder in template directories.

You can change this behaviour by overriding FORMRENDERINGTOOLS_TEMPLATE_DIR in 
your project's settings.

*********************************
FORMRENDERINGTOOLS_DEFAULT_LAYOUT
*********************************

By default:

.. code-block:: python

  FORMRENDERINGTOOLS_DEFAULT_LAYOUT = 'default'

When you call a template tag without specifying the 
optional "layout" argument, then it fallbacks to 
settings.FORMRENDERINGTOOLS_DEFAULT_LAYOUT.

****************************************************************
TEMPLATE_DIR and DEFAULT TEMPLATE settings for each form element
****************************************************************

The following settings exist (with default value):

* FORMRENDERINGTOOLS_FORM_TEMPLATE_DIR: 'form'
* FORMRENDERINGTOOLS_FORM_ERRORS_TEMPLATE_DIR: 'form_errors'
* FORMRENDERINGTOOLS_FIELD_LIST_TEMPLATE_DIR: 'field_list'
* FORMRENDERINGTOOLS_FIELD_TEMPLATE_DIR: 'field'
* FORMRENDERINGTOOLS_FIELD_ERRORS_TEMPLATE_DIR: 'field_errors'
* FORMRENDERINGTOOLS_LABEL_TEMPLATE_DIR: 'label'
* FORMRENDERINGTOOLS_HELP_TEXT_TEMPLATE_DIR: 'help_text'
* FORMRENDERINGTOOLS_DEFAULT_FORM_TEMPLATE: 'default.html'
* FORMRENDERINGTOOLS_DEFAULT_FORM_ERRORS_TEMPLATE: 'default.html'
* FORMRENDERINGTOOLS_DEFAULT_FIELD_LIST_TEMPLATE: 'default.html'
* FORMRENDERINGTOOLS_DEFAULT_FIELD_TEMPLATE: 'default.html'
* FORMRENDERINGTOOLS_DEFAULT_FIELD_ERRORS_TEMPLATE: 'default.html'
* FORMRENDERINGTOOLS_DEFAULT_LABEL_TEMPLATE: 'default.html'
* FORMRENDERINGTOOLS_DEFAULT_HELP_TEXT_TEMPLATE: 'default.html'

These values are used to compute the default template name for use with the
template tag.
