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
![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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Close
Hashes for cmsplugin-forms-builder-1.0.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 583779df067a68e37b1837411567178afc11d30be6151a0a00e18b8d687826a2 |
|
MD5 | eb80197329b72d5ddc4e462208555f67 |
|
BLAKE2b-256 | 980b3d2c7bc79f604330c0110028fa30cd4316de037a70e813d8c0424afb648a |