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:

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:

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.