本文详解如何在 wordpress 自定义区块渲染中通过全局变量准确计数问题块，并在指定位置（如第2、4、6个问题后）安全插入广告代码，避免因变量作用域错误导致内容不渲染的问题。
本文详解如何在 wordpress 自定义区块渲染中通过全局变量准确计数问题块，并在指定位置（如第2、4、6个问题后）安全插入广告代码，避免因变量作用域错误导致内容不渲染的问题。
在 WordPress 主题或插件开发中，常需在特定位置动态插入广告（如在第2、第4、第6个问答区块后）。许多开发者尝试使用全局计数器配合 render_block 类过滤器（如 render_block_buzzeditor/personality-question），却遇到“无报错但前端完全不显示内容”的问题——根本原因在于 PHP 变量作用域未正确声明。
❌ 常见错误：全局变量未在函数内声明
原始代码中，$question_count 在函数外部初始化为 1，但在 add_question_ad_place() 函数体内未使用 global $question_count; 声明。这导致函数内部访问的是局部变量副本（默认为 null 或 0），每次调用都从初始值重新开始，计数失效，且 $block_content 无法被正确拼接与返回，最终导致整个区块渲染为空白（WordPress 默认静默忽略异常返回值）。
✅ 正确写法：函数内显式声明 global
必须在函数首行显式声明 global $question_count;，确保读写的是同一全局变量实例：
// 注册过滤器（支持多种问答区块类型）
add_filter('render_block_buzzeditor/personality-question', 'add_question_ad_place', 10, 2);
add_filter('render_block_buzzeditor/trivia-question', 'add_question_ad_place', 10, 2);
// 初始化全局计数器（放在函数外，仅执行一次）
$question_count = 1;
function add_question_ad_place($block_content, $block) {
global $question_count; // ✅ 关键：必须在此声明！
// 在指定问题序号后追加广告 HTML（示例为纯文本，实际可替换为广告脚本）
if ($question_count === 2) {
$block_content .= '<div class="ad-placement" data-position="after-2">【广告位：第2题后】</div>';
}
if ($question_count === 4) {
$block_content .= '<div class="ad-placement" data-position="after-4">【广告位：第4题后】</div>';
}
if ($question_count === 6) {
$block_content .= '<div class="ad-placement" data-position="after-6">【广告位：第6题后】</div>';
}
$question_count++; // 计数递增
return $block_content; // 必须返回修改后的内容
}
⚠️ 重要注意事项
- 作用域是核心：PHP 中函数内访问全局变量必须显式用 global 声明，否则视为新局部变量；
- 避免重复初始化：$question_count = 1 应置于函数外部（如 functions.php 顶部），确保仅初始化一次；若放在函数内会导致每次调用重置；
- 兼容性与健壮性：该方案依赖区块渲染顺序，适用于单页内线性渲染场景；若页面含多个独立问答区域（如 AJAX 加载、多实例区块），需改用更可靠的计数机制（如基于 $block['attrs'] 唯一标识或 wp_add_inline_script 动态注入）；
- 生产环境建议：将广告代码封装为独立函数（如 get_ad_html($position)），便于维护与 A/B 测试；
- 调试技巧：临时添加 error_log("Count: {$question_count}"); 配合 tail -f wp-content/debug.log 快速验证计数逻辑。
掌握全局变量的正确作用域声明，是 WordPress 钩子开发中绕不开的基础能力——看似微小的 global 语句，往往就是功能成败的关键分水岭。
