djangocms-forms

http://img.shields.io/coveralls/mishbahr/djangocms-forms.svg?style=flat-square

This project requires django-cms v3.0 or higher to be properly installed and configured.

This package is compatible with Aldryn.

Quickstart

Install djangocms-forms:
```
pip install djangocms-forms
```

Add djangocms_forms to INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'djangocms_forms',
    ...
)

Sync database tables (requires south>=1.0.1 if you are using Django 1.6.x):
```
python manage.py migrate
```
Add djangocms_forms.urls to your project’s urls module or create a django CMS page to hook the application into. In Advanced Settings, set its Application to Forms (this requires a server restart):
```
urlpatterns = patterns(
    ...
    url(r'^', include('djangocms_forms.urls')),
    ...
)
```

To use reCAPTCHA for spam protection, you need to sign up for an API key pair for your site:

DJANGOCMS_FORMS_RECAPTCHA_PUBLIC_KEY = '<recaptcha_site_key>'
DJANGOCMS_FORMS_RECAPTCHA_SECRET_KEY = '<recaptcha_secret_key>'

You can register a new site via https://www.google.com/recaptcha/admin

Configuration

Plugin(s) Module - If module is None, plugin is grouped Generic group:

DJANGOCMS_FORMS_PLUGIN_MODULE = _('Generic')

Name of the plugin:

DJANGOCMS_FORMS_PLUGIN_NAME = _('Form')

The path to the default template used to render the template:

DJANGOCMS_FORMS_DEFAULT_TEMPLATE = 'djangocms_forms/form_template/default.html'

or override the Form Template dropdown choices to have different template options:

DJANGOCMS_FORMS_TEMPLATES = (
    ('djangocms_forms/form_template/default.html', _('Default')),
)

HTML5 required - When set to True all required fields inputs will be rendered with HTML5 required=required attribute:

DJANGOCMS_FORMS_USE_HTML5_REQUIRED = False

By default, djangocms-forms adds additional css classes to all form inputs. e.g. a Text field generates an <input class="textinput"> You can override this to integrate your own CSS framework:

DJANGOCMS_FORMS_WIDGET_CSS_CLASSES = {'__all__': ('form-control', ) }

e.g. the above setting would generate <input class"form-control" .... for all fields.

By default, djangocms-forms will redirect a successful form submission after 1000 milliseconds (1 second). You may provide your own redirect delay value for all forms site-wide via settings:

DJANGOCMS_FORMS_REDIRECT_DELAY = 10000  # 10 seconds

or on a per-form basis via the redirect_delay field. The order of precedence for the redirect value is always:

instance.redirect_delay > DJANGOCMS_FORMS_REDIRECT_DELAY > 1000 (default)

Preview

http://mishbahr.github.io/djangocms-forms/assets/resized/djangocms_forms_001.jpeg

http://mishbahr.github.io/djangocms-forms/assets/resized/djangocms_forms_005.jpeg

http://mishbahr.github.io/djangocms-forms/assets/resized/djangocms_forms_002.jpeg

http://mishbahr.github.io/djangocms-forms/assets/resized/djangocms_forms_003.jpeg

http://mishbahr.github.io/djangocms-forms/assets/resized/djangocms_forms_004.jpeg

Metadata

Development Status
- 4 - Beta
Framework
- Django
Intended Audience
- Developers
License
- OSI Approved :: BSD License
Natural Language
- English
Programming Language

Release files for djangocms-forms 0.2.5

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

Source distribution (sdist)

Source distribution for djangocms-forms 0.2.5
File	Size	Uploaded	Provenance
djangocms-forms-0.2.5.tar.gz	134.7 kB	Dec 29, 2016	Without provenance	Details

Release files / djangocms-forms-0.2.5.tar.gz

Download URL	djangocms-forms-0.2.5.tar.gz
Size	134.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`83719b7bec66f935fc30698d81541d52cf35a45bef27089cd8899fa9d4d19d36`
BLAKE2b-256 checksum How to use checksums	`f6c37e084b7c4352fffdd9b035d653dc45148a16ef03df72eb38a4e4df291e3b`
Upload date	Dec 29, 2016
Uploaded using Trusted Publishing? What is trusted publishing?	No

Security for djangocms-forms 0.2.5

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.