WordPress中判断听书插件是否启用，需先引入plugin.php或用file_exists()+function_exists()组合校验，避免前台调用is_plugin_active()报错；前端通过wp_add_inline_script注入状态标识。
WordPress 中用 is_plugin_active() 判断听书插件是否启用
WordPress 官方提供了 is_plugin_active() 函数，但注意：它**只能在管理后台（admin）或插件激活钩子中安全使用**，前台直接调用会报 Call to undefined function is_plugin_active() 错误。
常见错误写法：
if (is_plugin_active('ting-shu/ting-shu.php')) { ... }——这在主题的 functions.php 或模板文件里大概率失败。
- 必须先
include_once ABSPATH . 'wp-admin/includes/plugin.php';才能调用该函数 - 插件主文件路径要写对，比如听书插件目录叫
ting-shu、主文件是ting-shu.php，那参数就是'ting-shu/ting-shu.php' - 该函数不检查插件是否存在，只检查「是否已启用」；若插件根本没安装，会返回
false，但不会报错
更稳妥的判断方式：检查插件主文件是否存在 + 是否已加载
绕过 is_plugin_active() 依赖，直接验证插件是否「可被识别且已生效」。适合用在主题或自定义功能中：
- 用
file_exists()检查插件主文件路径：WP_PLUGIN_DIR . '/ting-shu/ting-shu.php' - 再检查关键函数或类是否已定义，比如听书插件常提供
ting_shu_play()或TingShu_Player类 - 组合判断比单靠激活状态更可靠，避免插件启用但未完成初始化的情况
示例逻辑：
function is_ting_shu_active() {
$plugin_file = WP_PLUGIN_DIR . '/ting-shu/ting-shu.php';
if (!file_exists($plugin_file)) {
return false;
}
// 假设插件加载后会定义这个函数
return function_exists('ting_shu_get_book_list');
}
插件未启用时调用其函数导致的致命错误
最常踩的坑：在主题中直接调用听书插件的函数（如 ting_shu_render_player()），却不做存在性校验，结果站点白屏，错误日志出现：Uncaught Error: Call to undefined function ting_shu_render_player()
立即学习“PHP免费学习笔记（深入）”；
- 所有来自插件的函数、类、全局变量，都必须在调用前用
function_exists()或class_exists()包裹 - 不要依赖
defined('TING_SHU_VERSION')这类常量——有些插件不定义，或定义时机晚于你的调用点 - 如果插件使用了命名空间，
class_exists()要传完整类名，例如'TingShu\Player'，而非短名
前端 JS 层如何感知插件状态？
PHP 层判断完，往往还需让前端知道插件是否就绪，比如动态加载播放器 UI。推荐做法是 PHP 输出一个轻量标记：
wp_add_inline_script('your-script-handle', 'window.tingShuActive = ' . (is_ting_shu_active() ? 'true' : 'false') . ';', 'before');
这样 JS 里就能直接：
if (window.tingShuActive) {
// 初始化播放器
} else {
// 显示“请启用听书插件”提示
}
别用 AJAX 异步查状态——多一次请求、延迟高、还可能被缓存干扰。
插件路径拼写、函数名大小写、前后台执行环境差异，这三个点漏掉任何一个，判断就会失效。实际部署前务必在干净站点复现一遍启用/禁用流程。
