Skip to main content

Wagtail forms in a streamfield

Project description

CircleCI Codecov

This package is currently a concept but allows you to add add forms that are built in the cms admin area to any streamfield. You can also create your own form templates which will then appear as a template choice when you build your form. This allows you to decide how the form is submitted and to where.

Whats included?

  • Forms can be built in the cms admin and used site wide in any streamfield.

  • You can create your own form templates to display/submit how ever you wish to do it.

  • There is a before_page_serve hook that will handle the form POST submission. Which can easily be disabled to provide your own.

  • Forms are catagorised 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.

  • Recaptcha can be added to a form.

  • You can also add site wide regex validators fo use in regex fields.

  • A form and it’s fields can easily be copied to a new form.

  • There is a template tag that can be used to render a form. Incase you want it to appear outside a streamfield.

Documentation

Can be found on readthedocs.

Screenshots

http://wagtailstreamforms.readthedocs.io/en/latest/_images/screen6.png

Example Front End

http://wagtailstreamforms.readthedocs.io/en/latest/_images/screen1.png

Menu

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-dj111-wt112

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

wagtailstreamforms-1.4.0.tar.gz (18.0 kB view details)

Uploaded Source

File details

Details for the file wagtailstreamforms-1.4.0.tar.gz.

File metadata

File hashes

Hashes for wagtailstreamforms-1.4.0.tar.gz
Algorithm Hash digest
SHA256 5fdc8aa63e45b8fa9c0087eb98b29e673d9fc587d450e5714a53046e6916f12d
MD5 38ddb36aa396900c1945982954b42b91
BLAKE2b-256 aa99ac81ec50e2a08dcf0645d204b783609436ac2bb362bc118c26ecb5cf9678

See more details on using hashes here.

Provenance

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