Skip to main content

Adds a form editor to the structure board of django CMS.

Project description

pypi coverage python django djangocms djangocms4

djangocms-form-builder supports rendering of styled forms. The objective is to tightly integrate forms in the website design. djangocms-form-builder allows as many forms as you wish on one page. All forms are ajax/xhr-based. To this end, djangocms-form-builder extends the django CMS plugin model allowing a form plugin to receive ajax post requests.

There are two different ways to manage forms with djangocms-form-builder:

  1. Building a form with django CMS’ powerful structure board. This is fast an easy. It integrates smoothly with other design elements, especially the grid elements allowing to design simple responsive forms.

    Form actions can be configured by form. Built in actions include saving the results in the database for later evaluation and mailing submitted forms to the site admins. Other form actions can be registered.

  2. Works with django CMS v4 and djangocms-alias to manage your forms centrally. Djangocms-alias becomes your form editor and forms can be placed on pages by refering to them with their alias.

  3. Registering an application-specific form with djangocms-form-builder. If you already have forms you may register them with djangocms-form-builder and allow editors to use them in the form plugin. If you only have simpler design requirements, djangocms-form-builder allows you to use fieldsets as with admin forms.

Key features

Feedback

This project is in a early stage. All feedback is welcome! Please mail me at fsbraun(at)gmx.de

Also, all contributions are welcome.

Contributing

This is a an open-source project. We’ll be delighted to receive your feedback in the form of issues and pull requests. Before submitting your pull request, please review our contribution guidelines.

We’re grateful to all contributors who have helped create and maintain this package. Contributors are listed at the contributors section.

Installation

For a manual install:

  • run pip install git+https://github.com/fsbraun/djangocms-form-builder@master#egg=djangocms-form-builder

  • add djangocms_form_builder to your INSTALLED_APPS:

  • run python manage.py migrate

To use the djangocms-form-builder you will have to have jQuery installed in your project. djangocms-form-builder does not include jQuery.

Download files

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

Source Distribution

djangocms-form-builder-0.1.tar.gz (34.1 kB view hashes)

Uploaded Source

Built Distribution

djangocms_form_builder-0.1-py3-none-any.whl (42.7 kB view hashes)

Uploaded Python 3

Supported by

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