Vtiger自定义模块已创建但未在Tools主菜单显示，请求协助
2026-6-15
问题
我按照Vtiger官方提供的实体模块示例脚本创建了名为Expenses的自定义模块，脚本执行日志显示所有步骤均完成（包含“Added to menu Tools ... DONE”的提示），但该模块并未显示在主菜单的Tools选项下，请求协助解决。
执行日志如下：
Creating Module Expenses ... STARTED Initializing module permissions ... DONE Updating tabdata file ... DONE Setting up sharing access options ... DONE Added to menu Tools ... DONE Updating parent_tabdata file ... STARTED Updating parent_tabdata file ... DONE Creating Module Expenses ... DONE Creating Block LBL_EXPENSES_INFORMATION ... DONE Module language entry for LBL_EXPENSES_INFORMATION ... CHECK Creating Block LBL_CUSTOM_INFORMATION ... DONE Module language entry for LBL_CUSTOM_INFORMATION ... CHECK Creating Field summary ... DONE Module language mapping for Summary ... CHECK Setting entity identifier ... DONE Creating Field expenseon ... DONE Module language mapping for Expense On ... CHECK Creating Field expenseamount ... DONE Module language mapping for Amount ... CHECK Creating Field description ... DONE Module language mapping for Description ... CHECK Creating Field assigned_user_id ... DONE Module language mapping for Assigned To ... CHECK Creating Field createdtime ... DONE Module language mapping for Created Time ... CHECK Creating Field modifiedtime ... DONE Module language mapping for Modified Time ... CHECK Creating Field source ... DONE Module language mapping for Source ... CHECK Creating Field starred ... DONE Module language mapping for starred ... CHECK Creating Field tags ... DONE Module language mapping for tags ... CHECK Creating Filter All ... DONE Setting Filter All to status [0] ... DONE Adding summary to All filter ... DONE Adding expenseon to All filter ... DONE Adding description to All filter ... DONE Adding assigned_user_id to All filter ... DONE Recalculating sharing rules ... DONE Initializing webservices support ...DONE OK
排查与解决方案
- 清除系统缓存：进入后台【设置】>【系统设置】>【缓存管理】，清除所有类型的缓存，重点清理菜单缓存。Vtiger的菜单配置依赖缓存，缓存未更新会导致新模块不显示。
- 验证用户权限：确认当前登录用户所属角色拥有Expenses模块的访问权限。路径：【设置】>【角色管理】，找到对应角色后，检查Expenses模块的权限是否已启用。
- 检查配置文件：
- 查看
modules/ModTracker/tabdata.php，确认其中已添加Expenses模块的条目，包含模块名称、标签、排序等信息。 - 查看
parent_tabdata.php，确认Expenses模块已关联到Tools父菜单的条目下。
- 查看
- 核对语言包：检查对应语言的模块语言文件（如
languages/zh_cn/Expenses.php），确认存在菜单名称的语言映射，避免因标签缺失导致菜单不显示。 - 执行模块修复：进入【设置】>【模块管理】>【模块修复】，选择Expenses模块执行修复操作，触发系统重新生成菜单配置。
- 清理浏览器缓存：清空浏览器缓存或使用无痕模式访问系统，排除前端缓存导致的菜单不加载问题。
内容的提问来源于stack exchange，提问作者hamidsolat
相关产品推荐
相关产品推荐
