Skip to main content

django-cms plugin for cmsplugin-forms-builder

Project description

# cmsplugin-forms-builder

![Screenshot](https://raw.githubusercontent.com/nimbis/cmsplugin-forms-builder/develop/screenshots/readme.png)

![Screenshot2](https://raw.githubusercontent.com/nimbis/cmsplugin-forms-builder/develop/screenshots/readme2.png)

### A [django-forms-builder](https://github.com/stephenmcd/django-forms-builder) plugin for [django-cms](https://github.com/divio/django-cms)

[![Build Status](https://travis-ci.org/nimbis/cmsplugin-forms-builder.svg?branch=master)](https://travis-ci.org/nimbis/cmsplugin-forms-builder)

This plugin provides a simple means of inserting django-forms-builder forms
as django-cms plugins. You will need to override django-forms-builder's default `built_form.html` [template](https://github.com/stephenmcd/django-forms-builder/blob/master/forms_builder/forms/templates/forms/includes/built_form.html) in your project in order to POST the form using AJAX, which is then handled appropriately by django-forms-builder's built in views. See the sample [template](https://github.com/nimbis/cmsplugin-forms-builder/blob/develop/sample/templates/forms/includes/built_form.html) for a better idea of how this works.


## Requires

* django >= 1.4
* django-cms >= 2.4
* django-forms-builder


## Setup

* Verify django-cms and django-forms-builder are installed correctly.

* Run `pip install cmsplugin-forms-builder` or download this package and run `python setup.py install`

* Add `'cmsplugin_forms_builder'` to your project's INSTALLED_APPS.

* If you're using Django < 1.7 in conjunction with South, make sure that your SOUTH_MIGRATION_MODULES setting contains `'cmsplugin_forms_builder': 'cmsplugin_forms_builder.south_migrations'`, like so:

```
SOUTH_MIGRATION_MODULES = {
# your other south migration modules...
'cmsplugin_forms_builder': 'cmsplugin_forms_builder.south_migrations',
}
```

* In order to submit your django-forms-builder forms via AJAX, you will need to override django-forms-builder's default `built_form.html` template. Since everyone's use case is different, this repository does not come with a predefined template in order to work "out-of-the-box". However, a sample [template](https://github.com/nimbis/cmsplugin-forms-builder/blob/develop/sample/templates/forms/includes/built_form.html) is provided to help you get started.

## History

v1.0.1:

* Include README.md in the manifest.

v1.0.0:

* Removed unnecessary code in views.py and urls.py.
* Improved documentation in README
* Added screenshots and sample `build_form.html` template
* Fixed setup.py, no longer requires pip>=6.0
* Loosened requirements slightly

v0.1.11:

* Update to Django 1.7 migrations

v0.1.4:

* Fixed bug on Safari browser, make sure that 'cmsplugin_forms_builder' comes
above 'forms_builder.forms' in INSTALLED_APPS

v0.1.1:

* Fixed bugs related to imports in views.py

v0.1.0:

* Initial commit

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

cmsplugin-forms-builder-1.0.1.tar.gz (5.6 kB view hashes)

Uploaded Source

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