如何在 WordPress 子主题中正确添加并调用自定义短代码

在 WordPress 多站点环境下，子主题中注册的短代码（如 [site_url]）无法直接写在 PHP 模板文件中生效，必须通过 do_shortcode() 函数显式解析后输出。

在 wordpress 多站点环境下，子主题中注册的短代码（如 `[site_url]`）无法直接写在 php 模板文件中生效，必须通过 `do_shortcode()` 函数显式解析后输出。

要在子主题中成功使用自定义短代码（例如 [site_url]），需同时满足两个条件：正确注册短代码 + 在模板中正确解析短代码。

首先，您已在 functions.php 中注册了短代码，但当前代码存在语法错误（缺少闭合括号与分号），应修正为：

add_action( 'init', function() {
    add_shortcode( 'site_url', function( $atts = [], $content = null ) {
        return site_url();
    } );
} );

✅ 注意事项：

add_shortcode() 必须在 WordPress 已加载短代码系统后执行，init 钩子是安全选择；
$atts 参数建议设为默认空数组 []（更符合现代 PHP 规范）；
确保该代码位于子主题的 functions.php 中，且未被其他逻辑意外中断（如未闭合的 PHP 标签或语法错误）。

其次，关键问题在于：模板文件中硬编码的 [site_url] 不会自动解析——WordPress 仅对文章内容、页面内容、小工具等由 the_content()、the_excerpt() 等函数输出的文本自动执行短代码解析。而直接写在 .php 模板中的字符串（如

SEO Keyword Density

SEO关键词密度优化与页面审计技能。使用场景：①提供页面路径与关键词进行SEO优化；②提升页面关键词密度；③提升搜索引擎排名；④进行SEO审计（meta标签、OG、hreflang等）。触发词：关键词密度、SEO优化、关键词优化等。

下载

Notre site web : [site_url]

）只是纯文本，不会触发短代码机制。

✅ 正确做法：使用 do_shortcode() 手动解析并输出：

/*
Template name: Test 
*/
get_header(); ?>
<div>
    <h1>Notre site web : <?php echo do_shortcode('[site_url]'); ?>
</h1>
    <?php if ( have_posts() ) :
        while ( have_posts() ) :
            the_post();
            get_template_part( 'content', 'page' );
        endwhile;
    endif;
    ?>
</div>
<?php get_footer(); ?>

? 进阶建议：

若需多次使用，可封装为模板函数，提升可维护性：

if ( ! function_exists( 'echo_site_url' ) ) {
    function echo_site_url() {
        echo do_shortcode( '[site_url]' );
    }
}
// 在模板中调用：
// <h1>Notre site web : <?php echo_site_url(); ?>
</h1>