djangocms-aldryn-forms 7.3.0

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.

INSTALLED_APPS = [
    ...
    'aldryn_forms',
    'aldryn_forms.contrib.email_notifications',
    'captcha',
    ...
]

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

• FormPlugin plugin lets you embed certain forms on a CMS page.

• Fieldset groups fields.

• TextField renders text input.

• TextAreaField renders text input.

• HiddenField

• PhoneField

• DateField

• DateTimeLocalField

• TimeField

• NumberField

• EmailField

• FileField renders a file upload input.

• MultipleFilesField

• ImageField same as FileField but validates that the uploaded file is an image.

• BooleanField renders checkbox.

• SelectField renders single select input.

• MultipleSelectField

• MultipleCheckboxSelectField renders multiple checkboxes.

• CaptchaField

• HideContentWhenPostPlugin