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 add your own fields along with the vast array of default fields which include the likes of file fields. Form submissions are controlled by hooks that you can add that process the forms cleaned data. 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
Please note that due to this package being virtually re-written for version 3, you cannot upgrade any existing older version of this package to version 3 and onwards. If you have an existing version installed less than 3 then you will need to completely remove it including tables and any migrations that were applied in the databases django_migrations table.
Older versions:
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<2Other wise you must install a version of this package from 2 onwards:
$ pip install wagtailstreamforms>=2What else is included?
Each form is built using a StreamField.
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.
Form submissions are controlled via hooks meaning you can easily create things like emailing the submission which you can turn on and off on each form.
Fields can easily be added to the form from your own code such as Recaptcha or a Regex Field.
The default set of fields can easily be replaced to add things like widget attributes.
You can define a model that will allow you to save additional settings for each form.
Form submissions are also listed by their form which you can filter by date and are ordered by newest first.
Files can also be submitted to the forms that are shown with the form submissions.
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.
Documentation
Can be found on readthedocs.
Screenshots
Example Front End
Form Fields Selection
Example site with docker
Clone the repo
$ git clone https://github.com/AccentDesign/wagtailstreamforms.gitRun the docker container
$ cd wagtailstreamforms
$ docker-compose upCreate yourself a superuser
$ docker-compose exec app bash
$ python manage.py createsuperuserGo to http://127.0.0.1:8000
Testing
You can test using the tox.ini file in on your own system if you are used to pyenv and tox or you can use the dockerfile that has everything installed ready. Just follow the below commands.
Build the tox test docker image:
docker-compose -f docker-compose-tox.yml buildBash into the container:
docker-compose -f docker-compose-tox.yml run tox bashFrom here you can just execute tox commands:
# Execute all environments
$ tox
# Or a single environment
$ tox -e py36-dj200-wt200Release 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-3.3.tar.gz.
File metadata
- Download URL: wagtailstreamforms-3.3.tar.gz
- Upload date:
- Size: 22.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: Python-urllib/3.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 87f8c3c3094ca6ff41097c1d477c86b8d47b17ede63e045d4048463b99958eaf |
|
| MD5 | e2f6726ce868759d0cd3074688241c25 |
|
| BLAKE2b-256 | e4e6deebf645fb2792d1980f1712e06217c5c6b2e2ffd8f8151aabe69e5723bb |
