Metadata-Version: 1.0
Name: django-forms-builder
Version: 0.1.1
Summary: A Django reusable app providing the ability for admin users to create their own forms within the admin interface drawing from a set of fields defined by the developer.
Home-page: http://bitbucket.org/citrus/django-forms-builder
Author: Stephen McDonald
Author-email: stephen.mc@gmail.com
License: UNKNOWN
Description: Introduction
        ------------
        
        A Django reusable app providing the ability for admin users to create their own forms within the admin interface drawing from a set of fields defined by the developer.
        
        Installation
        ------------
        
        Checkout the source and run ``python setup.py install``. You can then add ``email_extras`` to your ``INSTALLED_APPS`` and ``forms_builder.urls`` to your url conf.
        
        How It Works
        ------------
        
        Two models are defined in forms_builder.models - ``BuiltForm`` and ``BuiltFormSubmission`` which represent a user created form and a submission to that form respectively. ``BuiltForm`` contains two special fields called ``mandatory_extra_fields`` and ``optional_extra_fields``. These are present in the admin interface as a list of checkboxes derived from all the fields on the ``BuiltFormSubmission`` model that have the keyword attribute ``blank`` set to ``True``. The difference between these two sets of fields is whether the fields are mandatory for the website user submitting the form.
        
        The actual form that gets displayed on the website is a ``ModelForm`` for ``BuiltFormSubmission`` and any of the fields within ``mandatory_extra_fields`` and ``optional_extra_fields`` that aren't selected for a given ``BuiltForm`` are excluded from the form on the website. The developer has the ability to define fields that are always present in the website form by not setting the ``blank`` attribute to ``True`` on the relevant fields of the ``BuiltFormSubmission`` model.
        
        Configuration
        -------------
        
        As described above, configuration of website form fields is done entirely on the ``BuiltFormSubmission`` model. Fields with a ``blank`` attribute set to ``True`` will be available as extra fields, and all other fields will always be present on the website form.
        
        There are also two settings you can configure in your project's ``settings`` module:
        
        * ``FORMS_BUILDER_EMAIL_TO`` - An email address that will be sent an email upon each form submission if the ``send_email`` field is set to ``True`` by the admin user for the given ``BuiltForm``.
        
        * ``FORMS_BUILDER_UPLOAD_TO`` - The location in your ``MEDIA_ROOT`` that files will be saved to if any ``FileField`` or ``ImageField`` fields are defined on your ``BuiltFormSubmission`` model. These files will also be attached to the email if it is sent.
        
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Framework :: Django
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
