可适配全站含WooCommerce商店页的通用钩子实现置顶年龄验证层

• 之前使用the_content钩子失效的原因：该钩子仅作用于WordPress默认主循环的文章/页面正文渲染流程，WooCommerce的商店列表、产品详情、购物车、结账页全部使用独立的模板渲染逻辑，不会触发the_content的过滤流程，天然覆盖不到这些页面。
• 之前尝试挂载其他钩子失效的核心原因：
  • init属于WordPress加载早期钩子，此时尚未开始输出页面HTML内容，直接在此阶段输出HTML会打乱页面渲染顺序，甚至触发PHP语法错误。
  • 之前直接将带$content参数的内容过滤型函数挂载到wp_head/wp_footer上，存在两层逻辑不匹配：一是这类全局action钩子不会向函数传入$content参数，二是action钩子不会读取函数的return返回值，必须在函数内部直接echo输出HTML才能正常展示，所以之前的写法即使挂到这些钩子上，也不会有任何显示效果。
• 你的需求是实现全站顶层固定遮罩，完全不需要依赖内容区钩子，只需要选择所有页面一定会触发的全局输出钩子即可。

wp_footer是WordPress内置的、所有正常渲染的前端页面（含普通博客页、WooCommerce全流程页面、自定义文章类型页）都会在关闭</body>标签前触发的全局钩子，完全满足你的全站覆盖需求。
修正后的完整可运行代码如下：

add_action( 'wp_footer', 'age_verification_disclaimer' );
function age_verification_disclaimer() {
    // 内置遮罩样式，保证固定顶层、全屏覆盖不被其他元素遮挡
    echo '<style>
    .disclaimer-wrapper {
        position: fixed;
        inset: 0;
        width: 100vw;
        height: 100vh;
        background: rgba(0,0,0,0.85);
        z-index: 999999;
        display: flex;
        align-items: center;
        justify-content: center;
    }
    .disclaimer-container {
        background: #fff;
        padding: 2.5rem;
        border-radius: 0.5rem;
        max-width: 32rem;
        text-align: center;
    }
    .disclaimer-answer {
        margin: 0 0.625rem;
        display: inline-block;
    }
    </style>';

    // 输出年龄验证模块HTML
    echo '
    <div class="disclaimer-wrapper">
        <div class="disclaimer-container">
            Are you over 18 years old?<br /><br />
            <a href="" class="button disclaimer-answer" data-answer="yes">'.__('Yes').'</a>
            <a href="" class="button disclaimer-answer" data-answer="no">'.__('No').'</a>
        </div>
    </div>
    ';
}

• 遮罩的z-index值需要设置到足够大：WooCommerce自带的购物车弹窗、站点通知提示的层级一般在9999以内，999999的层级值可以保证遮罩始终处于页面最顶层，不会被其他插件、主题的元素遮挡。
• 不要将该功能挂载到内容类钩子上：不管是the_content还是其他页面构建器的内容过滤钩子，都存在覆盖盲区，用全局页脚钩子实现固定遮罩是最稳定的方案。
• 后续如果需要实现验证状态记忆，只需补充前端JS逻辑：用户点击验证按钮后将状态存入Cookie或sessionStorage，页面加载时先判断存储的状态，如果已完成验证则隐藏遮罩，避免每次访问都重复弹出。

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