Skip to content

Design contact forms, search forms etc from the Django admin, without writing any code. Integrates with Django CMS.

License

Notifications You must be signed in to change notification settings

IndustriaTech/django-form-designer

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Django Form Designer

A Django app for building many kinds of forms visually, without any programming knowledge.

Key features:

  • Design contact forms, search forms etc from the Django admin, without writing any code
  • Form data can be logged and CSV-exported, sent via e-mail, or forwarded to any web address
  • Integration with Django CMS: Add forms to any page
  • Use drag & drop to change the position of your form fields
  • Fully collapsible admin interface for better overview over your form
  • Implements many form fields included with Django (TextField, EmailField, DateField etc)
  • Validation rules as supplied by Django are fully configurable (maximum length, regular expression etc)
  • Customizable messages and labels
  • Supports POST and GET forms

Installation

This install guide assumes that you are familiar with Python and Django.

  • Install the module using pip:

    $ pip install git://github.com/philomat/django-form-designer.git#egg=django-form-designer
    

    or download it from http://github.com/philomat/django-form-designer, and run the installation script:

    $ python setup.py install
    

Basic setup

  • Add form_designer to your INSTALLED_APPS setting:

    INSTALLED_APPS = (
        ...
        'form_designer',
    )
    
  • Set up the database tables using:

    $ manage.py syncdb
    

    or, if you are using South:

    $ manage.py migrate form_designer
    
  • If you are using django.contrib.staticfiles (recommended), just run the usual command to collect static files:

    $ python manage.py collectstatic
    

    Note

    Please refer to the Django documentation on how to set up the static files app if you have not done that yet.

    If you are not going to use the staticfiles app, you will have to copy the contents of the static folder to the location you are serving static files from.

  • Add the URLs to your URL conf. For instance, in order to make a form named example-form available under http://domain.com/forms/example-form, add the following line to your project's urls.py:

    urlpatterns = patterns('',
        (r'^forms/', include('form_designer.urls')),
        ...
    )
    

    Note

    If you are using the form_designer plugin for Django CMS for making forms public, this step is not necessary.

Using Django Form Designer with Django CMS

  • Add form_designer.contrib.cms_plugins.form_designer_form to your INSTALLED_APPS setting:

    INSTALLED_APPS = (
        ...
        'form_designer.contrib.cms_plugins.form_designer_form',
    )
    
  • Set up the database tables using:

    $ manage.py syncdb
    

You can now add forms to pages created with Django CMS.

Email Headers

In order to add custom header in the emails, sent from the form designer, you can use the FORM_DESIGNER_EMAIL_HEADER setting in your settings.py:

FORM_DESIGNER_EMAIL_HEADER = 'X-Category'

Optional requirements

The form_designer admin interface requires jQuery and the jQuery UI Sortable plugin to make building forms a lot more user-friendly. The two Javascript files are bundled with form_designer. If you want to use you own jquery.js instead because you're already including it anyway, define JQUERY_JS in your settings file. For instance:

JQUERY_JS = 'jquery/jquery-latest.js'

About

Design contact forms, search forms etc from the Django admin, without writing any code. Integrates with Django CMS.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%