Create forms and embed them on CMS pages
Project description
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-hypernode.com/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 history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file aldryn-forms-5.0.4.tar.gz.
File metadata
- Download URL: aldryn-forms-5.0.4.tar.gz
- Upload date:
- Size: 64.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: Python-urllib/2.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 65bdacf5c3b6aea0368fdb6e156129748e1553d07ade7ce260b1b4f24452be2e |
|
| MD5 | 3817a709d7ff94e4a2464618c53a06b5 |
|
| BLAKE2b-256 | 1b4e17bc8928817a2797e7495e3f9f3ea05c6ab56f4d0a6c950a38e5c5ec1da5 |
Provenance
File details
Details for the file aldryn_forms-5.0.4-py2-none-any.whl.
File metadata
- Download URL: aldryn_forms-5.0.4-py2-none-any.whl
- Upload date:
- Size: 114.0 kB
- Tags: Python 2
- Uploaded using Trusted Publishing? No
- Uploaded via: Python-urllib/2.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 71bbce4eb5bc369982d7c030acf4ea586463ec84664b523b64ba49a92cbbf2ef |
|
| MD5 | 22cf330055916baa135f50360360d505 |
|
| BLAKE2b-256 | 971f74088ee95461a515b3a488fac40c1e2b0ba45aa38feb305c639f4483a63c |
