小伙伴们有没有觉得学习文章很有意思？有意思就对了！今天就给大家带来《如何在 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 模板中的字符串（如

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>

• 如需支持多站点上下文（如获取当前子站点 URL 而非网络主站），推荐改用 home_url() 或 get_site_url( get_current_blog_id() )，更精准可靠。

总结：短代码不是“魔法标签”，它依赖 WordPress 的内容过滤流程；脱离该流程时，必须主动调用 do_shortcode() —— 这是模板开发中一个常见却易被忽略的核心原则。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。