流字段中的Wagtail表单
项目描述
允许您在CMS管理区域构建表单,并将其添加到网站中的任何StreamField。您可以根据需要添加自己的字段,以及包括文件字段在内的各种默认字段。表单提交由您可以添加的钩子控制,用于处理清理后的表单数据。可以创建模板,然后在构建表单时作为选项出现,使您能够以任何方式显示和提交表单。
向下兼容性
请注意,由于该包几乎为版本3重写,因此您不能将任何现有旧版本的此包升级到版本3及其以后版本。如果您已安装版本低于3的现有版本,则必须完全删除它,包括数据库中django_migrations表中的任何迁移。
旧版本
如果您正在使用wagtail 1.x版本,则此包的最新兼容版本是1.6.3。
$ pip install wagtailstreamforms<2
否则,您必须从2版本开始安装此包。
$ pip install wagtailstreamforms>=2
还包括哪些内容?
每个表单都是使用StreamField构建的。
可以自定义诸如成功和错误消息、提交后的重定向等。
表单通过before_page_serve钩子进行处理。这意味着无需记住包含页面混入。
可以轻松禁用此钩子,以提供创建自己的钩子的能力。
表单提交由钩子控制,这意味着您可以轻松创建诸如通过电子邮件发送提交内容之类的功能,您可以在每个表单中打开或关闭这些功能。
可以轻松地将字段添加到自己的代码中,例如Recaptcha或正则表达式字段。
可以轻松替换默认字段集,以添加诸如小部件属性之类的功能。
可以定义一个模型,允许为每个表单保存额外的设置。
表单提交按其表单列出,您可以按日期筛选,并按最新顺序排序。
也可以将文件提交到表单,这些文件与表单提交一起显示。
可以轻松地将表单及其字段复制到新的表单中。
还有一个模板标签可以用于渲染表单,以防您希望将其显示在StreamField之外。
文档
可在readthedocs上找到。
屏幕截图
前端示例
表单字段选择
带有Docker的示例站点
克隆存储库
$ git clone https://github.com/labd/wagtailstreamforms.git
运行Docker容器
$ cd wagtailstreamforms
$ docker-compose up
创建超级用户
$ docker-compose exec app bash
$ python manage.py createsuperuser
项目详情
下载文件
下载适用于您平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。