WordPress Shortcode(短代码)：完全指南

2. 进阶短代码

2.1 短代码参数
短代码非常灵活，因为它允许我们添加参数以使它们具有更多的功能。假定我们需要显示一定数量的最新文章。为了实现这个，我们需要给短代码增加额外的选择来指定显示最新的多少篇文章。

我们需要使用两个函数，第一个是Wordpress内置的 shortcode_atts() 函数，它把用户的短代码属性与本地属性结合在一起，并填充到所需要的位置。第二个是PHP的 extract() 函数，顾名思义，它提取短代码的各个属性。

扩展我们的回调函数，我们添加一个参数，它是一个数组，从中我们可以提取到我们需要获取的文章的数量。我们查询数据库，获取指定数量的文章，并返回一个列表：

function recent_posts_function($atts){
   extract(shortcode_atts(array(
      'posts' => 1,
   ), $atts));
 
   $return_string = '<ul>';
   query_posts(array('orderby' => 'date', 'order' => 'DESC' , 'showposts' => $posts));
   if (have_posts()) :
      while (have_posts()) : the_post();
         $return_string .= '<li><a href="'.get_permalink().'">'.get_the_title().'</a></li>';
      endwhile;
   endif;
   $return_string .= '</ul>';
 
   wp_reset_query();
   return $return_string;
}

如果用户不指定该选项，1将是默认值。我们可以添加更多的属性，使短代码接受更多的参数。用这个增强的函数，我们可以指定调用最新文章的数量：

[recent-posts posts="5"]

在浏览器中显示时，你将看到最新的五篇文章列表。
2.2 短代码中添加内容
我们可以更进一步扩展我们的短代码，添加一些内容作为参数来传递，这将是最新文章列表的标题。为了实现此功能，我们需要在回调函数中增加第二个参数 $content ，并把它显示在列表前面的一个 h3 标签中。新的函数如下：

2.2 短代码中添加内容
function recent_posts_function($atts, $content = null) {
   extract(shortcode_atts(array(
      'posts' => 1,
   ), $atts));
 
   $return_string = '<h3>'.$content.'</h3>';
   $return_string .= '<ul>';
   query_posts(array('orderby' => 'date', 'order' => 'DESC' , 'showposts' => $posts));
   if (have_posts()) :
      while (have_posts()) : the_post();
         $return_string .= '<li><a href="'.get_permalink().'">'.get_the_title().'</a></li>';
      endwhile;
   endif;
   $return_string .= '</ul>';
 
   wp_reset_query();
   return $return_string;
}

这种短代码类似于一个HTML标签：

[recent-posts posts="5"]This is the list heading[/recent-posts]

除了文章列表多了一个标题，其余的内容和上一个示例是一样的：
3. 在任何地方显示短代码
3.1 在侧边栏小工具中使用短代码
默认情况下，侧边栏小工具是忽略短代码的，实例如下：

[recent-posts posts="5"]

如果你把这段代码放在小工具里的时候，你将看到类似输出

//原简码输出
[recent-posts posts="5"]

我们可以通过一行代码来启用这个函数，为了使侧边栏小工具支持短代码，添加如下的代码：

add_filter('widget_text', 'do_shortcode');

现在不需要修改其他任何地方，刷新一下页面看看，侧边栏将会正确的显示：
其它地方显示：

//在评论中启用短代码：
add_filter( 'comment_text', 'do_shortcode' );
//摘要中启用短代码：
add_filter( 'the_excerpt', 'do_shortcode');