Wagtail StreamForms
===================
|tests| |Codecov| |pypi| |github|
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:
.. code:: bash
$ pip install wagtailstreamforms<2
Other wise you must install a version of this package from 2 onwards:
.. code:: bash
$ pip install wagtailstreamforms>=2
What 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 <http://wagtailstreamforms.readthedocs.io/>`_.
Screenshots
-----------
.. figure:: http://wagtailstreamforms.readthedocs.io/en/latest/_images/screen_1.png
:width: 728 px
Example Front End
.. figure:: http://wagtailstreamforms.readthedocs.io/en/latest/_images/screen_3.png
:width: 728 px
Form Fields Selection
Example site with docker
------------------------
Clone the repo
.. code:: bash
$ git clone https://github.com/labd/wagtailstreamforms.git
Run the docker container
.. code:: bash
$ cd wagtailstreamforms
$ docker-compose up
Create yourself a superuser
.. code:: bash
$ docker-compose exec app bash
$ python manage.py createsuperuser
Go to http://127.0.0.1:8000
.. |tests| image:: https://github.com/labd/wagtailstreamforms/workflows/Python%20Tests/badge.svg
:target: https://github.com/labd/wagtailstreamforms/actions?query=workflow%3A%22Python+Tests%22
.. |Codecov| image:: https://codecov.io/gh/labd/wagtailstreamforms/branch/master/graph/badge.svg
:target: https://codecov.io/gh/labd/wagtailstreamforms
.. |pypi| image:: https://img.shields.io/pypi/v/wagtailstreamforms.svg
:target: https://pypi.org/project/wagtailstreamforms/
.. |github| image:: https://img.shields.io/github/stars/labd/wagtailstreamforms.svg?style=social&logo=github
:target: https://github.com/labd/wagtailstreamforms/stargazers
Raw data
{
"_id": null,
"home_page": "https://github.com/AccentDesign/wagtailstreamforms/",
"name": "wagtailstreamforms",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "wagtail,streamfield,forms,accent,design",
"author": "Stuart George",
"author_email": "stuart@accentdesign.co.uk",
"download_url": "https://files.pythonhosted.org/packages/50/5e/e15b80284e402507b416007991afecf985acc320d49c7db6b020dfd1ef16/wagtailstreamforms-4.1.0.tar.gz",
"platform": null,
"description": "Wagtail StreamForms\n===================\n\n|tests| |Codecov| |pypi| |github|\n\nAllows you to build forms in the CMS admin area and add them to any StreamField in your site.\nYou can add your own fields along with the vast array of default fields which include the likes\nof file fields. Form submissions are controlled by hooks that you can add that process the forms cleaned data.\nTemplates can be created which will then appear as choices when you build your form,\nallowing you to display and submit a form however you want.\n\nBackwards Compatibility\n-----------------------\n\nPlease note that due to this package being virtually re-written for version 3, you cannot upgrade any existing\nolder version of this package to version 3 and onwards.\nIf you have an existing version installed less than 3 then you will need to completely remove it including\ntables and any migrations that were applied in the databases ``django_migrations`` table.\n\nOlder versions:\n\nIf you are using a version of wagtail 1.x, then the latest compatible version of this package is 1.6.3:\n\n.. code:: bash\n\n $ pip install wagtailstreamforms<2\n\nOther wise you must install a version of this package from 2 onwards:\n\n.. code:: bash\n\n $ pip install wagtailstreamforms>=2\n\nWhat else is included?\n----------------------\n\n* Each form is built using a StreamField.\n* Customise things like success and error messages, post submit redirects and more.\n* Forms are processed via a ``before_page_serve`` hook. Meaning there is no fuss like remembering to include a page mixin.\n* The hook can easily be disabled to provide the ability to create your own.\n* 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.\n* Fields can easily be added to the form from your own code such as Recaptcha or a Regex Field.\n* The default set of fields can easily be replaced to add things like widget attributes.\n* You can define a model that will allow you to save additional settings for each form.\n* Form submissions are also listed by their form which you can filter by date and are ordered by newest first.\n* Files can also be submitted to the forms that are shown with the form submissions.\n* A form and its fields can easily be copied to a new form.\n* There is a template tag that can be used to render a form, in case you want it to appear outside a StreamField.\n\nDocumentation\n-------------\n\nCan be found on `readthedocs <http://wagtailstreamforms.readthedocs.io/>`_.\n\nScreenshots\n-----------\n\n.. figure:: http://wagtailstreamforms.readthedocs.io/en/latest/_images/screen_1.png\n :width: 728 px\n\n Example Front End\n\n.. figure:: http://wagtailstreamforms.readthedocs.io/en/latest/_images/screen_3.png\n :width: 728 px\n\n Form Fields Selection\n\nExample site with docker\n------------------------\n\nClone the repo\n\n.. code:: bash\n\n $ git clone https://github.com/labd/wagtailstreamforms.git\n\nRun the docker container\n\n.. code:: bash\n\n $ cd wagtailstreamforms\n $ docker-compose up\n\nCreate yourself a superuser\n\n.. code:: bash\n\n $ docker-compose exec app bash\n $ python manage.py createsuperuser\n\nGo to http://127.0.0.1:8000\n\n.. |tests| image:: https://github.com/labd/wagtailstreamforms/workflows/Python%20Tests/badge.svg\n :target: https://github.com/labd/wagtailstreamforms/actions?query=workflow%3A%22Python+Tests%22\n.. |Codecov| image:: https://codecov.io/gh/labd/wagtailstreamforms/branch/master/graph/badge.svg\n :target: https://codecov.io/gh/labd/wagtailstreamforms\n.. |pypi| image:: https://img.shields.io/pypi/v/wagtailstreamforms.svg\n :target: https://pypi.org/project/wagtailstreamforms/\n.. |github| image:: https://img.shields.io/github/stars/labd/wagtailstreamforms.svg?style=social&logo=github\n :target: https://github.com/labd/wagtailstreamforms/stargazers\n\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Wagtail forms in a streamfield",
"version": "4.1.0",
"project_urls": {
"Download": "https://pypi.python.org/pypi/wagtailstreamforms",
"Homepage": "https://github.com/AccentDesign/wagtailstreamforms/"
},
"split_keywords": [
"wagtail",
"streamfield",
"forms",
"accent",
"design"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a9b64e9f9e900d26a53decf04dafcbeb9d6facfdd169dfc113b621b7819679cc",
"md5": "6dc7926baf46fec3a6d949c32ee31c64",
"sha256": "053a63a9cd648708e6cd6aea4d60bbecea6bcc491796d8c0b509621397f7ef71"
},
"downloads": -1,
"filename": "wagtailstreamforms-4.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6dc7926baf46fec3a6d949c32ee31c64",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 52540,
"upload_time": "2023-12-01T15:06:52",
"upload_time_iso_8601": "2023-12-01T15:06:52.888659Z",
"url": "https://files.pythonhosted.org/packages/a9/b6/4e9f9e900d26a53decf04dafcbeb9d6facfdd169dfc113b621b7819679cc/wagtailstreamforms-4.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "505ee15b80284e402507b416007991afecf985acc320d49c7db6b020dfd1ef16",
"md5": "6c456c29cf8bcfab6122a9170161d5e5",
"sha256": "411b8deedd161f25fc0f028053b4ea64f24b2e083fbb537477a4dd7c2778f7e7"
},
"downloads": -1,
"filename": "wagtailstreamforms-4.1.0.tar.gz",
"has_sig": false,
"md5_digest": "6c456c29cf8bcfab6122a9170161d5e5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 36107,
"upload_time": "2023-12-01T15:06:54",
"upload_time_iso_8601": "2023-12-01T15:06:54.351097Z",
"url": "https://files.pythonhosted.org/packages/50/5e/e15b80284e402507b416007991afecf985acc320d49c7db6b020dfd1ef16/wagtailstreamforms-4.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-01 15:06:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "AccentDesign",
"github_project": "wagtailstreamforms",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "wagtailstreamforms"
}
JSON
