https://github.com/MarkusH/django-dynamic-forms

django-dynamic-forms is a reusable Django application to create and configure forms through the admin.
https://github.com/MarkusH/django-dynamic-forms

Last synced: about 1 month ago
JSON representation

django-dynamic-forms is a reusable Django application to create and configure forms through the admin.

• Host: GitHub
• URL: https://github.com/MarkusH/django-dynamic-forms
• Owner: MarkusH
• License: bsd-3-clause
• Created: 2013-09-16T19:02:40.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2019-04-13T09:43:42.000Z (over 5 years ago)
• Last Synced: 2024-07-22T15:43:26.421Z (about 2 months ago)
• Language: Python
• Homepage: https://django-dynamic-forms.readthedocs.org
• Size: 250 KB
• Stars: 156
• Watchers: 13
• Forks: 38
• Open Issues: 12
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

• starred-awesome - django-dynamic-forms - django-dynamic-forms is a reusable Django application to create and configure forms through the admin. (Python)

README

        
===================

Django Dynamic Form

===================

.. image:: http://unmaintained.tech/badge.svg

   :target: http://unmaintained.tech/

   :alt: No Maintenance Intended 

.. image:: https://img.shields.io/pypi/v/django-dynamic-forms.svg

   :target: https://pypi.python.org/pypi/django-dynamic-forms

.. image:: https://img.shields.io/pypi/l/django-dynamic-forms.svg

   :target: https://pypi.python.org/pypi/django-dynamic-forms

.. image:: https://img.shields.io/pypi/dm/django-dynamic-forms.svg

   :target: https://pypi.python.org/pypi/django-dynamic-forms

.. image:: https://img.shields.io/travis/MarkusH/django-dynamic-forms/master.svg

   :target: https://travis-ci.org/MarkusH/django-dynamic-forms

.. image:: https://img.shields.io/codecov/c/github/MarkusH/django-dynamic-forms/master.svg

   :target: https://codecov.io/github/MarkusH/django-dynamic-forms

**django-dynamic-forms** lets you create your forms through the Django admin.

You can add and remove form fields as you need them. That makes it perfect

for creating survey or application forms.

Documentation: https://django-dynamic-forms.readthedocs.org/

INSTALLATION

============

Add ``'dynamic_forms.apps.DynamicFormsConfig'`` to the ``INSTALLED_APPS``::

    INSTALLED_APPS = (

        ...

        'dynamic_forms.apps.DynamicFormsConfig',

        ...

    )

Add ``'dynamic_forms.middlewares.FormModelMiddleware'`` to the

``MIDDLEWARE_CLASSES`` (probably at the end)::

    MIDDLEWARE_CLASSES = (

        ...

        'dynamic_forms.middlewares.FormModelMiddleware'

    )

Add ``'dynamic_forms.urls'`` to the URL patterns::

    urlpatterns = patterns('',

        ...

        url(r'^dynamic_forms/',

            include('dynamic_forms.urls', namespace='dynamic_forms')),

        ...

    )

.. important::

   Make sure that you get the namespace straight: ``dynamic_forms``!

You can set ``DYNAMIC_FORMS_EMAIL_RECIPIENTS`` in your settings to a list of

e-mail addresses. Forms being send via e-mail will then be send to those

addresses instead of those defined in ``settings.ADMINS``. Each recipient will

see *all* other recipients. See `send_mail

`_

in the officiall documentation.

Example

=======

1. Change into the ``example/`` directory

2. Apply all migrations: ``python manage.py migrate``

3. Create a superuser (if not asked before): ``python manage.py createsuperuser``

4. Run ``python manage.py runserver``

The *admin* is available at http://127.0.0.1:8000/admin/.

You can find an example form at http://127.0.0.1:8000/example-form/.

Running the tests

=================

1. Make sure to install tox: ``$ pip install tox``

2. Run ``tox``