diff --git a/CHANGELOG.rst b/CHANGELOG.rst
index 78cf53fd..b197e9aa 100644
--- a/CHANGELOG.rst
+++ b/CHANGELOG.rst
@@ -1324,7 +1324,7 @@ Existing files
 2015-03-26
 
 - `Checkbox select multiple
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/checkbox_select_multiple>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/checkbox_select_multiple>`_
   field added.
 - Minor improvements (styling) in the Foundation 5 theme.
 - Initial configuration for tox tests.
@@ -1360,22 +1360,22 @@ Existing files
 2015-03-20
 
 - `Decimal
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/decimal>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/decimal>`_
   field added.
 - `Float
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/float>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/float>`_
   field added.
 - `Slug
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/slug>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/slug>`_
   field added.
 - `IP address
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/ip_address>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/ip_address>`_
   field added.
 - `Null boolean
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/null_boolean>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/null_boolean>`_
   field added.
 - `Time
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/time>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/time>`_
   field added.
 - From now on using `simplejson` package in favour of `json`, since it can
   handle decimal data.
diff --git a/CREDITS.rst b/CREDITS.rst
index 968eea6e..2087cfdb 100644
--- a/CREDITS.rst
+++ b/CREDITS.rst
@@ -17,10 +17,10 @@ Thanks to the following people for their contributions:
   <https://github.com/barseghyanartur/django-fobi/commits?author=adrien-delhorme>`_
   for French translations and some minor fixes.
 - `Maximilian Kindshofer
-  <https://github.com/barseghyanartur/django-fobi/commits/master?author=MaximilianKindshofer>`_
+  <https://github.com/barseghyanartur/django-fobi/commits/main?author=MaximilianKindshofer>`_
   for German translations.
 - `Thomas Wajs
-  <https://github.com/barseghyanartur/django-fobi/commits/master?author=thomasWajs>`_
+  <https://github.com/barseghyanartur/django-fobi/commits/main?author=thomasWajs>`_
   for number of minor yet valuable fixes.
 - `garmoncheg
   <https://github.com/barseghyanartur/django-fobi/commits?author=garmoncheg>`_
@@ -29,20 +29,20 @@ Thanks to the following people for their contributions:
   <https://github.com/barseghyanartur/django-fobi/commits?author=jmsfwk>`_
   for number of Django 1.9 support fixes.
 - `Mario Taddei
-  <https://github.com/barseghyanartur/django-fobi/commits/master?author=mariuccio>`_
+  <https://github.com/barseghyanartur/django-fobi/commits/main?author=mariuccio>`_
   for his initiative to make `Select multiple with max` plugin.
 - `Andy Babic
-  <https://github.com/barseghyanartur/django-fobi/commits/master?author=ababic>`_
+  <https://github.com/barseghyanartur/django-fobi/commits/main?author=ababic>`_
   for improvements in the generic integration processor and contributions
   to the ``wagtail_integration`` contrib app.
 - `Heldroe
-  <https://github.com/barseghyanartur/django-fobi/commits/master?author=Heldroe>`_
+  <https://github.com/barseghyanartur/django-fobi/commits/main?author=Heldroe>`_
   for minor fixes.
 - `Michal Dabski
-  <https://github.com/barseghyanartur/django-fobi/commits/master?author=mick88>`_
+  <https://github.com/barseghyanartur/django-fobi/commits/main?author=mick88>`_
   for minor fixes.
 - `Marcos Amorim
-  <https://github.com/barseghyanartur/django-fobi/commits/master?author=marcosamorim>`_
+  <https://github.com/barseghyanartur/django-fobi/commits/main?author=marcosamorim>`_
   for number of validation improvements.
 - `Grzegorz Bialy
   <https://github.com/barseghyanartur/django-fobi/commits?author=grzegorzbialy>`_
diff --git a/QUICK_START.rst b/QUICK_START.rst
index cdcbdbc5..11575378 100644
--- a/QUICK_START.rst
+++ b/QUICK_START.rst
@@ -10,7 +10,7 @@ several parts listed below::
 Part 1: standard Django installation
 ====================================
 Example project code available `here
-<https://github.com/barseghyanartur/django-fobi/tree/master/examples/quick_start>`_.
+<https://github.com/barseghyanartur/django-fobi/tree/main/examples/quick_start>`_.
 
 Installation and configuration
 ------------------------------
diff --git a/README.rst b/README.rst
index 773f9c28..81a6b0a4 100644
--- a/README.rst
+++ b/README.rst
@@ -28,8 +28,8 @@ handling the submitted form data).
    :target: https://github.com/barseghyanartur/django-fobi/#License
    :alt: GPL-2.0-only OR LGPL-2.1-or-later
 
-.. image:: https://coveralls.io/repos/github/barseghyanartur/django-fobi/badge.svg?branch=master
-    :target: https://coveralls.io/github/barseghyanartur/django-fobi?branch=master
+.. image:: https://coveralls.io/repos/github/barseghyanartur/django-fobi/badge.svg?branch=main
+    :target: https://coveralls.io/github/barseghyanartur/django-fobi?branch=main
     :alt: Coverage
 
 Prerequisites
@@ -138,7 +138,7 @@ Some of the upcoming/in-development features/improvements are:
 - Foundation 6 support.
 
 See the `TODOS
-<https://raw.githubusercontent.com/barseghyanartur/django-fobi/master/TODOS.rst>`_
+<https://raw.githubusercontent.com/barseghyanartur/django-fobi/main/TODOS.rst>`_
 for the full list of planned-, pending- in-development- or to-be-implemented
 features.
 
@@ -1519,10 +1519,10 @@ Make changes to an existing theme
 As said above, making your own theme from scratch could be costly. Instead,
 you can override/reuse an existing one and change it to your needs with
 minimal efforts. See the `override simple theme
-<https://github.com/barseghyanartur/django-fobi/tree/master/examples/simple/override_simple_theme/>`_
+<https://github.com/barseghyanartur/django-fobi/tree/main/examples/simple/override_simple_theme/>`_
 example. In order to see it in action, run the project with
 `settings_override_simple_theme
-<https://github.com/barseghyanartur/django-fobi/blob/master/examples/simple/settings_override_simple_theme.py>`_
+<https://github.com/barseghyanartur/django-fobi/blob/main/examples/simple/settings_override_simple_theme.py>`_
 option:
 
 .. code-block:: sh
@@ -1913,59 +1913,67 @@ Fields marked with asterisk (*) fall under the definition of text elements.
 It's possible to provide `Dynamic initial values`_ for text elements.
 
 - `Boolean (checkbox)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/boolean/>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/boolean/>`_
+- `Checkbox select multiple
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/checkbox_select_multiple/>`_
 - `Date
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/date/>`_
-- `DateTime
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/datetime/>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/date/>`_
 - `Date drop down (year, month, day selection drop-downs)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/date_drop_down/>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/date_drop_down/>`_
+- `DateTime
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/datetime/>`_
 - `Decimal
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/decimal>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/decimal>`_
 - `Duration
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/duration>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/duration>`_
 - `Email*
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/email/>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/email/>`_
 - `File
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/file/>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/file/>`_
 - `Float
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/float>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/float>`_
 - `Hidden*
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/hidden/>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/hidden/>`_
+- `Hidden model object
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/hidden_model_object/>`_
 - `Input
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/input/>`_
-- `IP address*
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/ip_address>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/input/>`_
 - `Integer
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/integer/>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/integer/>`_
+- `IP address*
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/ip_address>`_
 - `Null boolean
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/null_boolean>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/null_boolean>`_
 - `Password*
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/password/>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/password/>`_
 - `Radio select (radio button)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/radio/>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/radio/>`_
 - `Range select
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/range_select/>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/range_select/>`_
+- `Regex
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/regex/>`_
 - `Select (drop-down)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/select/>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/select/>`_
 - `Select model object (drop-down)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/select_model_object/>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/select_model_object/>`_
 - `Select multiple (drop-down)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/select_multiple/>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/select_multiple/>`_
 - `Select multiple model objects (drop-down)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/select_multiple_model_objects/>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/select_multiple_model_objects/>`_
+- `Select multiple with max (drop-down)
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/select_multiple_with_max/>`_
 - `Slider
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/slider>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/slider>`_
 - `Slug*
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/slug>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/slug>`_
 - `Text*
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/text/>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/text/>`_
 - `Textarea*
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/textarea/>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/textarea/>`_
 - `Time
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/time>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/time>`_
 - `URL*
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/url/>`_
+  <https://github.com/barseghyanartur/django-fobi/tree/main/src/fobi/contrib/plugins/form_elements/fields/url/>`_
 
 Content/presentation
 ~~~~~~~~~~~~~~~~~~~~
@@ -1978,16 +1986,16 @@ complete and content rich.
 - `Content image URL
   <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/content/content_image_url/>`_:
   Insert an image URL.
-- `Content text
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/content/content_text/>`_:
-  Add text.
+- `Content markdown
+  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/content/content_markdown/>`_:
+  Add markdown text.
 - `Content richtext
   <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/content/content_richtext/>`_:
   Add rich text (based on `django-ckeditor <https://github.com/django-ckeditor/django-ckeditor>`_
   package).
-- `Content markdown
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/content/content_markdown/>`_:
-  Add markdown text.
+- `Content text
+  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/content/content_text/>`_:
+  Add text.
 - `Content video
   <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/content/content_video/>`_:
   Add an embed YouTube or Vimeo video.
@@ -2290,7 +2298,7 @@ Using `django-floppyforms`
     {% form form %}
 
 See how it's done in the `override simple theme
-<https://github.com/barseghyanartur/django-fobi/tree/master/examples/simple/override_simple_theme/>`__
+<https://github.com/barseghyanartur/django-fobi/tree/main/examples/simple/override_simple_theme/>`__
 example.
 
 Import/export forms
@@ -2329,9 +2337,9 @@ easily achievable with introduction of custom locale paths in your project.
 See the following as a good example of overriding some English plugin labels.
 
 - `custom settings
-  <https://raw.githubusercontent.com/barseghyanartur/django-fobi/master/examples/simple/settings/alternative_labels.py>`__
+  <https://raw.githubusercontent.com/barseghyanartur/django-fobi/main/examples/simple/settings/alternative_labels.py>`__
 - `custom locales directory
-  <https://github.com/barseghyanartur/django-fobi/tree/master/examples/simple/fobi_locale/>`__
+  <https://github.com/barseghyanartur/django-fobi/tree/main/examples/simple/fobi_locale/>`__
 
 Run the example project as follows:
 
diff --git a/docs/changelog.rst b/docs/changelog.rst
index 78cf53fd..4d7817ae 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -1,1887 +1 @@
-Release history and notes
-=========================
-`Sequence based identifiers
-<http://en.wikipedia.org/wiki/Software_versioning#Sequence-based_identifiers>`_
-are used for versioning (schema follows below):
-
-.. code-block:: text
-
-    major.minor[.revision]
-
-- It's always safe to upgrade within the same minor version (for example, from
-  0.3 to 0.3.4).
-- Minor version changes might be backwards incompatible. Read the
-  release notes carefully before upgrading (for example, when upgrading from
-  0.3.4 to 0.4).
-- All backwards incompatible changes are mentioned in this document.
-
-0.19.2
-------
-2022-07-14
-
-- Make it easier to get initial data for the `ViewFormEntry` view.
-- Apply black and isort on entire code base.
-
-0.19.1
-------
-2022-07-12
-
-- Added class-based view for Dashboard.
-
-0.19
-----
-2022-07-11
-
-- Introduce class based views. Function based views are still supported
-  and will be supported until at least 0.23.
-
-  Migration to class based views is simple. Only your project's ``urls.py``
-  would change:
-
-  .. code-block:: python
-
-      urlpatterns = [
-          # ...
-          url(r'^fobi/', include('fobi.urls.class_based.view')),
-          url(r'^fobi/', include('fobi.urls.class_based.edit')),
-          # ...
-      ]
-
-  To use function based views, simply replace the previous line with:
-
-  .. code-block:: python
-
-      urlpatterns = [
-          # ...
-          url(r'^fobi/', include('fobi.urls.view')),
-          url(r'^fobi/', include('fobi.urls.edit')),
-          # ...
-      ]
-
-- Class-based permissions (work only in combination with class-based views).
-
-  Example:
-
-  .. code-block:: python
-
-      from fobi.permissions.definitions import edit_form_entry_permissions
-      from fobi.permissions.generic import BasePermission
-      from fobi.permissions.helpers import (
-          any_permission_required_func, login_required,
-      )
-
-      class EditFormEntryPermission(BasePermission):
-      """Permission to edit form entries."""
-
-      def has_permission(self, request, view) -> bool:
-          return login_required(request) and any_permission_required_func(
-              edit_form_entry_permissions
-          )(request.user)
-
-      def has_object_permission(self, request, view, obj) -> bool:
-          return login_required(request) and any_permission_required_func(
-              edit_form_entry_permissions
-          )(request.user) and obj.user == request.user
-
-0.18
-----
-2022-06-23
-
-- Tested against Python 3.9, Django 3.2 and 4.0.
-
-.. note::
-
-    Release dedicated to my dear son, Tigran, who turned 10 recently.
-
-0.17.1
-------
-2021-01-25
-
-.. note::
-
-    Release dedicated to defenders of Armenia and Artsakh (Nagorno Karabakh)
-    and all the victims of Turkish and Azerbaijani aggression.
-
-- Replace outdated `simplejson` with `json`.
-
-0.17
-----
-2020-12-28
-
-.. note::
-
-    Release dedicated to defenders of Armenia and Artsakh (Nagorno Karabakh)
-    and all the victims of Turkish and Azerbaijani aggression.
-
-- Deprecate support for the following Django versions: 1.11, 2.0 and 2.1.
-
-0.16.4
-------
-2020-04-08
-
-- Replace `admin_static` templatetag module with `static`, since the latter is
-  available in Django 1.11, which is now the minimal supported version.
-
-0.16.3
-------
-2020-04-04
-
-- Fixes in ``invisible_recaptcha`` plugin. Treat empty ``SITE_KEY`` as error.
-
-0.16.2
-------
-2020-04-03
-
-- Conditional use of deprecated `admin_static` templatetag module.
-
-0.16.1
-------
-2020-03-18
-
-- Fix the ``datetime`` is not JSON serializable error.
-
-0.16
-----
-2020-01-11
-
-.. note::
-
-    This release drops support for Python 2.7 and 3.4 and sets the minimum
-    requirement version for Django to 1.11. If you don't meet these
-    requirements - do not upgrade.
-
-- Add support for Django 3.0.
-- Drop support Django 1.8, 1.9, 1.10. Minimal supported Django version is 1.11.
-- Tested against Python 3.8.
-- Drop Python 2.7 support.
-- Drop Python 3.4 support.
-- Tested with Django REST Framework 3.11.x. All older versions of
-  Django REST Framework should still work, although they are no longer tested.
-- Tested with FeinCMS 1.17.x. No code changes at all. All older versions of
-  FeinCMS should still work, although they are no longer tested.
-
-0.15
-----
-2019-06-20
-
-.. note::
-
-    Although this release does not contain major backwards incompatible
-    changes, some things you have had working in past might break.
-
-- The following settings
-  ``FOBI_FAIL_ON_ERRORS_IN_FORM_ELEMENT_PLUGINS``,
-  ``FOBI_FAIL_ON_ERRORS_IN_FORM_HANDLER_PLUGINS``,
-  ``FOBI_FAIL_ON_MISSING_INTEGRATION_FORM_ELEMENT_PLUGINS`` and
-  ``FOBI_FAIL_ON_MISSING_INTEGRATION_FORM_HANDLER_PLUGINS`` used to be set to
-  ``False`` by default (silencing exceptions). It's no longer so. Exceptions
-  will cause errors from now on (you might get error 500). If you want old
-  behaviour, set them to ``False``.
-
-0.14
-----
-2019-05-24
-
-- Tested again Django 2.2 and Python 3.7.
-- Use ChromeDriver (for browser tests).
-- Wiping out (as stated many versions ago) support for Django < 1.8.
-- Reactivate travis (although not all tests yet pass, while they do pass
-  locally; to be solved in future).
-
-0.13.10
--------
-2019-02-28
-
-- Add `mail_sender` DRF integration plugin.
-
-0.13.9
-------
-2019-02-28
-
-.. note::
-
-    Release supported by `Goldmund, Wyldebeast & Wunderliebe
-    <https://goldmund-wyldebeast-wunderliebe.nl/>`_.
-
-- Add `mail_sender` form handler plugin.
-- Upgrade test suite.
-
-0.13.8
-------
-2019-01-07
-
-.. note::
-
-    Release supported by `Goldmund, Wyldebeast & Wunderliebe
-    <https://goldmund-wyldebeast-wunderliebe.nl/>`_.
-
-- Make it easier to redirect to a new URL (on success) in integration apps.
-
-0.13.7
-------
-2018-10-01
-
-- Make fobi wagtail integration work with wagtail 2.
-
-0.13.6
-------
-2018-08-16
-
-- Completely wiping out ``django-autoslug`` in requirements (for now it has
-  been replaced with ``django-autoslug-iplweb``).
-
-0.13.5
-------
-2018-08-12
-
-- Minor fixes in code, tests and docs.
-
-0.13.4
-------
-2018-08-11
-
-- Django 2.1 support (initial).
-- Upgrade test suite.
-
-0.13.3
-------
-2018-07-10
-
-- Minor fixes admin export of form entries (Postgres).
-
-0.13.2
-------
-2018-03-12
-
-- Choices are now required fields for `checkbox_select_multiple`, `radio`,
-  `select`, `select_multiple` and `select_multiple_with_max` form elements.
-- The `active_date_from`, `active_date_to`, `inactive_page_title`,
-  `inactive_page_message` added to forms the import/export flow.
-
-0.13.1
-------
-2018-02-28
-
-- Minor fixes in recaptcha plugin.
-- Add `max_length` to textarea plugin.
-
-0.13
-----
-2018-02-25
-
-.. note::
-
-    This release contains minor backwards incompatible changes.
-    A number of new database fields have been added to the `FormEntry`
-    model (`active_date_from`, `active_date_to`, `inactive_page_title`,
-    `inactive_page_message`). You will need to migrate your database.
-
-- Implement disabling forms based on dates. Note, that although the feature
-  is landed into the core, contrib packages (such as Foundation 5 theme,
-  Simple theme, Django CMS admin style theme, DRF integration app,
-  FeinCMS integration app, Mezzanine integration app, DjangoCMS integration app
-  and Wagtail app) are not yet updated to reflect these changes. It's a work
-  in progress to be done in the nearest minor releases. Check the
-  `issue #143 <https://github.com/barseghyanartur/django-fobi/issues/143>`_
-  for state of the progress.
-
-0.12.20
--------
-2018-02-24
-
-- Minor Python 2 fixes.
-
-0.12.19
--------
-2018-02-21
-
-- Make it possible to sort on plugin ``name`` instead of ``uid``.
-
-0.12.18
--------
-2018-02-19
-
-- Improved form element add drop-down order.
-- Add initial migrations for DjangoCMS integration app.
-- Add French translations.
-- Implemented styles for ``bleach`` within ``content_richtext`` plugin.
-- Documentation improvements.
-
-0.12.17
--------
-2018-02-14
-
-- Security fixes in db_store plugin.
-- Minor fixes and cleanups.
-- If CKEditor is installed, use it (rich text) for success page message.
-
-0.12.16
--------
-2018-01-21
-
-.. note::
-
-    Note, that this release contains minor backwards incompatible changes, that
-    may slightly break your JS and/or styling.
-
-    The `form-horizontal` class attribute on the main form with elements (in
-    templates) has been replaced with `fobi-form` id attribute.
-
-    Affected files:
-
-    - src/fobi/templates/fobi/generic/add_form_element_entry_ajax.html
-    - src/fobi/templates/fobi/generic/edit_form_element_entry_ajax.html
-    - src/fobi/templates/fobi/generic/snippets/form_ajax.html
-
-    If you have modified any of these, you might want to check and update
-    your code.
-
-- Invisible reCAPTCHA form plugin (security) added.
-- Clean up templates.
-- Introduce a form_id block. The following templates were affected.
-
-0.12.15
--------
-2018-01-17
-
-- Minor clean up of HTML templates (in some templates
-  ``hidden_form_element_wrapper_html_class`` was used while others
-  ``form_element_wrapper_hidden_html_class``). Now
-  ``form_element_wrapper_hidden_html_class`` is used everywhere. Some HTML
-  files have been re-indented (2 spaces).
-- Minor clean up of JS.
-- Optionally limit file extensions for file upload element
-
-0.12.14
--------
-2018-01-10
-
-- Minor clean up of HTML templates (unused classes removed).
-- Nicer captcha (simple captcha) for bootstrap3 and foundation5 themes.
-
-0.12.13
--------
-2018-01-09
-
-.. note::
-
-    Note, that this release contains minor backwards incompatible changes, that may
-    slightly break your JS and/or styling.
-
-    The `form-horizontal` class attribute on the main form with elements (in
-    templates) has been replaced with `fobi-form` id attribute.
-
-    Affected files:
-
-    - /src/fobi/contrib/themes/djangocms_admin_style_theme/static/djangocms_admin_style_theme/js/fobi.djangocms_admin_style_theme.edit.js
-    - /src/fobi/contrib/themes/djangocms_admin_style_theme/templates/djangocms_admin_style_theme/edit_form_entry_ajax.html
-    - /src/fobi/contrib/themes/foundation5/static/foundation5/js/foundation5_fobi_extras.js
-    - /src/fobi/contrib/themes/foundation5/templates/foundation5/edit_form_entry_ajax.html
-    - /src/fobi/contrib/themes/foundation5/templates/foundation5/edit_form_wizard_entry_ajax.html
-    - /src/fobi/contrib/themes/simple/static/simple/js/fobi.simple.edit.js
-    - /src/fobi/contrib/themes/simple/templates/simple/edit_form_entry_ajax.html
-    - /src/fobi/contrib/themes/simple/templates/simple/edit_form_wizard_entry_ajax.html
-    - /src/fobi/contrib/themes/bootstrap3/static/bootstrap3/js/bootstrap3_fobi_extras.js
-    - /src/fobi/templates/fobi/generic/edit_form_entry_ajax.html
-
-    If you have modified any of these, please double check that your edit views
-    work and look properly.
-
-- Fixes in simple and django-cms-admin-style themes (assets being loaded
-  incorrectly since 0.12.6).
-- Base template, as well as templates of all the themes have been made a
-  little bit more flexible.
-- Minor documentation fixes.
-
-0.12.12
--------
-2018-01-03
-
-- More consistent loading of assets (JS, CSS) in add- and
-  edit-form-element-entry templates.
-- Copyright and licenses year update.
-- Minor fixes in the widgets.
-- Clean up.
-
-0.12.11
--------
-2017-12-27
-
-- Clean up Django < 1.8 code.
-- Clean up old code.
-
-0.12.10
--------
-2017-12-24
-
-- Django 2.0 support (experimental).
-- (Temporary) replace ``django-autoslug`` package with
-  ``django-autoslug-iplweb``, which works fine for Django versions >=1.8,<=2.0.
-
-0.12.9
-------
-2017-12-21
-
-- Added content markdown plugin.
-
-0.12.8
-------
-2017-12-19
-
-- Added common form callback ``AutoFormMail`` for auto mailing the form
-  data (without need to add the mail plugin to the form).
-
-0.12.7
-------
-2017-12-17
-
-- Minor fixes (in the add form element entry bootstrap3 template).
-- Add content rich text plugin (based on CKEditor).
-- Added common form callback ``AutoFormDbStore`` for auto saving the form
-  data (without need to add the db_store plugin to the form).
-
-0.12.6
-------
-2017-12-12
-
-- Clean up.
-- Minor documentation fixes.
-- Minor plugin clean-up/fixes (``captcha``, ``recaptcha``, ``content_text``).
-- Minor Python 3 fixes.
-- Minor fixes in FormWizard ``get_absolute_url`` method.
-
-0.12.5
-------
-2017-09-27
-
-- Documentation fixes.
-
-0.12.4
-------
-2017-09-27
-
-- Documentation fixes.
-
-0.12.3
-------
-2017-09-27
-
-- Minor fixes.
-- Reflect form-wizards support changes in the `foundation5` theme.
-- Documentation fixes.
-
-0.12.2
-------
-2017-08-02
-
-- Some work on full form-wizards support in the `foundation5` theme.
-- Django 1.11 fixes for customised widgets.
-- Update example project requirements.
-
-0.12.1
-------
-2017-07-31
-
-- Reflect form-wizards support changes in the `simple` theme.
-- Fixes in docs.
-
-0.12
-----
-2017-06-28
-
-- Wagtail integration (yet experimental).
-
-0.11.13
--------
-2017-06-10
-
-- Updated docs for DjangoCMS, FeinCMS and Mezzanine.
-- Updated outdated Dutch translations.
-- Improvements of the DRF integration app documentation.
-- Duration field added.
-- Support ``DurationField`` in ``drf_integration`` integration app.
-- Minor fixes in docs.
-
-0.11.12
--------
-2017-05-31
-
-- Added a lot of field metadata to the OPTIONS call of ``drf_integration`` app.
-- Appended a lot of sub-module README files to the main documentation.
-
-0.11.11
--------
-2017-05-29
-
-- Minor fixes in ``content_text`` ``drf_integration`` plugin.
-- Added ``imageurl`` support to the ``mailchimp_importer`` plugin.
-
-0.11.10
--------
-2017-05-26
-
-- Minor fixes in form-wizards on Django 1.11.
-
-0.11.9
-------
-2017-05-24
-
-- Mezzanine integration updated to work with Mezzanine 4.2.3.
-- Fixes in date-drop-down plugin when using form wizards.
-
-0.11.8
-------
-2017-05-17
-
-- ``ContentImageURL`` plugin added.
-- Minor Python3 fixes in ``db_store`` plugin (related to export of forms to
-  ``xls`` format).
-
-0.11.7
-------
-2017-05-16
-
-- Fixed in ``fobi.integration`` package related to Django 1.10 and higher.
-- FeinCMS integration updated (only migrations added) to work with
-  FeinCMS 1.13.2.
-- DjangoCMS integration updated to work with DjangoCMS 3.4.3.
-
-0.11.6
-------
-2017-05-15
-
-- Minor fixes in ``drf_integration`` app, added GET/detail actions tests.
-
-0.11.5
-------
-2017-05-15
-
-- Added ``date_drop_down`` to ``drf_integration`` app.
-- Fixed dependencies issue.
-- Added dedicated requirements for specific Django versions.
-
-0.11.4
-------
-2017-05-12
-
-- Minor fixes in integration callbacks of the ``drf_integration`` sub-package.
-- Added support for ``content_image``, ``content_text`` and ``content_video``
-  plugins.
-- Fixes in installable demo.
-
-0.11.3
-------
-2017-05-10
-
-- Concept of integration callbacks introduced and implemented for the
-  ``drf_integration`` sub-package.
-
-0.11.2
-------
-2017-05-09
-
-- Minor fixes in ``drf_integration`` app.
-
-0.11.1
-------
-2017-05-08
-
-- Minor fixes in ``decimal`` plugin.
-- Minor documentation improvements.
-
-0.11
-----
-2017-05-07
-
-This release is dedicated to my beloved `wife <https://github.com/anagardi>`_
-for all the love and support she gave me through years. If you are a company
-looking for (female) developers in Groningen area (the Netherlands),  do not
-hesitate to `contact her <mailto:anahit.gardishyan@gmail.com>`_.
-
-- Django REST framework integration. Check the Heroku demo `here
-  <https://django-fobi.herokuapp.com/api/>`_.
-- Documentation fixes.
-- PEP8 code fixes.
-- Minor setup fixes related to moved screen-shots file.
-- Added helper scripts to test with Firefox in headless mode. Describe
-  testing with Firefox in headless mode in documentation.
-- Validate the ``decimal`` field plugin - quantize the decimal value to the
-  configured precision.
-- Minor fixes in the ``float`` field plugin.
-- Minor improvements in complex form element plugins (``select``, ``file``) and
-  form handler plugins (``db_store``, ``mail``, ``http_respost``) in order to
-  simplify integration plugins and reduce code duplication.
-- Minor Python3 fixes in ``range_select`` and ``slider`` form element plugins.
-- Minor Python3 fixes in ``http_repost`` and ``mail`` form handler plugins.
-
-0.10.7
-------
-2017-03-13
-
-- Several Django deprecation/moves fixes for better future compatibility.
-
-0.10.6
-------
-2017-02-14
-
-- Minor Python 3 fixes for integer, float and decimal fields.
-
-0.10.5
-------
-2017-02-13
-
-- Tested against Python 3.6.
-- Initial (experimental) Django 1.11 support.
-
-0.10.4
-------
-2017-01-11
-
-- Minor fixes in Django admin.
-- Various pep8 fixes.
-- Fixes additions and improvements in/of docs.
-- Add options to test with PhantomJS instead of Firefox.
-
-0.10.3
-------
-2016-11-24
-
-- Minor fixes.
-
-0.10.2
-------
-2016-11-24
-
-- Minor fixes.
-
-0.10.1
-------
-2016-11-17
-
-- Fixed captcha and re-captcha issues in form wizards.
-
-0.10
-----
-2016-11-16
-
-.. note::
-
-    Note, that this release contains minor backwards incompatible changes, that may
-    break your code. Two additional arguments have been added to the
-    `submit_plugin_form_data` method of the form element plugins. If you have
-    written custom form element plugins - update your code.
-
-- Added `form_entry_elements` and `kwargs` to the `submit_plugin_form_data`
-  method of the form element plugins. Make sure to update your custom
-  plugins if you have written any.
-- Added tests for mailchimp integration plugin.
-- Moving all plugins to base submodules of the correspondent sub
-  packages.
-- Add missing whitespace to the ``help_text`` of the ``title`` field of
-  ``FormEntry`` and ``FormWizardEntry`` models.
-- Disable GoogleAnalytics while testing (guess what - this change speeds up
-  selenium tests twice).
-- Docs updated.
-- Helper scripts updated.
-- Multiple pep8 fixes.
-
-0.9.17
-------
-2016-11-13
-
-.. note::
-
-    Announcing dropping support of Python 2.6 and Django 1.7. As of 0.9.17
-    everything is still backwards compatible with Django 1.7, but in future
-    versions it will be wiped out.
-
-- Value validations for Integer and Text Fields.
-- Hide previous button in form wizard template for bootstrap3 on first step.
-
-0.9.16
-------
-2016-11-10
-
-- Introduced form titles (shown in view templates).
-- Improved navigation of the form wizards.
-
-0.9.15
-------
-2016-11-07
-
-- Minor fixes.
-
-0.9.14
-------
-2016-11-07
-
-- Minor fixes.
-
-0.9.13
-------
-2016-11-05
-
-.. note::
-
-    Announcing dropping support of Django 1.5 and 1.6. As of 0.9.13 everything is
-    still backwards compatible with versions 1.5 and 1.6, but in future versions
-    compatibility with these versions will be wiped out.
-
-- Fix backwards compatibility of `slider` and `range_select` plugins with
-  Django versions 1.5 and 1.6.
-
-0.9.12
-------
-2016-11-02
-
-- Better debugging.
-- Upgrade example FeinCMS integration to work with 1.12.
-
-0.9.11
-------
-2016-11-01
-
-- Fixes.
-
-0.9.10
-------
-2016-11-01
-
-- Fixed issue with custom labels in the `slider` plugin.
-- Made `slider` plugin compatible with Django <= 1.6.
-- Fixes `get_absolute_url` methods on `FormEntry` and `FormWizardEntry`
-  models. #48
-
-0.9.9
------
-2016-10-31
-
-- Make it possible to add custom ticks to the `slider` plugin.
-
-0.9.8
------
-2016-10-27
-
-- Support multiple sliders in one form.
-
-0.9.7
------
-2016-10-27
-
-- Improvements in the generic integration processor. #47
-- Improved form wizard interface and navigation.
-- Fixed a broken test.
-- Added import/export functionality for form wizards.
-
-0.9.6
------
-2016-10-25
-
-- Fixed InvalidQuery exception raised when attempting to export entry from a
-  'DB store' handler. #44
-- Fixed ProgrammingError raised when using the 'Export data to CSV/XLS'
-  action. #45
-
-0.9.5
------
-2016-10-25
-
-- Minor fixes in `slider` and `select_range` plugins.
-
-0.9.4
------
-2016-10-24
-
-- Fix issue with `select_multiple`, `select_multiple_model_objects` and
-  `select_multiple_mptt_model_objects` being invalidated on the last step
-  of the form wizard.
-
-0.9.3
------
-2016-10-24
-
-- Change to `NumberInput` widget for all number inputs.
-- Fixed issue with `slider` plugin missing labels if `Show endpoints as` is
-  set to `Labeled ticks`.
-- Link to edit form entry added to edit form wizard entry view.
-
-0.9.2
------
-2016-10-24
-
-- Minor fixes.
-
-0.9.1
------
-2016-10-24
-
-- Minor fixes.
-
-0.9
----
-2016-10-24
-
-.. note::
-
-    Note, that this release contain minor backwards incompatible changes, that
-    may break your existing code (your data is left intact). If you have written
-    custom form element plugins you should update your code!
-
-- The :method:`get_form_field_instances`
-  and :method:`_get_form_field_instances` of
-  the :class:`fobi.base.FormElementPlugin` both accept two new optional
-  arguments: `form_entry` and `form_element_entries` as well as `**kwargs`.
-  Make sure to update your custom plugins if you have written any.
-- Minor fixes in the form wizards: forms in intermediate steps do receive
-  updates from the `submit_plugin_form_data` of the plugins.
-- Fixed issue in the `base_bulk_change_plugins` function on Django 1.10.
-
-0.8.10
-------
-2016-10-22
-
-- Minor CSS improvements of the `slider` plugin.
-- Fixed broken readthedocs requirements.
-
-0.8.9
------
-2016-10-22
-
-- Simplified debugging (never set `FOBI_DEBUG` to True in production!).
-- Major `slider` plugin improvements.
-
-0.8.8
------
-2016-10-21
-
-- Minor `slider` plugin improvements (JavaScript).
-
-0.8.7
------
-2016-10-21
-
-- Fixed issue of plugin media not being collected in the form wizard.
-
-0.8.6
------
-2016-10-21
-
-- Functional improvements of `slider` plugin.
-
-0.8.5
------
-2016-10-20
-
-- Add `range_select` and `slider` form field plugins.
-- Fixed custom CSS classes not appearing in the rendered HTML of the field
-  plugin/widget.
-- Fixed issue with undefined file storage for form wizards. From now on
-  the `FileSystemStorage` storage is used for wizard uploads.
-- Fixed too much of extreme data view/export security of the `db_store`
-  plugin.
-- Backwards compatibility fixes for Django < 1.7.
-
-0.8.4
------
-2016-10-19
-
-- Fix broken export (to JSON) of form entries.
-- Fix broken import (from JSON) of form entries.
-
-0.8.3
------
-2016-10-18
-
-- Minor fixes.
-
-0.8.2
------
-2016-10-18
-
-- Minor fixes.
-
-0.8.1
------
-2016-10-17
-
-- Minor fixes.
-
-0.8
----
-2016-10-17
-
-Release supported by `Lund University Cognitive Science
-<http://www.lucs.lu.se/choice-blindness-group/>`_.
-
-- Adding form-wizards functionality. Note, that at the moment only
-  `bootstrap3` theme was updated to fully support the form wizards. Although,
-  all other themes would by default support form-wizard functionality, they
-  may not look as nice as they should be (to be fixed in 0.8.x releases
-  shortly).
-- The `six` package requirements increased to >= 1.8.
-- Tests comply with pep8.
-- Fixed recently broken drag-and-drop ordering of the form elements.
-- Fixed typo for HTML id "tab-form-elemenets" -> "tab-form-elements". You
-  may need to update your custom CSS/JS/HTML accordingly. See the listing
-  0.8.a for the files affected.
-- An additional property `form_view_form_entry_option_class` has been added
-  to all the themes. Change your custom CSS/JS/HTML accordingly. See the
-  listing 0.8.b for the files affected.
-- Fixed drag-and-drop not working for ordering of form elements. #43
-- Fixed issue with non-proper rendering of the form-importer templates.
-
-.. note::
-
-    Although this release does not contain backwards incompatible changes, there
-    have been several changes in GUI and some parts of the generic HTML and themes
-    were updated. If you have custom themes implemented, you should likely make
-    some minor updates to the HTML in order to reflect the latest GUI changes.
-    The following templates have been affected:
-
-New files
-~~~~~~~~~
-- src/fobi/contrib/plugins/form_handlers/db_store/templates/db_store/view_saved_form_wizard_data_entries.html
-- src/fobi/contrib/themes/bootstrap3/templates/bootstrap3/add_form_wizard_handler_entry.html
-- src/fobi/contrib/themes/bootstrap3/templates/bootstrap3/add_form_wizard_handler_entry_ajax.html
-- src/fobi/contrib/themes/bootstrap3/templates/bootstrap3/create_form_wizard_entry.html
-- src/fobi/contrib/themes/bootstrap3/templates/bootstrap3/create_form_wizard_entry_ajax.html
-- src/fobi/contrib/themes/bootstrap3/templates/bootstrap3/edit_form_wizard_entry.html
-- src/fobi/contrib/themes/bootstrap3/templates/bootstrap3/edit_form_wizard_entry_ajax.html
-- src/fobi/contrib/themes/bootstrap3/templates/bootstrap3/form_wizards_dashboard.html
-- src/fobi/contrib/themes/bootstrap3/templates/bootstrap3/snippets/form_wizard_ajax.html
-- src/fobi/contrib/themes/bootstrap3/templates/bootstrap3/snippets/form_wizard_properties_snippet.html
-- src/fobi/contrib/themes/bootstrap3/templates/bootstrap3/snippets/form_wizard_snippet.html
-- src/fobi/contrib/themes/bootstrap3/templates/bootstrap3/view_form_wizard_entry.html
-- src/fobi/contrib/themes/bootstrap3/templates/bootstrap3/view_form_wizard_entry_ajax.html
-- src/fobi/templates/fobi/generic/add_form_wizard_handler_entry.html
-- src/fobi/templates/fobi/generic/add_form_wizard_handler_entry_ajax.html
-- src/fobi/templates/fobi/generic/create_form_wizard_entry.html
-- src/fobi/templates/fobi/generic/create_form_wizard_entry_ajax.html
-- src/fobi/templates/fobi/generic/edit_form_wizard_entry.html
-- src/fobi/templates/fobi/generic/edit_form_wizard_entry_ajax.html
-- src/fobi/templates/fobi/generic/form_wizard_entry_submitted.html
-- src/fobi/templates/fobi/generic/form_wizard_entry_submitted_ajax.html
-- src/fobi/templates/fobi/generic/form_wizards_dashboard.html
-- src/fobi/templates/fobi/generic/snippets/form_wizard_ajax.html
-- src/fobi/templates/fobi/generic/snippets/form_wizard_properties_snippet.html
-- src/fobi/templates/fobi/generic/snippets/form_wizard_snippet.html
-- src/fobi/templates/fobi/generic/snippets/form_wizard_view_ajax.html
-- src/fobi/templates/fobi/generic/view_form_wizard_entry.html
-- src/fobi/templates/fobi/generic/view_form_wizard_entry_ajax.html
-
-Existing files
-~~~~~~~~~~~~~~
-- src/fobi/contrib/plugins/form_importers/mailchimp_importer/templates/mailchimp_importer/1.html
-- src/fobi/contrib/plugins/form_importers/mailchimp_importer/views.py
-- src/fobi/contrib/themes/djangocms_admin_style_theme/templates/djangocms_admin_style_theme/edit_form_entry_ajax.html
-- src/fobi/contrib/themes/foundation5/templates/foundation5/edit_form_entry_ajax.html
-- src/fobi/templates/fobi/generic/edit_form_entry_ajax.html
-
-Additional listings
-~~~~~~~~~~~~~~~~~~~
-Listing 0.8.a "tab-form-elemenets" -> "tab-form-elements"
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-- src/fobi/contrib/themes/djangocms_admin_style_theme/static/djangocms_admin_style_theme/css/fobi.djangocms_admin_style_theme.edit.css
-- src/fobi/contrib/themes/djangocms_admin_style_theme/templates/djangocms_admin_style_theme/edit_form_entry_ajax.html
-- src/fobi/contrib/themes/foundation5/templates/foundation5/edit_form_entry_ajax.html
-- src/fobi/contrib/themes/simple/static/simple/css/fobi.simple.edit.css
-- src/fobi/contrib/themes/simple/templates/simple/edit_form_entry_ajax.html
-- src/fobi/templates/fobi/generic/edit_form_entry_ajax.html
-- src/fobi/templates/fobi/generic/edit_form_wizard_entry_ajax.html
-
-Listing 0.8.b `form_view_form_entry_option_class` property
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-- src/fobi/contrib/themes/bootstrap3/fobi_themes.py
-- src/fobi/contrib/themes/djangocms_admin_style_theme/fobi_themes.py
-- src/fobi/contrib/themes/foundation5/fobi_themes.py
-- src/fobi/contrib/themes/simple/fobi_themes.py
-- src/fobi/templates/fobi/generic/edit_form_wizard_entry_ajax.html
-
-0.7.1
------
-2016-09-22
-
-Release sponsored by `Goldmund, Wyldebeast & Wunderliebe
-<https://www.goldmund-wyldebeast-wunderliebe.nl/>`_.
-
-- Code comply with pep8.
-- Minor fixes in selenium tests.
-
-0.7
----
-2016-09-13
-
-Release sponsored by `Goldmund, Wyldebeast & Wunderliebe
-<https://www.goldmund-wyldebeast-wunderliebe.nl/>`_.
-
-- Initial Django 1.10 support.
-- `django-localeurl` has been replaced with `i18n_patterns` in sample project.
-- Minor fixes.
-
-0.6.10
-------
-2016-09-11
-
-- Moved `plugin_uid` field choices from model level to form level for
-  `FormHandler` and `FormHandlerEntry` models. #37
-
-0.6.9
------
-2016-09-08
-
-- Moved `plugin_uid` field choices from model level to form level for
-  `FormElement` and `FormElementEntry` models. #37
-- Fixed element "name" field stripping underscores issue. #33
-
-0.6.8
------
-2016-09-06
-
-- Fixed changing order of the `FormElement`, `FormElementEntry`, `FormHandler`
-  and `FormHandlerEntry` models.
-
-0.6.7
------
-2016-08-30
-
-- Minor fixes in `db_store` plugin (Django 1.6 compatibility issue).
-- Added __str__ methods to models.
-- Restrict queryset to form element entries related to the form entry in
-  position calculation.
-
-0.6.6
------
-2016-05-12
-
-- Fixed broken dependencies in demos.
-- Minor fixes.
-- Adding a new `Select multiple with max` plugin, which restricts max number
-  of choices allowed to be chosen.
-
-0.6.5
------
-2015-12-24
-
-- Minor fixes.
-
-0.6.4
------
-2015-12-24
-
-- Minor fixes.
-
-0.6.3
------
-2015-12-23
-
-- Minor fixes.
-
-0.6.2
------
-2015-12-22
-
-- Make it possible to render a list of forms using custom template tag (not
-  only on the dashboard page).
-
-0.6.1
------
-2015-12-21
-
-- Documentation fixes.
-
-0.6
----
-2015-12-18
-
-- Form importers (and as a part of it - MailChimp integration,
-  which would allow to import forms from MailChimp into `django-fobi` using
-  a user-friendly wizard).
-- Improved Django 1.9 support.
-
-0.5.19
-------
-2015-12-15
-
-- New style urls everywhere.
-
-0.5.18
-------
-2015-12-08
-
-- Minor improvements. Adding request to the `get_form_field_instances` method
-  of the `FormElementPlugin`.
-
-0.5.17
-------
-2015-10-22
-
-- Increased `easy-thumbnails` requirement to >= 2.1 for Python 3, since it was
-  causing installation errors.
-- Increased the `django-nine` requirement to >=0.1.6, since it has better
-  Python 3 support.
-
-0.5.16
-------
-2015-10-05
-
-- Fixes in migrations on Django 1.7.
-
-0.5.15
-------
-2015-09-17
-
-- Minor fixes.
-
-0.5.14
-------
-2015-09-13
-
-- Add create/update dates to the forms. Adding initial migrations.
-
-0.5.13
-------
-2015-09-01
-
-- Translation fixes.
-- Updating Dutch and Russian translations.
-
-0.5.12
-------
-2015-08-29
-
-- Export/import forms into/from JSON.
-- Minor UI improvements. Adding "Service" tab in the edit view which contains
-  links to export form to JSON and delete form.
-
-.. note::
-
-    Although this release does not contain backwards incompatible changes, there
-    have been several changes in GUI and some parts of the generic HTML and themes
-    were updated. If you have custom themes implemented, you should likely make
-    some minor updates to the HTML in order to reflect the latest GUI changes.
-    The following templates have been affected:
-
-New files
-~~~~~~~~~
-- src/fobi/contrib/themes/djangocms_admin_style_theme/templates/djangocms_admin_style_theme/import_form_entry.html
-- src/fobi/contrib/themes/djangocms_admin_style_theme/templates/djangocms_admin_style_theme/import_form_entry_ajax.html
-
-- src/fobi/contrib/themes/foundation5/templates/foundation5/import_form_entry.html
-- src/fobi/contrib/themes/foundation5/templates/foundation5/import_form_entry_ajax.html
-
-- src/fobi/contrib/themes/simple/templates/simple/import_form_entry.html
-- src/fobi/contrib/themes/simple/templates/simple/import_form_entry_ajax.html
-
-- src/fobi/templates/fobi/generic/import_form_entry.html
-- src/fobi/templates/fobi/generic/import_form_entry_ajax.html
-
-Existing files
-~~~~~~~~~~~~~~
-- src/fobi/contrib/themes/djangocms_admin_style_theme/templates/djangocms_admin_style_theme/dashboard.html
-- src/fobi/contrib/themes/djangocms_admin_style_theme/templates/djangocms_admin_style_theme/edit_form_entry_ajax.html
-
-- src/fobi/contrib/themes/foundation5/templates/foundation5/dashboard.html
-- src/fobi/contrib/themes/foundation5/templates/foundation5/edit_form_entry_ajax.html
-
-- src/fobi/contrib/themes/simple/templates/simple/dashboard.html
-- src/fobi/contrib/themes/simple/templates/simple/edit_form_entry_ajax.html
-
-- src/fobi/templates/fobi/generic/dashboard.html
-- src/fobi/templates/fobi/generic/edit_form_entry_ajax.html
-
-0.5.11
-------
-2015-08-20
-
-- Minor improvements of the dynamic values feature. Forbid usage of django
-  template tags in initial values.
-
-0.5.10
-------
-2015-08-18
-
-- Minor improvements of the initial dynamic values feature.
-
-0.5.9
------
-2015-08-17
-
-- Minor fixes in the initial dynamic values feature.
-
-0.5.8
------
-2015-08-16
-
-- Made it possible to define dynamic initials for form fields. Example initial
-  dynamic values in the form (like {{ request.path }}).
-- Minor fixes/improvements.
-
-0.5.7
------
-2015-08-03
-
-- Minor Python 3 improvements.
-
-0.5.6
------
-2015-07-31
-
-- `django-mptt` support through `select_mptt_model_object` and
-  `select_multiple_mptt_model_objects` plugins.
-- Python 3 fixes.
-
-0.5.5
------
-2015-06-30
-
-- Change the `action` field of the FormEntry into a URL field; check if
-  action exists.
-- `captcha`, `recaptcha` and `honeypot` plugins have been made required
-  in the form.
-- Fix: take default values provided in the `plugin_data_fields` of the plugin
-  form into consideration.
-
-0.5.4
------
-2015-05-21
-
-- Minor Django 1.8 fixes.
-- Improved texts/translations.
-
-0.5.3
------
-2015-05-02
-
-- Minor fixes in the `mail
-  <https://github.com/barseghyanartur/django-fobi/tree/0.5.2/src/fobi/contrib/plugins/form_handlers/mail>`_
-  form handler plugin.
-
-0.5.2
------
-2015-04-26
-
-- Make it possible to provide multiple `to` email addresses in the `mail
-  <https://github.com/barseghyanartur/django-fobi/tree/0.5.2/src/fobi/contrib/plugins/form_handlers/mail>`_
-  form handler plugin.
-- DateTime picker widget added for Foundation5 theme for `date
-  <https://github.com/barseghyanartur/django-fobi/tree/0.5.2/src/fobi/contrib/plugins/form_elements/fields/date>`_
-  and `datetime
-  <https://github.com/barseghyanartur/django-fobi/tree/0.5.2/src/fobi/contrib/plugins/form_elements/fields/datetime>`_
-  plugins.
-- Added more tests (more plugins tested).
-
-0.5.1
------
-2015-04-21
-
-- DateTime picker widget added for Bootstrap 3 theme for `date
-  <https://github.com/barseghyanartur/django-fobi/tree/0.5.2/src/fobi/contrib/plugins/form_elements/fields/date>`_
-  and `datetime
-  <https://github.com/barseghyanartur/django-fobi/tree/0.5.2/src/fobi/contrib/plugins/form_elements/fields/datetime>`_
-  plugins.
-
-0.5
----
-2015-04-06
-
-.. note::
-
-    Note, that this release contains minor backwards incompatible changes. The
-    changes may affect your existing forms and data. Read the notes below
-    carefully.
-
-- Fixed previously wrongly labeled (in `AppConf`) add-ons/plugins
-  (`fobi.contrib.plugins.form_handlers.db_store`,
-  `fobi.contrib.apps.feincms_integration`,
-  `fobi.contrib.apps.djangocms_integration`,
-  `fobi.contrib.apps.mezzanine_integration`). Due to the change, you would
-  likely have to rename a couple of database tables and update references
-  accordingly. No migrations to solve the issue are included at the moment.
-
-0.4.36
-------
-2015-04-03
-
-- Handle non-ASCII characters content_text form element.
-
-0.4.35
-------
-2015-03-28
-
-- Fixed the issue with `allow_multiple` working incorrectly for form handler
-  plugins. Fix the `db_store` plugin as well.
-
-0.4.34
-------
-2015-03-27
-
-- Minor fixes in the `Checkbox select multiple` and `Radio` plugins.
-- Minified tox tests.
-
-0.4.33
-------
-2015-03-26
-
-- `Checkbox select multiple
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/checkbox_select_multiple>`_
-  field added.
-- Minor improvements (styling) in the Foundation 5 theme.
-- Initial configuration for tox tests.
-- Clean up requirements (for example setups and tests).
-
-0.4.32
-------
-2015-03-25
-
-- Updated missing parts in the Russian translations.
-- Minor API improvements. From now on, the `run` method of form handlers
-  may return a tuple (bool, mixed). In case of errors it might be (False, err).
-- Minor code clean ups.
-
-0.4.31
-------
-2015-03-23
-
-- When path of the uploaded file (plugins) doesn't yet exist, create it,
-  instead of failing.
-
-0.4.30
-------
-2015-03-23
-
-- From now on submitted files are sent as attachments in the mail plugin.
-- Documentation improvements. Adding information of rendering forms using
-  `django-crispy-forms` or alternatives.
-- Minor fixes.
-
-0.4.29
-------
-2015-03-20
-
-- `Decimal
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/decimal>`_
-  field added.
-- `Float
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/float>`_
-  field added.
-- `Slug
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/slug>`_
-  field added.
-- `IP address
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/ip_address>`_
-  field added.
-- `Null boolean
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/null_boolean>`_
-  field added.
-- `Time
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/time>`_
-  field added.
-- From now on using `simplejson` package in favour of `json`, since it can
-  handle decimal data.
-- Minor improvements of the date plugins (`datetime`, `date`).
-
-0.4.28
-------
-2015-03-13
-
-- Fix improperly picked configurations of the
-  `fobi.contrib.plugins.form_elements.fields.select_multiple_model_objects`
-  plugin.
-- Long identifiers of models can now be safely used in foreign key plugins
-  (such as
-  `fobi.contrib.plugins.form_elements.fields.select_model_object_plugin` and
-  `fobi.contrib.plugins.form_elements.fields.select_multiple_model_objects`
-  plugins).
-- Fixed admin bulk change of the plugins.
-- From now it's possible to have some control/configure the following plugins
-  for the submitted value:
-
-      * fobi.contrib.plugins.form_elements.fields.select_model_object
-      * fobi.contrib.plugins.form_elements.fields.select_multiple_model_objects
-
-  The only thing needs to be done is to specify the appropriate variable
-  in the settings module of the project (settings.py).
-
-      * FOBI_FORM_ELEMENT_SELECT_MODEL_OBJECT_SUBMIT_VALUE_AS
-      * FOBI_FORM_ELEMENT_SELECT_MULTIPLE_MODEL_OBJECTS_SUBMIT_VALUE_AS
-
-  Allowed values are: "val", "repr", "mix".
-
-0.4.27
-------
-2015-03-12
-
-- Temporary allow the `fobi.contrib.plugins.form_handlers.db_store` plugin to
-  be used multiple times per form, until the bug with not being able to assign
-  the `db_store` plugin to the form due to incorrect handling of restrictions
-  (``allow_multiple``) introduced in previous version is properly fixed.
-- From now it's possible to have some control/configure the following plugins
-  for the submitted value:
-
-      * fobi.contrib.plugins.form_elements.fields.radio
-      * fobi.contrib.plugins.form_elements.fields.select
-      * fobi.contrib.plugins.form_elements.fields.select_multiple
-
-  The only thing needs to be done is to specify the appropriate variable
-  in the settings module of the project (settings.py).
-
-      * FOBI_FORM_ELEMENT_RADIO_SUBMIT_VALUE_AS
-      * FOBI_FORM_ELEMENT_SELECT_SUBMIT_VALUE_AS
-      * FOBI_FORM_ELEMENT_SELECT_MULTIPLE_SUBMIT_VALUE_AS
-
-  Allowed values are: "val", "repr", "mix".
-
-0.4.26
-------
-2015-03-06
-
-- Validate `fobi.contrib.plugins.form_elements.fields.email`,
-  `fobi.contrib.plugins.form_elements.fields.integer` and
-  `fobi.contrib.plugins.form_elements.fields.url` plugins initial values.
-- Properly show field types "checkbox" and "radio" in the `input` plugin (as
-  previously they showed up too large).
-- It's now possible to restrict multiple usage of form handler plugins via
-  ``allow_multiple`` property. In case if it's set to False, the plugin can
-  be used once only (per form). Default value is True. The `db_store` plugin
-  is from now on allowed to be used only once (per form).
-
-0.4.25
-------
-2015-03-04
-
-- Post-fix in the discover module (moved logging definition up).
-
-0.4.24
-------
-2015-03-04
-
-- The management command `migrate_03_to_04` intended to migrate 0.3.x branch
-  data to > 0.4.x branch data, has been renamed to `fobi_migrate_03_to_04`.
-- Add missing app config declaration for the `db_store` form handler plugin.
-- Add missing app config for the core `fobi` package.
-- Improved autodiscover for Django>=1.7. Fix exception when using a dotted
-  path to an `AppConfig` in `INSTALLED_APPS` (instead of using the path to
-  the app: ex. "path.to.app.apps.AppConfig" instead of "path.to.app").
-
-0.4.23
-------
-2015-03-04
-
-- Fix improper initial value validation for Select-like (`radio`,  `select` and
-  `select_multiple`) plugins.
-
-0.4.22
-------
-2015-03-03
-
-- Fix replace system-specific path separator by a slash on file urls.
-- Fix empty options appearing in the Select-like (`radio`,  `select` and
-  `select_multiple`) plugins and unified the processing of the raw choices
-  data.
-- Validate the initial value for Select-like (`radio`,  `select` and
-  `select_multiple`) plugins.
-
-0.4.21
-------
-2015-02-28
-
-- The
-  ``fobi.contrib.plugins.form_elements.fields.select_multiple_model_objects``
-  plugin added.
-
-0.4.20
-------
-2015-02-27
-
-- Make it possible to load initial form data from GET variables.
-- Remove "button" and "submit" types from ``fobi.contrib.elements.fields.input``
-  form element plugin.
-- The ``fobi.contrib.plugins.form_elements.fields.select_model_object`` plugin
-  no longer returns an absolute URL to the admin of the chosen model object
-  instance. Instead, it contains the app label, model name, pk and the repr
-  of it separated by dots. Example: "comments.comment.5.Lorem ipsum".
-- Minor fixes in ``from fobi.contrib.elements.fields.file`` plugin. Use system
-  path separator on ``from fobi.contrib.elements.fields.file.FILES_UPLOAD_DIR``
-  default setting.
-- Minor documentation improvements.
-
-0.4.19
-------
-2015-02-15
-
-- Some more work on future (Django 1.9) compatibility.
-- Replace bits of backwards-/forwards- compatibility code with equal code
-  parts of ``django-nine``.
-
-0.4.18
-------
-2015-02-13
-
-- From now on it's possible to localise (translated) URLs.
-- Safe way to get the user model for Django >= 1.5.* <= 1.8.*
-
-0.4.17
-------
-2015-02-12
-
-- Fix circular imports by proper referencing of the user model in
-  foreign key and many-to-many relations (``settings.AUTH_USER_MODEL`` instead
-  of ``django.contrib.auth.get_user_model``).
-- Minor documentation improvements.
-
-0.4.16
-------
-2015-02-10
-
-- A new theme ``djangocms_admin_style_theme`` added.
-- Making ``fobi.fields.NoneField`` always valid.
-- Initial work on Django 1.8 and 1.9 support.
-- Minor fixes.
-
-0.4.15
-------
-2015-01-27
-
-- Fix the "large" checkboxes in edit mode - now shown small as they should be.
-
-0.4.14
-------
-2015-01-26
-
-- German translations added.
-
-0.4.13
-------
-2015-01-15
-
-- Remove an `ipdb` statement from base integration processor
-  `fobi.integration.processors.IntegrationProcessor`.
-- Added information in the docs about FeinCMS demo part on heroku demo.
-- Make sure values of form elements declared not to have a value (``has_value``
-  property is set to False) aren't being saved in the ``db_store`` plugin.
-- Remove redundant static assets (package size decreased).
-
-0.4.12
-------
-2015-01-14
-
-- Fix empty options appearing in the Select-like plugins and unified the
-  processing of the raw choices data.
-- Update the `vishap` package requirement to latest stable 0.1.3.
-- Support for wheel packages.
-
-0.4.11
-------
-2014-12-29
-
-- Styling fixes in the ``radio`` button field of the ``bootstrap3`` theme.
-- Fixed ``db_store`` issue with CSV/XLS export failing on Django 1.7.
-
-0.4.10
-------
-2014-12-28
-
-- Minor fixes in FeinCMS integration app.
-
-0.4.9
------
-2014-12-28
-
-- Third party app integration (at the moment, FeinCMS, DjangoCMS, Mezzanine)
-  had been generalised and unified.
-- Mention the Heroku live demo in the docs.
-- Minor CSS fixes in the ``simple`` theme.
-
-0.4.8
------
-2014-12-25
-
-- More verbose debugging.
-
-0.4.7
------
-2014-12-24
-
-- Temporary left out the "cloneable" column from the dashboard templates.
-- Fixed broken imports in CAPTCHA plugin.
-- Fixed broken imports in ReCAPTCHA plugin.
-
-0.4.6
------
-2014-12-23
-
-- Updated requirements for the ``vishap`` package to avoid the ``six`` version
-  conflicts.
-- Minor documentation fixes.
-
-0.4.5
------
-2014-12-17
-
-- ReCAPTCHA field added.
-- Mezzanine integration app added.
-- Remove redundant dependencies (django-tinymce).
-- Minor improvements of the discover module.
-
-0.4.4
------
-2014-12-06
-
-- Documentation improvements.
-- Updated Dutch and Russian translations.
-- Minor fixes related to lazy translations.
-
-0.4.3
------
-2014-12-05
-
-- Make sure values of form elements declared not to have a value (``has_value``
-  property is set to False) aren't being saved in the ``db_store`` plugin.
-- Apply that to the ``honeypot`` and ``captcha`` plugins.
-
-0.4.2
------
-2014-12-04
-
-- Helper script (management command) in order to migrate django-fobi==0.3.*
-  data to django-fobi==0.4.* data (caused by renaming the ``birthday`` field
-  to ``date_drop_down`` - see the release notes of 0.4 below). Follow the steps
-  precisely in order to painlessly upgrade your django-fobi==0.3.* to
-  django-fobi==0.4.*:
-
-  1. Install django-fobi>=0.4.2:
-
-     .. code-block:: sh
-
-         pip install django-fobi>=0.4.2
-
-  2. In your settings change the:
-
-     .. code-block:: python
-
-         'fobi.contrib.plugins.form_elements.fields.birthday'
-
-     to:
-
-     .. code-block:: python
-
-         'fobi.contrib.plugins.form_elements.fields.date_drop_down'
-
-  3. Run the ``migrate_03_to_04`` management command. Note, that as of version
-     0.4.24, the `migrate_03_to_04` command has been renamed to
-     `fobi_migrate_03_to_04`.:
-
-     .. code-block:: sh
-
-         ./manage.py migrate_03_to_04
-
-0.4.1
------
-2014-12-04
-
-- Fixes in Foundation5 and Simple themes related to the changes in error
-  validation/handling of hidden fields.
-
-0.4
----
-2014-12-03
-
-.. note::
-
-    Note, that this release contains minor backwards incompatible changes. The
-    changes may affect your existing forms and data. Read the notes below
-    carefully (UPDATE 2014-12-04: the django-fobi==0.4.2 contains a management
-    command which makes the necessary changes in the database for safe upgrade).
-
-- The ``captcha`` field has been moved from
-  ``fobi.contrib.plugins.form_elements.fields.captcha`` to
-  ``fobi.contrib.plugins.form_elements.security.captcha``. Make sure to update
-  the package paths in ``INSTALLED_APPS`` of your projects' settings module
-  (settings.py) when upgrading to this version.
-- The ``honeypot`` field has been added.
-- The ``birthday`` field has been renamed to ``date_drop_down`` (A real
-  ``birthday`` field is still to come in later releases). The change causes
-  backwards incompatibility issues if you have used that ``birthday`` field.
-  If you haven't - you have nothing to worry. If you have been using it,
-  grab the 0.3.4 version, copy the
-  ``fobi.contrib.plugins.form_elements.fields.date_drop_down`` package to
-  your project apps, make necessary path changes and update the package paths
-  in ``INSTALLED_APPS`` settings module (settings.py) before upgrading to this
-  version. Then, in Django admin management interface, replace all the
-  occurrences of ``Birthday`` field with ``Date drop down`` field.
-- Better error validation/handling of hidden fields. A new form snippet
-  template added for displaying the non-field and hidden fields errors. The new
-  template makes a part of a standard theme as an attribute
-  ``form_non_field_and_hidden_errors_snippet_template``.
-- Minor fixes in generic templates.
-- An additional property ``is_hidden`` added to the hidden form elements. Those
-  form elements would be getting a default TextInput widget in the edit mode
-  instead of the widget they come from by default. It's possible to provide an
-  alternative widget for the edit mode as well. Default value of the
-  ``is_hidden`` is set to False.
-
-0.3.4
------
-2014-11-23
-
-- New settings ``FOBI_FAIL_ON_ERRORS_IN_FORM_ELEMENT_PLUGINS`` and
-  ``FOBI_FAIL_ON_ERRORS_IN_FORM_HANDLER_PLUGINS`` introduced. They do as
-  their name tells. Default value for both is False.
-- Fixed exceptions raised when unicode characters were used as form names.
-- Fixed exceptions raised when unicode characters were used as field labels.
-- Fixes in the `db_store` and `mail` plugins related to usage of unicode
-  characters.
-
-0.3.3
------
-2014-11-22
-
-- Clean up the setup. Remove redundant dependencies.
-- Documentation improvements.
-
-0.3.2
------
-2014-11-20
-
-- DjangoCMS integration app made compatible with DjangoCMS 2.4.3.
-
-0.3.1
------
-2014-11-19
-
-- DjangoCMS integration app.
-
-0.3
----
-2014-11-09
-
-.. note::
-
-    Note, that this release contains minor backwards incompatible changes. The
-    changes do not anyhow affect your existing forms or data. The only thing you
-    need to do is update the app paths in the ``settings`` module of your project.
-
-- Minor core improvements related to the theming of the form handler plugins.
-- Several presentational form element plugins have been renamed.
-  The ``fobi.contrib.plugins.form_elements.content.image`` plugin has been
-  renamed to ``fobi.contrib.plugins.form_elements.content.content_image``.
-  The ``fobi.contrib.plugins.form_elements.content.text`` plugin has been
-  renamed to ``fobi.contrib.plugins.form_elements.content.content_text``.
-  The ``fobi.contrib.plugins.form_elements.content.video`` plugin has been
-  renamed to ``fobi.contrib.plugins.form_elements.content.content_video``.
-  If you have used any of the above mentioned plugins, make sure to update
-  the app paths in the ``settings`` module of your project.
-- The ``fobi.contrib.plugins.form_elements.content.dummy`` plugin has been moved
-  to ``fobi.contrib.plugins.form_elements.test.dummy`` location. If you have
-  used it, make sure to update the its' path in the ``settings`` module of
-  your project.
-- Added readme to the following content form element plugins: ``dummy``,
-  ``content_image``, ``content_text`` and ``content_video``.
-- Added ``foundation5`` and ``simple`` theme widgets for ``db_store`` plugin.
-- If you have been overriding the defaults of the ``db_store`` plugin, change
-  the prefix from ``FOBI_PLUGIN_DB_EXPORT_`` to ``FOBI_PLUGIN_DB_STORE_``. For
-  example,  ``FOBI_PLUGIN_DB_EXPORT_CSV_DELIMITER`` should become
-  ``FOBI_PLUGIN_DB_STORE_CSV_DELIMITER``.
-- Mentioning the ``fobi_find_broken_entries`` management command in the
-  documentation, as well as improving the management command itself (more
-  verbose output).
-- Birthday field added.
-
-0.2.1
------
-2014-11-06
-
-- Minor improvements of the ``db_store`` plugin.
-- Minor improvements of the ``simple`` theme. Make sure that custom
-  form handler actions are properly shown in the form handlers list.
-- Make it possible to fail silently on missing form element or form
-  handler plugins by setting the respected values to False:
-  ``FOBI_FAIL_ON_MISSING_FORM_ELEMENT_PLUGINS``,
-  ``FOBI_FAIL_ON_MISSING_FORM_HANDLER_PLUGINS``. Otherwise an appropriate
-  exception is raised.
-
-0.2
----
-2014-11-05
-
-Note, that this release contains minor backwards incompatible changes.
-
-- Minor (backwards incompatible) changes in the form handler plugin API.
-  From now on both ``custom_actions`` and ``get_custom_actions`` methods
-  accept ``form_entry`` (obligatory) and ``request`` (optional) arguments. If
-  you have written your own or have changed existing form handler plugins
-  with use of one of the above mentioned methods, append those arguments to
-  the method declarations when upgrading to this version. If you haven't
-  written your own or changed existing form handler plugins, you may just
-  upgrade to this version.
-- Added data export features to the ``db_store`` plugin.
-- Minor fixes in ``db_store`` plugin.
-- Added missing documentation for the ``feincms_integration`` app.
-- Updated translations for Dutch and Russian.
-
-0.1.6
------
-2014-10-25
-
-- Minor improvements in the theming API. From now on the
-  ``view_embed_form_entry_ajax_template`` template would be used
-  when integrating the form rendering from other products (for example,
-  a CMS page, which has a widget which references the form object. If
-  that property is left empty, the ``view_form_entry_ajax_template``
-  is used. For a success page the ``embed_form_entry_submitted_ajax_template``
-  template would be used.
-- Functional improvements of the FeinCMS integration (the widget). If you
-  have used the FeinCMS widget of earlier versions, you likely want to update
-  to this one. From now on you can select a custom form title and the button
-  text, as well as provide custom success page title and the success  message;
-  additionally, it has been made possible to hide the form- or success-page-
-  titles.
-
-0.1.5
------
-2014-10-23
-
-- Minor fixes in the ``Integer`` form element plugin.
-- Minor fixes in the ``Input`` form element plugin.
-- Minor fixes in themes (disable HTML5 form validation in edit mode).
-- Minor documentation improvements.
-
-0.1.4
------
-2014-10-22
-
-- Minor core improvements.
-- Django 1.5 support improvements.
-- Django 1.7 support improvements.
-- Added ``Captcha`` form element plugin.
-- Added highly-customisable ``Input`` form element plugin - a custom input field
-  with support for almost any ever existing HTML attribute.
-- Documentation improvements.
-
-0.1.3
------
-2014-10-13
-
-- Django 1.7 support.
-- Add HTML5 "placeholder" field attribute support.
-
-0.1.2
------
-2014-10-11
-
-- Simple theme fixes: Fix for making the theme work in Django 1.5.
-
-0.1.1
------
-2014-10-11
-
-- Bootstrap 3 theme fixes: When tab pane has no or little content so
-  that the height of the dropdown menu exceeds the height of the tab pane
-  content the dropdown menu now becomes scrollable (vertically).
-
-0.1
----
-2014-10-11
-
-- Initial release.
\ No newline at end of file
+.. include:: ../CHANGELOG.rst
\ No newline at end of file
diff --git a/docs/documentation.rst.distrib b/docs/documentation.rst
similarity index 100%
rename from docs/documentation.rst.distrib
rename to docs/documentation.rst
diff --git a/docs/empty.rst.distrib b/docs/empty.rst
similarity index 100%
rename from docs/empty.rst.distrib
rename to docs/empty.rst
diff --git a/docs/index.rst b/docs/index.rst
index d3f9b2af..0082acad 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,7207 +1,224 @@
-===========
-django-fobi
-===========
-`django-fobi` (or just `fobi`) is a customisable, modular, user- and developer-
-friendly form generator/builder application for Django. With `fobi` you can
-build Django forms using an intuitive GUI, save or mail posted form data or
-even export forms into JSON format and import them on other instances. API
-allows you to build your own form elements and form handlers (mechanisms for
-handling the submitted form data).
-
-.. image:: https://img.shields.io/pypi/v/django-fobi.svg
-   :target: https://pypi.python.org/pypi/django-fobi
-   :alt: PyPI Version
-
-.. image:: https://img.shields.io/pypi/pyversions/django-fobi.svg
-    :target: https://pypi.python.org/pypi/django-fobi/
-    :alt: Supported Python versions
-
-.. image:: https://img.shields.io/travis/barseghyanartur/django-fobi/master.svg
-   :target: http://travis-ci.org/barseghyanartur/django-fobi
-   :alt: Build Status
-
-.. image:: https://readthedocs.org/projects/django-fobi/badge/?version=latest
-    :target: http://django-fobi.readthedocs.io/en/latest/?badge=latest
-    :alt: Documentation Status
-
-.. image:: https://img.shields.io/badge/license-GPL--2.0--only%20OR%20LGPL--2.1--or--later-blue.svg
-   :target: https://github.com/barseghyanartur/django-fobi/#License
-   :alt: GPL-2.0-only OR LGPL-2.1-or-later
-
-.. image:: https://coveralls.io/repos/github/barseghyanartur/django-fobi/badge.svg?branch=master
-    :target: https://coveralls.io/github/barseghyanartur/django-fobi?branch=master
-    :alt: Coverage
-
-Prerequisites
-=============
-- Django 2.2, 3.0, 3.1, 3.2 and 4.0.
-- Python 3.6, 3.7, 3.8 and 3.9.
-
-Key concepts
-============
-- Each form consists of elements. Form elements are divided into groups:
-
-  (a) form fields (input field, textarea, hidden field, file field, etc.).
-  (b) content (presentational) elements (text, image, embed video, etc.).
-  (c) security elements (captcha, etc).
-
-- Number of form elements is not limited.
-- Each form may contain handlers. Handler processes the form data (for example,
-  saves it or mails it). Number of the handlers is not limited.
-- Both form elements and form handlers are made with Django permission system
-  in mind.
-- As an addition to form handlers, form callbacks are implemented. Form
-  callbacks are fired on various stages of pre- and post-processing the form
-  data (on POST). Form callbacks do not make use of permission system (unless
-  you intentionally do so in the code of your callback) and are fired for all
-  forms (unlike form handlers, that are executed only if assigned).
-- Each plugin (form element or form handler) or a callback - is a Django
-  micro-app.
-- In addition for form element and form handler plugins, integration form
-  element and integration form handler plugins are implemented for integration
-  with diverse third-party apps and frameworks (such as Django REST framework).
-
-Note, that `django-fobi` does not require django-admin and administrative
-rights/permissions to access the UI, although almost seamless integration with
-django-admin is implemented through the ``simple`` theme.
-
-Main features and highlights
-============================
-- User-friendly GUI to quickly build forms.
-- Large variety of `Bundled form element plugins`_. Most of the Django fields
-  are supported. `HTML5 fields`_ are supported as well.
-- `Form wizards`_. Combine your forms into wizards. Form wizards may contain
-  handlers. Handler processes the form wizard data (for example, saves it or
-  mails it). Number of the form wizard handlers is not limited.
-- Forms can be automatically enabled/disabled based on dates (start date, end
-  date).
-- Anti-spam solutions like `CAPTCHA
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/security/captcha>`_,
-  `ReCAPTCHA
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/security/recaptcha>`_,
-  `Honeypot
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/security/honeypot>`_
-  or `Invisible reCAPTCHA
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/security/invisible_recaptcha>`__
-  come out of the box (CAPTCHA and ReCAPTCHA do require additional third-party
-  apps to be installed; Invisible reCAPTCHA doesn't).
-- In addition to standard form elements, there are cosmetic (presentational)
-  form elements (for adding a piece of text, image or a embed video)
-  alongside standard form elements.
-- Data handling in plugins (form handlers). Save the data, mail it to some
-  address or re-post it to some other endpoint. See the
-  `Bundled form handler plugins`_ for more information.
-- Developer-friendly API, which allows to edit existing or build new form
-  fields and handlers without touching the core.
-- Support for custom user model.
-- Class based views (and class-based permissions). Forms have an
-  owner (``auth.User``). Default permissions are set for the owner, but
-  class-based views provide a lot of freedom and can be easily customized.
-- `Theming`_. There are 4 ready to use `Bundled themes`_: "Bootstrap 3",
-  "Foundation 5", "Simple" (with editing interface in style of Django admin)
-  and "DjangoCMS admin style" theme (which is another simple theme with editing
-  interface in style of `djangocms-admin-style
-  <https://github.com/divio/djangocms-admin-style>`_).
-- Implemented `integration with Django REST framework
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/apps/drf_integration>`_.
-- Implemented `integration with Wagtail
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/apps/wagtail_integration>`_
-  (in a form of a Wagtail page).
-- Implemented `integration with FeinCMS
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/apps/feincms_integration>`_
-  (in a form of a FeinCMS page widget).
-- Implemented `integration with DjangoCMS
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/apps/djangocms_integration>`_
-  (in a form of a DjangoCMS page plugin).
-- Implemented `integration with Mezzanine
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/apps/mezzanine_integration>`_
-  (in a form of a Mezzanine page).
-- Reordering of form elements using drag-n-drop.
-- Data export (`DB store
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_handlers/db_store>`_
-  form handler plugin) into XLS/CSV format.
-- `Dynamic initial values`_ for form elements.
-- Import/export forms to/from JSON format.
-- Import forms from MailChimp using `mailchimp importer
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_importers/mailchimp_importer>`_.
-
-Roadmap
-=======
-Some of the upcoming/in-development features/improvements are:
-
-- Implement disabling forms based on dates.
-- Cloning of forms.
-- JSON schema support.
-- Webpack integration.
-- Improved Django REST framework OPTIONS.
-- Bootstrap 4 support.
-- Foundation 6 support.
-
-See the `TODOS
-<https://raw.githubusercontent.com/barseghyanartur/django-fobi/master/TODOS.rst>`_
-for the full list of planned-, pending- in-development- or to-be-implemented
-features.
-
-Some screenshots
-================
-See the documentation for some screen shots:
-
-- `ReadTheDocs <http://django-fobi.readthedocs.org/#screenshots>`_
-
-Demo
-====
-Live demo
----------
-See the `live demo app <https://django-fobi.herokuapp.com/>`_ on Heroku.
-Additionally, see the `Django REST framework integration demo
-<https://django-fobi.herokuapp.com/api/>`_.
-
-Credentials:
-
-- username: test_user
-- password: test_user
-
-Run demo locally
-----------------
-In order to be able to quickly evaluate the ``django-fobi``, a demo app (with a
-quick installer) has been created (works on Ubuntu/Debian, may work on other
-Linux systems as well, although not guaranteed). Follow the instructions below
-for having the demo running within a minute.
-
-Grab the latest ``django_fobi_example_app_installer.sh``:
-
-.. code-block:: sh
-
-    wget https://raw.github.com/barseghyanartur/django-fobi/stable/examples/django_fobi_example_app_installer.sh
-
-Assign execute rights to the installer and run the
-`django_fobi_example_app_installer.sh`:
-
-.. code-block:: sh
-
-    chmod +x django_fobi_example_app_installer.sh
-    ./django_fobi_example_app_installer.sh
-
-Open your browser and test the app.
-
-Dashboard:
-
-- URL: http://127.0.0.1:8001/fobi/
-- Admin username: test_admin
-- Admin password: test
-
-Django admin interface:
-
-- URL: http://127.0.0.1:8001/admin/
-- Admin username: test_admin
-- Admin password: test
-
-If quick installer doesn't work for you, see the manual steps on running the
-`example project
-<https://github.com/barseghyanartur/django-fobi/tree/stable/examples>`_.
-
-Quick start
-===========
-See the `quick start <http://django-fobi.readthedocs.io/en/latest/quickstart.html>`_.
-
-Installation
-============
-
-(1) Install latest stable version from PyPI:
-
-    .. code-block:: sh
-
-        pip install django-fobi
-
-    Or latest stable version from GitHub:
-
-    .. code-block:: sh
-
-        pip install https://github.com/barseghyanartur/django-fobi/archive/stable.tar.gz
-
-(2) Add `fobi` to ``INSTALLED_APPS`` of the your projects' Django settings.
-    Furthermore, all themes and plugins to be used, shall be added to the
-    ``INSTALLED_APPS`` as well. Note, that if a plugin has additional
-    dependencies, you should be mentioning those in the ``INSTALLED_APPS``
-    as well.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # Used by fobi
-            'django.contrib.auth',
-            'django.contrib.contenttypes',
-            'django.contrib.sessions',
-            'django.contrib.sites',
-            'django.contrib.messages',
-            'django.contrib.staticfiles',
-            'django.contrib.admin',
-
-            # ...
-            # `django-fobi` core
-            'fobi',
-
-            # `django-fobi` themes
-            'fobi.contrib.themes.bootstrap3', # Bootstrap 3 theme
-            'fobi.contrib.themes.foundation5', # Foundation 5 theme
-            'fobi.contrib.themes.simple', # Simple theme
-
-            # `django-fobi` form elements - fields
-            'fobi.contrib.plugins.form_elements.fields.boolean',
-            'fobi.contrib.plugins.form_elements.fields.checkbox_select_multiple',
-            'fobi.contrib.plugins.form_elements.fields.date',
-            'fobi.contrib.plugins.form_elements.fields.date_drop_down',
-            'fobi.contrib.plugins.form_elements.fields.datetime',
-            'fobi.contrib.plugins.form_elements.fields.decimal',
-            'fobi.contrib.plugins.form_elements.fields.email',
-            'fobi.contrib.plugins.form_elements.fields.file',
-            'fobi.contrib.plugins.form_elements.fields.float',
-            'fobi.contrib.plugins.form_elements.fields.hidden',
-            'fobi.contrib.plugins.form_elements.fields.input',
-            'fobi.contrib.plugins.form_elements.fields.integer',
-            'fobi.contrib.plugins.form_elements.fields.ip_address',
-            'fobi.contrib.plugins.form_elements.fields.null_boolean',
-            'fobi.contrib.plugins.form_elements.fields.password',
-            'fobi.contrib.plugins.form_elements.fields.radio',
-            'fobi.contrib.plugins.form_elements.fields.regex',
-            'fobi.contrib.plugins.form_elements.fields.select',
-            'fobi.contrib.plugins.form_elements.fields.select_model_object',
-            'fobi.contrib.plugins.form_elements.fields.select_multiple',
-            'fobi.contrib.plugins.form_elements.fields.select_multiple_model_objects',
-            'fobi.contrib.plugins.form_elements.fields.slug',
-            'fobi.contrib.plugins.form_elements.fields.text',
-            'fobi.contrib.plugins.form_elements.fields.textarea',
-            'fobi.contrib.plugins.form_elements.fields.time',
-            'fobi.contrib.plugins.form_elements.fields.url',
-
-            # `django-fobi` form elements - content elements
-            'fobi.contrib.plugins.form_elements.test.dummy',
-            'easy_thumbnails', # Required by `content_image` plugin
-            'fobi.contrib.plugins.form_elements.content.content_image',
-            'fobi.contrib.plugins.form_elements.content.content_image_url',
-            'fobi.contrib.plugins.form_elements.content.content_text',
-            'fobi.contrib.plugins.form_elements.content.content_video',
-
-            # `django-fobi` form handlers
-            'fobi.contrib.plugins.form_handlers.db_store',
-            'fobi.contrib.plugins.form_handlers.http_repost',
-            'fobi.contrib.plugins.form_handlers.mail',
-            'fobi.contrib.plugins.form_handlers.mail_sender',
-
-            # Other project specific apps
-            'foo', # Test app
-            # ...
-        )
-
-(3) Make appropriate changes to the ``TEMPLATES`` of the your projects'
-    Django settings.
-
-    And ``fobi.context_processors.theme`` and
-    ``fobi.context_processors.dynamic_values``. See the following example.
-
-    .. code-block:: python
-
-        TEMPLATES = [
-            {
-                'BACKEND': 'django.template.backends.django.DjangoTemplates',
-                'DIRS': [(os.path.join('path', 'to', 'your', 'templates'))],
-                'OPTIONS': {
-                    'context_processors': [
-                        "django.template.context_processors.debug",
-                        'django.template.context_processors.request',
-                        "django.contrib.auth.context_processors.auth",
-                        "django.contrib.messages.context_processors.messages",
-                        "fobi.context_processors.theme",  # Important!
-                        "fobi.context_processors.dynamic_values",  # Optional
-                    ],
-                    'loaders': [
-                        'django.template.loaders.filesystem.Loader',
-                        'django.template.loaders.app_directories.Loader',
-                        'admin_tools.template_loaders.Loader',
-                    ],
-                    'debug': DEBUG_TEMPLATE,
-                }
-            },
-        ]
-
-    Make sure that ``django.core.context_processors.request`` is in
-    ``context_processors`` too.
-
-(4) Configure URLs
-
-    Add the following line to urlpatterns of your `urls` module.
-
-    .. code-block:: python
-
-        # View URLs
-        url(r'^fobi/', include('fobi.urls.view')),
-
-        # Edit URLs
-        url(r'^fobi/', include('fobi.urls.edit')),
-
-    Note, that some plugins require additional URL includes. For instance, if
-    you listed the ``fobi.contrib.plugins.form_handlers.db_store`` form handler
-    plugin in the ``INSTALLED_APPS``, you should mention the following in
-    ``urls`` module.
-
-    .. code-block:: python
-
-        # DB Store plugin URLs
-        url(r'^fobi/plugins/form-handlers/db-store/',
-            include('fobi.contrib.plugins.form_handlers.db_store.urls')),
-
-View URLs are put separately from edit URLs in order to make it possible
-to prefix the edit URLs differently. For example, if you're using the
-"Simple" theme, you would likely want to prefix the edit URLs with "admin/"
-so that it looks more like django-admin.
-
-Creating a new form element plugin
-==================================
-Form element plugins represent the elements of which the forms is made:
-Inputs, checkboxes, textareas, files, hidden fields, as well as pure
-presentational elements (text or image). Number of form elements in a form
-is not limited.
-
-Presentational form elements are inherited from ``fobi.base.FormElementPlugin``.
-
-The rest (real form elements, that are supposed to have a value)
-are inherited from ``fobi.base.FormFieldPlugin``.
-
-You should see a form element plugin as a Django micro app, which could have
-its' own models, admin interface, etc.
-
-`django-fobi` comes with several bundled form element plugins. Do check the
-source code as example.
-
-Let's say, you want to create a textarea form element plugin.
-
-There are several properties, each textarea should have. They are:
-
-- `label` (string): HTML label of the textarea.
-- `name` (string): HTML name of the textarea.
-- `initial` (string): Initial value of the textarea.
-- `required` (bool): Flag, which tells us whether the field is required or
-  optional.
-
-Let's name that plugin ``sample_textarea``. The plugin directory should then
-have the following structure.
-
-.. code-block:: sh
-
-    path/to/sample_textarea/
-    ├── __init__.py
-    ├── fobi_form_elements.py # Where plugins are defined and registered
-    ├── forms.py # Plugin configuration form
-    └── widgets.py # Where plugins widgets are defined
-
-Form element plugins should be registered in "fobi_form_elements.py" file. Each
-plugin module should be put into the ``INSTALLED_APPS`` of your Django
-projects' settings.
-
-In some cases, you would need plugin specific overridable settings (see
-``fobi.contrib.form_elements.fields.content.content_image`` plugin as an
-example). You are advised to write your settings in such a way, that variables
-of your Django project settings module would have `FOBI_PLUGIN_` prefix.
-
-Define and register the form element plugin
--------------------------------------------
-Step by step review of a how to create and register a plugin and plugin
-widgets. Note, that `django-fobi` auto-discovers your plugins if you place
-them into a file named ``fobi_form_elements.py`` of any Django app listed in
-``INSTALLED_APPS`` of your Django projects' settings module.
-
-path/to/sample_textarea/fobi_form_elements.py
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-A single form element plugin is registered by its' UID.
-
-Required imports.
-
-.. code-block:: python
-
-    from django import forms
-    from fobi.base import FormFieldPlugin, form_element_plugin_registry
-    from path.to.sample_textarea.forms import SampleTextareaForm
-
-Defining the Sample textarea plugin.
-
-.. code-block:: python
-
-    class SampleTextareaPlugin(FormFieldPlugin):
-        """Sample textarea plugin."""
-
-        uid = "sample_textarea"
-        name = "Sample Textarea"
-        form = SampleTextareaForm
-        group = "Samples" # Group to which the plugin belongs to
-
-        def get_form_field_instances(self,
-                                     request=None,
-                                     form_entry=None,
-                                     form_element_entries=None,
-                                     **kwargs):
-            kwargs = {
-                'required': self.data.required,
-                'label': self.data.label,
-                'initial': self.data.initial,
-                'widget': forms.widgets.Textarea(attrs={})
-            }
-
-            return [(self.data.name, forms.CharField, kwargs),]
-
-Registering the ``SampleTextareaPlugin`` plugin.
-
-.. code-block:: python
-
-    form_element_plugin_registry.register(SampleTextareaPlugin)
-
-Note, that in case you want to define a pure presentational element, make use
-of ``fobi.base.FormElementPlugin`` for subclassing, instead of
-``fobi.base.FormFieldPlugin``.
-See the source of the content plugins
-(fobi.contrib.plugins.form_elements.content) as a an example.
-
-For instance, the ``captcha`` and ``honeypot`` fields are implemented
-as form elements (subclasses the ``fobi.base.FormElementPlugin``). The
-``db_store`` form handler plugin does not save the form data of
-those elements. If you want the form element data to be saved, do inherit
-from ``fobi.base.FormFieldPlugin``.
-
-Hidden form element plugins, should be also having set the ``is_hidden``
-property to True. By default it's set to False. That makes the hidden
-form elements to be rendered using as ``django.forms.widgets.TextInput``
-widget in edit mode. In the view mode, the original widget that you
-assigned in your form element plugin would be used.
-
-There might be cases, when you need to do additional handling of the data upon
-the successful form submission. In such cases, you will need to define a
-``submit_plugin_form_data`` method in the plugin, which accepts the
-following arguments:
-
-- `form_entry` (fobi.models.FormEntry): Form entry, which is being submitted.
-- `request` (django.http.HttpRequest): The Django HTTP request.
-- `form` (django.forms.Form): Form object (a valid one, which contains
-  the ``cleaned_data`` attribute).
-- `form_element_entries` (fobi.models.FormElementEntry): Form element entries
-  for the `form_entry` given.
-- (**)kwargs : Additional arguments.
-
-Example (taken from fobi.contrib.plugins.form_elements.fields.file):
-
-.. code-block:: python
-
-    def submit_plugin_form_data(self,
-                                form_entry,
-                                request,
-                                form,
-                                form_element_entries=None,
-                                **kwargs):
-        """Submit plugin form data."""
-        # Get the file path
-        file_path = form.cleaned_data.get(self.data.name, None)
-        if file_path:
-            # Handle the upload
-            saved_file = handle_uploaded_file(FILES_UPLOAD_DIR, file_path)
-            # Overwrite ``cleaned_data`` of the ``form`` with path to moved
-            # file.
-            form.cleaned_data[self.data.name] = "{0}{1}".format(
-                settings.MEDIA_URL, saved_file
-            )
-
-        # It's critically important to return the ``form`` with updated
-        # ``cleaned_data``
-        return form
-
-In the example below, the original form is being modified. If you don't want
-the original form to be modified, do not return anything.
-
-Check the file form element plugin
-(fobi.contrib.plugins.form_elements.fields.file) for complete example.
-
-path/to/sample_textarea/forms.py
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Why to have another file for defining forms? Just to keep the code clean and
-less messy, although you could perfectly define all your plugin forms in the
-module ``fobi_form_elements.py``, it's recommended to keep it separate.
-
-Take into consideration, that ``forms.py`` is not an auto-discovered file
-pattern. All your form element plugins should be registered in modules named
-``fobi_form_elements.py``.
-
-Required imports.
-
-.. code-block:: python
-
-    from django import forms
-    from fobi.base import BasePluginForm
-
-Form for for ``SampleTextareaPlugin`` form element plugin.
-
-.. code-block:: python
-
-    class SampleTextareaForm(forms.Form, BasePluginForm):
-        """Sample textarea form."""
-
-        plugin_data_fields = [
-            ("name", ""),
-            ("label", ""),
-            ("initial", ""),
-            ("required", False)
-        ]
-
-        name = forms.CharField(label="Name", required=True)
-        label = forms.CharField(label="Label", required=True)
-        initial = forms.CharField(label="Initial", required=False)
-        required = forms.BooleanField(label="Required", required=False)
-
-Note that although it's not being checked in the code, but for form
-field plugins the following fields should be present in the plugin
-form (``BasePluginForm``) and the form plugin (``FormFieldPlugin``):
-
-- name
-
-In some cases, you might want to do something with the data
-before it gets saved. For that purpose, ``save_plugin_data`` method
-has been introduced.
-
-See the following `example
-<https://github.com/barseghyanartur/django-fobi/blob/stable/src/fobi/contrib/plugins/form_elements/content/content_image/forms.py>`_.
-
-.. code-block:: python
-
-    def save_plugin_data(self, request=None):
-        """Saving the plugin data and moving the file."""
-        file_path = self.cleaned_data.get('file', None)
-        if file_path:
-            saved_image = handle_uploaded_file(IMAGES_UPLOAD_DIR, file_path)
-            self.cleaned_data['file'] = saved_image
-
-path/to/sample_textarea/widgets.py
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Required imports.
-
-.. code-block:: python
-
-    from fobi.base import FormElementPluginWidget
-
-Defining the base plugin widget.
-
-.. code-block:: python
-
-    class BaseSampleTextareaPluginWidget(FormElementPluginWidget):
-        """Base sample textarea plugin widget."""
-
-        # Same as ``uid`` value of the ``SampleTextareaPlugin``.
-        plugin_uid = "sample_textarea"
-
-path/to/sample_layout/fobi_form_elements.py
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Register in the registry (in some module which is for sure to be loaded; it's
-handy to do it in the theme module).
-
-Required imports.
-
-.. code-block:: python
-
-    from fobi.base import form_element_plugin_widget_registry
-    from path.to.sample_textarea.widgets import BaseSampleTextareaPluginWidget
-
-Define the theme specific plugin.
-
-.. code-block:: python
-
-    class SampleTextareaPluginWidget(BaseSampleTextareaPluginWidget):
-        """Sample textarea plugin widget."""
-
-        theme_uid = 'bootstrap3' # Theme for which the widget is loaded
-        media_js = [
-            'sample_layout/js/fobi.plugins.form_elements.sample_textarea.js',
-        ]
-        media_css = [
-            'sample_layout/css/fobi.plugins.form_elements.sample_textarea.css',
-        ]
-
-Register the widget.
-
-.. code-block:: python
-
-    form_element_plugin_widget_registry.register(SampleTextareaPluginWidget)
-
-Form element plugin final steps
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Now, that everything is ready, make sure your plugin module is added to
-``INSTALLED_APPS``.
-
-.. code-block:: python
-
-    INSTALLED_APPS = (
-        # ...
-        'path.to.sample_textarea',
-        # ...
-    )
-
-Afterwards, go to terminal and type the following command.
-
-.. code-block:: sh
-
-    ./manage.py fobi_sync_plugins
-
-If your HTTP server is running, you would then be able to see the new plugin
-in the edit form interface.
-
-Dashboard URL: http://127.0.0.1:8000/fobi/
-
-Note, that you have to be logged in, in order to use the dashboard. If your
-new plugin doesn't appear, set the ``FOBI_DEBUG`` to True in your Django's
-local settings module, re-run your code and check console for error
-notifications.
-
-Creating a new form handler plugin
-==================================
-Form handler plugins handle the form data. `django-fobi` comes with several
-bundled form handler plugins, among which is the ``db_store`` and ``mail``
-plugins, which are responsible for saving the submitted form data into the
-database and mailing the data to recipients specified. Number of form handlers
-in a form is not limited. Certain form handlers are not configurable (for
-example the ``db_store`` form handler isn't), while others are (``mail``,
-``http_repost``).
-
-You should see a form handler as a Django micro app, which could have its' own
-models, admin interface, etc.
-
-By default, it's possible to use a form handler plugin multiple times per form.
-If you wish to allow form handler plugin to be used only once in a form,
-set the ``allow_multiple`` property of the plugin to False.
-
-As said above, `django-fobi` comes with several bundled form handler plugins.
-Do check the source code as example.
-
-Define and register the form handler plugin
--------------------------------------------
-Let's name that plugin ``sample_mail``. The plugin directory should then have
-the following structure.
-
-.. code-block:: text
-
-    path/to/sample_mail/
-    ├── __init__.py
-    ├── fobi_form_handlers.py  # Where plugins are defined and registered
-    └── forms.py  # Plugin configuration form
-
-Form handler plugins should be registered in "fobi_form_handlers.py" file.
-Each plugin module should be put into the ``INSTALLED_APPS`` of your Django
-projects' settings.
-
-path/to/sample_mail/fobi_form_handlers.py
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-A single form handler plugin is registered by its' UID.
-
-Required imports.
-
-.. code-block:: python
-
-    import json
-    from django.core.mail import send_mail
-    from fobi.base import FormHandlerPlugin, form_handler_plugin_registry
-    from path.to.sample_mail.forms import SampleMailForm
-
-Defining the Sample mail handler plugin.
-
-.. code-block:: python
-
-    class SampleMailHandlerPlugin(FormHandlerPlugin):
-        """Sample mail handler plugin."""
-
-        uid = "sample_mail"
-        name = _("Sample mail")
-        form = SampleMailForm
-
-        def run(self, form_entry, request, form, form_element_entries=None):
-            """To be executed by handler."""
-            send_mail(
-                self.data.subject,
-                json.dumps(form.cleaned_data),
-                self.data.from_email,
-                [self.data.to_email],
-                fail_silently=True
-            )
-
-Register the plugin
-
-.. code-block:: python
-
-    form_handler_plugin_registry.register(SampleMailHandlerPlugin)
-
-Some form handlers are configurable, some others not. In order to
-have a user friendly way of showing the form handler settings, what's
-sometimes needed, a ``plugin_data_repr`` method has been introduced.
-Simplest implementation of it would look as follows:
-
-.. code-block:: python
-
-    def plugin_data_repr(self):
-        """Human readable representation of plugin data.
-
-        :return string:
-        """
-        return self.data.__dict__
-
-path/to/sample_mail/forms.py
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-If plugin is configurable, it has configuration data. A single form may have
-unlimited number of same plugins. Imagine, you want to have different subjects
-and additional body texts for different user groups. You could then assign two
-form handler ``mail`` plugins to the form. Of course, saving the posted form
-data many times does not make sense, but it's up to the user. So, in case if
-plugin is configurable, it should have a form.
-
-Why to have another file for defining forms? Just to keep the code clean and
-less messy, although you could perfectly define all your plugin forms in the
-module ``fobi_form_handlers.py``, it's recommended to keep it separate.
-
-Take into consideration, that ``forms.py`` is not an auto-discovered file
-pattern. All your form handler plugins should be registered in modules named
-``fobi_form_handlers.py``.
-
-Required imports.
-
-.. code-block:: python
-
-    from django import forms
-    from django.utils.translation import ugettext_lazy as _
-    from fobi.base import BasePluginForm
-
-Defining the form for Sample mail handler plugin.
-
-.. code-block:: python
-
-    class MailForm(forms.Form, BasePluginForm):
-        """Mail form."""
-
-        plugin_data_fields = [
-            ("from_name", ""),
-            ("from_email", ""),
-            ("to_name", ""),
-            ("to_email", ""),
-            ("subject", ""),
-            ("body", ""),
-        ]
-
-        from_name = forms.CharField(label=_("From name"), required=True)
-        from_email = forms.EmailField(label=_("From email"), required=True)
-        to_name = forms.CharField(label=_("To name"), required=True)
-        to_email = forms.EmailField(label=_("To email"), required=True)
-        subject = forms.CharField(label=_("Subject"), required=True)
-        body = forms.CharField(
-            label=_("Body"),
-            required=False,
-            widget=forms.widgets.Textarea
-        )
-
-After the plugin has been processed, all its' data is available in a
-``plugin_instance.data`` container (for example,
-``plugin_instance.data.subject`` or ``plugin_instance.data.from_name``).
-
-Prioritise the execution order
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Some form handlers shall be executed prior others. A good example of such, is
-a combination of "mail" and "db_save" form handlers for the form. In case if
-large files are posted, submission of form data would fail if "mail" plugin
-would be executed after "db_save" has been executed. That's why it's possible
-to prioritise that ordering in a ``FOBI_FORM_HANDLER_PLUGINS_EXECUTION_ORDER``
-setting variable.
-
-If not specified or left empty, form handler plugins would be ran in the order
-of discovery. All form handler plugins that are not listed in the
-``FORM_HANDLER_PLUGINS_EXECUTION_ORDER``, would be ran after the plugins that
-are mentioned there.
-
-.. code-block:: python
-
-    FORM_HANDLER_PLUGINS_EXECUTION_ORDER = (
-        'http_repost',
-        'mail',
-        # The 'db_store' is left out intentionally, since it should
-        # be the last plugin to be executed.
-    )
-
-Form handler plugin custom actions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-By default, a single form handler plugin has at least a "delete" action.
-If plugin is configurable, it gets an "edit" action as well.
-
-For some of your plugins, you may want to register a custom action. For
-example, the "db_store" plugin does have one, for showing a link to
-a listing page with saved form data for the form given.
-
-For such cases, define a ``custom_actions`` method in your form handler
-plugin. That method shall return a list of triples. In each triple,
-first value is the URL, second value is the title and the third value
-is the icon of the URL.
-
-The following example is taken from the "db_store" plugin.
-
-.. code-block:: python
-
-    def custom_actions(self):
-        """Adding a link to view the saved form entries.
-
-        :return iterable:
-        """
-        return (
-            (
-                reverse('fobi.contrib.plugins.form_handlers.db_store.view_saved_form_data_entries'),
-                _("View entries"),
-                'glyphicon glyphicon-list'
-            ),
-        )
-
-Form handler plugin final steps
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Do not forget to add the form handler plugin module to ``INSTALLED_APPS``.
-
-.. code-block:: python
-
-    INSTALLED_APPS = (
-        # ...
-        'path.to.sample_mail',
-        # ...
-    )
-
-Afterwards, go to terminal and type the following command.
-
-.. code-block:: sh
-
-    ./manage.py fobi_sync_plugins
-
-If your HTTP server is running, you would then be able to see the new plugin
-in the edit form interface.
-
-Creating a new form importer plugin
-===================================
-Form importer plugins import the forms from some external data source into
-`django-fobi` form format. Number of form importers is not limited. Form
-importers are implemented in forms of wizards (since they may contain several
-steps).
-
-You should see a form importer as a Django micro app, which could have its' own
-models, admin interface, etc.
-
-At the moment `django-fobi` comes with only one bundled form handler plugin,
-which is the ``mailchimp_importer``, which is responsible for importing
-existing MailChimp forms into `django-fobi`.
-
-Define and register the form importer plugin
---------------------------------------------
-Let's name that plugin ``sample_importer``. The plugin directory should then
-have the following structure.
-
-.. code-block:: text
-
-    path/to/sample_importer/
-    ├── templates
-    │   └── sample_importer
-    │       ├── 0.html
-    │       └── 1.html
-    ├── __init__.py
-    ├── fobi_form_importers.py # Where plugins are defined and registered
-    ├── forms.py # Wizard forms
-    └── views.py # Wizard views
-
-Form importer plugins should be registered in "fobi_form_importers.py" file.
-Each plugin module should be put into the ``INSTALLED_APPS`` of your Django
-projects' settings.
-
-path/to/sample_importer/fobi_form_importers.py
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-A single form importer plugin is registered by its' UID.
-
-Required imports.
-
-.. code-block:: python
-
-    from django.utils.translation import ugettext_lazy as _
-    from fobi.form_importers import BaseFormImporter, form_importer_plugin_registry
-    from fobi.contrib.plugins.form_elements import fields
-    from path.to.sample_importer.views import SampleImporterWizardView
-
-Defining the Sample importer plugin.
-
-.. code-block:: python
-
-    class SampleImporterPlugin(FormHandlerPlugin):
-        """Sample importer plugin."""
-
-        uid = 'sample_importer'
-        name = _("Sample importer")
-        wizard = SampleImporterWizardView
-        templates = [
-            'sample_importer/0.html',
-            'sample_importer/1.html',
-        ]
-
-        # field_type (at importer): uid (django-fobi)
-        fields_mapping = {
-            # Implemented
-            'email': fields.email.UID,
-            'text': fields.text.UID,
-            'number': fields.integer.UID,
-            'dropdown': fields.select.UID,
-            'date': fields.date.UID,
-            'url': fields.url.UID,
-            'radio': fields.radio.UID,
-
-            # Transformed into something else
-            'address': fields.text.UID,
-            'zip': fields.text.UID,
-            'phone': fields.text.UID,
-        }
-
-        # Django standard: remote
-        field_properties_mapping = {
-            'label': 'name',
-            'name': 'tag',
-            'help_text': 'helptext',
-            'initial': 'default',
-            'required': 'req',
-            'choices': 'choices',
-        }
-
-        field_type_prop_name = 'field_type'
-        position_prop_name = 'order'
-
-        def extract_field_properties(self, field_data):
-            field_properties = {}
-            for prop, val in self.field_properties_mapping.items():
-                if val in field_data:
-                    if 'choices' == val:
-                        field_properties[prop] = "\n".join(field_data[val])
-                    else:
-                        field_properties[prop] = field_data[val]
-            return field_properties
-
-
-    form_importer_plugin_registry.register(SampleImporter)
-
-path/to/sample_importer/forms.py
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-As mentioned above, form importers are implemented in form of wizards. The
-forms are the wizard steps.
-
-Required imports.
-
-.. code-block:: python
-
-    from django import forms
-    from django.utils.translation import ugettext_lazy as _
-    from sample_service_api import sample_api  # Just an imaginary API client
-
-Defining the form for Sample importer plugin.
-
-.. code-block:: python
-
-    class SampleImporterStep1Form(forms.Form):
-        """First form the the wizard."""
-
-        api_key = forms.CharField(required=True)
-
-
-    class SampleImporterStep2Form(forms.Form):
-        """Second form of the wizard."""
-
-        list_id = forms.ChoiceField(required=True, choices=[])
-
-        def __init__(self, *args, **kwargs):
-            self._api_key = None
-
-            if 'api_key' in kwargs:
-                self._api_key = kwargs.pop('api_key', None)
-
-            super(SampleImporterStep2Form, self).__init__(*args, **kwargs)
-
-            if self._api_key:
-                client = sample_api.Api(self._api_key)
-                lists = client.lists.list()
-                choices = [(l['id'], l['name']) for l in lists['data']]
-                self.fields['list_id'].choices = choices
-
-path/to/sample_importer/views.py
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The wizard views.
-
-Required imports.
-
-.. code-block:: python
-
-    from sample_service_api import sample_api  # Just an imaginary API client
-
-    from django.shortcuts import redirect
-    from django.core.urlresolvers import reverse
-    from django.contrib import messages
-    from django.utils.translation import ugettext_lazy as _
-
-    # For django LTE 1.8 import from `django.contrib.formtools.wizard.views`
-    from formtools.wizard.views import SessionWizardView
-
-    from path.to.sample_importer.forms import (
-        SampleImporterStep1Form,
-        SampleImporterStep2Form,
-    )
-
-Defining the wizard view for Sample importer plugin.
-
-.. code-block:: python
-
-    class SampleImporterWizardView(SessionWizardView):
-        """Sample importer wizard view."""
-
-        form_list = [SampleImporterStep1Form, SampleImporterStep2Form]
-
-        def get_form_kwargs(self, step):
-            """Get form kwargs (to be used internally)."""
-            if '1' == step:
-                data = self.get_cleaned_data_for_step('0') or {}
-                api_key = data.get('api_key', None)
-                return {'api_key': api_key}
-            return {}
-
-        def done(self, form_list, **kwargs):
-            """After all forms are submitted."""
-            # Merging cleaned data into one dict
-            cleaned_data = {}
-            for form in form_list:
-                cleaned_data.update(form.cleaned_data)
-
-            # Connecting to sample client API
-            client = sample_client.Api(cleaned_data['api_key'])
-
-            # Fetching the form data
-            form_data = client.lists.merge_vars(
-                id={'list_id': cleaned_data['list_id']}
-            )
-
-            # We need the first form only
-            try:
-                form_data = form_data['data'][0]
-            except Exception as err:
-                messages.warning(
-                    self.request,
-                    _('Selected form could not be imported due errors.')
-                )
-                return redirect(reverse('fobi.dashboard'))
-
-            # Actually, import the form
-            form_entry = self._form_importer.import_data(
-                {'name': form_data['name'], 'user': self.request.user},
-                form_data['merge_vars']
-            )
-
-            redirect_url = reverse(
-                'fobi.edit_form_entry',
-                kwargs={'form_entry_id': form_entry.pk}
-            )
-
-            messages.info(
-                self.request,
-                _('Form {0} imported successfully.').format(form_data['name'])
-            )
-
-            return redirect("{0}".format(redirect_url))
-
-Form importer plugin final steps
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Do not forget to add the form importer plugin module to ``INSTALLED_APPS``.
-
-.. code-block:: python
-
-    INSTALLED_APPS = (
-        # ...
-        'path.to.sample_importer',
-        # ...
-    )
-
-Afterwards, go to terminal and type the following command.
-
-.. code-block:: sh
-
-    ./manage.py fobi_sync_plugins
-
-If your HTTP server is running, you would then be able to see the new plugin
-in the dashboard form interface (implemented in all bundled themes).
-
-Creating a form callback
-========================
-Form callbacks are additional hooks, that are executed on various stages of
-the form submission.
-
-Let's place the callback in the ``foo`` module. The plugin directory should
-then have the following structure.
-
-.. code-block:: text
-
-    path/to/foo/
-    ├── __init__.py
-    └── fobi_form_callbacks.py # Where callbacks are defined and registered
-
-See the callback example below.
-
-Required imports.
-
-.. code-block:: python
-
-    from fobi.constants import (
-        CALLBACK_BEFORE_FORM_VALIDATION,
-        CALLBACK_FORM_VALID_BEFORE_SUBMIT_PLUGIN_FORM_DATA,
-        CALLBACK_FORM_VALID, CALLBACK_FORM_VALID_AFTER_FORM_HANDLERS,
-        CALLBACK_FORM_INVALID
-    )
-    from fobi.base import FormCallback, form_callback_registry
-
-Define and register the callback
-
-.. code-block:: python
-
-    class SampleFooCallback(FormCallback):
-        """Sample foo callback."""
-
-        stage = CALLBACK_FORM_VALID
-
-        def callback(self, form_entry, request, form):
-            """Define your callback code here."""
-            print("Great! Your form is valid!")
-
-    form_callback_registry.register(SampleFooCallback)
-
-Add the callback module to ``INSTALLED_APPS``.
-
-.. code-block:: python
-
-    INSTALLED_APPS = (
-        # ...
-        'path.to.foo',
-        # ...
-    )
-
-Class-based views
-=================
-Views
------
-Migration to class based views is simple. Only your project's ``urls.py``
-would change:
-
-.. code-block:: python
-
-    urlpatterns = [
-        # ...
-        url(r'^fobi/', include('fobi.urls.class_based.view')),
-        url(r'^fobi/', include('fobi.urls.class_based.edit')),
-        # ...
-    ]
-
-To use function based views, simply replace the previous line with:
-
-.. code-block:: python
-
-    urlpatterns = [
-        # ...
-        url(r'^fobi/', include('fobi.urls.view')),
-        url(r'^fobi/', include('fobi.urls.edit')),
-        # ...
-    ]
-
-Permissions
------------
-
-Class-based permissions work only in combination with class-based views.
-
-Example:
-
-.. code-block:: python
-
-    from fobi.permissions.definitions import edit_form_entry_permissions
-    from fobi.permissions.generic import BasePermission
-    from fobi.permissions.helpers import (
-      any_permission_required_func, login_required,
-    )
-
-    class EditFormEntryPermission(BasePermission):
-    """Permission to edit form entries."""
-
-    def has_permission(self, request, view) -> bool:
-      return login_required(request) and any_permission_required_func(
-          edit_form_entry_permissions
-      )(request.user)
-
-    def has_object_permission(self, request, view, obj) -> bool:
-      return login_required(request) and any_permission_required_func(
-          edit_form_entry_permissions
-      )(request.user) and obj.user == request.user
-
-Suggestions
-===========
-Custom action for the form
---------------------------
-Sometimes, you would want to specify a different action for the form.
-Although it's possible to define a custom form action (``action`` field
-in the "Form properties" tab), you're advised to use the ``http_repost``
-plugin instead, since then the form would be still validated locally
-and only then the valid data, as is, would be sent to the desired
-endpoint.
-
-Take in mind, that if both cases, if CSRF protection is enabled on
-the endpoint, your post request would result an error.
-
-When you want to customise too many things
-------------------------------------------
-`django-fobi`, with its' flexible form elements, form handlers and form
-callbacks is very customisable. However, there might be cases when you need to
-override entire view to fit your needs. Take a look at the
-`FeinCMS integration
-<https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/apps/feincms_integration/widgets.py>`_
-or `DjangoCMS integration
-<https://github.com/barseghyanartur/django-fobi/blob/stable/src/fobi/contrib/apps/djangocms_integration/cms_plugins.py>`_
-as a good example of such. You may also want to compare the code from original
-view ``fobi.views.view_form_entry`` with the code from the widget to get a
-better idea of what could be changed in your case. If need a good advice,
-just ask me.
-
-Theming
-=======
-`django-fobi` comes with theming API. While there are several ready-to-use
-themes:
-
-- "Bootstrap 3" theme
-- "Foundation 5" theme
-- "Simple" theme in (with editing interface in style of the Django admin)
-- "DjangoCMS admin style" theme (which is another simple theme with editing
-  interface in style of ``djangocms-admin-style``)
-
-Obviously, there are two sorts of views when it comes to editing and viewing
-the form.
-
-- The "view-view", when the form as it has been made is exposed to the
-  site end- users/visitors.
-- The "edit-view" (builder view), where the authorised users build their forms.
-
-Both "Bootstrap 3" and "Foundation 5" themes are making use of the same style
-for both "view-view" and "edit-view" views.
-
-Both "Simple" and "DjangoCMS admin style" themes are styling for the
-"edit-view" only. The "view-view" is pretty much blank, as shown on the one
-of the screenshots [2.6]_.
-
-Have in mind, that creating a brand new theme could be time consuming.
-Instead, you are advised to extend existing themes or in the worst case,
-if too much customisation required, create your own themes based on
-existing ones (just copy the desired theme to your project directory and
-work it out further).
-
-It's possible to use different templates for all "view" and "edit"
-actions (see the source code of the "simple" theme). Both "Bootstrap 3" and
-"Foundation 5" themes look great. Although if you can't use any of those,
-the "Simple" theme is the best start, since it looks just like django-admin.
-
-Create a new theme
-------------------
-
-Let's place the theme in the ``sample_theme`` module. The theme directory
-should then have the following structure.
-
-.. code-block:: text
-
-    path/to/sample_theme/
-    ├── static
-    │   ├── css
-    │   │   └── sample_theme.css
-    │   └── js
-    │       └── sample_theme.js
-    ├── templates
-    │   └── sample_theme
-    │       ├── _base.html
-    │       ├── add_form_element_entry.html
-    │       ├── ...
-    │       └── view_form_entry_ajax.html
-    ├── __init__.py
-    ├── fobi_form_elements.py
-    └── fobi_themes.py # Where themes are defined and registered
-
-See the theme example below.
-
-.. code-block:: python
-
-    from django.utils.translation import ugettext_lazy as _
-
-    from fobi.base import BaseTheme, theme_registry
-
-    class SampleTheme(BaseTheme):
-        """Sample theme."""
-
-        uid = 'sample'
-        name = _("Sample")
-
-        media_css = (
-            'sample_theme/css/sample_theme.css',
-            'css/fobi.core.css',
-        )
-
-        media_js = (
-            'js/jquery-1.10.2.min.js',
-            'jquery-ui/js/jquery-ui-1.10.3.custom.min.js',
-            'js/jquery.slugify.js',
-            'js/fobi.core.js',
-            'sample_theme/js/sample_theme.js',
-        )
-
-        # Form element specific
-        form_element_html_class = 'form-control'
-        form_radio_element_html_class = 'radio'
-        form_element_checkbox_html_class = 'checkbox'
-
-        form_edit_form_entry_option_class = 'glyphicon glyphicon-edit'
-        form_delete_form_entry_option_class = 'glyphicon glyphicon-remove'
-        form_list_container_class = 'list-inline'
-
-        # Templates
-        master_base_template = 'sample_theme/_base.html'
-        base_template = 'sample_theme/base.html'
-
-        form_ajax = 'sample_theme/snippets/form_ajax.html'
-        form_snippet_template_name = 'sample_theme/snippets/form_snippet.html'
-        form_properties_snippet_template_name = 'sample_theme/snippets/form_properties_snippet.html'
-        messages_snippet_template_name = 'sample_theme/snippets/messages_snippet.html'
-
-        add_form_element_entry_template = 'sample_theme/add_form_element_entry.html'
-        add_form_element_entry_ajax_template = 'sample_theme/add_form_element_entry_ajax.html'
-
-        add_form_handler_entry_template = 'sample_theme/add_form_handler_entry.html'
-        add_form_handler_entry_ajax_template = 'sample_theme/add_form_handler_entry_ajax.html'
-
-        create_form_entry_template = 'sample_theme/create_form_entry.html'
-        create_form_entry_ajax_template = 'bootstrap3/create_form_entry_ajax.html'
-
-        dashboard_template = 'sample_theme/dashboard.html'
-
-        edit_form_element_entry_template = 'sample_theme/edit_form_element_entry.html'
-        edit_form_element_entry_ajax_template = 'sample_theme/edit_form_element_entry_ajax.html'
-
-        edit_form_entry_template = 'sample_theme/edit_form_entry.html'
-        edit_form_entry_ajax_template = 'sample_theme/edit_form_entry_ajax.html'
-
-        edit_form_handler_entry_template = 'sample_theme/edit_form_handler_entry.html'
-        edit_form_handler_entry_ajax_template = 'sample_theme/edit_form_handler_entry_ajax.html'
-
-        form_entry_submitted_template = 'sample_theme/form_entry_submitted.html'
-        form_entry_submitted_ajax_template = 'sample_theme/form_entry_submitted_ajax.html'
-
-        view_form_entry_template = 'sample_theme/view_form_entry.html'
-        view_form_entry_ajax_template = 'sample_theme/view_form_entry_ajax.html'
-
-Registering the ``SampleTheme`` plugin.
-
-.. code-block:: python
-
-    theme_registry.register(SampleTheme)
-
-Sometimes you would want to attach additional properties to the theme
-in order to use them later in templates (remember, current theme object
-is always available in templates under name ``fobi_theme``).
-
-For such cases you would need to define a variable in your project's settings
-module, called ``FOBI_CUSTOM_THEME_DATA``. See the following code as example:
-
-.. code-block:: python
-
-    # `django-fobi` custom theme data for to be displayed in third party apps
-    # like `django-registraton`.
-    FOBI_CUSTOM_THEME_DATA = {
-        'bootstrap3': {
-            'page_header_html_class': '',
-            'form_html_class': 'form-horizontal',
-            'form_button_outer_wrapper_html_class': 'control-group',
-            'form_button_wrapper_html_class': 'controls',
-            'form_button_html_class': 'btn',
-            'form_primary_button_html_class': 'btn-primary pull-right',
-        },
-        'foundation5': {
-            'page_header_html_class': '',
-            'form_html_class': 'form-horizontal',
-            'form_button_outer_wrapper_html_class': 'control-group',
-            'form_button_wrapper_html_class': 'controls',
-            'form_button_html_class': 'radius button',
-            'form_primary_button_html_class': 'btn-primary',
-        },
-        'simple': {
-            'page_header_html_class': '',
-            'form_html_class': 'form-horizontal',
-            'form_button_outer_wrapper_html_class': 'control-group',
-            'form_button_wrapper_html_class': 'submit-row',
-            'form_button_html_class': 'btn',
-            'form_primary_button_html_class': 'btn-primary',
-        }
-    }
-
-You would now be able to access the defined extra properties in templates
-as shown below.
-
-.. code-block:: html
-
-    <div class="{{ fobi_theme.custom_data.form_button_wrapper_html_class }}">
-
-You likely would want to either remove the footer text or change it. Define
-a variable in your project's settings module, called ``FOBI_THEME_FOOTER_TEXT``.
-See the following code as example:
-
-.. code-block:: python
-
-    FOBI_THEME_FOOTER_TEXT = gettext('&copy; django-fobi example site 2014')
-
-Below follow the properties of the theme:
-
-- ``base_edit``
-- ``base_view``
-
-There are generic templates made in order to simplify theming. Some
-of them you would never need to override. Some others, you would likely
-want to.
-
-Templates that you likely would want to re-write in your custom
-theme implementation are marked with three asterisks (\*\*\*):
-
-.. code-block:: text
-
-    generic
-    ├── snippets
-    │   ├── form_ajax.html
-    │   ├── form_edit_ajax.html
-    │   ├── *** form_properties_snippet.html
-    │   ├── *** form_snippet.html
-    │   ├── --- form_edit_snippet.html (does not exist in generic templates)
-    │   ├── --- form_view_snippet.html (does not exist in generic templates)
-    │   ├── form_view_ajax.html
-    │   └── messages_snippet.html
-    │
-    ├── _base.html
-    ├── add_form_element_entry.html
-    ├── add_form_element_entry_ajax.html
-    ├── add_form_handler_entry.html
-    ├── add_form_handler_entry_ajax.html
-    ├── base.html
-    ├── create_form_entry.html
-    ├── create_form_entry_ajax.html
-    ├── *** dashboard.html
-    ├── edit_form_element_entry.html
-    ├── edit_form_element_entry_ajax.html
-    ├── edit_form_entry.html
-    ├── *** edit_form_entry_ajax.html
-    ├── edit_form_handler_entry.html
-    ├── edit_form_handler_entry_ajax.html
-    ├── form_entry_submitted.html
-    ├── *** form_entry_submitted_ajax.html
-    ├── *** theme.html
-    ├── view_form_entry.html
-    └── view_form_entry_ajax.html
-
-From all of the templates listed above, the _base.html template is
-the most influenced by the Bootstrap 3 theme.
-
-Make changes to an existing theme
----------------------------------
-As said above, making your own theme from scratch could be costly. Instead,
-you can override/reuse an existing one and change it to your needs with
-minimal efforts. See the `override simple theme
-<https://github.com/barseghyanartur/django-fobi/tree/master/examples/simple/override_simple_theme/>`_
-example. In order to see it in action, run the project with
-`settings_override_simple_theme
-<https://github.com/barseghyanartur/django-fobi/blob/master/examples/simple/settings_override_simple_theme.py>`_
-option:
-
-.. code-block:: sh
-
-    ./manage.py runserver --settings=settings_override_simple_theme
-
-Details explained below.
-
-Directory structure
-~~~~~~~~~~~~~~~~~~~
-.. code-block:: text
-
-    override_simple_theme/
-    ├── static
-    │   └── override_simple_theme
-    │       ├── css
-    │       │   └── override-simple-theme.css
-    │       └── js
-    │           └── override-simple-theme.js
-    │
-    ├── templates
-    │   └── override_simple_theme
-    │       ├── snippets
-    │       │   └── form_ajax.html
-    │       └── base_view.html
-    ├── __init__.py
-    └── fobi_themes.py # Where themes are defined and registered
-
-fobi_themes.py
-~~~~~~~~~~~~~~
-Overriding the "simple" theme.
-
-.. code-block:: python
-
-    __all__ = ('MySimpleTheme',)
-
-    from fobi.base import theme_registry
-
-    from fobi.contrib.themes.simple.fobi_themes import SimpleTheme
-
-    class MySimpleTheme(SimpleTheme):
-        """My simple theme, inherited from `SimpleTheme` theme."""
-
-        html_classes = ['my-simple-theme',]
-        base_view_template = 'override_simple_theme/base_view.html'
-        form_ajax = 'override_simple_theme/snippets/form_ajax.html'
-
-Register the overridden theme. Note, that it's important to set the `force`
-argument to True, in order to override the original theme. Force can be
-applied only once (for an overridden element).
-
-.. code-block:: python
-
-    theme_registry.register(MySimpleTheme, force=True)
-
-templates/override_simple_theme/base_view.html
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.. code-block:: html
-
-    {% extends "simple/base_view.html" %}
-
-    {% load static %}
-
-    {% block stylesheets %}
-    <link
-      href="{% static 'override_simple_theme/css/override-simple-theme.css' %}"
-      rel="stylesheet" media="all" />
-    {% endblock stylesheets %}
-
-    {% block main-wrapper %}
-    <div id="sidebar">
-      <h2>It's easy to override a theme!</h2>
-    </div>
-
-    {{ block.super }}
-    {% endblock main-wrapper %}
-
-templates/override_simple_theme/snippets/form_ajax.html
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.. code-block:: html
-
-    {% extends "fobi/generic/snippets/form_ajax.html" %}
-
-    {% block form_html_class %}basic-grey{% endblock %}
-
-Form wizards
-============
-Basics
-------
-With form wizards you can split forms across multiple pages. State is
-maintained in one of the backends (at the moment the Session backend). Data
-processing is delayed until the submission of the final form.
-
-In `django-fobi` wizards work in the following way:
-
-- Number of forms in a form wizard is not limited.
-- Form callbacks, handlers are totally ignored in form wizards. Instead,
-  the form-wizard specific handlers (form wizard handlers) take over handling
-  of the form data on the final step.
-
-Bundled form wizard handler plugins
------------------------------------
-Below a short overview of the form wizard handler plugins. See the
-README.rst file in directory of each plugin for details.
-
-- `DB store
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_handlers/db_store/>`__:
-  Stores form data in a database.
-- `HTTP repost
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_handlers/http_repost/>`__:
-  Repost the POST request to another endpoint.
-- `Mail
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_handlers/mail/>`__:
-  Send the form data by email.
-- `Mail the sender
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_handlers/mail_sender/>`__:
-  Send the form data by email to the sender (submitter) of the form.
-
-Integration with third-party apps and frameworks
-================================================
-`django-fobi` has been successfully integrated into a number of diverse
-third-party apps and frameworks, such as: Django REST framework, Django CMS,
-FeinCMS, Mezzanine and Wagtail.
-
-Certainly, integration into CMS is one case, integration into REST framework -
-totally another. In REST frameworks we no longer have forms as such. Context
-is very different. Handling of form data should obviously happen in a
-different way. Assembling of the form class isn't enough (in case of Django
-REST framework we assemble the serializer class).
-
-In order to handle such level of integration, two additional sort of plugins
-have been introduced:
-
-- IntegrationFormElementPlugin
-- IntegrationFormHandlerPlugin
-
-These plugins are in charge of representation of the form elements in a
-proper way for the package to be integrated and handling the submitted form
-data.
-
-`Additional documentation
-<https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/apps/drf_integration/>`_
-is available in the sub-package.
-
-Sample `IntegrationFormElementPlugin`
--------------------------------------
-Sample is taken from `here
-<https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/apps/drf_integration/form_elements/fields/email/>`__.
-
-base.py
-~~~~~~~
-Define the form element plugin.
-
-.. code-block:: python
-
-    from django.utils.translation import ugettext_lazy as _
-
-    from rest_framework.fields import EmailField
-
-    from fobi.base import IntegrationFormFieldPlugin
-    from fobi.contrib.apps.drf_integration import UID as INTEGRATE_WITH_UID
-    from fobi.contrib.apps.drf_integration.base import (
-        DRFIntegrationFormElementPluginProcessor,
-        DRFSubmitPluginFormDataMixin,
-    )
-    from fobi.contrib.apps.drf_integration.form_elements.fields.email import UID
-
-
-    class EmailInputPlugin(IntegrationFormFieldPlugin,
-                           DRFSubmitPluginFormDataMixin):
-        """EmailField plugin."""
-
-        uid = UID
-        integrate_with = INTEGRATE_WITH_UID
-        name = _("Decimal")
-        group = _("Fields")
-
-        def get_custom_field_instances(self,
-                                       form_element_plugin,
-                                       request=None,
-                                       form_entry=None,
-                                       form_element_entries=None,
-                                       **kwargs):
-            """Get form field instances."""
-            field_kwargs = {
-                'required': form_element_plugin.data.required,
-                'initial': form_element_plugin.data.initial,
-                'label': form_element_plugin.data.label,
-                'help_text': form_element_plugin.data.help_text,
-                'max_length': form_element_plugin.data.max_length,
-            }
-            return [
-                DRFIntegrationFormElementPluginProcessor(
-                    field_class=EmailField,
-                    field_kwargs=field_kwargs
-                )
-            ]
-
-fobi_integration_form_elements.py
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Register the plugin. Note the name pattern `fobi_integration_form_elements`.
-
-.. code-block:: python
-
-    from fobi.base import integration_form_element_plugin_registry
-    from .base import EmailInputPlugin
-
-    integration_form_element_plugin_registry.register(EmailInputPlugin)
-
-Don't forget to list your plugin in the ``INSTALLED_APPS`` afterwards.
-
-Sample `IntegrationFormHandlerPlugin`
--------------------------------------
-Sample is taken from `here
-<https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/apps/drf_integration/form_handlers/db_store/>`__.
-
-base.py
-~~~~~~~
-Define the form handler plugin.
-
-.. code-block:: python
-
-    import logging
-    from mimetypes import guess_type
-    import os
-
-    from django.conf import settings
-    from django.utils.translation import ugettext_lazy as _
-
-    from fobi.base import IntegrationFormHandlerPlugin
-    from fobi.helpers import extract_file_path
-
-    from fobi.contrib.apps.drf_integration import UID as INTEGRATE_WITH_UID
-    from fobi.contrib.apps.drf_integration.base import get_processed_serializer_data
-
-    from . import UID
-
-
-    class MailHandlerPlugin(IntegrationFormHandlerPlugin):
-        """Mail handler form handler plugin.
-
-        Can be used only once per form.
-        """
-
-        uid = UID
-        name = _("Mail")
-        integrate_with = INTEGRATE_WITH_UID
-
-        def run(self,
-                form_handler_plugin,
-                form_entry,
-                request,
-                form_element_entries=None,
-                **kwargs):
-            """Run."""
-            base_url = form_handler_plugin.get_base_url(request)
-
-            serializer = kwargs['serializer']
-
-            # Clean up the values, leave our content fields and empty values.
-            field_name_to_label_map, cleaned_data = get_processed_serializer_data(
-                serializer,
-                form_element_entries
-            )
-
-            rendered_data = form_handler_plugin.get_rendered_data(
-                serializer.validated_data,
-                field_name_to_label_map,
-                base_url
-            )
-
-            files = self._prepare_files(request, serializer)
-
-            form_handler_plugin.send_email(rendered_data, files)
-
-        def _prepare_files(self, request, serializer):
-            """Prepares the files for being attached to the mail message."""
-            files = {}
-
-            def process_path(file_path, imf):
-                """Processes the file path and the file."""
-                if file_path:
-                    file_path = file_path.replace(
-                        settings.MEDIA_URL,
-                        os.path.join(settings.MEDIA_ROOT, '')
-                    )
-                    mime_type = guess_type(imf.name)
-                    files[field_name] = (
-                        imf.name,
-                        ''.join([c for c in imf.chunks()]),
-                        mime_type[0] if mime_type else ''
-                    )
-
-            for field_name, imf in request.FILES.items():
-                try:
-                    file_path = serializer.validated_data.get(field_name, '')
-                    process_path(file_path, imf)
-                except Exception as err:
-                    file_path = extract_file_path(imf.name)
-                    process_path(file_path, imf)
-
-            return files
-
-fobi_integration_form_handlers.py
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Register the plugin. Note the name pattern `fobi_integration_form_handlers`.
-
-.. code-block:: python
-
-    from fobi.base import integration_form_handler_plugin_registry
-    from .base import MailHandlerPlugin
-
-    integration_form_handler_plugin_registry.register(MailHandlerPlugin)
-
-Don't forget to list your plugin in the ``INSTALLED_APPS`` afterwards.
-
-Permissions
-===========
-Plugin system allows administrators to specify the access rights to every
-plugin. `django-fobi` permissions are based on Django Users and User Groups.
-Access rights are manageable via Django admin ("/admin/fobi/formelement/",
-"/admin/fobi/formhandler/"). If user doesn't have the rights to access plugin,
-it doesn't appear on his form even if has been added to it (imagine, you have
-once granted the right to use the news plugin to all users, but later on
-decided to limit it to Staff members group only). Note, that superusers have
-access to all plugins.
-
-.. code-block:: text
-
-            Plugin access rights management interface in Django admin
-
-    ┌──────────────────────────┬───────────────────────┬───────────────────────┐
-    │ `Plugin`                 │ `Users`               │ `Groups`              │
-    ├──────────────────────────┼───────────────────────┼───────────────────────┤
-    │ Text                     │ John Doe              │ Form builder users    │
-    ├──────────────────────────┼───────────────────────┼───────────────────────┤
-    │ Textarea                 │                       │ Form builder users    │
-    ├──────────────────────────┼───────────────────────┼───────────────────────┤
-    │ File                     │ Oscar, John Doe       │ Staff members         │
-    ├──────────────────────────┼───────────────────────┼───────────────────────┤
-    │ URL                      │                       │ Form builder users    │
-    ├──────────────────────────┼───────────────────────┼───────────────────────┤
-    │ Hidden                   │                       │ Form builder users    │
-    └──────────────────────────┴───────────────────────┴───────────────────────┘
-
-Management commands
-===================
-There are several management commands available.
-
-- `fobi_find_broken_entries`. Find broken form element/handler entries that
-  occur when some plugin which did exist in the system, no longer exists.
-- `fobi_sync_plugins`. Should be ran each time a new plugin is being added to
-  the `django-fobi`.
-- `fobi_update_plugin_data`. A mechanism to update existing plugin data in
-  case if it had become invalid after a change in a plugin. In order for it
-  to work, each plugin should implement and ``update`` method, in which the
-  data update happens.
-
-Tuning
-======
-There are number of `django-fobi` settings you can override in the settings
-module of your Django project:
-
-- `FOBI_RESTRICT_PLUGIN_ACCESS` (bool): If set to True, (Django) permission
-  system for dash plugins is enabled. Defaults to True. Setting this to False
-  makes all plugins available for all users.
-- `FOBI_DEFAULT_THEME` (str): Active (default) theme UID. Defaults to
-  "bootstrap3".
-- `FORM_HANDLER_PLUGINS_EXECUTION_ORDER` (list of tuples): Order in which the
-  form handlers are executed. See the "Prioritise the execution order"
-  section for details.
-
-For tuning of specific contrib plugin, see the docs in the plugin directory.
-
-Bundled plugins and themes
-==========================
-`django-fobi` ships with number of bundled form element- and form handler-
-plugins, as well as themes which are ready to be used as is.
-
-Bundled form element plugins
-----------------------------
-Below a short overview of the form element plugins. See the README.rst file
-in directory of each plugin for details.
-
-Fields
-~~~~~~
-Fields marked with asterisk (*) fall under the definition of text elements.
-It's possible to provide `Dynamic initial values`_ for text elements.
-
-- `Boolean (checkbox)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/boolean/>`_
-- `Date
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/date/>`_
-- `DateTime
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/datetime/>`_
-- `Date drop down (year, month, day selection drop-downs)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/date_drop_down/>`_
-- `Decimal
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/decimal>`_
-- `Duration
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/duration>`_
-- `Email*
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/email/>`_
-- `File
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/file/>`_
-- `Float
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/float>`_
-- `Hidden*
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/hidden/>`_
-- `Input
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/input/>`_
-- `IP address*
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/ip_address>`_
-- `Integer
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/integer/>`_
-- `Null boolean
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/null_boolean>`_
-- `Password*
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/password/>`_
-- `Radio select (radio button)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/radio/>`_
-- `Range select
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/range_select/>`_
-- `Select (drop-down)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/select/>`_
-- `Select model object (drop-down)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/select_model_object/>`_
-- `Select multiple (drop-down)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/select_multiple/>`_
-- `Select multiple model objects (drop-down)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/select_multiple_model_objects/>`_
-- `Slider
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/slider>`_
-- `Slug*
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/slug>`_
-- `Text*
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/text/>`_
-- `Textarea*
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/textarea/>`_
-- `Time
-  <https://github.com/barseghyanartur/django-fobi/tree/master/src/fobi/contrib/plugins/form_elements/fields/time>`_
-- `URL*
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/url/>`_
-
-Content/presentation
-~~~~~~~~~~~~~~~~~~~~
-Content plugins are presentational plugins, that make your forms look more
-complete and content rich.
-
-- `Content image
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/content/content_image/>`_:
-  Insert an image.
-- `Content image URL
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/content/content_image_url/>`_:
-  Insert an image URL.
-- `Content text
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/content/content_text/>`_:
-  Add text.
-- `Content richtext
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/content/content_richtext/>`_:
-  Add rich text (based on `django-ckeditor <https://github.com/django-ckeditor/django-ckeditor>`_
-  package).
-- `Content markdown
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/content/content_markdown/>`_:
-  Add markdown text.
-- `Content video
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/content/content_video/>`_:
-  Add an embed YouTube or Vimeo video.
-
-Security
-~~~~~~~~
-- `CAPTCHA
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/security/captcha/>`__:
-  CAPTCHA integration, requires ``django-simple-captcha`` package.
-- `ReCAPTCHA
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/security/recaptcha/>`__:
-  CAPTCHA integration, requires ``django-recaptcha`` package.
-- `Invisible ReCAPTCHA
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/security/invisible_recaptcha/>`__:
-  Google invisible reCAPTCHA integration, with no additional dependencies.
-- `Honeypot
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/security/honeypot/>`__:
-  `Anti-spam honeypot <http://en.wikipedia.org/wiki/Anti-spam_techniques#Honeypots>`_
-  field.
-
-MPTT fields
-~~~~~~~~~~~
-- `Select MPTT model object (drop-down)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/select_mptt_model_object/>`_
-- `Select multiple MPTT model objects (drop-down)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/select_multiple_mptt_model_objects/>`_
-
-Test
-~~~~
-Test plugins are made for dev purposes only.
-
-- `Dummy
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/test/dummy/>`_:
-  Solely for dev purposes.
-
-Bundled form handler plugins
-----------------------------
-Below a short overview of the form handler plugins. See the README.rst file
-in directory of each plugin for details.
-
-- `DB store
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_handlers/db_store/>`__:
-  Stores form data in a database.
-- `HTTP repost
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_handlers/http_repost/>`__:
-  Repost the POST request to another endpoint.
-- `Mail
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_handlers/mail/>`__:
-  Send the form data by email.
-- `Mail the sender
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_handlers/mail_sender/>`__:
-  Send the form data by email to the sender.
-
-Bundled themes
---------------
-Below a short overview of the themes. See the README.rst file in directory
-of each theme for details.
-
-- `Bootstrap 3
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/themes/bootstrap3/>`_:
-  Bootstrap 3 theme.
-- `Foundation 5
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/themes/foundation5/>`_:
-  Foundation 5 theme.
-- `Simple
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/themes/simple/>`_:
-  Basic theme with form editing is in a style of Django admin.
-- `DjangoCMS admin style
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/themes/djangocms_admin_style_theme/>`_:
-  Basic theme with form editing is in a style of `djangocms-admin-style
-  <https://github.com/divio/djangocms-admin-style>`_.
-
-Third-party plugins and themes
-==============================
-List of remarkable third-party plugins:
-
-- `fobi-phonenumber <https://pypi.python.org/pypi/fobi-phonenumber>`_ - A Fobi
-  PhoneNumber form field plugin. Makes use of the
-  `phonenumber_field.formfields.PhoneNumberField` and
-  `phonenumber_field.widgets.PhoneNumberPrefixWidget`.
-
-HTML5 fields
-============
-The following HTML5 fields are supported in corresponding bundled plugins:
-
-- date
-- datetime
-- email
-- max
-- min
-- number
-- url
-- placeholder
-- type
-
-With the ``fobi.contrib.plugins.form_elements.fields.input`` support for
-HTML5 fields is extended to the following fields:
-
-- autocomplete
-- autofocus
-- list
-- multiple
-- pattern
-- step
-
-Loading initial data using GET arguments
-========================================
-It's possible to provide initial data for the form using the GET arguments.
-
-In that case, along with the field values, you should be providing
-an additional argument named "fobi_initial_data", which doesn't have to
-hold a value. For example, if your form contains of fields named "email" and
-"age" and you want to provide initial values for those using GET arguments, you
-should be constructing your URL to the form as follows:
-
-http://127.0.0.1:8001/fobi/view/test-form/?fobi_initial_data&email=test@example.com&age=19
-
-Dynamic initial values
-======================
-It's possible to provide a dynamic initial value for any of the text elements.
-In order to do that, you should use the build-in context processor or make
-your own one. The only requirement is that you should store all values that
-should be exposed in the form as a dict for ``fobi_dynamic_values`` dictionary
-key. Beware, that passing the original request object might be unsafe in
-many ways. Currently, a stripped down version of the request object is being
-passed as a context variable.
-
-.. code-block:: python
-
-    TEMPLATES = [
-        {
-            # ...
-            'OPTIONS': {
-                # ...
-                'context_processors': [
-                    # ...
-                    "fobi.context_processors.theme",  # Important!
-                    "fobi.context_processors.dynamic_values",  # Optional
-                ]
-            },
-        },
-    ]
-
-.. code-block:: python
-
-    def dynamic_values(request):
-        return {
-            'fobi_dynamic_values': {
-                'request': StrippedRequest(request),
-                'now': datetime.datetime.now(),
-                'today': datetime.date.today(),
-            }
-        }
-
-In your GUI, you should be referring to the initial values in the following
-way:
-
-.. code-block:: html
-
-    {{ request.path }} {{ now }} {{ today }}
-
-Note, that you should not provide the `fobi_dynamic_values.` as a prefix.
-Currently, the following variables are available in the
-`fobi.context_processors.dynamic_values` context processor:
-
-.. code-block:: text
-
-    - request: Stripped HttpRequest object.
-
-        - request.path: A string representing the full path to the requested
-          page, not including the scheme or domain.
-
-        - request.get_full_path(): Returns the path, plus an appended query
-          string, if applicable.
-
-        - request.is_secure():  Returns True if the request is secure; that
-          is, if it was made with HTTPS.
-
-        - request.is_ajax(): Returns True if the request was made via an
-          XMLHttpRequest, by checking the HTTP_X_REQUESTED_WITH header for the
-          string 'XMLHttpRequest'.
-
-        - request.META: A stripped down standard Python dictionary containing
-          the available HTTP headers.
-
-            - HTTP_ACCEPT_ENCODING: Acceptable encodings for the response.
-
-            - HTTP_ACCEPT_LANGUAGE: Acceptable languages for the response.
-
-            - HTTP_HOST: The HTTP Host header sent by the client.
-
-            - HTTP_REFERER: The referring page, if any.
-
-            - HTTP_USER_AGENT: The client’s user-agent string.
-
-            - QUERY_STRING: The query string, as a single (un-parsed) string.
-
-            - REMOTE_ADDR: The IP address of the client.
-
-        - request.user: Authenticated user.
-
-            - request.user.email:
-
-            - request.user.get_username(): Returns the username for the user.
-              Since the User model can be swapped out, you should use this
-              method instead of referencing the username attribute directly.
-
-            - request.user.get_full_name(): Returns the first_name plus the
-              last_name, with a space in between.
-
-            - request.user.get_short_name(): Returns the first_name.
-
-            - request.user.is_anonymous():
-
-    - now: datetime.datetime.now()
-
-    - today: datetime.date.today()
-
-Submitted form element plugins values
-=====================================
-While some values of form element plugins are submitted as is, some others
-need additional processing. There are 3 types of behaviour taken into
-consideration:
-
-- "val": value is being sent as is.
-- "repr": (human readable) representation of the value is used.
-- "mix": mix of value as is and human readable representation.
-
-The following plugins have been made configurable in such a way, that
-developers can choose the desired behaviour in projects' settings:
-
-- ``FOBI_FORM_ELEMENT_CHECKBOX_SELECT_MULTIPLE_SUBMIT_VALUE_AS``
-- ``FOBI_FORM_ELEMENT_RADIO_SUBMIT_VALUE_AS``
-- ``FOBI_FORM_ELEMENT_SELECT_SUBMIT_VALUE_AS``
-- ``FOBI_FORM_ELEMENT_SELECT_MULTIPLE_SUBMIT_VALUE_AS``
-- ``FOBI_FORM_ELEMENT_SELECT_MODEL_OBJECT_SUBMIT_VALUE_AS``
-- ``FOBI_FORM_ELEMENT_SELECT_MULTIPLE_MODEL_OBJECTS_SUBMIT_VALUE_AS``
-
-See the README.rst in each of the following plugins for more information.
-
-- `Checkbox select multiple (multiple checkboxes)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/radio/>`__
-- `Radio select (radio button)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/radio/>`__
-- `Select (drop-down)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/select/>`__
-- `Select model object (drop-down)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/select_model_object/>`__
-- `Select MPTT model object (drop-down)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/select_mptt_model_object/>`__
-- `Select multiple (drop-down)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/select_multiple/>`__
-- `Select multiple model objects (drop-down)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/select_multiple_model_objects/>`__
-- `Select multiple MPTT model objects (drop-down)
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/fields/select_multiple_mptt_model_objects/>`__
-
-Rendering forms using third-party libraries
-===========================================
-You might want to render your forms using third-party libraries such as
-`django-crispy-forms <http://django-crispy-forms.readthedocs.org/>`_,
-`django-floppyforms <http://django-floppyforms.readthedocs.org/>`_ or
-other alternatives.
-
-For that purpose you should override the "snippets/form_snippet.html" used
-by the theme you have chosen. Your template would then look similar to the
-one below (make sure to setup/configure your third-party form rendering library
-prior doing this).
-
-Using `django-crispy-forms`
----------------------------
-
-.. code-block:: html
-
-    {% load crispy_forms_tags fobi_tags %}
-
-    {% block form_non_field_and_hidden_errors %}
-        {% get_form_hidden_fields_errors form as form_hidden_fields_errors %}
-        {% if form.non_field_errors or form_hidden_fields_errors %}
-            {% include fobi_theme.form_non_field_and_hidden_errors_snippet_template %}
-        {% endif %}
-    {% endblock form_non_field_and_hidden_errors %}
-
-    {% crispy form %}
-
-Using `django-floppyforms`
---------------------------
-
-.. code-block:: html
-
-    {% load floppyforms fobi_tags %}
-
-    {% block form_non_field_and_hidden_errors %}
-        {% get_form_hidden_fields_errors form as form_hidden_fields_errors %}
-        {% if form.non_field_errors or form_hidden_fields_errors %}
-            {% include fobi_theme.form_non_field_and_hidden_errors_snippet_template %}
-        {% endif %}
-    {% endblock form_non_field_and_hidden_errors %}
-
-    {% form form %}
-
-See how it's done in the `override simple theme
-<https://github.com/barseghyanartur/django-fobi/tree/master/examples/simple/override_simple_theme/>`__
-example.
-
-Import/export forms
-===================
-There might be cases when you have `django-fobi` running on multiple instances
-and have already spend some time on making forms on one of the instances,
-and want to reuse those forms on another. You could of course re-create entire
-form in the GUI, but we can do better than that. It's possible to export forms
-into JSON format and import the exported forms again. It's preferable that
-you run both instances on the same versions of `django-fobi`, otherwise imports
-might break (although it might just work). There many ways to deal with
-missing plugin errors, but the chosen strategy (which you don't yet have full
-control of) is safest (import everything possible, but warn user about errors).
-If both instances have the same set of form element and form handler plugins
-imports should go smoothly. It is though possible to make an import ignoring
-missing form element and form handler plugins. You would get an appropriate
-notice about that, but import will continue leaving the broken plugin data out.
-
-Translations
-============
-Available translations
-----------------------
-English is the primary language. The following translations are
-available (core and plugins)
-
-- `Dutch <https://django-fobi.herokuapp.com/nl/>`_
-- `German <https://django-fobi.herokuapp.com/de/>`_
-- `Russian <https://django-fobi.herokuapp.com/ru/>`_
-- `French <https://django-fobi.herokuapp.com/fr/>`_
-
-Overriding translations
------------------------
-There might be cases when you want to override certain translations. It's
-easily achievable with introduction of custom locale paths in your project.
-
-See the following as a good example of overriding some English plugin labels.
-
-- `custom settings
-  <https://raw.githubusercontent.com/barseghyanartur/django-fobi/master/examples/simple/settings/alternative_labels.py>`__
-- `custom locales directory
-  <https://github.com/barseghyanartur/django-fobi/tree/master/examples/simple/fobi_locale/>`__
-
-Run the example project as follows:
-
-.. code-block:: sh
-
-    cd examples/simple/
-    ./manage.py runserver --settings=settings.alternative_labels
-
-In the example given, "Boolean" and "Checkbox select multiple" plugin names
-are renamed to "Checkbox" and "Multiple checkboxes" respectively.
-
-All built-in plugin ``name`` values are almost equivalent to the plugin ``uid``
-values. By default plugins are sorted by ``uid`` value. When you override the
-``name`` of the plugin, sorting breaks. Therefore, it's recommended to
-set the ``FOBI_SORT_PLUGINS_BY_VALUE`` value to True in your settings module.
-Default value is False, which means that plugins are sorted by their ``uid``
-value.
-
-.. code-block:: python
-
-    FOBI_SORT_PLUGINS_BY_VALUE = True
-
-Debugging
-=========
-By default debugging is turned off. It means that broken form entries, which
-are entries with broken data, that are not possible to be shown, are just
-skipped. That's safe in production. Although, you for sure would want to
-see the broken entries in development. Set the ``FOBI_DEBUG`` to True
-in the ``settings.py`` of your project in order to do so.
-
-Most of the errors are logged (DEBUG). If you have written a plugin and it
-somehow doesn't appear in the list of available plugins, do run the following
-management command since it not only syncs your plugins into the database,
-but also is a great way of checking for possible errors.
-
-.. code-block:: sh
-
-    ./manage.py fobi_sync_plugins
-
-Run the following command in order to identify the broken plugins.
-
-.. code-block:: sh
-
-    ./manage.py fobi_find_broken_entries
-
-If you have forms referring to form element- of form handler- plugins
-that are currently missing (not registered, removed, failed to load - thus
-there would be a risk that your form would't be rendered properly/fully and
-the necessary data handling wouldn't happen either) you will get an
-appropriate exception. Although it's fine to get an instant error message about
-such failures in development, in production is wouldn't look appropriate.
-Thus, there are two settings related to the non-existing (not-found) form
-element- and form handler- plugins.
-
-- FOBI_DEBUG: Set this to True in your development environment anyway. Watch
-  error logs closely.
-- FOBI_FAIL_ON_MISSING_FORM_ELEMENT_PLUGINS: If you want no error to be
-  shown in case of missing form element plugins, set this to False in
-  your settings module. Default value is True.
-- FOBI_FAIL_ON_MISSING_FORM_HANDLER_PLUGINS: If you want no error to be
-  shown in case of missing form element handlers, set this to False in
-  your settings module. Default value is True.
-
-Testing
-=======
-Project is covered by test (functional- and browser-tests).
-
-.. note::
-
-    You are recommended to use Postgres or MySQL for testing. Tests
-    occasionally fail on SQLite due to very intensive IO and SQLite table
-    locking.
-
-To test with all supported Python/Django versions type:
-
-.. code-block:: sh
-
-    tox
-
-To test against specific environment, type:
-
-.. code-block:: sh
-
-    tox -e py37-django21
-
-To test just your working environment type:
-
-.. code-block:: sh
-
-    ./runtests.py
-
-To run a single test class in a given test module in your working environment type:
-
-.. code-block:: sh
-
-    ./runtests.py src/fobi/tests/test_browser_build_dynamic_forms.py::FobiBrowserBuldDynamicFormsTest -k "test_2004_submit_form"
-
-It's assumed that you have all the requirements installed. If not, first
-install the test requirements:
-
-.. code-block:: sh
-
-    pip install -r examples/requirements/test.txt
-
-Browser tests
--------------
-For browser tests you may choose between Firefox, headless Firefox and
-PhantomJS. PhantomJS is faster, headless Firefox is fast as well, but
-normal Firefox tests tell you more (as you see what exactly happens on the
-screen). Both cases require some effort and both have disadvantages regarding
-the installation (although once you have them installed they work perfect).
-
-Latest versions of Firefox are often not supported by Selenium. Current
-version of the Selenium for Python (2.53.6) works fine with Firefox 47.
-Thus, instead of using system Firefox you could better use a custom one.
-
-For PhantomJS you need to have NodeJS installed.
-
-Set up ChromeDriver
-~~~~~~~~~~~~~~~~~~~
-1. Download ChromeDriver version matching your browser. You can always find
-   proper version
-   at `chromedriver.chromium.org/downloads <https://chromedriver.chromium.org/downloads>`__:
-
-    .. code-block:: sh
-
-        wget https://chromedriver.storage.googleapis.com/87.0.4280.88/chromedriver_linux64.zip
-        unzip chromedriver_linux64.zip
-        sudo mv chromedriver /usr/bin/chromedriver87
-        sudo chown root:root /usr/bin/chromedriver87
-        sudo chmod +x /usr/bin/chromedriver87
-
-2. Specify the full path to your ChromeDriver in
-   ``CHROME_DRIVER_EXECUTABLE_PATH`` setting. Example:
-
-    .. code-block:: python
-
-        CHROME_DRIVER_EXECUTABLE_PATH = '/usr/bin/chromedriver87'
-
-After that your Selenium tests would work.
-
-Set up Firefox 47
-~~~~~~~~~~~~~~~~~
-1. Download Firefox 47 from
-   `this
-   <https://ftp.mozilla.org/pub/firefox/releases/47.0.1/linux-x86_64/en-GB/firefox-47.0.1.tar.bz2>`__
-   location and unzip it into ``/usr/lib/firefox47/``
-
-2. Specify the full path to your Firefox in ``FIREFOX_BIN_PATH``
-   setting. Example:
-
-   .. code-block:: python
-
-       FIREFOX_BIN_PATH = '/usr/lib/firefox47/firefox'
-
-   If you set to use system Firefox, remove or comment-out the
-   ``FIREFOX_BIN_PATH`` setting.
-
-After that your Selenium tests would work.
-
-Set up headless Firefox
-~~~~~~~~~~~~~~~~~~~~~~~
-1. Install ``xvfb`` package which is used to start Firefox in headless mode.
-
-   .. code-block:: sh
-
-        sudo apt-get install xvfb
-
-2. Run the tests using headless Firefox.
-
-   .. code-block:: sh
-
-        ./scripts/runtests.sh
-
-   Or run tox tests using headless Firefox.
-
-   .. code-block:: sh
-
-        ./scripts/tox.sh
-
-   Or run specific tox tests using headless Firefox.
-
-   .. code-block:: sh
-
-        ./scripts/tox.sh -e py36-django111
-
-Setup PhantomJS
-~~~~~~~~~~~~~~~
-You could also run tests in headless mode (faster). For that you will need
-PhantomJS.
-
-1. Install PhantomJS and dependencies.
-
-   .. code-block:: sh
-
-       curl -sL https://deb.nodesource.com/setup_6.x -o nodesource_setup.sh
-       sudo bash nodesource_setup.sh
-       sudo apt-get install nodejs
-       sudo apt-get install build-essential libssl-dev
-       sudo npm -g install phantomjs-prebuilt
-
-2. Specify the ``PHANTOM_JS_EXECUTABLE_PATH`` setting. Example:
-
-   .. code-block:: python
-
-       PHANTOM_JS_EXECUTABLE_PATH = ""
-
-   If you want to use Firefox for testing, remove or comment-out the
-   ``PHANTOM_JS_EXECUTABLE_PATH`` setting.
-
-Writing documentation
-=====================
-Keep the following hierarchy.
-
-.. code-block:: text
-
-    =====
-    title
-    =====
-
-    header
-    ======
-
-    sub-header
-    ----------
-
-    sub-sub-header
-    ~~~~~~~~~~~~~~
-
-    sub-sub-sub-header
-    ##################
-
-    sub-sub-sub-sub-header
-    ^^^^^^^^^^^^^^^^^^^^^^
-
-    sub-sub-sub-sub-sub-header
-    ++++++++++++++++++++++++++
-
-Troubleshooting
-===============
-If you get a ``FormElementPluginDoesNotExist`` or a
-``FormHandlerPluginDoesNotExist`` exception, make sure you have listed your
-plugin in the ``settings`` module of your project.
-
-Contributing
-============
-If you want to contribute to the library, but don't know where to start,
-do check the `open issues where help is appreciated
-<https://github.com/barseghyanartur/django-fobi/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+appreciated%22>`_
-or ask the `Author`_ how you could help.
-
-License
-=======
-GPL-2.0-only OR LGPL-2.1-or-later
-
-Support
-=======
-For any issues contact me at the e-mail given in the `Author`_ section.
-
-Author
-======
-Artur Barseghyan <artur.barseghyan@gmail.com>
-
-
-
-Screenshots
-===========
-Bootstrap3 theme
-----------------
-Dashboard
-~~~~~~~~~
-.. [1.1] Dashboard
-
-.. image:: _static/bootstrap3/01_dashboard.png
-    :scale: 80 %
-
-Create a form
-~~~~~~~~~~~~~
-.. [1.2] Create a form
-
-.. image:: _static/bootstrap3/02_create_form.png
-    :scale: 80 %
-
-View/edit form
-~~~~~~~~~~~~~~
-Form elements
-#############
-.. [1.3] Edit form - form elements tab active, no elements yet
-
-.. image:: _static/bootstrap3/03_edit_form_-_form_elements_tab_active_-_no_elements_yet.png
-    :scale: 80 %
-
-.. [1.4] Edit form - form elements tab active, add a form element menu
-
-.. image:: _static/bootstrap3/04_edit_form_-_form_elements_tab_active_-_add_element_menu.png
-    :scale: 80 %
-
-.. [1.5] Edit form - add a form element (URL plugin)
-
-.. image:: _static/bootstrap3/05_edit_form_-_add_form_element_url_plugin.png
-    :scale: 80 %
-
-.. [1.6] Edit form - form elements tab active, with form elements
-
-.. image:: _static/bootstrap3/06_edit_form_-_form_elements_tab_active_-_with_elements.png
-    :scale: 80 %
-
-Form handlers
-#############
-
-.. [1.7] Edit form - form handlers tab active, no handlers yet
-
-.. image:: _static/bootstrap3/07_edit_form_-_form_handlers_tab_active_-_no_handlers_yet.png
-    :scale: 80 %
-
-.. [1.8] Edit form - form handlers tab tactive, add form handler menu
-
-.. image:: _static/bootstrap3/08_edit_form_-_form_handlers_tab_active_-_add_handler_menu.png
-    :scale: 80 %
-
-.. [1.9] Edit form - add a form handler (Mail plugin)
-
-.. image:: _static/bootstrap3/09_edit_form_-_add_form_handler_mail_plugin.png
-    :scale: 80 %
-
-.. [1.10] Edit form - form handlers tab active, with form handlers
-
-.. image:: _static/bootstrap3/10_edit_form_-_form_handlers_tab_active_with_handlers.png
-    :scale: 80 %
-
-.. [1.11] Edit form - form properties tab active
-
-.. image:: _static/bootstrap3/11_edit_form_-_form_properties_tab_active.png
-    :scale: 80 %
-
-.. [1.12] View form
-
-.. image:: _static/bootstrap3/12_view_form.png
-    :scale: 80 %
-
-.. [1.13] View form - form submitted (thanks page)
-
-.. image:: _static/bootstrap3/13_view_form_-_form_submitted.png
-    :scale: 80 %
-
-.. [1.14] Edit form - add a form element (Video plugin)
-
-.. image:: _static/bootstrap3/14_edit_form_-_add_form_element_video_plugin.png
-    :scale: 80 %
-
-.. [1.15] Edit form - add a form element (Boolean plugin)
-
-.. image:: _static/bootstrap3/15_edit_form_-_add_form_element_boolean_plugin.png
-    :scale: 80 %
-
-.. [1.16] Edit form
-
-.. image:: _static/bootstrap3/16_edit_form.png
-    :scale: 80 %
-
-.. [1.17] View form
-
-.. image:: _static/bootstrap3/17_view_form.png
-    :scale: 80 %
-
-Simple theme
-------------
-View/edit form
-~~~~~~~~~~~~~~
-.. [2.1] Edit form - form elements tab active, with form elements
-
-.. image:: _static/simple/01_edit_form_-_form_elements_tab_active_with_elements.png
-    :scale: 80 %
-
-.. [2.2] Edit form - form elements tab active, add a form element menu
-
-.. image:: _static/simple/02_edit_form_-_form_elements_tab_active_add_elements_menu.png
-    :scale: 80 %
-
-.. [2.3] Edit form - add a form element (Hidden plugin)
-
-.. image:: _static/simple/03_edit_form_-_add_form_element_hidden.png
-    :scale: 80 %
-
-.. [2.4] Edit form - form handlers tab active, with form handlers
-
-.. image:: _static/simple/04_edit_form_-_form_handlers_tab_active_with_handlers.png
-    :scale: 80 %
-
-.. [2.5] Edit form - form properties tab active
-
-.. image:: _static/simple/05_edit_form_-_form_properties_tab_active.png
-    :scale: 80 %
-
-.. [2.6] View form
-
-.. image:: _static/simple/06_view_form.png
-    :scale: 80 %
-
-
-
-Documentation
-=============
-Contents:
-
-.. toctree::
-   :maxdepth: 20
-
-   index
-   quickstart
-   changelog
-   licenses
-   fobi
-
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
-
-
-
-(Sub)modules
-============
-Some additional documentation on ``django-fobi`` sub-modules are listed
-below.
-
-
-fobi.contrib.apps.djangocms_integration
----------------------------------------
-A ``django-fobi`` integration with DjangoCMS.
-
-Prerequisites
-~~~~~~~~~~~~~
-Tested with DjangoCMS 2.4.3, 3.0.6 and 3.4.3 only. Might work on earlier (or
-later) versions as well.
-
-Installation
-~~~~~~~~~~~~
-Versions
-########
-See the requirements files:
-
-- `DjangoCMS 2.4.3 requirements
-  <https://github.com/barseghyanartur/django-fobi/blob/stable/examples/requirements/djangocms_2.txt>`_.
-- `DjangoCMS 3.0.6 requirements
-  <https://github.com/barseghyanartur/django-fobi/blob/stable/examples/requirements/djangocms_3_0_6.txt>`_.
-- `DjangoCMS 3.4.3 requirements
-  <https://github.com/barseghyanartur/django-fobi/blob/stable/examples/requirements/djangocms_3_4_3.txt>`_.
-
-your_project/settings.py
-########################
-See the example settings files:
-
-- `DjangoCMS 2.4.3 settings
-  <https://github.com/barseghyanartur/django-fobi/blob/stable/examples/simple/settings/bootstrap3_theme_djangocms_2.py>`_.
-- `DjangoCMS 3.0.6/3.4.3. settings
-  <https://github.com/barseghyanartur/django-fobi/blob/stable/examples/simple/settings/bootstrap3_theme_djangocms.py>`_.
-
-.. code-block:: python
-
-    INSTALLED_APPS = list(INSTALLED_APPS)
-    INSTALLED_APPS += [
-        'cms',  # DjangoCMS
-
-        'fobi.contrib.apps.djangocms_integration',  # Fobi DjangoCMS app
-    ]
-
-Information for developers
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-Templates for DjangoCMS
-#######################
-Django-CMS templates are quite specific and in some aspects are not 100%
-compatible with built-in themes (due to the fact that DjangoCMS intensively 
-makes use of ``django-sekizai`` which isn't used in the generic templates).
-
-That does not anyhow affect the core ``fobi`` and the built-in themes,
-although you can't magically reuse built-in ``fobi`` themes with Django-CMS
-(as it's done for `FeinCMS page templates
-<https://github.com/barseghyanartur/django-fobi/blob/stable/examples/simple/templates/page/base.html>`_).
-
-You would have to make custom page templates from scratch (or based on a
-copy of the desired bundled template). See how I did it for all bundled themes
-`here
-<https://github.com/barseghyanartur/django-fobi/tree/stable/examples/simple/templates/cms_page>`_:
-
-- `Bootstrap 3
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/examples/simple/templates/cms_page/bootstrap3>`_
-- `Foundation 5
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/examples/simple/templates/cms_page/foundation5>`_
-- `Simple
-  <https://github.com/barseghyanartur/django-fobi/tree/stable/examples/simple/templates/cms_page/simple>`_
-
-Template rendering
-##################
-The embed DjangoCMS widget is rendered with use of two theme templates:
-
-- ``view_embed_form_entry_ajax_template``: Used for rendering the form.
-- ``embed_form_entry_submitted_ajax_template``: Used for rendering the form
-  sent event.
-
-Using custom templates for rendering the widget
-###############################################
-In the widget, you can specify a template which you want to be used for
-rendering the form or the form-sent event.
-
-Example:
-
-.. code-block:: python
-
-    FOBI_DJANGOCMS_INTEGRATION_FORM_TEMPLATE_CHOICES = (
-        ("yourapp/custom_view_embed_form_v1.html",
-         "Custom embed form view template #1"),
-        ("yourapp/custom_view_embed_form_v2.html",
-         "Custom embed form view template #2"),
-    )
-
-Same goes for form-sent templates.
-
-.. code-block:: python
-
-    FOBI_DJANGOCMS_INTEGRATION_SUCCESS_PAGE_TEMPLATE_CHOICES = (
-        ("yourapp/custom_embed_form_submitted_v1.html",
-         "Custom form-sent template #1"),
-        ("yourapp/custom_embed_form_submitted_v2.html",
-         "Custom form-sent template #2"),
-    )
-
-Registering a template in the ``FORM_TEMPLATE_CHOICES`` makes it available
-for all the themes. If you rather want to use different custom templates
-for different themes, use the ``FOBI_CUSTOM_THEME_DATA`` as shown in the
-example below.
-
-.. code-block:: python
-
-    FOBI_CUSTOM_THEME_DATA = {
-        'bootstrap3': {
-            'djangocms_integration': {
-                'form_template_choices': [
-                    ('fobi/bootstrap3_extras/view_embed_form.html',
-                     "Custom bootstrap3 embed form view template"),
-                ],
-                'success_page_template_choices': [
-                    ('fobi/bootstrap3_extras/embed_form_submitted.html',
-                     "Custom bootstrap3 embed form entry submitted template"),
-                ],
-            },
-        },
-        'foundation5': {
-            'djangocms_integration': {
-                'form_template_choices': [
-                    ('fobi/foundation5_extras/view_embed_form.html',
-                     "Custom foundation5 embed form view template"),
-                ],
-                'success_page_template_choices': [
-                    ('fobi/foundation5_extras/embed_form_submitted.html',
-                     "Custom foundation5 embed form entry submitted template"),
-                ],
-            },
-        },
-    }
-
-Usage
-~~~~~
-The ``fobi.contrib.apps.djangocms_integration.models.FobiFormWidget`` consists
-of the following fields:
-
-- Form: The form to be used.
-- Form template name: Template to be used to render the embed form.
-- Hide form title: If checked, no form title would be shown.
-- Form title: Overrides the standard form title.
-- Submit button text: Overrides the default submit button text.
-- Success page template name: Template to be used to render the embed form-sent
-  event.
-- Hide success page title: If checked, no form-sent title would be shown.
-- Success page title: Overrides the form-sent title.
-- Success page text: Overrides the form-sent text.
-
-
-fobi.contrib.apps.drf_integration
----------------------------------
-A ``django-fobi`` integration with ``Django REST framework``.
-
-Supported actions are:
-
-- `LIST`_: List all the forms.
-- `OPTIONS`_: Describe the given form.
-- `PUT`_: Submit form data.
-
-Live demo
-~~~~~~~~~
-Live demo is available on Heroku.
-
-- `The core <https://django-fobi.herokuapp.com/>`_
-- `Django REST framework integration <https://django-fobi.herokuapp.com/api/>`_
-
-Supported fields
-~~~~~~~~~~~~~~~~
-The following fields are supported.
-
-Content (presentational form elements)
-######################################
-Unlike standard fields, ``content`` fields are purely presentational.
-You're not supposed to make write actions on them (it won't work). Neither
-will they be displayed in the browsable API (list/retrieve actions). However,
-they will be listed in the options action call. All content fields are of type
-"content".
-
-- content_image
-- content_image_url
-- content_richtext
-- content_text
-- content_video
-
-Fields
-######
-- boolean
-- checkbox_select_multiple
-- date
-- date_drop_down
-- datetime
-- decimal
-- duration
-- email
-- file
-- float
-- hidden (in terms of the Django REST framework - a read-only field)
-- input (some sort of a copy of ``text`` plugin)
-- integer
-- ip_address
-- null_boolean
-- password (some sort of a copy of ``text`` plugin)
-- radio
-- range_select
-- regex
-- select
-- select_multiple
-- select_multiple_with_max
-- slider (just a copy of range_select, for compatibility with main package)
-- slug
-- text
-- textarea (some sort of a copy of ``text`` plugin)
-- time
-- url
-
-Not (yet) supported fields
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-The following fields are not supported. Those marked with asterisk are planned
-to be supported in the upcoming releases.
-
-- select_model_object
-- select_mptt_model_object
-- select_multiple_model_objects
-- select_multiple_mptt_model_objects
-
-Implementation details
-~~~~~~~~~~~~~~~~~~~~~~
-Each ``django-fobi`` plugin has its' own representative integration plugin
-within ``fobi.contrib.aps.drf_integration`` package.
-
-Some of the plugins may seam to have zero-added-value and in fact they are.
-For instance, DRF integration ``slider`` plugin is just an exact copy of the
-``range_select`` plugin, created in order to provide exactly the same form
-fields generated in the API.
-
-You should mention all the plugins you want to use explicitly in the
-project settings. Thus, if you have used (included in the ``INSTALLED_APPS``)
-the core plugins:
-
-- fobi.contrib.plugins.form_elements.fields.boolean
-- fobi.contrib.plugins.form_elements.fields.checkbox_select_multiple
-- fobi.contrib.plugins.form_elements.fields.date
-- fobi.contrib.plugins.form_elements.fields.date_drop_down
-- fobi.contrib.plugins.form_elements.fields.datetime
-- fobi.contrib.plugins.form_elements.fields.decimal
-- fobi.contrib.plugins.form_elements.fields.duration
-- fobi.contrib.plugins.form_elements.fields.email
-- fobi.contrib.plugins.form_elements.fields.file
-- fobi.contrib.plugins.form_elements.fields.float
-- fobi.contrib.plugins.form_elements.fields.hidden
-- fobi.contrib.plugins.form_elements.fields.input
-- fobi.contrib.plugins.form_elements.fields.integer
-- fobi.contrib.plugins.form_elements.fields.ip_address
-- fobi.contrib.plugins.form_elements.fields.null_boolean
-- fobi.contrib.plugins.form_elements.fields.password
-- fobi.contrib.plugins.form_elements.fields.radio
-- fobi.contrib.plugins.form_elements.fields.range_select
-- fobi.contrib.plugins.form_elements.fields.regex
-- fobi.contrib.plugins.form_elements.fields.select
-- fobi.contrib.plugins.form_elements.fields.select_multiple
-- fobi.contrib.plugins.form_elements.fields.select_multiple_with_max
-- fobi.contrib.plugins.form_elements.fields.slider
-- fobi.contrib.plugins.form_elements.fields.slug
-- fobi.contrib.plugins.form_elements.fields.text
-- fobi.contrib.plugins.form_elements.fields.textarea
-- fobi.contrib.plugins.form_elements.fields.time
-- fobi.contrib.plugins.form_elements.fields.url
-- fobi.contrib.plugins.form_elements.content.content_image
-- fobi.contrib.plugins.form_elements.content.content_image_url
-- fobi.contrib.plugins.form_elements.content.content_richtext
-- fobi.contrib.plugins.form_elements.content.content_text
-- fobi.contrib.plugins.form_elements.content.content_video
-- fobi.contrib.plugins.form_handlers.db_store
-- fobi.contrib.plugins.form_handlers.http_repost
-- fobi.contrib.plugins.form_handlers.mail
-
-You should include their correspondent Django REST framework implementations
-in the ``INSTALLED_APPS`` as well:
-
-- fobi.contrib.apps.drf_integration.form_elements.fields.boolean
-- fobi.contrib.apps.drf_integration.form_elements.fields.checkbox_select_multiple
-- fobi.contrib.apps.drf_integration.form_elements.fields.date
-- fobi.contrib.apps.drf_integration.form_elements.fields.date_drop_down
-- fobi.contrib.apps.drf_integration.form_elements.fields.datetime
-- fobi.contrib.apps.drf_integration.form_elements.fields.decimal
-- fobi.contrib.apps.drf_integration.form_elements.fields.duration
-- fobi.contrib.apps.drf_integration.form_elements.fields.email
-- fobi.contrib.apps.drf_integration.form_elements.fields.file
-- fobi.contrib.apps.drf_integration.form_elements.fields.float
-- fobi.contrib.apps.drf_integration.form_elements.fields.hidden
-- fobi.contrib.apps.drf_integration.form_elements.fields.input
-- fobi.contrib.apps.drf_integration.form_elements.fields.integer
-- fobi.contrib.apps.drf_integration.form_elements.fields.ip_address
-- fobi.contrib.apps.drf_integration.form_elements.fields.null_boolean
-- fobi.contrib.apps.drf_integration.form_elements.fields.password
-- fobi.contrib.apps.drf_integration.form_elements.fields.radio
-- fobi.contrib.apps.drf_integration.form_elements.fields.range_select
-- fobi.contrib.apps.drf_integration.form_elements.fields.regex
-- fobi.contrib.apps.drf_integration.form_elements.fields.select
-- fobi.contrib.apps.drf_integration.form_elements.fields.select_multiple
-- fobi.contrib.apps.drf_integration.form_elements.fields.select_multiple_with_max
-- fobi.contrib.apps.drf_integration.form_elements.fields.slider
-- fobi.contrib.apps.drf_integration.form_elements.fields.slug
-- fobi.contrib.apps.drf_integration.form_elements.fields.text
-- fobi.contrib.apps.drf_integration.form_elements.fields.textarea
-- fobi.contrib.apps.drf_integration.form_elements.fields.time
-- fobi.contrib.apps.drf_integration.form_elements.fields.url
-- fobi.contrib.apps.drf_integration.form_elements.content.content_image
-- fobi.contrib.apps.drf_integration.form_elements.content.content_image_url
-- fobi.contrib.apps.drf_integration.form_elements.content.content_richtext
-- fobi.contrib.apps.drf_integration.form_elements.content.content_text
-- fobi.contrib.apps.drf_integration.form_elements.content.content_video
-- fobi.contrib.apps.drf_integration.form_handlers.db_store
-- fobi.contrib.apps.drf_integration.form_handlers.http_repost
-- fobi.contrib.apps.drf_integration.form_handlers.mail
-
-Installation
-~~~~~~~~~~~~
-Versions
-########
-Was made with ``djangorestframework`` 3.6.2. May work on earlier versions,
-although not guaranteed.
-
-See the `requirements file
-<https://github.com/barseghyanartur/django-fobi/blob/stable/examples/requirements/djangorestframework.txt>`_.
-
-your_project/settings.py
-########################
-See the `example settings file
-<https://github.com/barseghyanartur/django-fobi/blob/stable/examples/simple/settings_bootstrap3_theme_drf_integration.py>`_.
-
-.. code-block:: python
-
-    INSTALLED_APPS = list(INSTALLED_APPS)
-    INSTALLED_APPS += [
-        # ...
-        # Here should come a list of form element plugins of the core
-        # package, followed by the list of form handler plugins of the core
-        # package, followed by the list of themes of the core package and
-        # all other apps that do matter.
-        # ...
-        'rest_framework',  # Django REST framework
-        'fobi.contrib.apps.drf_integration',  # DRF integration app
-
-        # DRF integration form element plugins - fields
-        'fobi.contrib.apps.drf_integration.form_elements.fields.boolean',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.checkbox_select_multiple',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.date',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.datetime',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.decimal',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.duration',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.email',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.file',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.float',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.hidden',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.input',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.integer',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.ip_address',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.null_boolean',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.password',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.radio',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.range_select',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.regex',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.select',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.select_multiple',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.select_multiple_with_max',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.slider',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.slug',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.text',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.textarea',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.time',
-        'fobi.contrib.apps.drf_integration.form_elements.fields.url',
-
-        # DRF integration form element plugins - presentational
-        'fobi.contrib.apps.drf_integration.form_elements.content.content_image',
-        'fobi.contrib.apps.drf_integration.form_elements.content.content_image_url',
-        'fobi.contrib.apps.drf_integration.form_elements.content.content_richtext',
-        'fobi.contrib.apps.drf_integration.form_elements.content.content_text',
-        'fobi.contrib.apps.drf_integration.form_elements.content.content_video',
-
-        # DRF integration form handler plugins
-        'fobi.contrib.apps.drf_integration.form_handlers.db_store',
-        'fobi.contrib.apps.drf_integration.form_handlers.mail',
-        'fobi.contrib.apps.drf_integration.form_handlers.http_repost',
-        # ...
-    ]
-
-your_project/urls.py
-####################
-Add the following code to the main ``urls.py`` of your project:
-
-.. code-block:: python
-
-    # Conditionally including django-rest-framework integration app
-    if 'fobi.contrib.apps.drf_integration' in settings.INSTALLED_APPS:
-        from fobi.contrib.apps.drf_integration.urls import fobi_router
-        urlpatterns += [
-            url(r'^api/', include(fobi_router.urls))
-        ]
-
-Usage
-~~~~~
-If you have followed the steps above precisely, you would be able to access
-the API using ``http://localhost:8000/api/fobi-form-entry/``.
-
-Actions/methods supported:
-
-LIST
-####
-.. code-block:: text
-
-    GET /api/fobi-form-entry/
-
-Lists all the forms available. Anonymous users would see the list of all
-public forms. Authenticated users would see their own forms in addition
-to the public forms.
-
-OPTIONS
-#######
-.. code-block:: text
-
-    OPTIONS /api/fobi-form-entry/{FORM_SLUG}/
-
-Lists all field options for the selected form.
-
-See the `test DRF form
-<https://django-fobi.herokuapp.com/en/fobi/view/test-drf-form/>`_ and
-`same form in DRF integration app
-<https://django-fobi.herokuapp.com/api/fobi-form-entry/test-drf-form/>`_ with
-most of the fields that do have rich additional metadata.
-
-OPTIONS call produces the following response:
-
-.. code-block:: text
-
-    OPTIONS /api/fobi-form-entry/test-drf-form/
-    HTTP 200 OK
-    Allow: GET, PUT, PATCH, OPTIONS
-    Content-Type: application/json
-    Vary: Accept
-
-
-.. code-block:: python
-
-    {
-        "name": "Fobi Form Entry Instance",
-        "description": "FormEntry view set.",
-        "renders": [
-            "application/json",
-            "text/html"
-        ],
-        "parses": [
-            "application/json",
-            "application/x-www-form-urlencoded",
-            "multipart/form-data"
-        ],
-        "actions": {
-            "PUT": {
-                "test_integer": {
-                    "type": "integer",
-                    "required": false,
-                    "read_only": false,
-                    "label": "Test integer",
-                    "min_value": 1,
-                    "max_value": 20,
-                    "initial": 10
-                },
-                "test_email": {
-                    "type": "email",
-                    "required": true,
-                    "read_only": false,
-                    "label": "Test email",
-                    "help_text": "Donec mollis hendrerit risus. Phasellus a "
-                                 "est. Nam ipsum risus, rutrum vitae, "
-                                 "vestibulum eu, molestie vel, lacus. "
-                                 "Praesent nec nisl a purus blandit viverra. "
-                                 "Cras id dui.",
-                    "max_length": 255,
-                    "placeholder": "john@doe.com"
-                },
-                "test_text": {
-                    "type": "string",
-                    "required": false,
-                    "read_only": false,
-                    "label": "Test text",
-                    "help_text": "Sed lectus. Phasellus gravida semper "
-                                 "nisi. Curabitur at lacus ac velit ornare "
-                                 "lobortis. Mauris turpis nunc, blandit et, "
-                                 "volutpat molestie, porta ut, ligula. Lorem "
-                                 "ipsum dolor sit amet, consectetuer "
-                                 "adipiscing elit.",
-                    "max_length": 255,
-                    "placeholder": "Lorem ipsum dolor sit amet"
-                },
-                "test_url": {
-                    "type": "url",
-                    "required": false,
-                    "read_only": false,
-                    "label": "Test URL",
-                    "max_length": 255,
-                    "initial": "http://github.com"
-                },
-                "test_decimal_field": {
-                    "type": "decimal",
-                    "required": false,
-                    "read_only": false,
-                    "label": "Test decimal field",
-                    "min_value": 1.0,
-                    "max_value": 25.0,
-                    "initial": 10.0,
-                    "placeholder": "3.14",
-                    "max_digits": 5,
-                    "decimal_places": 2
-                },
-                "test_float_field": {
-                    "type": "float",
-                    "required": false,
-                    "read_only": false,
-                    "label": "Test float field",
-                    "min_value": 1.0,
-                    "max_value": 10.0,
-                    "initial": 3.14
-                },
-                "test_ip_address": {
-                    "type": "string",
-                    "required": false,
-                    "read_only": false,
-                    "label": "Test IP address",
-                    "max_length": 255,
-                    "placeholder": "127,0.0.1"
-                },
-                "test_password_field": {
-                    "type": "string",
-                    "required": false,
-                    "read_only": false,
-                    "label": "Test password field",
-                    "max_length": 255,
-                    "placeholder": "your-secret-password"
-                },
-                "test_regex_field": {
-                    "type": "regex",
-                    "required": false,
-                    "read_only": false,
-                    "label": "Test regex field",
-                    "max_length": 255,
-                    "regex": "^([a-zA-Z])+$"
-                },
-                "test_slug_field": {
-                    "type": "slug",
-                    "required": false,
-                    "read_only": false,
-                    "label": "Test slug field",
-                    "max_length": 255,
-                    "placeholder": "lorem-ipsum-dolor-sit-amet"
-                },
-                "test_textarea_field": {
-                    "type": "string",
-                    "required": false,
-                    "read_only": false,
-                    "label": "Test textarea field",
-                    "placeholder": "Pellentesque habitant morbi tristique."
-                },
-                "test_input_field": {
-                    "type": "string",
-                    "required": false,
-                    "read_only": true,
-                    "label": "Test input field",
-                    "max_length": 255,
-                    "autofocus": "autofocus",
-                    "autocomplete": "on",
-                    "disabled": "disabled"
-                },
-                "content_image_url_b0996b16-9f1c-430d-a6c7-0a722f4c2177": {
-                    "type": "content",
-                    "required": false,
-                    "read_only": true,
-                    "initial": "<p><img src=\"http://example.com/image.jpg\" alt=\"n.n.\" width=\"600\"/></p>",
-                    "contenttype": "image",
-                    "raw_data": {
-                        "url": "http://example.com/image.jpg",
-                        "alt": "n.n.",
-                        "fit_method": "fit_width",
-                        "size": "600x600"
-                    },
-                    "content": "<p><img src=\"http://example.com/image.jpg\" alt=\"n.n.\" width=\"600\"/></p>"
-                },
-                "content_text_de4d69b2-99e1-479d-8c61-1534dea7c981": {
-                    "type": "content",
-                    "required": false,
-                    "read_only": true,
-                    "initial": "<p>Pellentesque posuere. Quisque id mi. "
-                               "Duis arcu tortor, suscipit eget, imperdiet "
-                               "nec, imperdiet iaculis, ipsum. Phasellus a "
-                               "est. In turpis.</p>",
-                    "contenttype": "text",
-                    "raw_data": {
-                        "text": "Pellentesque posuere. Quisque id mi. Duis "
-                                "arcu tortor, suscipit eget, imperdiet nec, "
-                                "imperdiet iaculis, ipsum. Phasellus a est. "
-                                "In turpis."
-                    },
-                    "content": "<p>Pellentesque posuere. Quisque id mi. Duis "
-                               "arcu tortor, suscipit eget, imperdiet nec, "
-                               "imperdiet iaculis, ipsum. Phasellus a est. "
-                               "In turpis.</p>"
-                },
-                "content_video_f4799aca-9a0b-4f1a-8069-dda611858ef4": {
-                    "type": "content",
-                    "required": false,
-                    "read_only": true,
-                    "initial": "<iframe src=\"//www.youtube.com/embed/8GVIui0JK0M\" width=\"500\" height=\"400\" frameborder=\"0\" allowfullscreen></iframe>",
-                    "contenttype": "video",
-                    "raw_data": {
-                        "title": "Delusional Insanity - To far beyond...",
-                        "url": "https://www.youtube.com/watch?v=8GVIui0JK0M&t=1s",
-                        "size": "500x400"
-                    },
-                    "content": "<iframe src=\"//www.youtube.com/embed/8GVIui0JK0M\" width=\"500\" height=\"400\" frameborder=\"0\" allowfullscreen></iframe>"
-                }
-            }
-        }
-    }
-
-**Some insights:**
-
-Meta-data is passed to the ``DRFIntegrationFormElementPluginProcessor`` as
-``field_metadata`` argument, which is supposed to be a dict.
-
-- `Example 1: content_image plugin
-  <https://github.com/barseghyanartur/django-fobi/blob/master/src/fobi/contrib/apps/drf_integration/form_elements/content/content_image/base.py#L54>`_
-
-- `Example 2: decimal plugin
-  <https://github.com/barseghyanartur/django-fobi/blob/master/src/fobi/contrib/apps/drf_integration/form_elements/fields/decimal/base.py#L86>`_
-
-- `Example 3: text plugin
-  <https://github.com/barseghyanartur/django-fobi/blob/master/src/fobi/contrib/apps/drf_integration/form_elements/fields/text/base.py#L55>`_
-
-Private forms would be only visible to authenticated users.
-
-PUT
-###
-.. code-block:: text
-
-    PUT /api/fobi-form-entry/{FORM_SLUG}/
-
-    {DATA}
-
-Callbacks
-~~~~~~~~~
-Callbacks work just the same way the core callbacks work.
-
-fobi_form_callbacks.py
-######################
-.. code-block:: python
-
-    from fobi.base import (
-        integration_form_callback_registry,
-        IntegrationFormCallback,
-    )
-
-    from fobi.constants import (
-        CALLBACK_BEFORE_FORM_VALIDATION,
-        CALLBACK_FORM_INVALID,
-        CALLBACK_FORM_VALID,
-        CALLBACK_FORM_VALID_AFTER_FORM_HANDLERS,
-        CALLBACK_FORM_VALID_BEFORE_SUBMIT_PLUGIN_FORM_DATA,
-    )
-
-    from fobi.contrib.apps.drf_integration import UID as INTEGRATE_WITH
-
-
-    class DRFSaveAsFooItem(IntegrationFormCallback):
-        """Save the form as a foo item, if certain conditions are met."""
-
-        stage = CALLBACK_FORM_VALID
-        integrate_with = INTEGRATE_WITH
-
-        def callback(self, form_entry, request, **kwargs):
-            """Custom callback login comes here."""
-            logger.debug("Great! Your form is valid!")
-
-
-    class DRFDummyInvalidCallback(IntegrationFormCallback):
-        """Saves the form as a foo item, if certain conditions are met."""
-
-        stage = CALLBACK_FORM_INVALID
-        integrate_with = INTEGRATE_WITH
-
-        def callback(self, form_entry, request, **kwargs):
-            """Custom callback login comes here."""
-            logger.debug("Damn! You've made a mistake, boy!")
-
-Testing
-~~~~~~~
-To test Django REST framework integration package only, run the following
-command:
-
-.. code-block:: sh
-
-    ./runtests.py src/fobi/tests/test_drf_integration.py
-
-or use plain Django tests:
-
-.. code-block:: sh
-
-    ./manage.py test fobi.tests.test_drf_integration --settings=settings.test
-
-Limitations
-~~~~~~~~~~~
-Certain fields are not available yet (relational fields).
-
-
-Form elements
--------------
-
-
-Content form element
-~~~~~~~~~~~~~~~~~~~~
-Presentational form elements for ``drf_integration``.
-
-
-fobi.contrib.apps.drf_integration.form_elements.content.content_image
-#####################################################################
-A ``django-fobi`` ContentImage plugin for integration with
-``Django REST framework``. Makes use of the
-``fobi.contrib.apps.drf_integration.fields.ContentImage``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.content.content_image``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.content.content_image',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-Usage
-^^^^^
-Unlike standard fields, ``ContentImage`` field is purely presentational.
-You're not supposed to make write actions on it (it won't work). Neither
-will it be displayed in the browsable API (list/retrieve actions). However,
-it will be listed in the options action call.
-
-**Sample JSON response fragment**
-
-.. code-block:: javascript
-
-    "actions": {
-        "PUT": {
-            // ...
-            "content_image_89c8c319-195b-487a-a44d-f59ef14a5d44": {
-                "type": "content",
-                "required": false,
-                "read_only": true,
-                "contenttype": "image",
-                "content": "\n<p>\n\n\n\n\n<img src=\"/media/fobi_plugins/content_image/test-image-thumbnail.jpg\" alt=\"Lorem ipsum\"/>\n\n\n</p>\n",
-                "raw": {
-                    "file": "/media/fobi_plugins/content_image/test-image.jpg",
-                    "alt": "Lorem ipsum",
-                    "fit_method": "center",
-                    "size": "500x500"
-                }
-            },
-            // ...
-        }
-    }
-
-**JSON response fragment explained**
-
-- ``type`` (str): Set to "content" for all presentational form elements.
-- ``contenttype`` (str): Set to "image" for ``ContentImage`` field.
-- ``content`` (str): Representation of the content. Rendered partial HTML.
-- ``raw`` (json dict): Raw attributes of the ``ContentImage`` plugin. Contains
-  "file", "alt", "fit_method" and "size" attributes.
-
-
-fobi.contrib.apps.drf_integration.form_elements.content.content_image_url
-#########################################################################
-A ``django-fobi`` ContentImageURL plugin for integration with
-``Django REST framework``. Makes use of the
-``fobi.contrib.apps.drf_integration.fields.ContentImage``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.content.content_image_url``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.content.content_image_url',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-Usage
-^^^^^
-Unlike standard fields, ``ContentImageURL`` field is purely presentational.
-You're not supposed to make write actions on it (it won't work). Neither
-will it be displayed in the browsable API (list/retrieve actions). However,
-it will be listed in the options action call.
-
-**Sample JSON response fragment**
-
-.. code-block:: javascript
-
-    "actions": {
-        "PUT": {
-            // ...
-            "content_image_89c8c319-195b-487a-a44d-f59ef14a5d44": {
-                "type": "content",
-                "required": false,
-                "read_only": true,
-                "contenttype": "image",
-                "content": "\n<p>\n\n\n\n\n<img src=\"http://example.com/media/test-image.jpg\" alt=\"Lorem ipsum\"/>\n\n\n</p>\n",
-                "raw": {
-                    "url": "http://example.com/media/test-image.jpg",
-                    "alt": "Lorem ipsum",
-                    "fit_method": "fit_width",
-                    "size": "500x500"
-                }
-            },
-            // ...
-        }
-    }
-
-**JSON response fragment explained**
-
-- ``type`` (str): Set to "content" for all presentational form elements.
-- ``contenttype`` (str): Set to "image" for ``ContentImageURL`` field.
-- ``content`` (str): Representation of the content. Rendered partial HTML.
-- ``raw`` (json dict): Raw attributes of the ``ContentImageURL`` plugin.
-  Contains "url", "alt", "fit_method" and "size" attributes.
-
-
-fobi.contrib.apps.drf_integration.form_elements.content.content_richtext
-########################################################################
-A ``django-fobi`` ContentRichText plugin for integration with
-``Django REST framework``. Makes use of the
-``fobi.contrib.apps.drf_integration.fields.ContentRichText``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.content.content_richtext``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.content.content_richtext',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-Usage
-^^^^^
-Unlike standard fields, ``ContentText`` field is purely presentational.
-You're not supposed to make write actions on it (it won't work). Neither
-will it be displayed in the browsable API (list/retrieve actions). However,
-it will be listed in the options action call.
-
-**Sample JSON response fragment**
-
-.. code-block:: javascript
-
-    "actions": {
-        "PUT": {
-            // ...
-            "content_text_89c8c319-195b-487a-a44d-f59ef14a5d44": {
-                "type": "content",
-                "required": false,
-                "read_only": true,
-                "contenttype": "text",
-                "content": "\n<p>\n\nLorem ipsum dolor sit amet.\n\n\n</p>\n",
-                "raw": {
-                    "text": "Lorem ipsum dolor sit amet."
-                }
-            },
-            // ...
-        }
-    }
-
-**JSON response fragment explained**
-
-- ``type`` (str): Set to "content" for all presentational form elements.
-- ``contenttype`` (str): Set to "text" for ``ContentText`` field.
-- ``content`` (str): Representation of the content. Rendered partial HTML.
-- ``raw`` (json dict): Raw attributes of the ``ContentText`` plugin. Contains
-  "text" attribute.
-
-
-fobi.contrib.apps.drf_integration.form_elements.content.content_text
-####################################################################
-A ``django-fobi`` ContentText plugin for integration with
-``Django REST framework``. Makes use of the
-``fobi.contrib.apps.drf_integration.fields.ContentText``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.content.content_text``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.content.content_text',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-Usage
-^^^^^
-Unlike standard fields, ``ContentText`` field is purely presentational.
-You're not supposed to make write actions on it (it won't work). Neither
-will it be displayed in the browsable API (list/retrieve actions). However,
-it will be listed in the options action call.
-
-**Sample JSON response fragment**
-
-.. code-block:: javascript
-
-    "actions": {
-        "PUT": {
-            // ...
-            "content_text_89c8c319-195b-487a-a44d-f59ef14a5d44": {
-                "type": "content",
-                "required": false,
-                "read_only": true,
-                "contenttype": "text",
-                "content": "\n<p>\n\nLorem ipsum dolor sit amet.\n\n\n</p>\n",
-                "raw": {
-                    "text": "Lorem ipsum dolor sit amet."
-                }
-            },
-            // ...
-        }
-    }
-
-**JSON response fragment explained**
-
-- ``type`` (str): Set to "content" for all presentational form elements.
-- ``contenttype`` (str): Set to "text" for ``ContentText`` field.
-- ``content`` (str): Representation of the content. Rendered partial HTML.
-- ``raw`` (json dict): Raw attributes of the ``ContentText`` plugin. Contains
-  "text" attribute.
-
-
-fobi.contrib.apps.drf_integration.form_elements.content.content_video
-#####################################################################
-A ``django-fobi`` ContentVideo plugin for integration with
-``Django REST framework``. Makes use of the
-``fobi.contrib.apps.drf_integration.fields.ContentVideo``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.content.content_video``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.content.content_video',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-Usage
-^^^^^
-Unlike standard fields, ``ContentVideo`` field is purely presentational.
-You're not supposed to make write actions on it (it won't work). Neither
-will it be displayed in the browsable API (list/retrieve actions). However,
-it will be listed in the options action call.
-
-**Sample JSON response fragment**
-
-.. code-block:: javascript
-
-    "actions": {
-        "PUT": {
-            // ...
-            "content_video_41a6b951-e6f9-4f08-ada6-3b109aa9a72f": {
-                "type": "content",
-                "required": false,
-                "read_only": true,
-                "contenttype": "video",
-                "content": "\n<iframe src=\"//www.youtube.com/embed/3P1qcVcs4Ik\" width=\"500\" height=\"400\" frameborder=\"0\" allowfullscreen></iframe>\n",
-                "raw": {
-                    "title": "Cras risus ipsum faucibus",
-                    "url": "https://www.youtube.com/watch?v=3P1qcVcs4Ik",
-                    "size": "500x400"
-                }
-            },
-            // ...
-        }
-    }
-
-**JSON response fragment explained**
-
-- ``type`` (str): Set to "content" for all presentational form elements.
-- ``contenttype`` (str): Set to "video" for ``ContentVideo`` field.
-- ``content`` (str): Representation of the content. Rendered partial HTML.
-- ``raw`` (json dict): Raw attributes of the ``ContentVideo`` plugin. Contains
-  "title", "url" and "size" attributes.
-
-
-Fields
-~~~~~~
-Form fields for ``drf_integration``.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.boolean
-##############################################################
-A ``django-fobi`` BooleanField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.BooleanField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.boolean`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.boolean',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.checkbox_select_multiple
-###############################################################################
-A ``django-fobi`` CharField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.MultipleChoiceField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.checkbox_select_multiple``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.checkbox_select_multiple',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.date
-###########################################################
-A ``django-fobi`` DateField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.DateField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.date`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.date',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.date_drop_down
-#####################################################################
-A ``django-fobi`` DateField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.DateField``.
-
-This plugin has been made primarily for compatibility with ``date_drop_down``
-plugin of the core package.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.date_drop_down``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.date_drop_down',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.datetime
-###############################################################
-A ``django-fobi`` DateField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.DateTimeField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.datetime`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.datetime',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.decimal
-##############################################################
-A ``django-fobi`` DecimalField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.DecimalField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.decimal`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.decimal',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.email
-############################################################
-A ``django-fobi`` EmailField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.EmailField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.email`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.email',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.file
-###########################################################
-A ``django-fobi`` FileField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.FileField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.file`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.file',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.float
-############################################################
-A ``django-fobi`` FloatField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.FloatField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.float`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.float',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.hidden
-#############################################################
-A ``django-fobi`` HiddenField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.HiddenField``.
-
-Note, that in terms of the Django REST framework it is a read-only field.
-Any values posted along won't be saved. Initial value would.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.hidden`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.hidden',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.input
-############################################################
-A ``django-fobi`` CharField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.CharField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.input`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.input',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.integer
-##############################################################
-A ``django-fobi`` IntegerField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.IntegerField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.integer`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.integer',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.ip_address
-#################################################################
-A ``django-fobi`` IPAddressField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.IPAddressField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.ip_address`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.ip_address',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.null_boolean
-###################################################################
-A ``django-fobi`` NullBooleanField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.NullBooleanField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.null_boolean``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.null_boolean',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.password
-###############################################################
-A ``django-fobi`` CharField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.CharField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.password`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.password',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.radio
-############################################################
-A ``django-fobi`` CharField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.ChoiceField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.radio`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.radio',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.range_select
-###################################################################
-A ``django-fobi`` ChoiceField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.ChoiceField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.range_select``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.range_select',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.regex
-############################################################
-A ``django-fobi`` RegexField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.RegexField``.
-
-Installation
-^^^^^^^^^^^^
-1. Add ``fobi.contrib.apps.drf_integration.form_elements.fields.regex`` to
-   the ``INSTALLED_APPS`` in your ``settings.py``.
-
-.. code-block:: python
-
-    INSTALLED_APPS = (
-        # ...
-        'fobi.contrib.apps.drf_integration.form_elements.fields.regex',
-        # ...
-    )
-
-2. In the terminal type:
-
-.. code-block:: sh
-
-    ./manage.py fobi_sync_plugins
-
-3. Assign appropriate permissions to the target users/groups to be using
-   the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.select
-#############################################################
-A ``django-fobi`` ChoiceField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.ChoiceField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.select``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.select',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.select_multiple
-######################################################################
-A ``django-fobi`` CharField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.MultipleChoiceField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.select_multiple``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.select_multiple',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.select_multiple
-######################################################################
-A ``django-fobi`` CharField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.MultipleChoiceField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.select_multiple``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.select_multiple',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.slider
-#############################################################
-A ``django-fobi`` ChoiceField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.ChoiceField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.slider``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.slider',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.slug
-###########################################################
-A ``django-fobi`` SlugField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.SlugField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.slug`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.slug',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.text
-###########################################################
-A ``django-fobi`` CharField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.CharField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.text`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.text',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.textarea
-###############################################################
-A ``django-fobi`` CharField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.CharField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.textarea`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.textarea',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.time
-###########################################################
-A ``django-fobi`` TimeField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.TimeField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.time`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.time',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_elements.fields.url
-##########################################################
-A ``django-fobi`` URLField plugin for integration with
-``Django REST framework``. Makes use of the
-``rest_framework.fields.URLField``.
-
-Installation
-^^^^^^^^^^^^
-(1) Add ``fobi.contrib.apps.drf_integration.form_elements.fields.time`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_elements.fields.url',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-Form handlers
--------------
-Form handlers for ``drf_integration``.
-
-
-fobi.contrib.apps.drf_integration.form_handlers.db_store
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-A ``django-fobi`` Mail form handler plugin for integration
-with ``Django REST framework``. Saves submitted form data into the
-``SavedFormDataEntry`` model.
-
-Installation
-############
-(1) Add ``fobi.contrib.apps.drf_integration.form_handlers.db_store`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_handlers.db_store',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py migrate
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_handlers.http_repost
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-A ``django-fobi`` HTTP repost form handler plugin for integration
-with ``Django REST framework``. Submits the form to another endpoint specified.
-
-Installation
-############
-(1) Add ``fobi.contrib.apps.drf_integration.form_handlers.http_respost`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_handlers.http_repost',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.drf_integration.form_handlers.mail
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-A ``django-fobi`` Mail form handler plugin for integration
-with ``Django REST framework``. Submits the form data by email to the
-specified email address.
-
-Installation
-############
-(1) Add ``fobi.contrib.apps.drf_integration.form_handlers.mail`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.apps.drf_integration.form_handlers.mail',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py migrate
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.apps.feincms_integration
--------------------------------------
-A ``django-fobi`` integration with FeinCMS.
-
-Prerequisites
-~~~~~~~~~~~~~
-Tested with FeinCMS 1.10, 1.12 and 1.13 only. Might work on earlier (or
-later) versions as well.
-
-Installation
-~~~~~~~~~~~~
-Versions
-########
-See the requirements files:
-
-- `FeinCMS 1.10 requirements
-  <https://github.com/barseghyanartur/django-fobi/blob/stable/examples/requirements/feincms_1_10.txt>`_.
-- `FeinCMS 1.12 requirements
-  <https://github.com/barseghyanartur/django-fobi/blob/stable/examples/requirements/feincms_1_12.txt>`_.
-- `FeinCMS 1.13 requirements
-  <https://github.com/barseghyanartur/django-fobi/blob/stable/examples/requirements/feincms_1_13.txt>`_.
-
-your_project/settings.py
-########################
-See the `example settings file
-<https://github.com/barseghyanartur/django-fobi/blob/stable/examples/simple/settings/bootstrap3_theme_feincms.py>`_.
-
-.. code-block:: python
-
-    INSTALLED_APPS = list(INSTALLED_APPS)
-    INSTALLED_APPS += [
-        'feincms',  # FeinCMS
-
-        'fobi.contrib.apps.feincms_integration',  # Fobi FeinCMS app
-
-        'page',  # Example
-    ]
-
-    FEINCMS_RICHTEXT_INIT_CONTEXT = {
-        'TINYMCE_JS_URL': STATIC_URL + 'tiny_mce/tiny_mce.js',
-    }
-
-your_project/page/models.py
-###########################
-.. code-block:: python
-
-    from django.utils.translation import ugettext_lazy as _
-
-    from feincms.module.page.models import Page
-    from feincms.content.raw.models import RawContent
-    from feincms.content.richtext.models import RichTextContent
-    # Import the ``django-fobi`` widget.
-    from fobi.contrib.apps.feincms_integration.widgets import FobiFormWidget
-
-    Page.register_extensions('feincms.module.extensions.translations',)
-
-    # Register basic template.
-    Page.register_templates(
-        {
-            'title': _(u"Base template"),
-            'path': 'page/base.html',
-            'key': 'page_base',
-            'regions': (
-                ('main', _(u"Main")),
-                ('sidebar', _(u"Sidebar")),
-            )
-        },
-        )
-
-    # Standard content types
-    Page.create_content_type(RawContent)
-    Page.create_content_type(RichTextContent)
-
-    # Register the ``django-fobi`` widget.
-    Page.create_content_type(FobiFormWidget)
-
-your_project/admin.py
-#####################
-.. code-block:: python
-
-    from django.contrib import admin
-
-    from feincms.module.page.modeladmins import PageAdmin
-
-    from page.models import Page
-
-    admin.site.register(Page, PageAdmin)
-
-Information for developers
-##########################
-Template rendering
-^^^^^^^^^^^^^^^^^^
-The embed FeinCMS widget is rendered with use of two theme templates:
-
-- ``view_embed_form_entry_ajax_template``: Used for rendering the form.
-- ``embed_form_entry_submitted_ajax_template``: Used for rendering the form
-  sent event.
-
-Using custom templates for rendering the widget
-###############################################
-In the widget, you can specify a template which you want to be used for
-rendering the form or the form-sent event.
-
-Example:
-
-.. code-block:: python
-
-    FOBI_FEINCMS_INTEGRATION_FORM_TEMPLATE_CHOICES = (
-        ("yourapp/custom_view_embed_form_v1.html",
-         "Custom embed form view template #1"),
-        ("yourapp/custom_view_embed_form_v2.html",
-         "Custom embed form view template #2"),
-    )
-
-Same goes for form-sent templates.
-
-.. code-block:: python
-
-    FOBI_FEINCMS_INTEGRATION_SUCCESS_PAGE_TEMPLATE_CHOICES = (
-        ("yourapp/custom_embed_form_submitted_v1.html",
-         "Custom form-sent template #1"),
-        ("yourapp/custom_embed_form_submitted_v2.html",
-         "Custom form-sent template #2"),
-    )
-
-Registering a template in the ``FORM_TEMPLATE_CHOICES`` makes it available
-for all the themes. If you rather want to use different custom templates
-for different themes, use the ``FOBI_CUSTOM_THEME_DATA`` as shown in the
-example below.
-
-.. code-block:: python
-
-    FOBI_CUSTOM_THEME_DATA = {
-        'bootstrap3': {
-            'feincms_integration': {
-                'form_template_choices': [
-                    ('fobi/bootstrap3_extras/view_embed_form.html',
-                     "Custom bootstrap3 embed form view template"),
-                ],
-                'success_page_template_choices': [
-                    ('fobi/bootstrap3_extras/embed_form_submitted.html',
-                     "Custom bootstrap3 embed form entry submitted template"),
-                ],
-            },
-        },
-        'foundation5': {
-            'feincms_integration': {
-                'form_template_choices': [
-                    ('fobi/foundation5_extras/view_embed_form.html',
-                     "Custom foundation5 embed form view template"),
-                ],
-                'success_page_template_choices': [
-                    ('fobi/foundation5_extras/embed_form_submitted.html',
-                     "Custom foundation5 embed form entry submitted template"),
-                ],
-            },
-        },
-    }
-
-Usage
-~~~~~
-The ``fobi.contrib.apps.feincms_integration.widgets.FobiFormWidget`` consists
-of the following fields:
-
-- Form: The form to be used.
-- Form template name: Template to be used to render the embed form.
-- Hide form title: If checked, no form title would be shown.
-- Form title: Overrides the standard form title.
-- Submit button text: Overrides the default submit button text.
-- Success page template name: Template to be used to render the embed form-sent
-  event.
-- Hide success page title: If checked, no form-sent title would be shown.
-- Success page title: Overrides the form-sent title.
-- Success page text: Overrides the form-sent text.
-
-
-fobi.contrib.apps.mezzanine_integration
----------------------------------------
-A ``django-fobi`` integration with Mezzanine.
-
-Prerequisites
-~~~~~~~~~~~~~
-Tested with Mezzanine 3.1.10 and 4.2.3 only. Might work on earlier (or
-later) versions as well.
-
-Installation
-~~~~~~~~~~~~
-Versions
-########
-See the requirements files:
-
-- `Mezzanine 4.2.3 requirements
-  <https://github.com/barseghyanartur/django-fobi/blob/stable/examples/mezzanine_example/requirements.txt>`_.
-
-your_project/settings.py
-########################
-See the `example settings file
-<https://github.com/barseghyanartur/django-fobi/blob/stable/examples/mezzanine_example/settings.py>`_.
-
-.. code-block:: python
-
-    INSTALLED_APPS = list(INSTALLED_APPS)
-    INSTALLED_APPS += [
-        # Standard mezzanine apps
-
-        'fobi.contrib.apps.mezzanine_integration',  # Fobi Mezzanine app
-    ]
-
-Information for developers
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-Template rendering
-##################
-The form embed into Mezzanine page is rendered with use of two theme templates:
-
-- ``view_embed_form_entry_ajax_template``: Used for rendering the form.
-- ``embed_form_entry_submitted_ajax_template``: Used for rendering the form
-  sent event.
-
-Using custom templates for rendering the form
-#############################################
-In the widget, you can specify a template which you want to be used for
-rendering the form or the form-sent event.
-
-Example:
-
-.. code-block:: python
-
-    FOBI_MEZZANINE_INTEGRATION_FORM_TEMPLATE_CHOICES = (
-        ("yourapp/custom_view_embed_form_v1.html",
-         "Custom embed form view template #1"),
-        ("yourapp/custom_view_embed_form_v2.html",
-         "Custom embed form view template #2"),
-    )
-
-Same goes for form-sent templates.
-
-.. code-block:: python
-
-    FOBI_MEZZANINE_INTEGRATION_SUCCESS_PAGE_TEMPLATE_CHOICES = (
-        ("yourapp/custom_embed_form_submitted_v1.html",
-         "Custom form-sent template #1"),
-        ("yourapp/custom_embed_form_submitted_v2.html",
-         "Custom form-sent template #2"),
-    )
-
-Registering a template in the ``FORM_TEMPLATE_CHOICES`` makes it available
-for all the themes. If you rather want to use different custom templates
-for different themes, use the ``FOBI_CUSTOM_THEME_DATA`` as shown in the
-example below.
-
-.. code-block:: python
-
-    FOBI_CUSTOM_THEME_DATA = {
-        'bootstrap3': {
-            'mezzanine_integration': {
-                'form_template_choices': [
-                    ('fobi/bootstrap3_extras/view_embed_form.html',
-                     "Custom bootstrap3 embed form view template"),
-                ],
-                'success_page_template_choices': [
-                    ('fobi/bootstrap3_extras/embed_form_submitted.html',
-                     "Custom bootstrap3 embed form entry submitted template"),
-                ],
-            },
-        },
-        'foundation5': {
-            'mezzanine_integration': {
-                'form_template_choices': [
-                    ('fobi/foundation5_extras/view_embed_form.html',
-                     "Custom foundation5 embed form view template"),
-                ],
-                'success_page_template_choices': [
-                    ('fobi/foundation5_extras/embed_form_submitted.html',
-                     "Custom foundation5 embed form entry submitted template"),
-                ],
-            },
-        },
-    }
-
-Usage
-~~~~~
-The ``fobi`` page model
-#######################
-The ``fobi.contrib.apps.mezzanine_integration.models.FobiFormPage`` consists
-of the following fields:
-
-- Form: The form to be used.
-- Form template name: Template to be used to render the embed form.
-- Hide form title: If checked, no form title would be shown.
-- Form title: Overrides the standard form title.
-- Submit button text: Overrides the default submit button text.
-- Success page template name: Template to be used to render the embed form-sent
-  event.
-- Hide success page title: If checked, no form-sent title would be shown.
-- Success page title: Overrides the form-sent title.
-- Success page text: Overrides the form-sent text.
-
-Steps described
-###############
-1. If you use the mezzanine `example
-   <https://github.com/barseghyanartur/django-fobi/blob/stable/examples/mezzanine_example/>`_
-   project, to start go to the http://localhost:8003/fobi/ URL and create a
-   form.
-2. Then go to http://localhost:8003/admin/pages/page/ and add a new `Fobi form`
-   page.
-3. Choose the form and optionally - override the form settings and then
-   save the page.
-4. See the page in the front-end.
-
-
-fobi.contrib.plugins.form_elements.content.content_image
---------------------------------------------------------
-A ``Fobi`` Image form element plugin.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.content.content_image`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'easy_thumbnails',
-            'fobi.contrib.plugins.form_elements.content.content_image',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) Additionally, for the fine tuning, see the
-    ``fobi.contrib.plugins.form_elements.content.content_image.defaults``
-    module. If necessary, override the settings by prepending
-    ``FOBI_PLUGIN_CONTENT_IMAGE_`` to the desired variable name from the
-    above mentioned ``defaults`` module.
-
-
-fobi.contrib.plugins.form_elements.content.content_image_url
-------------------------------------------------------------
-A ``Fobi`` ImageURL form element plugin.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.content.content_image_url`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.content.content_image_url',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) Additionally, for the fine tuning, see the
-    ``fobi.contrib.plugins.form_elements.content.content_image_url.defaults``
-    module. If necessary, override the settings by prepending
-    ``FOBI_PLUGIN_CONTENT_IMAGE_URL_`` to the desired variable name from the
-    above mentioned ``defaults`` module.
-
-
-fobi.contrib.plugins.form_elements.content.content_text
--------------------------------------------------------
-A ``Fobi`` Text form element plugin.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.content.content_text`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.content.content_text',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) Additionally, for the fine tuning, see the
-    ``fobi.contrib.plugins.form_elements.content.content_text.defaults``
-    module. If necessary, override the settings by prepending
-    ``FOBI_PLUGIN_CONTENT_TEXT_`` to the desired variable name from the
-    above mentioned ``defaults`` module.
-
-    By default the content of the text field is stripped using either the
-    awesome `bleach <https://bleach.readthedocs.io/>`_ library or if bleach
-    is not installed just Django's own `strip_tags` function. To configure
-    the strip (bleach only) behaviour, two settings are introduced:
-
-    .. code-block:: text
-
-       - ALLOWED_TAGS:
-       - ALLOWED_ATTRIBUTES:
-
-    The default values are:
-
-    .. code-block:: python
-
-        ALLOWED_TAGS = [
-            'a',
-            'abbr',
-            'acronym',
-            'b',
-            'blockquote',
-            'code',
-            'em',
-            'i',
-            'li',
-            'ol',
-            'strong',
-            'ul',
-        ]
-
-        ALLOWED_ATTRIBUTES = {
-            'a': ['href', 'title'],
-            'abbr': ['title'],
-            'acronym': ['title'],
-        }
-
-
-fobi.contrib.plugins.form_elements.content.content_richtext
------------------------------------------------------------
-
-A ``Fobi`` Rich text form element plugin based on
-`CKEditor <https://ckeditor.com/>`_ and
-`django-ckeditor <https://github.com/django-ckeditor/django-ckeditor>`_.
-
-Installation
-~~~~~~~~~~~~
-
-(1) Install ``django-ckeditor``.
-
-    .. code-block:: sh
-
-        pip install django-ckeditor
-
-(2) Add ``ckeditor`` to ``INSTALLED_APPS`` in ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            ...
-            'ckeditor',
-            ...
-        )
-
-(3) Add ``fobi.contrib.plugins.form_elements.content.content_richtext`` to
-    ``INSTALLED_APPS`` in ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            ...
-            'fobi.contrib.plugins.form_elements.content.content_richtext',
-            ...
-        )
-
-(4) Add ``fobi.contrib.themes.bootstrap3.widgets.form_elements.content_richtext_bootstrap3_widget`` to
-    ``INSTALLED_APPS`` in ``settings.py`` (if you're using ``bootstrap3`` theme).
-    If you're using another theme, add correspondent widget specific to the
-    active theme.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            ...
-            'fobi.contrib.themes.bootstrap3.widgets.form_elements.content_richtext_bootstrap3_widget',
-            ...
-        )
-
-(5) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(6) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to ``True``.
-
-Controlling HTML tags and attributes
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-(1) Install ``bleach``.
-
-    .. code-block:: sh
-
-        pip install bleach
-
-(2) Specify ``FOBI_PLUGIN_CONTENT_RICHTEXT_ALLOWED_TAGS``,
-    ``FOBI_PLUGIN_CONTENT_RICHTEXT_ALLOWED_ATTRIBUTES`` and
-    ``FOBI_PLUGIN_CONTENT_RICHTEXT_ALLOWED_STYLES`` in
-    ``settings.py``. The default values come from bleach:
-
-    .. code-block:: python
-
-        FOBI_PLUGIN_CONTENT_RICHTEXT_ALLOWED_TAGS = [
-            'a',
-            'abbr',
-            'acronym',
-            'b',
-            'blockquote',
-            'code',
-            'em',
-            'i',
-            'li',
-            'ol',
-            'strong',
-            'ul',
-        ]
-
-        FOBI_PLUGIN_CONTENT_RICHTEXT_ALLOWED_ATTRIBUTES = {
-            'a': ['href', 'title'],
-            'abbr': ['title'],
-            'acronym': ['title'],
-        }
-
-        FOBI_PLUGIN_CONTENT_RICHTEXT_ALLOWED_STYLES = []
-
-
-fobi.contrib.plugins.form_elements.content.content_video
---------------------------------------------------------
-A ``Fobi`` Video form element plugin.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.content.content_video`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.content.content_video',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) Additionally, for the fine tuning, see the
-    ``fobi.contrib.plugins.form_elements.content.content_video.defaults``
-    module. If necessary, override the settings by prepending
-    ``FOBI_PLUGIN_CONTENT_VIDEO_`` to the desired variable name from the
-    above mentioned ``defaults`` module.
-
-
-fobi.contrib.plugins.form_elements.fields.boolean
--------------------------------------------------
-A ``Fobi`` Boolean form field plugin. Makes use of the
-``django.forms.fields.BooleanField``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.boolean`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.boolean',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.fields.checkbox_select_multiple
-------------------------------------------------------------------
-A ``Fobi`` Select Multiple form field plugin. Makes use of the
-``django.forms.fields.MultipleChoiceField`` and
-``django.forms.widgets.CheckboxSelectMultiple``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.checkbox_select_multiple``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.checkbox_select_multiple',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) By default, the submitted form value of `checkbox_select_multiple`
-    elements is label (human readable representation of the value chosen).
-    However, that part of the behaviour has been made configurable. You can
-    choose between the following options:
-
-    Consider the following list of (value, label) choices (the first element in
-    the tuple is value, the second element is label):
-
-    .. code-block:: python
-
-        [
-            ('alpha', 'Alpha'),
-            ('beta', 'Beta'),
-            ('gamma', 'Gamma'),
-        ]
-
-    - "val": `value` (example: "alpha").
-    - "repr" (default): `label` (example: "Alpha").
-    - "mix": `value (label)` (example: "Alpha (alpha)").
-
-    Simply set the
-    ``FOBI_FORM_ELEMENT_CHECKBOX_SELECT_MULTIPLE_SUBMIT_VALUE_AS`` assign one
-    of the following values: "val", "repr" or "mix" to get the desired
-    behaviour.
-
-Usage
-~~~~~
-You should be entering a single choice per line. Choice might
-consist of just a single value or value/label pair.
-
-For example:
-
-.. code-block:: text
-
-    1
-    2
-    alpha, Alpha
-    beta, Beta
-    omega
-
-The following HTML would be made of:
-
-.. code-block:: html
-      
-    <ul id="id_NAME_OF_THE_ELEMENT">
-      <li>
-        <label for="id_NAME_OF_THE_ELEMENT_0">
-          <input class="form-control" id="id_NAME_OF_THE_ELEMENT_0" name="NAME_OF_THE_ELEMENT" type="checkbox" value="1" /> 1
-        </label>
-      </li>
-      <li>
-        <label for="id_NAME_OF_THE_ELEMENT_1">
-          <input class="form-control" id="id_NAME_OF_THE_ELEMENT_1" name="NAME_OF_THE_ELEMENT" type="checkbox" value="2" /> 2
-        </label>
-      </li>
-      <li>
-        <label for="id_NAME_OF_THE_ELEMENT_2">
-          <input class="form-control" id="id_NAME_OF_THE_ELEMENT_2" name="NAME_OF_THE_ELEMENT" type="checkbox" value="alpha" /> Alpha
-        </label>
-      </li>
-      <li>
-        <label for="id_NAME_OF_THE_ELEMENT_3">
-          <input class="form-control" id="id_NAME_OF_THE_ELEMENT_3" name="NAME_OF_THE_ELEMENT" type="checkbox" value="beta" /> Beta
-        </label>
-      </li>
-      <li>
-        <label for="id_NAME_OF_THE_ELEMENT_4">
-          <input class="form-control" id="id_NAME_OF_THE_ELEMENT_4" name="NAME_OF_THE_ELEMENT" type="checkbox" value="omega" /> omega
-        </label>
-      </li>
-    </ul>
-
-
-fobi.contrib.plugins.form_elements.fields.date
-----------------------------------------------
-A ``Fobi`` Date form field plugin. Makes use of the
-``django.forms.fields.DateField`` and ``django.forms.widgets.DateInput``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.date`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.date',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.fields.date_drop_down
---------------------------------------------------------
-A ``Fobi`` Birthday form field plugin. Makes use of the
-``django.forms.fields.DateField`` and
-``django.forms.extras.widgets.SelectDateWidget``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.date_drop_down`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.date_drop_down',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.fields.datetime
---------------------------------------------------
-A ``Fobi`` DateTime form field plugin. Makes use of the
-``django.forms.fields.DateTimeField`` and
-``django.forms.widgets.DateTimeInput``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.datetime`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.datetime',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.fields.decimal
--------------------------------------------------
-A ``Fobi`` Decimal form field plugin. Makes use of the
-``django.forms.fields.DecimalField`` and ``django.forms.widgets.NumberInput``
-(falling back to ``django.forms.widgets.TextInput`` for older Django
-versions).
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.decimal`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.decimal',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.fields.email
------------------------------------------------
-A ``Fobi`` Email form field plugin. Makes use of the
-``django.forms.fields.EmailField`` and ``django.forms.widgets.TextInput``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.email`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.email',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.fields.file
-----------------------------------------------
-A ``Fobi`` File form field plugin. Makes use of the
-``django.forms.fields.FileField`` and
-``django.forms.widgets.ClearableFileInput``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.file`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.file',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) By default uploaded files are stored in the "fobi_plugins/file" directory
-    of the media root. If you want to change the directory location,
-    set the ``FOBI_PLUGIN_FIELDS_FILE_FILES_UPLOAD_DIR`` value to the desired
-    (relative) path.
-
-(5) You may optionally restrict uploaded files extensions by specifying the
-    ``allowed_extensions`` field in the plugin.
-
-
-fobi.contrib.plugins.form_elements.fields.float
------------------------------------------------
-A ``Fobi`` Integer form field plugin. Makes use of the
-``django.forms.fields.FloatField`` and ``django.forms.widgets.NumberInput``
-(falling back to ``django.forms.widgets.TextInput`` for older Django
-versions).
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.float`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.float',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.fields.hidden
-------------------------------------------------
-A ``Fobi`` Hidden form field plugin. Makes use of the
-``django.forms.fields.CharField`` and ``django.forms.widgets.HiddenInput``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.hidden`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.hidden',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.fields.input
------------------------------------------------
-A generic input form field plugin. Makes use of the
-``django.forms.fields.Field`` and ``django.forms.widgets.Input``.
-Comes with a lot of options you likely won't use every day.
-
-The full list of supported HTML properties is listed below:
-
-- autocomplete
-- autofocus
-- disabled
-- list
-- max
-- min
-- multiple
-- pattern
-- placeholder
-- readonly
-- step
-- type
-
-See `w3schools.com <http://www.w3schools.com/tags/tag_input.asp>`_ for further
-explanations.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.input`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.input',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.fields.integer
--------------------------------------------------
-A ``Fobi`` Integer form field plugin. Makes use of the
-``django.forms.fields.IntegerField`` and ``django.forms.widgets.NumberInput``
-(falling back to ``django.forms.widgets.TextInput`` for older Django
-versions).
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.integer`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.integer',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.fields.ip_address
-----------------------------------------------------
-A ``Fobi`` Text form field plugin. Makes use of the
-``django.forms.fields.GenericIPAddressField`` and
-``django.forms.widgets.TextInput``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.ip_address`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.ip_address',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.fields.null_boolean
-------------------------------------------------------
-A ``Fobi`` NullBoolean form field plugin. Makes use of the
-``django.forms.fields.NullBooleanField`` and
-``django.forms.widgets.NullBooleanSelect``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.null_boolean`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.null_boolean',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.fields.password
---------------------------------------------------
-A ``Fobi`` Password form field plugin. Makes use of the
-``django.forms.fields.CharField`` and ``django.forms.widgets.PasswordInput``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.password`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.password',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.fields.radio
------------------------------------------------
-A ``Fobi`` Radio form field plugin. Makes use of the
-``django.forms.fields.ChoiceField`` and ``django.forms.widgets.RadioSelect``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.radio`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.radio',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) By default, the submitted form value of `radio`
-    elements is label (human readable representation of the value chosen).
-    However, that part of the behaviour has been made configurable. You can
-    choose between the following options:
-
-    Consider the following list of (value, label) choices (the first element in
-    the tuple is value, the second element is label):
-
-    .. code-block:: python
-
-        [
-            ('alpha', 'Alpha'),
-            ('beta', 'Beta'),
-            ('gamma', 'Gamma'),
-        ]
-
-    .. code-block:: text
-
-        - "val": `value` (example: "alpha").
-        - "repr" (default): `label` (example: "Alpha").
-        - "mix": `value (label)` (example: "Alpha (alpha)").
-
-    Simply set the
-    ``FOBI_FORM_ELEMENT_RADIO_SUBMIT_VALUE_AS`` assign one of the following
-    values: "val", "repr" or "mix" to get the desired behaviour.
-
-Usage
-~~~~~
-You should be entering a single choice per line. Choice might
-consist of just a single value or value/label pair.
-
-For example:
-
-.. code-block:: text
-
-    1
-    2
-    alpha, Alpha
-    beta, Beta
-    omega
-
-The following HTML would be made of:
-
-.. code-block:: html
-
-    <select id="id_NAME_OF_THE_ELEMENT" name="NAME_OF_THE_ELEMENT">
-      <option value="1">1</option>
-      <option value="2">2</option>
-      <option value="alpha">Alpha</option>
-      <option value="beta">Beta</option>
-      <option value="omega">omega</option>
-    </select>
-
-
-fobi.contrib.plugins.form_elements.fields.range_select
-------------------------------------------------------
-A ``Fobi`` RangeSelect form field plugin. Makes use of the
-``django.forms.fields.ChoiceField`` and ``django.forms.widgets.Select``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.range_select`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.range_select',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) Ranges are specified within the given min/max values. The default values
-    are:
-
-    .. code-block:: text
-
-        - INITIAL: 50
-        - INITIAL_MAX_VALUE: 100
-        - INITIAL_MIN_VALUE: 0
-        - MIN_VALUE: 0
-        - MAX_VALUE: 100
-        - STEP: 1
-
-    However, you can override each of them in the settings of your project by
-    prefixing correspondent names with `FOBI_FORM_ELEMENT_RANGE_SELECT_`:
-
-    .. code-block:: text
-
-        - FOBI_FORM_ELEMENT_RANGE_SELECT_INITIAL
-        - FOBI_FORM_ELEMENT_RANGE_SELECT_INITIAL_MAX_VALUE
-        - FOBI_FORM_ELEMENT_RANGE_SELECT_INITIAL_MIN_VALUE
-        - FOBI_FORM_ELEMENT_RANGE_SELECT_MIN_VALUE
-        - FOBI_FORM_ELEMENT_RANGE_SELECT_MAX_VALUE
-        - FOBI_FORM_ELEMENT_RANGE_SELECT_STEP
-
-(5) By default, the submitted form value of `range_select`
-    elements is label (human readable representation of the value chosen).
-    However, that part of the behaviour has been made configurable. You can
-    choose between the following options:
-
-    Consider the following list of (value, label) choices (the first element in
-    the tuple is value, the second element is label):
-
-    .. code-block:: python
-
-        [
-            ('alpha', 'Alpha'),
-            ('beta', 'Beta'),
-            ('gamma', 'Gamma'),
-        ]
-
-    .. code-block:: text
-
-        - "val": `value` (example: "alpha").
-        - "repr" (default): `label` (example: "Alpha").
-        - "mix": `value (label)` (example: "Alpha (alpha)").
-
-    Simply set the
-    ``FOBI_FORM_ELEMENT_RANGE_SELECT_SUBMIT_VALUE_AS`` assign one of the
-    following values: "val", "repr" or "mix" to get the desired behaviour.
-
-fobi.contrib.plugins.form_elements.fields.regex
------------------------------------------------
-A ``Fobi`` Text form field plugin. Makes use of the
-``django.forms.fields.RegexField`` and ``django.forms.widgets.TextInput``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.regex`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.regex',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.fields.select
-------------------------------------------------
-A ``Fobi`` Select form field plugin. Makes use of the
-``django.forms.fields.ChoiceField`` and ``django.forms.widgets.Select``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.select`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.select',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) By default, the submitted form value of `select`
-    elements is label (human readable representation of the value chosen).
-    However, that part of the behaviour has been made configurable. You can
-    choose between the following options:
-
-    Consider the following list of (value, label) choices (the first element in
-    the tuple is value, the second element is label):
-
-    .. code-block:: python
-
-        [
-            ('alpha', 'Alpha'),
-            ('beta', 'Beta'),
-            ('gamma', 'Gamma'),
-        ]
-
-    .. code-block:: text
-
-        - "val": `value` (example: "alpha").
-        - "repr" (default): `label` (example: "Alpha").
-        - "mix": `value (label)` (example: "Alpha (alpha)").
-
-    Simply set the
-    ``FOBI_FORM_ELEMENT_SELECT_SUBMIT_VALUE_AS`` assign one of the following
-    values: "val", "repr" or "mix" to get the desired behaviour.
-
-Usage
-~~~~~
-You should be entering a single choice per line. Choice might
-consist of just a single value or value/label pair.
-
-For example:
-
-.. code-block:: text
-
-    1
-    2
-    alpha, Alpha
-    beta, Beta
-    omega
-
-The following HTML would be made of:
-
-.. code-block:: html
-
-    <select id="id_NAME_OF_THE_ELEMENT" name="NAME_OF_THE_ELEMENT">
-      <option value="1">1</option>
-      <option value="2">2</option>
-      <option value="alpha">Alpha</option>
-      <option value="beta">Beta</option>
-      <option value="omega">omega</option>
-    </select>
-
-
-fobi.contrib.plugins.form_elements.fields.select_model_object
--------------------------------------------------------------
-A ``Fobi`` Select Model Object form field plugin. Makes use of the
-``django.forms.models.ModelChoiceField`` and ``django.forms.widgets.Select``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.select_model_object`` to
-    the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.select_model_object',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) Make sure to take a look at
-    ``fobi.contrib.plugins.form_elements.fields.select_model_object.defaults.IGNORED_MODELS``.
-    If necessary, override it in your `settings` as shown in the example below:
-
-    .. code-block:: python
-
-        FOBI_FORM_ELEMENT_SELECT_MODEL_OBJECT_IGNORED_MODELS = [
-            'auth.User',
-            'auth.Group',
-        ]
-
-(5) By default, the submitted form value of `select_model_object` elements is
-    `app_label.model_name.object_pk.object_repr`. However, that part of the
-    behaviour has been made configurable. You can choose between the following
-    options:
-
-    .. code-block:: text
-
-        - "val": `app_label.model_name.object_pk.object_repr`.
-        - "repr": `object_repr` (uses the ``__unicode__`` method of the model).
-        - "mix" (default): `app_label.model_name.object_pk.object_repr`.
-
-    Simply set the ``FOBI_FORM_ELEMENT_SELECT_MODEL_OBJECT_SUBMIT_VALUE_AS``
-    assign one of the following values: "val", "repr" or "mix" to get the
-    desired behaviour.
-
-
-fobi.contrib.plugins.form_elements.fields.select_mptt_model_object
-------------------------------------------------------------------
-A ``Fobi`` Select MPTT Model Object form field plugin. Makes use of the
-``mptt.fields.TreeNodeChoiceField`` and ``django.forms.widgets.Select``.
-
-Installation
-~~~~~~~~~~~~
-Install `django-mptt`
-#####################
-Taken from django-mptt `Getting started
-<http://django-mptt.github.io/django-mptt/tutorial.html#getting-started>`_.
-
-1. Download ``django-mptt`` using pip by running:
-
-.. code-block:: sh
-
-    pip install django-mptt
-
-2. Add ``mptt`` to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-Install `select_mptt_model_object` plugin
-#########################################
-(1) Add ``mptt`` and
-    ``fobi.contrib.plugins.form_elements.fields.select_mptt_model_object``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'mptt',
-            'fobi.contrib.plugins.form_elements.fields.select_mptt_model_object',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) Make sure to take a look at
-    ``fobi.contrib.plugins.form_elements.fields.select_mptt_model_object.defaults.IGNORED_MODELS``.
-    If necessary, override it in your `settings` as shown in the example below:
-
-    .. code-block:: python
-
-        FOBI_FORM_ELEMENT_SELECT_MPTT_MODEL_OBJECT_IGNORED_MODELS = [
-            'auth.User',
-            'auth.Group',
-        ]
-
-(5) By default, the submitted form value of `select_mptt_model_object` elements
-    is `app_label.model_name.object_pk.object_repr`. However, that part of the
-    behaviour has been made configurable. You can choose between the following
-    options:
-
-    .. code-block:: text
-
-        - "val": `app_label.model_name.object_pk.object_repr`.
-        - "repr": `object_repr` (uses the ``__unicode__`` method of the model).
-        - "mix" (default): `app_label.model_name.object_pk.object_repr`.
-
-    Simply set the ``FOBI_FORM_ELEMENT_SELECT_MPTT_MODEL_OBJECT_SUBMIT_VALUE_AS``
-    assign one of the following values: "val", "repr" or "mix" to get the
-    desired behaviour.
-
-
-fobi.contrib.plugins.form_elements.fields.select_multiple
----------------------------------------------------------
-A ``Fobi`` Select Multiple form field plugin. Makes use of the
-``django.forms.fields.MultipleChoiceField`` and
-``django.forms.widgets.SelectMultiple``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.select_multiple`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.select_multiple',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) By default, the submitted form value of `select_multiple`
-    elements is label (human readable representation of the value chosen).
-    However, that part of the behaviour has been made configurable. You can
-    choose between the following options:
-
-    Consider the following list of (value, label) choices (the first element in
-    the tuple is value, the second element is label):
-
-    .. code-block:: python
-
-        [
-            ('alpha', 'Alpha'),
-            ('beta', 'Beta'),
-            ('gamma', 'Gamma'),
-        ]
-
-    .. code-block:: text
-
-        - "val": `value` (example: "alpha").
-        - "repr" (default): `label` (example: "Alpha").
-        - "mix": `value (label)` (example: "Alpha (alpha)").
-
-    Simply set the
-    ``FOBI_FORM_ELEMENT_SELECT_MULTIPLE_SUBMIT_VALUE_AS`` assign one of the
-    following values: "val", "repr" or "mix" to get the desired behaviour.
-
-Usage
-~~~~~
-You should be entering a single choice per line. Choice might
-consist of just a single value or value/label pair.
-
-For example:
-
-.. code-block:: text
-
-    1
-    2
-    alpha, Alpha
-    beta, Beta
-    omega
-
-The following HTML would be made of:
-
-.. code-block:: html
-
-    <select id="id_NAME_OF_THE_ELEMENT" name="NAME_OF_THE_ELEMENT">
-      <option value="1">1</option>
-      <option value="2">2</option>
-      <option value="alpha">Alpha</option>
-      <option value="beta">Beta</option>
-      <option value="omega">omega</option>
-    </select>
-
-
-fobi.contrib.plugins.form_elements.fields.select_multiple_model_objects
------------------------------------------------------------------------
-A ``Fobi`` Select Multiple Model Objects form field plugin. Makes use of the
-``django.forms.models.ModelMultipleChoiceField`` and
-``django.forms.widgets.SelectMultiple``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add
-    ``fobi.contrib.plugins.form_elements.fields.select_multiple_model_objects``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.select_multiple_model_objects',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) Make sure to take a look at
-    ``fobi.contrib.plugins.form_elements.fields.select_multiple_model_objects.defaults.IGNORED_MODELS``.
-    If necessary, override it in your `settings` as shown in the example below:
-
-    .. code-block:: python
-
-        FOBI_FORM_ELEMENT_SELECT_MULTIPLE_MODEL_OBJECTS_IGNORED_MODELS = [
-            'auth.User',
-            'auth.Group',
-        ]
-
-(5) By default, the submitted form value of `select_multiple_model_objects`
-    elements is `app_label.model_name.object_pk.object_repr`. However, that
-    part of the behaviour has been made configurable. You can choose between
-    the following options:
-
-    .. code-block:: text
-
-        - "val": `app_label.model_name.object_pk.object_repr`.
-        - "repr": `object_repr` (uses the ``__unicode__`` method of the model).
-        - "mix" (default): `app_label.model_name.object_pk.object_repr`.
-
-    Simply set the
-    ``FOBI_FORM_ELEMENT_SELECT_MULTIPLE_MODEL_OBJECTS_SUBMIT_VALUE_AS`` assign
-    one of the following values: "val", "repr" or "mix" to get the desired
-    behaviour.
-
-
-fobi.contrib.plugins.form_elements.fields.select_multiple_mptt_model_objects
-----------------------------------------------------------------------------
-A ``Fobi`` Select Multiple MPTT Model Objects form field plugin. Makes use of
-the ``mptt.forms.TreeNodeMultipleChoiceField`` and
-``django.forms.widgets.SelectMultiple``.
-
-Installation
-~~~~~~~~~~~~
-Install `django-mptt`
-#####################
-Taken from django-mptt `Getting started
-<http://django-mptt.github.io/django-mptt/tutorial.html#getting-started>`_.
-
-1. Download ``django-mptt`` using pip by running:
-
-.. code-block:: sh
-
-    pip install django-mptt
-
-2. Add ``mptt`` to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-Install `select_multiple_mptt_model_objects` plugin
-###################################################
-(1) Add
-    ``fobi.contrib.plugins.form_elements.fields.select_multiple_mptt_model_objects``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'mptt',
-            'fobi.contrib.plugins.form_elements.fields.select_multiple_mptt_model_objects',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) Make sure to take a look at
-    ``fobi.contrib.plugins.form_elements.fields.select_multiple_mptt_model_objects.defaults.IGNORED_MODELS``.
-    If necessary, override it in your `settings` as shown in the example below:
-
-    .. code-block:: python
-
-        FOBI_FORM_ELEMENT_SELECT_MULTIPLE_MPTT_MODEL_OBJECTS_IGNORED_MODELS = [
-            'auth.User',
-            'auth.Group',
-        ]
-
-(5) By default, the submitted form value of `select_multiple_mptt_model_objects`
-    elements is `app_label.model_name.object_pk.object_repr`. However, that part
-    of the behaviour has been made configurable. You can choose between the
-    following options:
-
-    .. code-block:: text
-
-        - "val": `app_label.model_name.object_pk.object_repr`.
-        - "repr": `object_repr` (uses the ``__unicode__`` method of the model).
-        - "mix" (default): `app_label.model_name.object_pk.object_repr`.
-
-    Simply set the
-    ``FOBI_FORM_ELEMENT_SELECT_MULTIPLE_MPTT_MODEL_OBJECTS_SUBMIT_VALUE_AS``
-    assign one of the following values: "val", "repr" or "mix" to get the
-    desired behaviour.
-
-
-fobi.contrib.plugins.form_elements.fields.select_multiple_with_max
-------------------------------------------------------------------
-A ``Fobi`` Select Multiple form field plugin with max choices. Makes use of
-the ``django.forms.widgets.SelectMultiple``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.select_multiple_with_max``
-    to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.select_multiple_with_max',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) By default, the submitted form value of `select_multiple_with_max`
-    elements is label (human readable representation of the value chosen).
-    However, that part of the behaviour has been made configurable. You can
-    choose between the following options:
-
-    Consider the following list of (value, label) choices (the first element in
-    the tuple is value, the second element is label):
-
-    .. code-block:: python
-
-        [
-            ('alpha', 'Alpha'),
-            ('beta', 'Beta'),
-           ('gamma', 'Gamma'),
-        ]
-
-    .. code-block:: text
-
-        - "val": `value` (example: "alpha").
-        - "repr" (default): `label` (example: "Alpha").
-        - "mix": `value (label)` (example: "Alpha (alpha)").
-
-    Simply set the
-    ``FOBI_FORM_ELEMENT_SELECT_MULTIPLE_WITH_MAX_SUBMIT_VALUE_AS`` assign one of the
-    following values: "val", "repr" or "mix" to get the desired behaviour.
-
-Usage
-~~~~~
-You should be entering a single choice per line. Choice might
-consist of just a single value or value/label pair. If you enter an integer in
-the 'max_choices' field, the user can choose only <max_choices> or less choices.
-
-For example:
-
-.. code-block:: text
-
-    1
-    2
-    alpha, Alpha
-    beta, Beta
-    omega
-
-The following HTML would be made of:
-
-.. code-block:: html
-
-    <select id="id_NAME_OF_THE_ELEMENT" name="NAME_OF_THE_ELEMENT">
-      <option value="1">1</option>
-      <option value="2">2</option>
-      <option value="alpha">Alpha</option>
-      <option value="beta">Beta</option>
-      <option value="omega">omega</option>
-    </select>
-
-
-fobi.contrib.plugins.form_elements.fields.slider
-------------------------------------------------
-A ``Fobi`` Percentage form field plugin. Makes use of the
-``django.forms.fields.ChoiceField`` and ``django.forms.widgets.Select``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.slider`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.slider',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) Ranges are specified within the given min/max values. The default values
-    are:
-
-    .. code-block:: text
-
-       - INITIAL: 50
-       - INITIAL_MAX_VALUE: 100
-       - INITIAL_MIN_VALUE: 0
-       - MIN_VALUE: 0
-       - MAX_VALUE: 100
-       - STEP: 1
-
-    However, you can override each of them in the settings of your project by
-    prefixing correspondent names with `FOBI_FORM_ELEMENT_SLIDER_`:
-
-    .. code-block:: text
-
-       - FOBI_FORM_ELEMENT_SLIDER_INITIAL
-       - FOBI_FORM_ELEMENT_SLIDER_INITIAL_MAX_VALUE
-       - FOBI_FORM_ELEMENT_SLIDER_INITIAL_MIN_VALUE
-       - FOBI_FORM_ELEMENT_SLIDER_MIN_VALUE
-       - FOBI_FORM_ELEMENT_SLIDER_MAX_VALUE
-       - FOBI_FORM_ELEMENT_SLIDER_STEP
-
-(5) By default, the submitted form value of `slider`
-    elements is label (human readable representation of the value chosen).
-    However, that part of the behaviour has been made configurable. You can
-    choose between the following options:
-
-    Consider the following list of (value, label) choices (the first element in
-    the tuple is value, the second element is label):
-
-    .. code-block:: python
-
-        [
-            ('alpha', 'Alpha'),
-            ('beta', 'Beta'),
-            ('gamma', 'Gamma'),
-        ]
-
-    .. code-block:: text
-
-        - "val": `value` (example: "alpha").
-        - "repr" (default): `label` (example: "Alpha").
-        - "mix": `value (label)` (example: "Alpha (alpha)").
-
-    Simply set the
-    ``FOBI_FORM_ELEMENT_SLIDER_SUBMIT_VALUE_AS`` assign one of the following
-    values: "val", "repr" or "mix" to get the desired behaviour.
-
-fobi.contrib.plugins.form_elements.fields.text
-----------------------------------------------
-A ``Fobi`` Text form field plugin. Makes use of the
-``django.forms.fields.CharField`` and ``django.forms.widgets.TextInput``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.text`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.text',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.fields.textarea
---------------------------------------------------
-A ``Fobi`` Textarea form field plugin. Makes use of the
-``django.forms.fields.CharField`` and ``django.forms.widgets.Textarea``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.textarea`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.textarea',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.fields.time
-----------------------------------------------
-A ``Fobi`` DateTime form field plugin. Makes use of the
-``django.forms.fields.TimeField`` and
-``django.forms.widgets.TextInput``.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.time`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.time',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.fields.url
----------------------------------------------
-A ``Fobi`` URL form field plugin. Makes use of the
-``django.forms.fields.URLField`` and ``django.forms.widgets.URLInput`` falling
-back to ``django.forms.widgets.TextInput`` for older Django versions.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.fields.url`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.fields.url',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.security.captcha
----------------------------------------------------
-A `CAPTCHA <http://en.wikipedia.org/wiki/CAPTCHA>`_ form field plugin. Makes
-use of the `django-simple-captcha
-<http://django-simple-captcha.readthedocs.io/en/latest/>`_.
-
-Prerequisites
-~~~~~~~~~~~~~
-You will need ``libfreetype6``, otherwise ``django-simple-captcha`` won't work.
-
-.. code-block:: sh
-
-    sudo apt-get install libfreetype6-dev
-
-Installation
-~~~~~~~~~~~~
-Install `django-simple-captcha`
-###############################
-Taken from django-simple-captcha `installation instructions
-<http://django-simple-captcha.readthedocs.org/en/latest/usage.html#installation>`_.
-
-(1) Download ``django-simple-captcha`` using pip by running:
-
-    .. code-block:: sh
-
-        pip install django-simple-captcha
-
-(2) Add ``captcha`` to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-(3) Run ``python manage.py migrate``.
-
-(4) Add an entry to your ``urls.py``:
-
-    .. code-block:: python
-
-        urlpatterns += [
-            url(r'^captcha/', include('captcha.urls')),
-        ]
-
-Install `fobi` Captcha plugin
-#############################
-(1) Add ``fobi.contrib.plugins.form_elements.security.captcha`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.security.captcha',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) In order to have nicer text input widget, add the following line
-    to your settings (if you're using bootstrap3 theme):
-
-    .. code-block:: python
-
-        CAPTCHA_TEXT_FIELD_TEMPLATE = 'bootstrap3/captcha/text_field.html'
-
-    For foundation5 theme add the following line:
-
-    .. code-block:: python
-
-        CAPTCHA_TEXT_FIELD_TEMPLATE = 'foundation5/captcha/text_field.html'
-
-Troubleshooting and usage limitations
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-In combination with other captcha solutions
-###########################################
-At the moment, you can't use both ``CAPTCHA``
-(fobi.contrib.plugins.form_elements.security.captcha) and ``ReCAPTCHA``
-(fobi.contrib.plugins.form_elements.security.recaptcha) plugins alongside due
-to app name collision of the ``django-simple-captcha`` and ``django-recaptcha``
-packages.
-
-Usage
-~~~~~
-Note, that unlike most of the other form element plugins, default
-value for the ``required`` attribute is True, which makes the Captcha
-obligatory. Although you could still set it to False, it does not make
-much sense to do so.
-
-
-fobi.contrib.plugins.form_elements.security.honeypot
-----------------------------------------------------
-A `Honeypot <http://en.wikipedia.org/wiki/Honeypot_%28computing%29>`_
-form field plugin. Just another anti-spam technique.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.security.honeypot`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.security.honeypot',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_elements.security.recaptcha
------------------------------------------------------
-A `ReCAPTCHA <http://en.wikipedia.org/wiki/ReCAPTCHA>`_ form field plugin.
-Makes use of the `django-recaptcha
-<https://github.com/praekelt/django-recaptcha>`_.
-
-Installation
-~~~~~~~~~~~~
-Install `django-recaptcha`
-##########################
-(1) Download ``django-recaptcha`` using pip by running:
-
-    .. code-block:: sh
-
-        pip install django-recaptcha
-
-(2) Add ``captcha`` to the ``INSTALLED_APPS`` in your ``settings.py``.
-
-(3) Run ``python manage.py migrate``.
-
-Install `fobi` ReCAPTCHA plugin
-###############################
-(1) Add ``fobi.contrib.plugins.form_elements.security.recaptcha`` to the
-   ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.security.recaptcha',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-   the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) Specify the following ReCAPTCHA credentials in your settings:
-
-    .. code-block:: text
-
-       - ``RECAPTCHA_PUBLIC_KEY``
-       - ``RECAPTCHA_PRIVATE_KEY``
-
-For testing purposes obtain the keys `here
-<https://developers.google.com/recaptcha/docs/faq#id-like-to-run-automated-tests-with-recaptcha.-what-should-i-do>`_:
-
-Troubleshooting and usage limitations
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-In combination with other captcha solutions
-###########################################
-At the moment, you can't use both ``CAPTCHA``
-(fobi.contrib.plugins.form_elements.security.captcha) and ``ReCAPTCHA``
-(fobi.contrib.plugins.form_elements.security.recaptcha) plugins alongside due
-to app name collision of the ``django-simple-captcha`` and ``django-recaptcha``
-packages.
-
-If you happen to see errors like "Input error: k: Format of site key was
-invalid", make sure to have defined (and filled in properly) the
-``RECAPTCHA_PUBLIC_KEY`` and ``RECAPTCHA_PRIVATE_KEY`` in your settings.py.
-See the `following <https://github.com/praekelt/django-recaptcha/issues/32>`_
-thread for more information.
-
-Usage
-~~~~~
-Note, that unlike most of the other form element plugins, default
-value for the ``required`` attribute is True, which makes the ReCaptcha
-obligatory. Although you could still set it to False, it does not make
-much sense to do so.
-
-
-fobi.contrib.plugins.form_elements.test.dummy
----------------------------------------------
-A ``Fobi`` Dummy form element plugin. Created for testing purposes.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_elements.test.dummy`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.test.dummy',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_handlers.db_store
--------------------------------------------
-A ``Fobi`` Database Store form-/wizard- handler plugin. Saves submitted form
-data into the ``SavedFormDataEntry``/``SavedFormWizardDataEntry`` models.
-
-Dependencies
-~~~~~~~~~~~~
-The `xlwt <https://pypi.python.org/pypi/xlwt>`_ package is required
-(optional) for XLS export. If not present, export format falls back
-to CSV.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_handlers.db_store`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_handlers.db_store',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py migrate
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-(4) Add db_store form handler plugin URLs to the urls.py of your project.
-
-    .. code-block:: python
-
-        urlpatterns = [
-            # DB Store plugin URLs
-            url(r'^fobi/plugins/form-handlers/db-store/',
-                include('fobi.contrib.plugins.form_handlers.db_store.urls')),
-        ]
-
-    For form wizards do:
-
-    .. code-block:: python
-
-        urlpatterns = [
-            # DB Store plugin URLs
-            url(r'^fobi/plugins/form-wizard-handlers/db-store/',
-                include('fobi.contrib.plugins.form_handlers.db_store.urls.'
-                        'form_wizard_handlers')),
-        ]
-
-
-fobi.contrib.plugins.form_handlers.http_repost
-----------------------------------------------
-A ``Fobi`` HTTP Repost form handler plugin. Submits the form
-data as is to the given endpoint.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_handlers.http_repost`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_handlers.http_repost',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-fobi.contrib.plugins.form_handlers.mail
----------------------------------------
-A ``Fobi`` Mail form handler plugin. Submits the form
-data by email to the specified email address.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.plugins.form_handlers.mail`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_handlers.mail',
-            # ...
-        )
-
-(2) In the terminal type:
-
-    .. code-block:: sh
-
-        ./manage.py fobi_sync_plugins
-
-(3) Assign appropriate permissions to the target users/groups to be using
-    the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
-
-
-mailchimp_importer
-------------------
-A ``django-fobi`` integration with MailChimp.
-
-This plugin makes it possible to import a form from a MailChimp list. A typical
-list URL would be `this <https://us5.admin.mailchimp.com/lists/>`_. In the
-listing you would see list names and `Stats` at the right corner. If you click
-on it you would see the `Settings` link. Follow it and scroll to the bottom for
-the unique id for your list. Now, if you have been successfully authenticated
-to the MailChimp API using your API_KEY, you could call the `lists.merge_vars`
-method for getting the form. API_KEY could be obtained from the MailChimp
-in the `Account API <https://us5.admin.mailchimp.com/account/api/>`_.
-
-For additional information on MailChimp import see the following `article
-<http://kb.mailchimp.com/lists/managing-subscribers/manage-list-and-signup-form-fields>`_.
-
-Prerequisites
-~~~~~~~~~~~~~
-Python wrapper for the Mailchimp:
-
-.. code-block:: sh
-
-   pip install mailchimp
-
-If you are using Django 1.8 or greater, you would need `django-formtools`
-package as well:
-
-.. code-block:: sh
-
-   pip install django-formtools
-
-Installation
-~~~~~~~~~~~~
-your_project/settings.py
-########################
-.. code-block:: python
-
-    INSTALLED_APPS = list(INSTALLED_APPS)
-    INSTALLED_APPS += [
-        'fobi.contrib.plugins.form_importers.mailchimp_importer',
-    ]
-
-How it works
-~~~~~~~~~~~~
-Assuming that you have configured the `mailchimp_importer` plugin properly and
-have the Django running locally on port 8000, accessing the following URL would
-bring you to the MailChimp form import wizard.
-
-- http://localhost:8000/en/fobi/forms/importer/mailchimp/
-
-On the first step you would be asked to provide your API_KEY, which is used
-to authenticate to the MailChimp in order to fetch your list- and form-
-information. The key isn't stored/saved/remembered. Next time you want to
-import a form from the same account, you would have to provide it again.
-
-Development status
-~~~~~~~~~~~~~~~~~~
-This part of code is alpha, which means it experimental and needs improvements.
-
-See the `TODOS <https://raw.githubusercontent.com/barseghyanartur/django-fobi/master/TODOS.rst>`_
-for the full list of planned-, pending- in-development- or to-be-implemented
-features.
-
-If you want to improve it or did make it working, please, make a pull request.
-
-
-fobi.contrib.themes.bootstrap3
-------------------------------
-A ``django-fobi`` Bootstrap 3 theme. Based on the ??? template.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.themes.bootstrap3`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.themes.bootstrap3',
-            # ...
-        )
-
-(2) Specify ``bootstrap3`` as a default theme in your ``settings.py``:
-
-    .. code-block:: python
-
-        FOBI_DEFAULT_THEME = 'bootstrap3'
-
-
-fobi.contrib.themes.djangocms_admin_style_theme
------------------------------------------------
-A ``django-fobi`` theme in a style of ``djangocms-admin-style`` admin.
-Relies on ``djangocms-admin-style`` package and some jQuery UI only.
-
-jQuery UI "Smoothness" theme comes from `here <http://jqueryui.com/>`_.
-
-Installation
-~~~~~~~~~~~~
-Install `djangocms-admin-style`
-###############################
-See the original `installation instructions
-<https://pypi.python.org/pypi/djangocms-admin-style#installation>`_.
-
-(1) Install the ``djangocms-admin-style`` package.
-
-    .. code-block:: sh
-
-        pip install djangocms-admin-style
-
-(2) Add ``djangocms_admin_style`` to your ``INSTALLED_APPS`` just before
-    ``django.contrib.admin``.
-
-Install `fobi.contrib.themes.djangocms_admin_style_theme` theme
-###############################################################
-(1) Add ``fobi.contrib.themes.djangocms_admin_style_theme`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.themes.djangocms_admin_style_theme',
-            # ...
-        )
-
-(2) Specify ``djangocms_admin_style_theme`` as a default theme in your
-    ``settings.py``:
-
-    .. code-block:: python
-
-        FOBI_DEFAULT_THEME = 'djangocms_admin_style_theme'
-
-
-fobi.contrib.themes.foundation5
--------------------------------
-A ``django-fobi`` Foundation 5 theme. Based on the ??? template, but
-entire JS and CSS are taken from Foundation 5 version 5.4.0. The
-`following <http://zurb.com/playground/foundation-icon-fonts-3>`_ icon set
-was used.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.themes.foundation5`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.themes.foundation5',
-            # ...
-        )
-
-(2) Specify ``foundation5`` as a default theme in your ``settings.py``:
-
-    .. code-block:: python
-
-        FOBI_DEFAULT_THEME = 'foundation5'
-
-
-fobi.contrib.themes.simple
---------------------------
-A ``django-fobi`` theme in a style of Django admin. Relies on Django-admin
-and some jQuery UI only.
-
-jQuery UI "Django" theme comes from `here
-<http://jqueryui.com/themeroller/#!zThemeParams=5d000001004406000000000000003d8888d844329a8dfe02723de3e5702531794cd29e6ed19a93500bec10499630a65410e41ead4c600a0cf20b340bb5e2f7caf959ed396c92b6035d90d24df6690df466ac448d4e1c19e7fa7c9a0839be4194bf063920ea1af50a8118ad9351aef9ad563b3a37cd36e7495624fe90fc1dea5e04da5c3bc1b05fbaabd52118818b56bf553915a91d00d5f3e6d7170d10432c322c435542e105860d86f5aff187d2c5fd576473852b0a11341f0f25f44acc20995011eacc757f738992c953dbc7a1465ffdb121cb5442e4eab396fc706de223fe0fc9c95a7d117899db8aa67ebf8d5b547778d8301f54035188d6f909c525eba7227394e77fa275211eca51b9a828c4266d31e94e9ad9d094e2d5313fc059abfb69532833a14287184b79fd3e769e36246d5f0b3f8fb23a589e0ce916bb6b074faf8dbac4a8f379a481f14755e3043f7a684ccde3630e138ed0ed7e0e4af40517ffcf11fd3581d7da611c79f6481f3e02d2d1645c776ada5da686c7e62ad51e829cf9ba6ec42e0a7afa3dcaed299f70bd4a28055aa8c0f6d9d1d5f362280aff2c9be5d5355c0e15c5145565ac449331112dd272ba1c7f326f3502465763e229cdc80dec6054935a2c4ef8b62e3f00a7bee54e59377abda70f8f3fbd15004573b3372aaddd79545e195b14abddcb8dc730dc65504265aece22ee6158670dbc2d11f314ffebbc5e3d>`_.
-
-Installation
-~~~~~~~~~~~~
-(1) Add ``fobi.contrib.themes.simple`` to the
-    ``INSTALLED_APPS`` in your ``settings.py``.
-
-    .. code-block:: python
-
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.themes.simple',
-            # ...
-        )
-
-(2) Specify ``simple`` as a default theme in your ``settings.py``:
-
-    .. code-block:: python
-
-        FOBI_DEFAULT_THEME = 'simple'
-
-
+.. include:: ../README.rst
+.. include:: screenshots.rst
+.. include:: submodules.rst
+.. include:: ../src/fobi/contrib/apps/djangocms_integration/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/content/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/content/content_image/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/content/content_image_url/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/content/content_markdown/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/content/content_richtext/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/content/content_text/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/content/content_video/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/boolean/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/checkbox_select_multiple/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/date/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/date_drop_down/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/datetime/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/decimal/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/duration/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/email/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/file/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/float/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/hidden/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/input/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/integer/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/ip_address/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/null_boolean/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/password/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/radio/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/range_select/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/regex/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/select/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/select_model_object/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/select_multiple/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/select_multiple_model_objects/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/select_multiple_with_max/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/slider/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/slug/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/text/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/textarea/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/time/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_elements/fields/url/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_handlers/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_handlers/db_store/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_handlers/http_repost/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_handlers/mail/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/drf_integration/form_handlers/mail_sender/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/feincms_integration/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/mezzanine_integration/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/apps/wagtail_integration/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/content/content_image/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/content/content_image_url/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/content/content_markdown/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/content/content_richtext/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/content/content_text/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/content/content_video/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/boolean/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/checkbox_select_multiple/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/date/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/date_drop_down/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/datetime/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/decimal/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/duration/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/email/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/file/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/float/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/hidden/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/hidden_model_object/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/input/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/integer/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/ip_address/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/null_boolean/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/password/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/radio/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/range_select/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/regex/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/select/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/select_model_object/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/select_mptt_model_object/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/select_multiple/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/select_multiple_model_objects/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/select_multiple_mptt_model_objects/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/select_multiple_with_max/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/slider/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/slug/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/text/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/textarea/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/time/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/fields/url/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/security/captcha/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/security/honeypot/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/security/invisible_recaptcha/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/security/recaptcha/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_elements/test/dummy/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_handlers/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_handlers/db_store/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_handlers/http_repost/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_handlers/mail/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_handlers/mail_sender/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_importers/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/plugins/form_importers/mailchimp_importer/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/themes/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/themes/bootstrap3/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/themes/djangocms_admin_style_theme/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/themes/foundation5/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/contrib/themes/simple/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/integration/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/reusable/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/reusable/markdown_widget/README.rst
+.. include:: empty.rst
+.. include:: ../src/fobi/wizard/README.rst
+.. include:: empty.rst
+.. include:: documentation.rst
diff --git a/docs/licenses.rst b/docs/licenses.rst
index ff12c33f..5af9afc6 100644
--- a/docs/licenses.rst
+++ b/docs/licenses.rst
@@ -1,182 +1 @@
-========
-Licenses
-========
-Below information about third-party packages used in the project is presented.
-
-Bootstrap3
-==========
-http://getbootstrap.com/
-
-Licensing information:
-
-- Apache license 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
-
-Bootstrap 3 DateTime picker
-===========================
-http://eonasdan.github.io/bootstrap-datetimepicker/
-
-- MIT (http://opensource.org/licenses/mit-license.html)
-
-bootstrap-slider
-================
-https://github.com/seiyria/bootstrap-slider
-
-- MIT (http://opensource.org/licenses/mit-license.html)
-
-django-autoslug
-===============
-https://bitbucket.org/neithere/django-autoslug
-
-Licensing information:
-
-- LGPL 3 (https://www.gnu.org/licenses/lgpl.html)
-
-django-formtools
-================
-https://github.com/django/django-formtools
-
-Licensing information:
-
-- BSD (http://opensource.org/licenses/BSD-3-Clause)
-
-django-nine
-===========
-https://github.com/barseghyanartur/django-nine
-
-Licensing information:
-
-- GPL 2.0 (http://www.gnu.org/licenses/gpl-2.0.html)
-- LGPL 2.1 (https://www.gnu.org/licenses/lgpl-2.1.html)
-
-django-nonefield
-================
-https://github.com/barseghyanartur/django-nonefield
-
-Licensing information:
-
-- GPL 2.0 (http://www.gnu.org/licenses/gpl-2.0.html)
-- LGPL 2.1 (https://www.gnu.org/licenses/lgpl-2.1.html)
-
-easy-thumbnails
-===============
-https://github.com/SmileyChris/easy-thumbnails
-
-Licensing information:
-
-- BSD (http://opensource.org/licenses/BSD-3-Clause)
-
-Font-awesome
-============
-http://fontawesome.io/
-
-Licensing information:
-
-- http://fontawesome.io/license/
-- SIL OFL 1.1 (http://scripts.sil.org/OFL)
-- MIT (http://opensource.org/licenses/mit-license.html)
-
-Foundation 5
-============
-http://foundation.zurb.com/
-
-Licensing information:
-
-- MIT (http://opensource.org/licenses/mit-license.html)
-
-Foundation 5 DateTime picker
-============================
-https://github.com/aliibrahim/foundation-datetimepicker-rails
-
-Licensing information:
-
-- MIT (http://opensource.org/licenses/mit-license.html)
-
-jQuery Colorbox
-===============
-http://www.jacklmoore.com/colorbox/
-
-Licensing information:
-
-- MIT (http://www.opensource.org/licenses/mit-license.php)
-
-jQuery
-======
-https://jquery.org
-
-Licensing information:
-
-- https://jquery.org/license/
-- MIT (http://github.com/jquery/jquery/blob/master/MIT-LICENSE.txt)
-
-jQueryUI
-========
-http://jqueryui.com/
-
-Licensing information:
-
-- MIT (https://github.com/jquery/jquery-ui/blob/master/MIT-LICENSE.txt)
-
-jQuery-Slugify-Plugin
-=====================
-https://github.com/pmcelhaney/jQuery-Slugify-Plugin
-
-Licensing information:
-
-- BSD (https://github.com/pmcelhaney/jQuery-Slugify-Plugin/blob/master/LICENSE).
-
-moment.js
-=========
-http://momentjs.com/
-
-Licensing information:
-
-- MIT (http://opensource.org/licenses/mit-license.html)
-
-ordereddict
-===========
-https://pypi.python.org/pypi/ordereddict
-
-Licensing information:
-
-- MIT (http://opensource.org/licenses/mit-license.html)
-
-Pillow
-======
-http://python-pillow.github.io/
-
-Licensing information:
-
-- Python Imaging Library license (http://www.pythonware.com/products/pil/)
-
-Requests
-========
-https://python-requests.org
-
-Licensing information:
-
-- MIT (http://opensource.org/licenses/mit-license.html)
-
-Six
-===
-https://bitbucket.org/gutworth/six/
-
-Licensing information:
-
-- Apache 2.0 (http://opensource.org/licenses/Apache-2.0)
-
-Unidecode
-=========
-https://pypi.python.org/pypi/Unidecode
-
-Licensing information:
-
-- GPL 2.0 (http://www.gnu.org/licenses/gpl-2.0.html)
-
-vishap
-======
-https://pypi.python.org/pypi/vishap
-
-Licensing information:
-
-- GPL 2.0 (http://www.gnu.org/licenses/gpl-2.0.html)
-- LGPL 2.1 (https://www.gnu.org/licenses/lgpl-2.1.html)
+.. include:: ../LICENSES.rst
\ No newline at end of file
diff --git a/docs/quickstart.rst b/docs/quickstart.rst
index cdcbdbc5..285cd08e 100644
--- a/docs/quickstart.rst
+++ b/docs/quickstart.rst
@@ -1,275 +1 @@
-===========
-Quick start
-===========
-Tutorial for very quick start with ``django-fobi``. Consists of
-several parts listed below::
-
-- Part 1: Standard Django installation
-- Part 2: Integration with DjangoCMS (coming soon)
-
-Part 1: standard Django installation
-====================================
-Example project code available `here
-<https://github.com/barseghyanartur/django-fobi/tree/master/examples/quick_start>`_.
-
-Installation and configuration
-------------------------------
-Install the package in your environment.
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-.. code-block:: sh
-
-    pip install django-fobi
-
-INSTALLED_APPS
-^^^^^^^^^^^^^^
-Add ``fobi`` core and the plugins to the ``INSTALLED_APPS`` of the your
-``settings`` module.
-
-1. The core.
-
-.. code-block:: python
-
-    'fobi',
-
-2. The preferred theme. Bootstrap 3 theme is the default. If you have chosen a
-   different theme, update the value of ``FOBI_DEFAULT_THEME`` accordingly.
-
-.. code-block:: python
-
-    'fobi.contrib.themes.bootstrap3',
-
-3. The form field plugins. Plugins are like blocks. You are recommended to have
-   them all installed. Note, that the following plugins do not have
-   additional dependencies, while some others (like
-   `fobi.contrib.plugins.form_elements.security.captcha
-   <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/security/captcha/>`_
-   or `fobi.contrib.plugins.form_elements.security.recaptcha
-   <https://github.com/barseghyanartur/django-fobi/tree/stable/src/fobi/contrib/plugins/form_elements/security/recaptcha/>`_
-   would require additional packages to be installed. If so, make sure to have
-   installed and configured those dependencies prior adding the dependant
-   add-ons to the ``settings`` module.
-
-.. code-block:: python
-
-    'fobi.contrib.plugins.form_elements.fields.boolean',
-    'fobi.contrib.plugins.form_elements.fields.checkbox_select_multiple',
-    'fobi.contrib.plugins.form_elements.fields.date',
-    'fobi.contrib.plugins.form_elements.fields.date_drop_down',
-    'fobi.contrib.plugins.form_elements.fields.datetime',
-    'fobi.contrib.plugins.form_elements.fields.decimal',
-    'fobi.contrib.plugins.form_elements.fields.email',
-    'fobi.contrib.plugins.form_elements.fields.file',
-    'fobi.contrib.plugins.form_elements.fields.float',
-    'fobi.contrib.plugins.form_elements.fields.hidden',
-    'fobi.contrib.plugins.form_elements.fields.input',
-    'fobi.contrib.plugins.form_elements.fields.integer',
-    'fobi.contrib.plugins.form_elements.fields.ip_address',
-    'fobi.contrib.plugins.form_elements.fields.null_boolean',
-    'fobi.contrib.plugins.form_elements.fields.password',
-    'fobi.contrib.plugins.form_elements.fields.radio',
-    'fobi.contrib.plugins.form_elements.fields.regex',
-    'fobi.contrib.plugins.form_elements.fields.select',
-    'fobi.contrib.plugins.form_elements.fields.select_model_object',
-    'fobi.contrib.plugins.form_elements.fields.select_multiple',
-    'fobi.contrib.plugins.form_elements.fields.select_multiple_model_objects',
-    'fobi.contrib.plugins.form_elements.fields.slug',
-    'fobi.contrib.plugins.form_elements.fields.text',
-    'fobi.contrib.plugins.form_elements.fields.textarea',
-    'fobi.contrib.plugins.form_elements.fields.time',
-    'fobi.contrib.plugins.form_elements.fields.url',
-
-4. The presentational form elements (images, texts, videos).
-
-.. code-block:: python
-
-    'easy_thumbnails',  # Required by `content_image` plugin
-    'fobi.contrib.plugins.form_elements.content.content_image',
-    'fobi.contrib.plugins.form_elements.content.content_image_url',
-    'fobi.contrib.plugins.form_elements.content.content_text',
-    'fobi.contrib.plugins.form_elements.content.content_video',
-
-5. Form handlers. Note, that some of them may require database sync/migration.
-
-.. code-block:: python
-
-    'fobi.contrib.plugins.form_handlers.db_store',
-    'fobi.contrib.plugins.form_handlers.http_repost',
-    'fobi.contrib.plugins.form_handlers.mail',
-    'fobi.contrib.plugins.form_handlers.mail_sender',
-
-Putting all together, you would have something like this.
-
-.. code-block:: python
-
-    INSTALLED_APPS = (
-        # Used by fobi
-        'django.contrib.auth',
-        'django.contrib.contenttypes',
-        'django.contrib.sessions',
-        'django.contrib.sites',
-        'django.contrib.messages',
-        'django.contrib.staticfiles',
-        'django.contrib.admin',
-
-        # ...
-        # Core
-        'fobi',
-
-        # Theme
-        'fobi.contrib.themes.bootstrap3',
-
-        # Form field plugins
-        'fobi.contrib.plugins.form_elements.fields.boolean',
-        'fobi.contrib.plugins.form_elements.fields.checkbox_select_multiple',
-        'fobi.contrib.plugins.form_elements.fields.date',
-        'fobi.contrib.plugins.form_elements.fields.date_drop_down',
-        'fobi.contrib.plugins.form_elements.fields.datetime',
-        'fobi.contrib.plugins.form_elements.fields.decimal',
-        'fobi.contrib.plugins.form_elements.fields.email',
-        'fobi.contrib.plugins.form_elements.fields.file',
-        'fobi.contrib.plugins.form_elements.fields.float',
-        'fobi.contrib.plugins.form_elements.fields.hidden',
-        'fobi.contrib.plugins.form_elements.fields.input',
-        'fobi.contrib.plugins.form_elements.fields.integer',
-        'fobi.contrib.plugins.form_elements.fields.ip_address',
-        'fobi.contrib.plugins.form_elements.fields.null_boolean',
-        'fobi.contrib.plugins.form_elements.fields.password',
-        'fobi.contrib.plugins.form_elements.fields.radio',
-        'fobi.contrib.plugins.form_elements.fields.regex',
-        'fobi.contrib.plugins.form_elements.fields.select',
-        'fobi.contrib.plugins.form_elements.fields.select_model_object',
-        'fobi.contrib.plugins.form_elements.fields.select_multiple',
-        'fobi.contrib.plugins.form_elements.fields.select_multiple_model_objects',
-        'fobi.contrib.plugins.form_elements.fields.slug',
-        'fobi.contrib.plugins.form_elements.fields.text',
-        'fobi.contrib.plugins.form_elements.fields.textarea',
-        'fobi.contrib.plugins.form_elements.fields.time',
-        'fobi.contrib.plugins.form_elements.fields.url',
-
-        # Form element plugins
-        'easy_thumbnails',  # Required by ``content_image`` plugin
-        'fobi.contrib.plugins.form_elements.content.content_image',
-        'fobi.contrib.plugins.form_elements.content.content_image_url',
-        'fobi.contrib.plugins.form_elements.content.content_text',
-        'fobi.contrib.plugins.form_elements.content.content_video',
-
-        # Form handlers
-        'fobi.contrib.plugins.form_handlers.db_store',
-        'fobi.contrib.plugins.form_handlers.http_repost',
-        'fobi.contrib.plugins.form_handlers.mail',
-        'fobi.contrib.plugins.form_handlers.mail_sender',
-
-        # ...
-    )
-
-TEMPLATE_CONTEXT_PROCESSORS
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
-Add ``django.core.context_processors.request`` and
-``fobi.context_processors.theme`` to ``TEMPLATES`` of
-your ``settings`` module.
-
-.. code-block:: python
-
-    TEMPLATES = [
-        {
-            'BACKEND': 'django.template.backends.django.DjangoTemplates',
-            'DIRS': [(os.path.join('path', 'to', 'your', 'templates'))],
-            'OPTIONS': {
-                'context_processors': [
-                    "django.template.context_processors.debug",
-                    'django.template.context_processors.request',
-                    "django.contrib.auth.context_processors.auth",
-                    "django.contrib.messages.context_processors.messages",
-                    "fobi.context_processors.theme",  # Important!
-                    "fobi.context_processors.dynamic_values",  # Optional
-                ],
-                'loaders': [
-                    'django.template.loaders.filesystem.Loader',
-                    'django.template.loaders.app_directories.Loader',
-                    'admin_tools.template_loaders.Loader',
-                ],
-                'debug': DEBUG_TEMPLATE,
-            }
-        },
-    ]
-
-urlpatterns
-^^^^^^^^^^^
-Add the following line to ``urlpatterns`` of your ``urls`` module.
-
-.. code-block:: python
-
-    urlpatterns = [
-        # ...
-
-        # DB Store plugin URLs
-        url(r'^fobi/plugins/form-handlers/db-store/',
-            include('fobi.contrib.plugins.form_handlers.db_store.urls')),
-
-        # View URLs
-        url(r'^fobi/', include('fobi.urls.view')),
-
-        # Edit URLs
-        url(r'^fobi/', include('fobi.urls.edit')),
-
-        # ...
-    ]
-
-Update the database
-^^^^^^^^^^^^^^^^^^^
-1. First you should migrate the database. Depending on your
-   Django version and migration app, this step may vary. Typically as follows:
-
-.. code-block:: sh
-
-    ./manage.py migrate --fake-initial
-
-2. Sync installed ``fobi`` plugins. Go to terminal and type the following
-   command.
-
-.. code-block:: sh
-
-    ./manage.py fobi_sync_plugins
-
-Specify the active theme
-^^^^^^^^^^^^^^^^^^^^^^^^
-Specify the default theme in your ``settings`` module.
-
-.. code-block:: python
-
-    FOBI_DEFAULT_THEME = 'bootstrap3'
-
-Permissions
-^^^^^^^^^^^
-``fobi`` has been built with permissions in mind. Every single form element
-plugin or handler is permission based. If user hasn't been given permission
-to work with a form element or a form handler plugin, he won't be. If you want
-to switch the permission checks off, set the value of
-``FOBI_RESTRICT_PLUGIN_ACCESS`` to False in your `settings` module.
-
-.. code-block:: python
-
-    FOBI_RESTRICT_PLUGIN_ACCESS = False
-
-Otherwise, after having completed all the steps above, do log into the
-Django administration and assign the permissions (to certain user or a group)
-for every single form element or form handler plugin. Bulk assignments work
-as well.
-
-- http://yourdomain.com/admin/fobi/formelement/
-- http://yourdomain.com/admin/fobi/formhandler/
-
-Also, make sure to have the Django model permissions set for following models:
-
-- `fobi.models.FormEntry
-  <https://github.com/barseghyanartur/django-fobi/blob/stable/src/fobi/models.py#L253>`_
-- `fobi.models.FormElementEntry
-  <https://github.com/barseghyanartur/django-fobi/blob/stable/src/fobi/models.py#L427>`_
-- `fobi.models.FormHandlerEntry
-  <https://github.com/barseghyanartur/django-fobi/blob/stable/src/fobi/models.py#L463>`_
-- `fobi.contrib.plugins.form_handlers.db_store.models.SavedFormDataEntry
-  <https://github.com/barseghyanartur/django-fobi/blob/stable/src/fobi/contrib/plugins/form_handlers/db_store/models.py#L52>`_
-
-Part 2: Integration with DjangoCMS
-==================================
-Coming soon...
+.. include:: ../QUICK_START.rst
\ No newline at end of file
diff --git a/docs/screenshots.rst.distrib b/docs/screenshots.rst
similarity index 100%
rename from docs/screenshots.rst.distrib
rename to docs/screenshots.rst
diff --git a/docs/submodules.rst.distrib b/docs/submodules.rst
similarity index 100%
rename from docs/submodules.rst.distrib
rename to docs/submodules.rst
diff --git a/scripts/build_docs.sh b/scripts/build_docs.sh
index ed1d623b..9aa00b00 100755
--- a/scripts/build_docs.sh
+++ b/scripts/build_docs.sh
@@ -1,6 +1,6 @@
 #./scripts/uninstall.sh
 #./scripts/install.sh
-./scripts/prepare_docs.sh
+#./scripts/prepare_docs.sh
 sphinx-build -n -a -b html docs builddocs
 #sphinx-build -n -a -b pdf docs builddocs
 cd builddocs && zip -r ../builddocs.zip . -x ".*" && cd ..
diff --git a/scripts/prepare_docs.sh b/scripts/prepare_docs.sh
index ac440b09..cc3fffdd 100755
--- a/scripts/prepare_docs.sh
+++ b/scripts/prepare_docs.sh
@@ -1,286 +1,286 @@
-cat README.rst \
-    docs/empty.rst.distrib \
-    \
-    docs/screenshots.rst.distrib \
-    docs/empty.rst.distrib \
-    \
-    docs/documentation.rst.distrib \
-    docs/empty.rst.distrib \
-    \
-    docs/submodules.rst.distrib \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/djangocms_integration/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/content/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/content/content_image/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/content/content_image_url/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/content/content_richtext/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/content/content_text/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/content/content_video/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/boolean/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/checkbox_select_multiple/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/date/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/date_drop_down/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/datetime/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/decimal/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/email/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/file/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/float/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/hidden/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/input/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/integer/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/ip_address/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/null_boolean/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/password/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/radio/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/range_select/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/regex/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/select/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/select_multiple/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/select_multiple_with_max/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/slider/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/slug/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/text/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/textarea/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/time/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_elements/fields/url/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_handlers/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_handlers/db_store/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_handlers/http_repost/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/drf_integration/form_handlers/mail/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/feincms_integration/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/apps/mezzanine_integration/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/content/content_image/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/content/content_image_url/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/content/content_text/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/content/content_richtext/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/content/content_video/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/boolean/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/checkbox_select_multiple/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/date/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/date_drop_down/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/datetime/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/decimal/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/email/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/file/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/float/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/hidden/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/input/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/integer/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/ip_address/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/null_boolean/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/password/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/radio/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/range_select/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/regex/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/select/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/select_model_object/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/select_mptt_model_object/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/select_multiple/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/select_multiple_model_objects/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/select_multiple_mptt_model_objects/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/select_multiple_with_max/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/slider/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/text/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/textarea/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/time/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/fields/url/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/security/captcha/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/security/honeypot/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/security/recaptcha/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_elements/test/dummy/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_handlers/db_store/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_handlers/http_repost/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_handlers/mail/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/plugins/form_importers/mailchimp_importer/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/themes/bootstrap3/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/themes/djangocms_admin_style_theme/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/themes/foundation5/README.rst \
-    docs/empty.rst.distrib \
-    \
-    src/fobi/contrib/themes/simple/README.rst \
-    docs/empty.rst.distrib \
-    \
-    > docs/index.rst
-cat QUICK_START.rst > docs/quickstart.rst
-cat CHANGELOG.rst > docs/changelog.rst
-cat LICENSES.rst > docs/licenses.rst
+#cat README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    docs/screenshots.rst.distrib \
+#    docs/empty.rst.distrib \
+#    \
+#    docs/documentation.rst.distrib \
+#    docs/empty.rst.distrib \
+#    \
+#    docs/submodules.rst.distrib \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/djangocms_integration/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/content/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/content/content_image/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/content/content_image_url/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/content/content_richtext/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/content/content_text/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/content/content_video/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/boolean/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/checkbox_select_multiple/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/date/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/date_drop_down/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/datetime/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/decimal/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/email/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/file/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/float/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/hidden/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/input/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/integer/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/ip_address/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/null_boolean/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/password/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/radio/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/range_select/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/regex/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/select/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/select_multiple/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/select_multiple_with_max/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/slider/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/slug/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/text/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/textarea/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/time/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_elements/fields/url/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_handlers/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_handlers/db_store/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_handlers/http_repost/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/drf_integration/form_handlers/mail/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/feincms_integration/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/apps/mezzanine_integration/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/content/content_image/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/content/content_image_url/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/content/content_text/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/content/content_richtext/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/content/content_video/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/boolean/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/checkbox_select_multiple/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/date/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/date_drop_down/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/datetime/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/decimal/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/email/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/file/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/float/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/hidden/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/input/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/integer/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/ip_address/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/null_boolean/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/password/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/radio/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/range_select/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/regex/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/select/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/select_model_object/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/select_mptt_model_object/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/select_multiple/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/select_multiple_model_objects/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/select_multiple_mptt_model_objects/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/select_multiple_with_max/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/slider/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/text/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/textarea/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/time/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/fields/url/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/security/captcha/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/security/honeypot/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/security/recaptcha/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_elements/test/dummy/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_handlers/db_store/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_handlers/http_repost/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_handlers/mail/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/plugins/form_importers/mailchimp_importer/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/themes/bootstrap3/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/themes/djangocms_admin_style_theme/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/themes/foundation5/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    src/fobi/contrib/themes/simple/README.rst \
+#    docs/empty.rst.distrib \
+#    \
+#    > docs/index.rst
+#cat QUICK_START.rst > docs/quickstart.rst
+#cat CHANGELOG.rst > docs/changelog.rst
+#cat LICENSES.rst > docs/licenses.rst
diff --git a/scripts/rebuild_docs.sh b/scripts/rebuild_docs.sh
index 29abaa69..b5a6d30b 100755
--- a/scripts/rebuild_docs.sh
+++ b/scripts/rebuild_docs.sh
@@ -1,6 +1,6 @@
 #./scripts/uninstall.sh
 #./scripts/install.sh
-rm docs/*.rst
+#rm docs/*.rst
 rm -rf builddocs/
 sphinx-apidoc src/fobi --full -o docs -H 'django-fobi' -A 'Artur Barseghyan <artur.barseghyan@gmail.com>' -V '0.1' -f -d 20
 cp docs/conf.distrib docs/conf.py
diff --git a/setup.py b/setup.py
index 607e9c63..6c1b577e 100644
--- a/setup.py
+++ b/setup.py
@@ -94,7 +94,7 @@ try:
     screenshots = screenshots.replace(
         ".. image:: _static",
         ".. figure:: https://github.com/barseghyanartur/django-fobi/raw/"
-        "master/docs/_static",
+        "main/docs/_static",
     )
 except:
     readme = ""
diff --git a/src/fobi/contrib/apps/drf_integration/README.rst b/src/fobi/contrib/apps/drf_integration/README.rst
index b572832a..ee797c1d 100644
--- a/src/fobi/contrib/apps/drf_integration/README.rst
+++ b/src/fobi/contrib/apps/drf_integration/README.rst
@@ -478,13 +478,13 @@ Meta-data is passed to the ``DRFIntegrationFormElementPluginProcessor`` as
 ``field_metadata`` argument, which is supposed to be a dict.
 
 - `Example 1: content_image plugin
-  <https://github.com/barseghyanartur/django-fobi/blob/master/src/fobi/contrib/apps/drf_integration/form_elements/content/content_image/base.py#L54>`_
+  <https://github.com/barseghyanartur/django-fobi/blob/main/src/fobi/contrib/apps/drf_integration/form_elements/content/content_image/base.py#L54>`_
 
 - `Example 2: decimal plugin
-  <https://github.com/barseghyanartur/django-fobi/blob/master/src/fobi/contrib/apps/drf_integration/form_elements/fields/decimal/base.py#L86>`_
+  <https://github.com/barseghyanartur/django-fobi/blob/main/src/fobi/contrib/apps/drf_integration/form_elements/fields/decimal/base.py#L86>`_
 
 - `Example 3: text plugin
-  <https://github.com/barseghyanartur/django-fobi/blob/master/src/fobi/contrib/apps/drf_integration/form_elements/fields/text/base.py#L55>`_
+  <https://github.com/barseghyanartur/django-fobi/blob/main/src/fobi/contrib/apps/drf_integration/form_elements/fields/text/base.py#L55>`_
 
 Private forms would be only visible to authenticated users.
 
diff --git a/src/fobi/contrib/apps/drf_integration/TODOS.rst b/src/fobi/contrib/apps/drf_integration/TODOS.rst
index 550d8296..37b51929 100644
--- a/src/fobi/contrib/apps/drf_integration/TODOS.rst
+++ b/src/fobi/contrib/apps/drf_integration/TODOS.rst
@@ -40,7 +40,7 @@ Must haves
     + Fixed Python3 issues with max_length for text fields.
     + In decimal plugin, if any of the values are None, don't try to cast them
       into Decimal.
-    + Fix this https://github.com/barseghyanartur/django-fobi/blob/master/src/fobi/contrib/apps/drf_integration/views.py#L151
+    + Fix this https://github.com/barseghyanartur/django-fobi/blob/main/src/fobi/contrib/apps/drf_integration/views.py#L151
       It should not be form = ... but serializer = ...
 
 Should haves
diff --git a/src/fobi/contrib/plugins/form_elements/security/recaptcha/README.rst b/src/fobi/contrib/plugins/form_elements/security/recaptcha/README.rst
index 9ac6bb9f..69dbe80b 100644
--- a/src/fobi/contrib/plugins/form_elements/security/recaptcha/README.rst
+++ b/src/fobi/contrib/plugins/form_elements/security/recaptcha/README.rst
@@ -10,9 +10,9 @@ Install `django-recaptcha`
 ##########################
 (1) Download ``django-recaptcha`` using pip by running:
 
-    .. code-block:: sh
+.. code-block:: sh
 
-        pip install django-recaptcha
+    pip install django-recaptcha
 
 (2) Add ``captcha`` to the ``INSTALLED_APPS`` in your ``settings.py``.
 
@@ -21,31 +21,31 @@ Install `django-recaptcha`
 Install `fobi` ReCAPTCHA plugin
 ###############################
 (1) Add ``fobi.contrib.plugins.form_elements.security.recaptcha`` to the
-   ``INSTALLED_APPS`` in your ``settings.py``.
+``INSTALLED_APPS`` in your ``settings.py``.
 
-    .. code-block:: python
+.. code-block:: python
 
-        INSTALLED_APPS = (
-            # ...
-            'fobi.contrib.plugins.form_elements.security.recaptcha',
-            # ...
-        )
+    INSTALLED_APPS = (
+        # ...
+        'fobi.contrib.plugins.form_elements.security.recaptcha',
+        # ...
+    )
 
 (2) In the terminal type:
 
-    .. code-block:: sh
+.. code-block:: sh
 
-        ./manage.py fobi_sync_plugins
+    ./manage.py fobi_sync_plugins
 
 (3) Assign appropriate permissions to the target users/groups to be using
-   the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
+the plugin if ``FOBI_RESTRICT_PLUGIN_ACCESS`` is set to True.
 
 (4) Specify the following ReCAPTCHA credentials in your settings:
 
-    .. code-block:: text
+.. code-block:: text
 
-       - ``RECAPTCHA_PUBLIC_KEY``
-       - ``RECAPTCHA_PRIVATE_KEY``
+   - ``RECAPTCHA_PUBLIC_KEY``
+   - ``RECAPTCHA_PRIVATE_KEY``
 
 For testing purposes obtain the keys `here
 <https://developers.google.com/recaptcha/docs/faq#id-like-to-run-automated-tests-with-recaptcha.-what-should-i-do>`_:
diff --git a/src/fobi/contrib/plugins/form_importers/mailchimp_importer/README.rst b/src/fobi/contrib/plugins/form_importers/mailchimp_importer/README.rst
index 24dbf32b..2348832b 100644
--- a/src/fobi/contrib/plugins/form_importers/mailchimp_importer/README.rst
+++ b/src/fobi/contrib/plugins/form_importers/mailchimp_importer/README.rst
@@ -57,7 +57,7 @@ Development status
 ~~~~~~~~~~~~~~~~~~
 This part of code is alpha, which means it experimental and needs improvements.
 
-See the `TODOS <https://raw.githubusercontent.com/barseghyanartur/django-fobi/master/TODOS.rst>`_
+See the `TODOS <https://raw.githubusercontent.com/barseghyanartur/django-fobi/main/TODOS.rst>`_
 for the full list of planned-, pending- in-development- or to-be-implemented
 features.
 
diff --git a/src/fobi/wizard/README.rst b/src/fobi/wizard/README.rst
index a5e866ae..f6603f7f 100644
--- a/src/fobi/wizard/README.rst
+++ b/src/fobi/wizard/README.rst
@@ -1,3 +1,3 @@
 fobi.wizard
 ===========
-Persistent and working form-wizards for Django.
+Persistent and working form-wizards.