在 WordPress 多站点环境下，子主题中注册的短代码（如 [site_url]）若直接写在 PHP 模板文件中（如 page-test.php），不会自动解析；必须通过 do_shortcode() 函数显式执行，才能输出对应内容。

在 wordpress 多站点环境下，子主题中注册的短代码（如 `[site_url]`）若直接写在 php 模板文件中（如 `page-test.php`），不会自动解析；必须通过 `do_shortcode()` 函数显式执行，才能输出对应内容。

你已在子主题的 functions.php 中正确定义了短代码：

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

✅ 注意：此处已补全语法错误（原代码缺少闭合括号和分号），并添加空数组默认值 $atts = []，符合 WordPress 最佳实践。

但问题出在模板文件中——你将 [site_url] 直接写在 HTML 内容里：

<h1>Notre site web : [site_url]</h1>

⚠️ 这只是纯文本字符串，WordPress 不会自动解析模板文件中的短代码。只有以下场景会自动执行短代码：

SEO Keyword Density

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

下载

• 文章/页面内容（通过 the_content() 输出时）；
• 小工具（启用“文本”小工具并勾选“自动执行短代码”）；
• 使用 do_shortcode() 显式调用。

✅ 正确做法：在模板中用 PHP 调用 do_shortcode() 并 echo 输出：

/*
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(); ?>

? 进阶建议：

• 若需多次使用，可封装为辅助函数，提升可读性与复用性：

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

• 确保短代码注册钩子（init）早于模板加载，子主题 functions.php 默认满足此条件；
• 在多站点中，site_url() 返回当前站点的 URL（非网络主站），符合预期。

总结：短代码不是模板语法糖，而是需主动触发的 PHP 功能。牢记——模板中硬编码的短代码必须经 do_shortcode() 解析，否则仅作字符串显示。