在 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() 解析，否则仅作字符串显示。
