WordPress 常用函数 / do_shortcode

简介

搜索 $content 中的短代码(shortcode)并调用其对应的处理函数来替换。

用法

<?php echo do_shortcode( $content ) ?>

参数

$content
(string) (required) 含有短代码的字符串。
Default: None

返回值

(string)
短代码被对应其处理函数返回文本替换之后的字符串。

实例

// WordPress 默认的 filter,转换日志内容中的短代码
add_filter('the_content', 'do_shortcode', 11);
// 在 PHP 文件中使用短代码(日志内容外面)。
echo do_shortcode('');
// 在 PHP 文件中使用有开始和结束的短代码。
echo do_shortcode('
  • '.$items.'
');
// 让 widgets 支持短代码。
add_filter('widget_text', 'do_shortcode');

注解

如果内容中没有短代码,内容就会不做任何过滤直接返回,这样会引起一个问题,比如一个插件被禁用,其短代码就会直接显示在内容中。

修改记录

Since: 2.5

源文件

wp-includes/shortcodes.php