Totara 16.2（基于Moodle 3.4.9）自定义新选课方法无法正常生效问题求助

这种复制核心Self enrolment插件后出现「数据库有记录但前端不渲染、用户无法访问」的问题，我在Totara/Moodle开发中踩过好几次坑，核心原因基本都是插件的内部标识、逻辑钩子或者权限配置没跟上，咱们一步步来排查：

1. 先确认插件的内部标识符完全统一 #

复制Self enrolment后，最容易出问题的就是全局替换不彻底，Totara对插件的命名规范要求很严格：

• 插件文件夹必须是 enrol/yourcustomplugin（替换成你的插件名）
• db/install.xml 里的 <plugin> 字段要和文件夹名一致，比如 enrol_yourcustomplugin
• lang/en/enrol_yourcustomplugin.php 里的所有语言键前缀要统一，比如 enrol_yourcustomplugin:pluginname
• 主文件 lib.php 里的类名必须是 enrol_yourcustomplugin_plugin，并且正确继承 enrol_plugin
• 重点检查 lib.php 里的 get_name()、can_add_instance() 方法，有没有残留原Self enrol的硬编码判断，比如原方法里有没有判断特定的插件标识？

2. 验证数据库实例的状态字段 #

虽然mdl_enrol表里有记录，但要确认几个关键字段：

• status：必须是0（0=启用，1=禁用），如果是1的话，前端不会显示
• visible：必须是1（对用户可见），有些插件复制后默认配置可能把这个设为0
• enrol：字段值必须是你的插件短名（比如yourcustomplugin），不能是原self

3. 彻底清理缓存并验证插件注册 #

你说已经清了缓存，但Totara的缓存有时候需要更彻底的操作：

• 用命令行执行 php admin/cli/purge_caches.php（比网页清缓存更彻底）
• 检查mdl_plugins表，确认你的插件component字段是enrol_yourcustomplugin，enabled是1，version号和你插件version.php里的一致
• 尝试先禁用插件，再重新启用，或者卸载后重新安装（记得备份数据库），有时候安装时的钩子没触发，导致插件没被正确注册

4. 检查渲染逻辑和权限配置 #

• 课程的Enrolment methods页面渲染时，会调用插件的can_display_instance()方法，你可以在自己的lib.php里重写这个方法，直接返回true先验证：

  public function can_display_instance($instance) {
      return true;
  }
  

• 普通用户无法访问课程，要检查权限：在db/access.php里，有没有把原Self enrol的enrol/self:enrol权限改成enrol/yourcustomplugin:enrol，并且给student角色分配了这个权限
• 还要检查实例的availablefrom和availableuntil字段，有没有设置了过期或者未生效的时间，导致用户看不到

5. 开启Debug模式看隐藏错误 #

打开Site Administration > Development > Debugging，把Debug messages设为DEVELOPER，然后重新添加插件实例、刷新页面，看有没有PHP错误或者警告——比如某个文件路径写错、类名拼写错误，这些错误可能不会在安装页面显示，但会导致插件逻辑执行失败。

快速验证小技巧 #

在你的lib.php里的get_instance_name()方法里加个特殊字符，比如：

public function get_instance_name($instance) {
    return '我的自定义选课【测试】';
}

然后去配置页面看能不能显示这个名称，能显示说明插件类被正确加载，问题出在渲染或状态判断；不能显示说明插件没被正确注册。

内容的提问来源于stack exchange，提问作者Ward Vandevoort