流场中的摇尾形式
wagtailstreamforms的Python项目详细描述
允许您在CMS管理区域中生成表单并将其添加到站点中的任何streamfield。 您可以添加自己的字段以及大量默认字段,其中包括 文件字段的。表单提交由钩子控制,您可以添加钩子来处理表单清理后的数据。 可以创建模板,然后在生成表单时显示为选项, 允许您根据需要显示和提交表单。
向后兼容性
请注意,由于这个包实际上是为3版本重新编写的,所以不能升级任何现有的。 此软件包的旧版本升级到版本3及更高版本。 如果安装了小于3的现有版本,则需要完全删除它,包括 表和应用于数据库django_migrations表中的任何迁移。
旧版本:
如果您使用的是Wagtail 1.x版本,则此软件包的最新兼容版本为1.6.3:
$ pip install wagtailstreamforms<2
另外,您必须从2开始安装此软件包的版本:
$ pip install wagtailstreamforms>=2
还包括什么?
- 每个表单都是使用一个streamfield构建的。
- 定制成功和错误消息、post-submit重定向等。
- 表单通过before_page_servehook进行处理。这意味着没有记忆,包括一个页面混音。
- 钩子可以很容易地被禁用,以提供创建自己钩子的能力。
- 表单提交是通过hook控制的,这意味着您可以轻松地创建一些东西,比如通过电子邮件发送提交,您可以在每个表单上打开和关闭提交。
- 字段可以很容易地从您自己的代码(如reCAPTCHA或regex字段)添加到表单中。
- 可以很容易地替换默认的字段集来添加小部件属性之类的内容。
- 您可以定义一个模型,该模型允许您为每个表单保存其他设置。
- 表单提交也按其表单列出,您可以按日期进行筛选,并按最新者优先排序。
- 文件也可以提交到随表单提交一起显示的表单。
- 表单及其字段可以轻松复制到新表单。
- 有一个模板标记可用于呈现窗体,以防希望它出现在streamfield外部。
文档
可以在readthedocs上找到。
屏幕截图
前端示例
表单域选择
带Docker的示例站点
复制回购协议
$ git clone https://github.com/AccentDesign/wagtailstreamforms.git
运行Docker容器
$ cd wagtailstreamforms
$ docker-compose up
为自己创建一个超级用户
$ docker-compose exec app bash
$ python manage.py createsuperuser