Moodle可用性条件插件get_description可用状态文本不显示求助

• 检查核心调用逻辑的分支判断
  定位Moodle核心里调用get_description的代码（核心位置通常在core_availability\output\renderer类中），确认资源可用状态下是否触发了该函数的调用。很多情况是核心代码只在资源不可用时才调用该函数，可用时直接跳过，导致文本没机会渲染。

• 验证可用状态下函数的返回值
  在插件的get_description函数里加调试代码，比如用debugging($returnstring, DEBUG_DEVELOPER);输出返回内容，或者直接硬返回一段测试文本，确认当资源可用时函数是否被执行，返回值是否正常生成。避免因状态判断错误导致函数根本没跑起来。

• 排查模板的条件渲染规则
  查看课程模块描述对应的模板文件（比如课程格式模板course/format/xxx/templates/section.html，或可用性组件模板availability/templates/condition.html），检查是否存在模板代码只在资源不可用时才渲染get_description的返回内容，比如类似{% if not available %}的条件判断，漏掉了可用状态的渲染分支。

• 确认角色权限对文本展示的影响
  切换不同角色（管理员、教师、学生）测试，排查是否是角色权限配置导致可用状态下的文本被过滤。比如某些角色的权限设置中，可能隐藏了可用状态的提示文本，需要检查capabilities相关配置项。

• 查看Moodle调试日志
  开启Moodle调试模式（站点管理→开发→调试），查看是否有和可用性渲染相关的错误、警告信息，比如函数返回值为空、模板渲染语法错误等，日志能直接帮你定位问题根源。

内容的提问来源于stack exchange，提问作者Mohammad Farouk