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