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.

Documentation is currently being worked on but the basics are below

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.

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.2.3.tar.gz (15.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