跳转到主要内容

在您的网站上构建自定义表单

项目描述

License: LGPL-3

网站表单构建器

本模块为网站提供了在任何页面上添加自定义表单的功能。

安装

安装其他提供 website_form 支持的插件,以便利用本插件的特性。提示

  • website_crm

  • website_form_project

  • website_hr_recruitment

  • website_sale

配置

要配置此模块,您需要

  1. 拥有 管理 / 设置 权限。

  2. 转到 设置 > 激活开发者模式

  3. 转到 设置 > 技术 > 数据库结构 > 模型

  4. 搜索您想要管理网站表单访问的模型。

  5. 当您找到它时,它将有一个 网站表单 部分,您可以

    • 通过勾选 允许在表单中使用 来允许模型获取表单。

    • 表单动作标签 中为模型表单提供一个更好的名称。

    • 自定义表单数据字段 中选择存储自定义字段数据的位置。如果您将其留空,并且模型是邮件线程,则将附加一个包含该自定义数据的新消息。

  6. 字段 选项卡中,有一个新列称为 在Web表单中黑名单。这是一个安全特性,禁止表单提交者向这些字段写入。当您创建一个新的网站表单时,所有模型字段都自动被列入白名单以提高用户体验。如果您想要有更高的控制权,请在创建表单后返回此处,并将您想要的任何字段列入黑名单,尽管这只能用于自定义字段。

用法

要使用此模块,您需要

  1. 转到您的任何网站页面。

  2. 编辑它。

  3. 表单 片段拖放到页面中。

  4. 使用片段覆盖来添加、编辑和删除字段。

  5. 如果您想设置一个隐藏字段,请确保为其设置一个有效的默认值,否则用户可能会遇到隐藏错误,甚至可能无法提交表单!

Try me on Runbot

已知问题 / 路线图

  • 此类字段不会显示,因为它们在这个模块的上下文中没有意义,或者正确的实现只会增加复杂性而不会带来太多价值

    • id

    • create_uid

    • create_date

    • write_uid

    • write_date

    • __last_update

    • 任何one2many字段

    • 任何reference字段

    • 任何serialized字段

    • 任何只读字段

  • 为了在使用户已发送表单而无法重新发送时获得更好的用户体验,您应该在您的安装中包含https://github.com/odoo/odoo/pull/21628

  • 要编辑任何<label>文本,您需要点击两次。一旦https://bugzilla.mozilla.org/show_bug.cgi?id=853519得到修复,请再次检查问题。

  • 您不能手动编辑基础字段的黑名单状态,因为Odoo禁止这样做以保障安全

  • website_form以意外和未记录的方式工作。如果您计划在您的扩展中添加支持,这是开始阅读的好地方

  • 如果您向一个创建记录在没有任何mail.thread继承的模型中的表单添加自定义文件上传字段,您的用户将无法提交表单。

错误跟踪器

错误在GitHub Issues上跟踪。如果遇到问题,请检查您的错误是否已被报告。如果您是第一个发现它的人,请通过提供详细且受欢迎的反馈来帮助我们解决问题。

致谢

图片

贡献者

请不要直接联系贡献者寻求支持或技术问题的帮助。

维护者

Odoo Community Association

此模块由OCA维护。

OCA,或Odoo社区协会,是一个非营利组织,其使命是支持Odoo功能的协作开发并推广其广泛使用。

要为此模块做出贡献,请访问https://odoo-community.org

项目详细信息


下载文件

下载适合您的平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源分布

此版本没有可用的源分布文件。有关生成分布存档的教程。

构建分布

由以下机构支持