如何将自定义模块添加到Vtiger CRM的Webform下拉列表中？

1. 检查自定义模块的基础配置 #

• 登录Vtiger后台，进入设置 > 模块管理 > 模块管理器
• 定位目标自定义模块，点击右上角的编辑按钮
• 确认以下关键选项已勾选：
  • 模块可见性：设为「所有用户」或目标用户组
  • 允许Web表单创建（部分版本标注为「支持Web表单」）：必须勾选，这是模块出现在Webform列表的核心前提
• 保存配置

2. 验证模块类型 #

Webform仅支持实体模块（拥有独立数据库表的模块），工具类或关联模块默认不会显示：

• 在模块编辑页面，查看「模块类型」字段，确保值为「实体」而非「工具」或其他类型

3. 调整Webform的模块白名单 #

• 进入设置 > 扩展包 > Web表单
• 点击右上角的配置入口
• 在允许的模块列表中，手动勾选你的自定义模块，保存设置

4. 清理系统缓存 #

Vtiger缓存可能导致配置更新不生效，需强制刷新：

• 进入设置 > 系统 > 系统设置 > 缓存管理
• 点击清理缓存按钮，等待操作完成
• 也可手动删除Vtiger安装目录下cache文件夹内的所有文件（保留文件夹本身）

5. 检查角色权限 #

确保当前操作角色拥有该模块的对应权限：

• 进入设置 > 用户管理 > 角色
• 找到目标角色，点击编辑权限
• 在模块权限列表中，为自定义模块勾选「创建」及「Web表单」相关权限（若存在）
• 保存权限设置

6. 验证模块元数据完整性 #

自定义模块的元数据缺失会导致Webform无法识别：

• 检查Vtiger安装目录下modules/[你的模块名]/路径，确保存在module.php文件和metadata/目录，且内容完整
• 若通过模块生成器创建，重新生成一次模块，确保元数据同步

完成以上步骤后，刷新Webform配置页面，即可查看自定义模块是否出现在下拉列表中。

内容的提问来源于stack exchange，提问作者Cherridev cherritech