WordPress的短代码功能可以让用户在文章、页面中快速插入动态内容，但有时候我们需要在主题或插件的函数文件中直接执行短代码，这时候就需要用到do_shortcode函数。这个函数可以解析并执行传入的短代码字符串，返回对应的执行结果。
do_shortcode函数的基本说明
do_shortcode是WordPress核心提供的短代码解析函数，它的作用是把包含短代码格式的字符串转换成对应的实际输出内容。函数的基本语法如下：
<?php
/**
* 执行短代码并返回结果
* @param string $content 包含短代码的字符串
* @return string 短代码执行后的内容
*/
function do_shortcode( $content ) {
// 核心解析逻辑省略
}
?>
需要注意的是，do_shortcode只会解析字符串中符合短代码格式的标签，比如[gallery]这种格式的内容才会被处理，普通文本会原样返回。
在函数文件中使用do_shortcode的步骤
1. 确认短代码已经注册
在执行短代码之前，必须确保对应的短代码已经通过add_shortcode函数注册过，否则do_shortcode无法识别，会直接返回原字符串。比如我们要执行[recent_posts]这个短代码，需要先确认有类似下面的注册代码：
<?php
// 注册自定义短代码
add_shortcode( 'recent_posts', 'custom_recent_posts_shortcode' );
function custom_recent_posts_shortcode( $atts ) {
// 短代码逻辑，返回最新文章列表
$args = array(
'posts_per_page' => 5,
'post_status' => 'publish'
);
$query = new WP_Query( $args );
$output = '<ul>';
while ( $query->have_posts() ) {
$query->the_post();
$output .= '<li><a href="' . get_permalink() . '">' . get_the_title() . '</a></li>';
}
wp_reset_postdata();
$output .= '</ul>';
return $output;
}
?>
2. 在函数文件中调用do_shortcode
我们可以在主题的functions.php或者自定义插件文件中，直接调用do_shortcode函数执行短代码。比如我们要在网站底部输出最新文章列表，可以添加下面的代码：
<?php
// 在网站底部添加最新文章短代码输出
add_action( 'wp_footer', 'add_footer_recent_posts' );
function add_footer_recent_posts() {
// 执行短代码并输出结果
echo do_shortcode( '[recent_posts]' );
}
?>
3. 处理带参数的短代码
如果短代码支持参数，我们可以直接在字符串中传入参数，do_shortcode会自动解析参数并传递给短代码回调函数。比如我们的[recent_posts]短代码支持num参数控制显示数量，调用方式如下：
<?php
// 执行带参数的短代码
add_action( 'wp_footer', 'add_footer_recent_posts_with_param' );
function add_footer_recent_posts_with_param() {
// 传入num参数，显示3篇最新文章
echo do_shortcode( '[recent_posts num="3"]' );
}
?>
常见使用场景
- 在主题模板文件中动态调用短代码，比如页头、侧边栏、页脚等区域插入短代码内容
- 在自定义插件中，根据条件动态执行不同的短代码返回内容
- 处理文章保存时的内容，对自定义字段中的短代码进行解析后存储
注意事项
- 不要在短代码回调函数内部再调用do_shortcode处理当前短代码，否则会造成递归死循环
- 如果是在保存文章或自定义字段内容时使用do_shortcode，要注意过滤非法内容，避免安全漏洞
- do_shortcode返回的是字符串，如果需要进一步处理输出内容，可以先保存到变量中再做后续操作
- 执行短代码时要确保WordPress的核心函数已经加载完成，最好把调用代码放在对应的钩子函数中，比如
init之后的钩子
常见问题排查
如果调用do_shortcode后没有输出预期内容，可以按照下面的步骤排查：
- 检查短代码是否已经正确注册，确认
add_shortcode的调用时机早于do_shortcode的执行 - 打印do_shortcode的返回值，看是否返回了原短代码字符串，如果是说明短代码未被识别
- 检查短代码回调函数的逻辑是否有错误，比如是否有语法错误或者查询逻辑问题
- 确认短代码格式是否正确，比如是否有多余的空格或者标签闭合错误
注意：do_shortcode只能解析已经注册的短代码，对于未注册的短代码标签会原样返回，不会报错。
WordPressdo_shortcode短代码函数文件修改时间：2026-07-10 01:51:35