WordPress中从functions.php及插件引入文件无法读取Redux选项问题

核心原因 #

• 加载时机冲突：Redux Framework 的全局变量 $redux_demo 需在 WordPress after_setup_theme 钩子执行完成后才会完成初始化赋值。functions.php 代码会在 after_setup_theme 触发前直接执行，此时直接调用 $redux_demo 时变量尚未赋值，因此无输出。
• 作用域匹配问题：若独立的 theme-color.php 被引入时处于局部作用域内，即使声明了 global $redux_demo 也可能因作用域隔离无法读取全局变量值。
• 插件调用失败原因：WordPress 插件加载优先级早于主题，自定义插件直接引入文件时，Redux Framework 本身可能尚未加载完成，主题侧的 Redux 配置也未初始化，自然无法读取对应值。

修复方法 #

主题 functions.php 引入的修复方案 #

不要直接引入文件，将引入逻辑挂载到 after_setup_theme 及之后的钩子即可：

// functions.php 修改后的引入代码
add_action('after_setup_theme', function() {
    include get_template_directory() . '/theme-color.php';
});

请确认 theme-color.php 开头已主动声明全局变量：

<?php
global $redux_demo;
echo wp_kses_post( $redux_demo['text-call-header'] );
?>

自定义插件内调用的修复方案 #

插件内需等待主题加载完成后再执行引入逻辑，挂载到 init 钩子并判断Redux是否已加载即可：

// 自定义插件内的引入代码
add_action('init', function() {
    if (class_exists('Redux')) {
        include get_template_directory() . '/theme-color.php';
    }
});

补充说明：如果你的Redux配置中自定义了全局实例名，需将代码中的$redux_demo替换为你自己设置的实例名称，否则无法匹配到对应配置值。

内容的提问来源于stack exchange，提问作者attack-to-overflow