Metadata-Version: 2.1
Name: corebytecms-forms
Version: 1.0.0
Summary: Create forms and embed them on CMS pages
Home-page: https://github.com/svandeneertwegh/corebytecms-forms
Author: Corebyte
Author-email: info@corebyte.nl
License: BSD
Keywords: django django-cms form-builder form fields
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Framework :: Django
Classifier: Framework :: Django :: 3.2
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Description-Content-Type: text/x-rst
License-File: LICENSE

Features
============
- Create a cms page where you can setup form fields, a captcha and submit button.
- Works in python3.
- Set the apphook to 'Forms' and then the redirect works.
- Create a 'thank you' page where you can redirect to.
- Forms and all fields are saved in the database.
- When set the ``send mail option`` it sends a mail with all the fields to the specified receivers.
- In the admin, can view every form submission with the fields.
- In the admin, export is possible to .csv.

Installation
============

Run ``pip install git+https://github.com/svandeneertwegh/corebytecms-forms``.

Update ``INSTALLED_APPS`` with ::

    INSTALLED_APPS = [
        ...
        'cms_forms',
        'cms_forms.contrib.email_notifications',
        'filer',
    ]


Creating a Form
===============

You can create forms in the admin interface now. Search for the label ``Forms``.

Create a CMS page and install the ``Forms`` app there (choose ``Forms`` from the ``Advanced Settings -> Application`` dropdown).

Now redeploy/restart the site again.

The above CMS site has become a forms POST landing page - a place where submission errors get displayed if there are any.


Available Plug-ins
==================

``Form`` plugin lets you embed certain forms on a CMS page.

``Fieldset`` groups fields.

``Text Field`` renders text input.

``Text Area Field`` renders text input.

``Yes/No Field`` renders checkbox.

``Select Field`` renders single select input.

``Date Field`` renders date input.

``Multiple Select Field`` renders multiple checkboxes.

``File field`` renders a file upload input.

``Image field`` same as ``file field`` but validates that the uploaded file is an image.

