首页
/
CMS教程
/
WordPress教程
/
WordPress 文章上下方批量注入固定内容 functions.php 写法

WordPress 文章上下方批量注入固定内容 functions.php 写法

张文保 2018年4月21日更新 2026年5月8日 17 分钟阅读 1,997 阅读

这篇文章我把自己在多个项目里反复打磨的方案完整写下来，从最原始的 the_content 钩子写法，到带条件判断、带缓存友好、带 AMP 兼容的进阶版本，再到一些容易踩坑的细节，希望能帮到正在折腾 WordPress 的朋友。

为什么不建议直接改 single.php

很多教程一上来就让你打开 single.php，在 the_content() 函数前后写死一段 HTML，这种做法在小站确实能跑通，但保哥不推荐，原因有三个。

第一，主题更新会覆盖。只要你用的是市面上常见的主题，作者一旦发版，single.php 大概率会被覆写，你辛苦加的那段代码全部清零。哪怕你做了子主题，single.php 也属于经常被父主题改动的文件之一，维护成本不低。

第二，插入位置不灵活。直接写在模板里，等于把样式、内容、逻辑全部硬编码，以后想给某个分类、某种文章类型单独换一段内容，就得到处加 if 判断，模板会变得很乱。

第三，影响 RSS 和 REST API。模板层的代码只在前台页面执行，而通过钩子注入的内容会随 the_content 一起进入 RSS Feed、JSON REST API、AMP 输出。如果你不想让 Feed 里也出现广告，反而是钩子方式更可控，因为我们可以用 is_feed() 精确判断。

所以保哥的原则是：内容相关的注入，全部走 functions.php 的过滤器钩子，模板文件保持干净。

基础写法：用 the_content 过滤器统一注入

核心思路是注册一个 the_content 过滤器，在过滤器里拼好要插入的 HTML，然后根据需要拼到原 $content 的前面或后面。下面这段是我项目里在用的基础版，已经处理了 Feed、首页、归档、搜索页、附件页这些不该插入的场景。

<?php
/**
 * 在文章正文上方或下方注入固定内容
 * 放到当前主题的 functions.php 即可
 */
function zwb_extra_block( $position = 'after' ) {
    $html  = '<div class="zwb-extra-block zwb-' . esc_attr( $position ) . '">';
    $html .= '<h4>关注保哥笔记</h4>';
    $html .= '<p>更多 WordPress、Typecho、SEO 实战，欢迎访问 <a href="https://zhangwenbao.com/" rel="nofollow">zhangwenbao.com</a>。</p>';
    $html .= '</div>';
    return $html;
}

function zwb_inject_extra( $content ) {
    // 仅在前台单篇文章主查询里注入
    if ( is_singular( 'post' ) && in_the_loop() && is_main_query() && ! is_feed() ) {
        $before  = zwb_extra_block( 'before' );
        $after   = zwb_extra_block( 'after' );
        $content = $before . $content . $after;
    }
    return $content;
}
add_filter( 'the_content', 'zwb_inject_extra', 20 );

几个细节解释一下。is_singular('post') 限定只在文章详情页执行，自定义文章类型不受影响；in_the_loop() 和 is_main_query() 是为了避免一些插件在侧边栏里调用 the_content 时被重复注入；过滤器优先级写 20，是为了让自动段落 wpautop（默认 10）先执行完，我们再追加，HTML 结构最稳。

只在前面或只在后面插入

function zwb_inject_before_only( $content ) {
    if ( is_singular( 'post' ) && in_the_loop() && is_main_query() && ! is_feed() ) {
        $content = zwb_extra_block( 'before' ) . $content;
    }
    return $content;
}
add_filter( 'the_content', 'zwb_inject_before_only', 20 );

后置同理，把拼接顺序换一下即可。保哥更推荐用一个统一函数加参数控制，而不是写两个独立函数，后期维护改样式只要改一个地方。

按分类、标签、文章类型差异化注入

实际项目里很少所有文章都用同一段内容。比如 WordPress 教程下的文章想引导加微信，主机评测下的文章想推荐促销链接。可以这样做：

function zwb_inject_by_category( $content ) {
    if ( ! ( is_singular( 'post' ) && in_the_loop() && is_main_query() && ! is_feed() ) ) {
        return $content;
    }

    if ( has_category( 'wordpress' ) ) {
        $extra = '<div class="zwb-tip">想系统学 WordPress，可以看看保哥整理的入门到精通系列。</div>';
    } elseif ( has_category( 'host-review' ) ) {
        $extra = '<div class="zwb-tip">本文涉及的主机当前有促销，下单前请核对官网价格。</div>';
    } else {
        $extra = '';
    }

    return $content . $extra;
}
add_filter( 'the_content', 'zwb_inject_by_category', 20 );

如果分类策略复杂，建议把分类 slug 和对应 HTML 抽到一个数组里，循环匹配，functions.php 不至于堆成几百行。

不影响 Feed、AMP、REST API 的细节

is_feed() 用来排除 RSS、Atom 输出，被各种 RSS 同步、聚合阅读用到，里面尽量保持纯净。

rest API 的判断稍微麻烦，因为 the_content 也会在 wp/v2/posts 里被调用。可以用 defined('REST_REQUEST') && REST_REQUEST 判断；如果你接入了无头前端、小程序、App，建议直接 return $content，让 API 拿到的是干净正文，注入逻辑放到前端去做。

AMP 由 amp 插件接管时，可以用 function_exists('amp_is_request') && amp_is_request() 判断，AMP 模式下要么完全跳过，要么换一段不含 JS、不含表单的纯净 HTML。

合在一起就是这样：

function zwb_should_inject() {
    if ( ! ( is_singular( 'post' ) && in_the_loop() && is_main_query() ) ) {
        return false;
    }
    if ( is_feed() ) {
        return false;
    }
    if ( defined( 'REST_REQUEST' ) && REST_REQUEST ) {
        return false;
    }
    if ( function_exists( 'amp_is_request' ) && amp_is_request() ) {
        return false;
    }
    return true;
}

之后在每个注入函数最前面调一下 zwb_should_inject() 即可，不用重复写一长串判断。

SEO 友好的写法和容易忽略的细节

保哥做 SEO 这些年，看到很多人在文章上下方塞一堆站外链接，结果整站权重被稀释，甚至被算法识别成软文站。这里给几条经验。

站外链接尽量加 rel="nofollow"，尤其是广告、合作、互推。如果是自己的小程序或公众号引导，可以保留 dofollow。

避免在每篇文章前后塞超过 200 字的固定内容。重复内容比例过高会拖累每篇文章的相对权重，Google 对模版化重复内容容忍度逐年降低。短小精悍的引导框比大段文字更安全。

如果你的固定内容里包含 H 标签，记得用 H4 或 H5，不要用 H2。H2 会被搜索引擎当成正文小标题，破坏文章原本的语义结构，Featured Snippets 抓取也会变得不可控。

表格、图片、二维码这种富媒体，建议用懒加载属性 loading="lazy"，避免每篇文章都因为这块固定内容多一次首屏请求。

进阶：从后台可视化编辑这段内容

硬编码在 functions.php 里有个问题，每次想改文案都要登 SSH 或 FTP。保哥的做法是把内容存到 wp_options 里，后台开一个简单的设置页让运营同学自己改。

add_action( 'admin_menu', function() {
    add_options_page( '正文注入设置', '正文注入', 'manage_options', 'zwb-inject', 'zwb_inject_page' );
});

function zwb_inject_page() {
    if ( isset( $_POST['zwb_inject_html'] ) && check_admin_referer( 'zwb_inject_save' ) ) {
        update_option( 'zwb_inject_html', wp_kses_post( wp_unslash( $_POST['zwb_inject_html'] ) ) );
        echo '<div class="updated"><p>已保存</p></div>';
    }
    $value = get_option( 'zwb_inject_html', '' );
    echo '<div class="wrap"><h1>文章下方注入内容</h1><form method="post">';
    wp_nonce_field( 'zwb_inject_save' );
    echo '<textarea name="zwb_inject_html" rows="10" style="width:100%">' . esc_textarea( $value ) . '</textarea>';
    submit_button();
    echo '</form></div>';
}

注入逻辑里把硬编码 HTML 换成 get_option('zwb_inject_html', '') 即可。wp_kses_post 是关键，它会按 WordPress 默认白名单过滤掉危险标签，避免运营同学误粘贴 script 把站点搞挂。

调试和缓存相关的常见问题

做完上线，经常听到反馈说没生效。保哥总结了几个排查顺序。

第一步，确认主题没有被某些极简模板覆盖 the_content。有些主题在 single.php 里直接 echo $post->post_content，这样会绕过过滤器。改成 the_content() 或 apply_filters('the_content', $post->post_content) 才会触发钩子。

第二步，确认页面缓存。如果你用了 WP Super Cache、WP Rocket、LiteSpeed Cache，改完代码要清一次全站缓存，否则 HTML 还是旧的。CDN 层（Cloudflare、又拍云）也要刷新一次。

第三步，确认没有冲突插件。一些 SEO 插件、广告插件也在挂 the_content，并且把 $content 整个替换掉，导致你后挂的过滤器看似执行了但被它覆盖。可以临时把过滤器优先级调到 99 看看效果。

第四步，浏览器禁用扩展。AdBlock、隐私插件可能直接在前端把广告位 div 隐藏掉，看起来像没生效，其实 HTML 是渲染了的。