本文详解如何修改 PHP 弹窗逻辑，使其仅在 WordPress 静态首页（front page）加载时生效，并严格按预设访问次数（如第1、3、6…45次）触发，避免全站误显。
本文详解如何修改 php 弹窗逻辑，使其**仅在 wordpress 静态首页（front page）加载时生效**，并严格按预设访问次数（如第1、3、6…45次）触发，避免全站误显。
要实现“弹窗仅在首页显示 + 按指定访问次数触发”，关键在于双重条件校验：既要判断当前页面是否为 WordPress 的首页（is_front_page()），又要确保访问计数逻辑准确无误。原代码将 odpopwp_fire() 函数包裹在 if (is_front_page()) 中的做法存在语法错误（函数定义不能嵌套在条件语句内），且未对 wp_footer 钩子做上下文隔离，会导致钩子注册失效。
✅ 正确做法是：在钩子回调函数内部进行首页判断，同时修复 Cookie 设置与读取的逻辑缺陷。以下是优化后的完整代码：
<?php // 1. 设置/更新访问计数 Cookie（使用更安全的 setcookie 参数）
function od_cookie() {
// 仅在前端且非 AJAX 请求中处理
if ( ! is_admin() && ! wp_doing_ajax() ) {
$count = 1;
if ( isset( $_COOKIE['odpop'] ) && is_numeric( $_COOKIE['odpop'] ) ) {
$count = intval( $_COOKIE['odpop'] ) + 1;
}
// 设置 Cookie：有效期为 365 天，作用域为根路径，HTTPS 安全（如启用 HTTPS 建议加 'secure' 和 'httponly'）
$expires = time() + (365 * DAY_IN_SECONDS);
setcookie( 'odpop', $count, [
'expires' => $expires,
'path' => '/',
'domain' => '',
'secure' => is_ssl(),
'httponly'=> true,
'samesite'=> 'Lax'
] );
}
}
add_action( 'init', 'od_cookie' );
// 2. 首页弹窗主逻辑（在 wp_footer 中执行，但先校验 is_front_page()）
function odpopwp_fire() {
// ✅ 核心限制：仅首页执行
if ( ! is_front_page() ) {
return;
}
$fireOn = [1, 3, 6, 9, 12, 15, 18, 21, 24, 27, 30, 33, 36, 39, 42, 45];
// 表单提交成功页（通过 ?odpop=1 等 GET 参数识别）
if ( isset( $_GET['odpop'] ) ) {
include_once WP_PLUGIN_DIR . '/odonnell-popup/public/templates/success-template.php';
return;
}
// 检查访问计数并触发弹窗
if ( isset( $_COOKIE['odpop'] ) && in_array( (int) $_COOKIE['odpop'], $fireOn, true ) ) {
include_once WP_PLUGIN_DIR . '/odonnell-popup/public/templates/odpopwp-template.php';
return;
}
// ⚠️ 注意：首次访问（cookie 未设置）时不应直接显示弹窗，
// 因为 od_cookie() 在 init 阶段已设置为 1，下一次刷新才会生效。
// 若需首访即触发（对应 fireOn[0] = 1），可在此补充逻辑（见下方说明）
}
add_action( 'wp_footer', 'odpopwp_fire' );
? 关键改进说明：
- 首页判断前置：is_front_page() 放在函数开头，不满足则立即 return，高效终止执行；
- Cookie 安全增强：使用关联数组参数调用 setcookie()，支持 SameSite、HttpOnly 等现代安全策略；
- 避免重复包含：使用 include_once 防止模板文件意外多次加载；
- 类型严格校验：in_array(..., true) 启用严格比较，防止字符串 '1' 与整数 1 混淆；
- 环境隔离：is_admin() 和 wp_doing_ajax() 排除后台与 AJAX 场景，提升健壮性。
? 关于“首次访问是否显示”：当前逻辑中，用户首次访问首页时 $_COOKIE['odpop'] 尚未被读取（因 init 阶段设置，wp_footer 阶段才可用），故首次不会触发（符合多数场景预期）。若需首访即显示（匹配 fireOn[0] === 1），可在 odpopwp_fire() 中添加如下兜底逻辑：
} elseif ( ! isset( $_COOKIE['odpop'] ) ) {
// 首次访问，且 1 在 fireOn 数组中，则立即显示
if ( in_array( 1, $fireOn, true ) ) {
include_once WP_PLUGIN_DIR . '/odonnell-popup/public/templates/odpopwp-template.php';
}
}
最后，请确保主题已正确调用 wp_footer()（通常在 footer.php 中），并清除浏览器缓存及 WordPress 缓存插件缓存以验证效果。
