Wagtail forms in a streamfield
Project description
Allows you to build forms in the CMS admin area and add them to any StreamField in your site. You can create your own types of forms meaning an endless array of possibilities. Templates can be created which will then appear as choices when you build your form, allowing you to display and submit a form however you want.
Backwards Compatibility
If you are using a version of wagtail 1.x, then the latest compatible version of this package is 1.6.3:
$ pip install wagtailstreamforms<2
Other wise you must install a version of this package from 2 onwards:
$ pip install wagtailstreamforms>=2
What else is included?
Customise things like success and error messages, post submit redirects and more.
Forms are processed via a before_page_serve hook. Meaning there is no fuss like remembering to include a page mixin.
The hook can easily be disabled to provide the ability to create your own.
Forms are categorised by their class in the CMS admin for easier navigation.
Form submissions are also listed by their form which you can filter by date and are ordered by newest first.
You can add site wide regex validators for use in regex fields.
A form and its fields can easily be copied to a new form.
There is a template tag that can be used to render a form, in case you want it to appear outside a StreamField.
Recaptcha can be added to a form.
Documentation
Can be found on readthedocs.
Screenshots
Example site with docker
Clone the repo
$ git clone https://github.com/AccentDesign/wagtailstreamforms.git
Run the docker container
$ cd wagtailstreamforms
$ docker-compose up
Create yourself a superuser
$ docker exec -it <container_name> bash
$ python manage.py createsuperuser
Go to http://127.0.0.1:8000
Testing
Install dependencies
You will need pyenv installed see https://github.com/pyenv/pyenv
Also tox needs to be installed
$ pip install tox
Install python versions in pyenv
$ pyenv install 3.4.4
$ pyenv install 3.5.3
$ pyenv install 3.6.2
Set local project versions
$ pyenv local 3.4.4 3.5.3 3.6.2
Run the tests
$ tox
or run for a single environment
$ tox -e py36-dj200-wt200
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
File details
Details for the file wagtailstreamforms-2.0.1.tar.gz
.
File metadata
- Download URL: wagtailstreamforms-2.0.1.tar.gz
- Upload date:
- Size: 22.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 60879ab36a22a358a8f0835c9930af3d365f2695afd9a6af95ad0abaff5f2382 |
|
MD5 | 1d4ac2f589a81cd944ec443986ce74f0 |
|
BLAKE2b-256 | 077337a643e570b5d9f6c2fab0977bb419771667419886bda8ddc6628044c764 |