Getting Started


django-dataforms is a Django application that that allows Django forms to be dynamically data-driven. Django form logic is abstracted to the database layer. This allows for quick updates to forms and gives the user access to modify forms through the Django admin interface.


  1. Django 1.3

    django-dataforms has only been tested with 1.3. It might work with previous versions, but has not been tested as such.

  2. JQuery

    django-dataforms uses JQuery for parts of the admin interface. JQuery-UI is also used for date picker fields.


To get this application up and running, please follow the steps below:

  1. Create a Django production environment using the setup of your choice. Refer to:

  2. Create a new Django Project:

    $ startproject <projectname>
  3. Install django-bft to either your PYTHON_PATH or in a folder inside your project:

    • Install from pip:

      $ pip install django-dataforms
    • Download and install from source:

      $ python install
    • Install source to local directory:

      $ python build
      $ cp build/lib/bft /<PROJECT_ROOT>/
  4. Add the following to your file:

    • Add ‘dataforms’, ‘staticfiles’ and ‘admin’ to INSTALLED_APPS:

    • Make sure your static file finders are configured:

    • To maintain data integrity, you’ll need to add the transaction middleware to your This will put all queries from each request into a single transaction—so if something goes wrong, all DB changes from the entire request will not be committed.:

              # ...
  5. Modify as needed. See Dataforms Settings for specifics.

  6. Don’t forget to collect your static files and sync your database:

    $ python syncdb
    $ python collectstatic

Indices and tables