最简单和最灵活的django cms表单生成器w/recaptcha v2支持!
djangocms-forms的Python项目详细描述
此项目要求django cms v3.0或更高版本才能正确安装和配置。
此包与Aldryn兼容。
快速启动
安装djangocms-forms:
pip install djangocms-forms
将djangocms_forms添加到INSTALLED_APPS:
INSTALLED_APPS = ( ... 'djangocms_forms', ... )
同步数据库表(如果使用的是django 1.6.x,则要求south>;=1.0.1):
python manage.py migrate
将djangocms_forms.urls添加到项目的urls模块中,或者创建一个django CMS页面以将应用程序挂接到其中在Advanced Settings中,将其应用程序设置为Forms(这需要重新启动服务器):
urlpatterns = patterns( ... url(r'^', include('djangocms_forms.urls')), ... )
要使用reCAPTCHA进行垃圾邮件保护,您需要为您的站点注册一个API密钥对:
DJANGOCMS_FORMS_RECAPTCHA_PUBLIC_KEY = '<recaptcha_site_key>' DJANGOCMS_FORMS_RECAPTCHA_SECRET_KEY = '<recaptcha_secret_key>'
您可以通过https://www.google.com/recaptcha/admin注册一个新站点
配置
plugin(s)module-如果module为none,则plugin被分组为generic group:
DJANGOCMS_FORMS_PLUGIN_MODULE = _('Generic')
插件名称:
DJANGOCMS_FORMS_PLUGIN_NAME = _('Form')
用于呈现模板的默认模板的路径:
DJANGOCMS_FORMS_DEFAULT_TEMPLATE = 'djangocms_forms/form_template/default.html'
或者覆盖Form Template下拉选项以具有不同的模板选项:
DJANGOCMS_FORMS_TEMPLATES = ( ('djangocms_forms/form_template/default.html', _('Default')), )
html5必选-当设置为true时,所有必选字段输入都将使用html5required=required属性呈现:
DJANGOCMS_FORMS_USE_HTML5_REQUIRED = False
默认情况下,djangocms-forms向所有表单输入添加其他css类。例如,一个Text字段生成一个<input class="textinput">,您可以覆盖它来集成您自己的CSS框架:
DJANGOCMS_FORMS_WIDGET_CSS_CLASSES = {'__all__': ('form-control', ) }
例如,上述设置将为所有字段生成<input class"form-control"....。
默认情况下,djangocms表单将在1000毫秒(1秒)后重定向成功的表单提交。您可以通过设置为站点范围内的所有表单提供自己的重定向延迟值:
DJANGOCMS_FORMS_REDIRECT_DELAY = 10000 # 10 seconds
或者通过redirect_delay字段以每个表单为基础。重定向值的优先顺序始终为:
instance.redirect_delay > DJANGOCMS_FORMS_REDIRECT_DELAY > 1000 (default)
您也可以喜欢…
- djangocms研究-https://github.com/mishbahr/djangocms-disqus
- djangocms嵌入-https://github.com/mishbahr/djangocms-embed
- djangocms fbcomments-https://github.com/mishbahr/djangocms-fbcomments
- djangocms gmaps-https://github.com/mishbahr/djangocms-gmaps
- djangocms安装程序-https://github.com/mishbahr/djangocms-instagram
- djangocms响应包装-https://github.com/mishbahr/djangocms-responsive-wrapper
- djangocms-twitter2-https://github.com/mishbahr/djangocms-twitter2
- djangocms youtube-https://github.com/mishbahr/djangocms-youtube