Skip to main content

A Django reusable app providing the ability for admin users to create their own forms.

Project description

Introduction

A Django reusable app providing the ability for admin users to create their own forms within the admin interface drawing from a range of field widgets such as regular text fields, drop-down lists and file uploads. Options are also provided for controlling who gets sent email notifications when a form is submitted. All form entries are made available in the admin via CSV export.

Installation

Assuming you have setuptools installed, the easiest method is to install directly from pypi by running the following command:

$ easy_install -U django-forms-builder

Otherwise you can check out the source directly and install it via:

$ python setup.py install

Once installed you can then add forms_builder.forms to your INSTALLED_APPS and forms_builder.forms.urls to your url conf.

File Uploads

It’s possible for admin users to create forms that allow file uploads which can be accessed via a download URL for each file that is provided in the CSV export. By default these uploaded files are stored in an obscured location under your project’s MEDIA_ROOT directory but ideally the should be stored somewhere inaccessible to the public. To set the location where files are stored to be somewhere outside of your project’s MEDIA_ROOT directory you just need to define the FORMS_BUILDER_UPLOAD_ROOT setting in your project’s settings module. Its value should be an absolute path on the web server that isn’t accessible to the public.

Configuration

The following settings can be defined in your project’s settings module.

  • FORMS_BUILDER_FIELD_MAX_LENGTH - Maximum allowed length for field values. Defaults to 2000

  • FORMS_BUILDER_LABEL_MAX_LENGTH - Maximum allowed length for field labels. Defaults to 20

  • FORMS_BUILDER_UPLOAD_ROOT - The absolute path where files will be uploaded to. Defaults to None

  • FORMS_BUILDER_USE_SITES - Boolean controlling whether forms are associated to Django’s Sites framework. Defaults to "django.contrib.sites" in settings.INSTALLED_APPS

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-forms-builder-0.3.tar.gz (20.0 kB view details)

Uploaded Source

File details

Details for the file django-forms-builder-0.3.tar.gz.

File metadata

File hashes

Hashes for django-forms-builder-0.3.tar.gz
Algorithm Hash digest
SHA256 e82491c52a994b48dd8bee7f3c11bda74638673ea3e9f98d96ba47dc79871fa6
MD5 7243b77ea4a5831f1f32388e9ef9721d
BLAKE2b-256 d42a81840b5e99a9104e9f37a47fb629f9be0769de8bf3760ea9d35d2a3224d5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page