WordPress自定义过滤器未生效：gtag脚本始终显示在页脚

问题根源 #

你当前的代码逻辑存在两处问题，导致脚本默认就加载到页脚：

1. apply_filters 的默认参数直接设为 'footer'，且赋值给了 $position；
2. if 判断直接使用字符串的布尔值——PHP中所有非空字符串都会被视为 true，所以不管有没有自定义过滤器，都会执行 wp_footer 的钩子。

修复代码 #

调整过滤器逻辑为基于位置字符串的严格判断，同时将默认值设为 'header'，这样默认情况下脚本会加载到头部，只有添加自定义过滤器时才会切换到页脚：

// 修改后的过滤器判断逻辑
$position = apply_filters('myplugin_ga_script_position', 'header');
if ($position === 'footer') {
    add_action('wp_footer', array($this, 'myplugin_add_analytics_code'));
} else {
    add_action('wp_head', array($this, 'myplugin_add_analytics_code'));
}

逻辑说明 #

• 默认状态下，apply_filters 返回 'header'，触发 wp_head 钩子，脚本加载到页面头部；
• 当你在 functions.php 中添加指定的过滤器代码时，返回值变为 'footer'，才会切换到 wp_footer 钩子加载脚本。

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