djangocms-forms-maintained

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

This package is compatible with Aldryn.

This version uses for ReCaptcha capabilities.

Quickstart

1. Install djangocms-forms-maintained:

   pip install djangocms-forms-maintained
   

2. Add djangocms_forms to INSTALLED_APPS:

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

3. Sync database tables (requires south>=1.0.1 if you are using Django 1.6.x):

   python manage.py migrate
   

4. 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(
       ...
       path('', include('djangocms_forms.urls')),
       ...
   )
   

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

   DJANGOCMS_FORMS_RECAPTCHA_PUBLIC_KEY = ''
   DJANGOCMS_FORMS_RECAPTCHA_SECRET_KEY = ''
   

You can register a new site via

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 ` DJANGOCMS_FORMS_REDIRECT_DELAY > 1000 (default)

As of 202206141310 you can now specify new FORMAT_CHOICES for the form, since tablib seems to be a bit finicky in the latest version:

DJANGOCMS_FORMS_FORMAT_CHOICES = (
    ("csv", _("CSV")),
    ("json", _("JSON")),
    ("yaml", _("YAML")),
    ("xlsx", _("Microsoft Excel")),
)

Preview

You may also like the original author's plugins...

• djangocms-disqus -

• djangocms-embed -

• djangocms-fbcomments -

• djangocms-gmaps -

• djangocms-instagram -

• djangocms-responsive-wrapper -

• djangocms-twitter2 -

• djangocms-youtube -