WordPress子主题调用自定义短代码技巧

在 WordPress 多站点环境下的子主题开发中，很多人误以为在 PHP 模板文件（如 page-test.php）中直接写入 `[site_url]` 这类自定义短代码就能自动生效，但实际上它只会作为纯文本显示——短代码必须通过 `do_shortcode()` 函数显式解析才能输出真实内容；本文清晰揭示了这一常见误区，详解了正确注册短代码、在模板中安全调用及封装复用的最佳实践，帮你避开坑、写出更健壮可靠的子主题代码。

在 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 不会自动解析模板文件中的短代码。只有以下场景会自动执行短代码：

• 文章/页面内容（通过 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() 解析，否则仅作字符串显示。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~