aldryn-forms

Aldryn Forms allows you to build flexible HTML forms for your Aldryn and django CMS projects, and to integrate them directly in your pages.

Forms can be assembled using the form builder, with the familiar simple drag-and-drop interface of the django CMS plugin system.

Submitted data is stored in the Django database, and can be explored and exported using the admin, while forms can be configured to send a confirmation message to users.

Contributing

This is a an open-source project. We’ll be delighted to receive your feedback in the form of issues and pull requests. Before submitting your pull request, please review our contribution guidelines.

We’re grateful to all contributors who have helped create and maintain this package. Contributors are listed at the contributors section.

Installation

Aldryn Platform Users

Choose a site you want to install the add-on to from the dashboard. Then go to Apps -> Install app and click Install next to Forms app.

Redeploy the site.

Upgrading from < 2.0

Version 2.0 introduced a new model for form data storage called FormSubmission. The old FormData model has been deprecated. Although the FormData model’s data is still accessible through the admin, all new form data will be stored in the new FormSubmission model.

Manuall Installation

Run pip install aldryn-forms.

Update INSTALLED_APPS with

INSTALLED_APPS = [
    ...
    'absolute',
    'aldryn_forms',
    'aldryn_forms.contrib.email_notifications',
    'emailit',
    'filer',
    ...
]

Configure aldryn-boilerplates (https://pypi.python.org/pypi/aldryn-boilerplates/).

To use the old templates, set ALDRYN_BOILERPLATE_NAME='legacy'. To use https://github.com/aldryn/aldryn-boilerplate-standard (recommended, will be renamed to aldryn-boilerplate-bootstrap3) set ALDRYN_BOILERPLATE_NAME='bootstrap3'.

Also ensure you define an e-mail backend for your app.

Creating a Form

You can create forms in the admin interface now. Search for the label Aldryn_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.

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.

Release files for aldryn-forms 6.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aldryn-forms 6.2.1
File	Size	Uploaded
aldryn-forms-6.2.1.tar.gz	64.0 kB	Nov 14, 2020	Details

Built distribution (wheel)

Table of built distributions (wheels) for aldryn-forms 6.2.1
File	Interpreter	ABI	Platform	Reset
aldryn_forms-6.2.1-py3-none-any.whl 115.5 kB Nov 14, 2020	Python 3	none	any	Details

Total release size: 179.4 kB

Release files / aldryn-forms-6.2.1.tar.gz

Download URL	aldryn-forms-6.2.1.tar.gz
Size	64.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`a3c276cd2fbd01cdca1d0e8b62a1144ac7ae43fe3fcbcb5090ae17f5f5c20f2c`
BLAKE2b-256 checksum How to use checksums	`20369907888c2433496d2b80bfb2c88eb9b87ae4bffe1a08f44646f6879c3f61`
Upload date	Nov 14, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.6.0 requests-toolbelt/0.9.1 tqdm/4.50.0 CPython/3.7.8`

Release files / aldryn_forms-6.2.1-py3-none-any.whl

Download URL	aldryn_forms-6.2.1-py3-none-any.whl
Size	115.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`feb782528cf1affc8614a7e0e03fb355fe729afe4810d478d46fd9907979c72d`
BLAKE2b-256 checksum How to use checksums	`08756e61dc2428367fa6748e5931c95d6fd0ed014dda9c914be2a468589bfff4`
Upload date	Nov 14, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.6.0 requests-toolbelt/0.9.1 tqdm/4.50.0 CPython/3.7.8`