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

1. 简单的短代码

本教程的第一部分，我们将创建下面这个短代码的代码：

[recent-posts]

创建的过程非常简单，不需要很高级的PHP知识。创建过程如下：

创建一个函数，当 WordPress 发现短代码的时候会调用此函数；
通过设置一个唯一的名称来注册短代码；
把注册的函数绑定到Wordpress的action上。
本教程的所有代码都可以直接放到 functions.php 中，也可以放在一个将包含在 functions.php 的单独的PHP文件中。

1.1 创建回调函数

当发现短代码的时候，它会被一个称作回调函数的一段代码所代替。所以我们先创建一个函数，从数据库中获取最新的文章。

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

如上所示，我们查询数据库，获取最新的文章，并返回一个带有链接的字符串。值得注意的是，回调函数并不打印任何内容，而是返回一个字符串。

1.2 注册短代码

现在，我们告诉Wordpress这个函数是一个短代码：

function register_shortcodes(){
   add_shortcode('recent-posts', 'recent_posts_function');
}

当在文章的内容中发现短代码 [recent-posts] 时，将会自动调用 recent_posts_function() 函数，我们需要确保短代码的名字是唯一的，以避免重复。

1.3 Hook into WordPress

为了能够执行 recent_posts_function() 函数，我们需要把它绑定在 WordPress 的初始化钩子中。
add_action( 'init', 'register_shortcodes');

1.4 测试短代码

简单的短代码已经准备好了，现在我们需要测试它是否能够正常运行。我们创建一个新的文章（或打开一个已存在的），把下面的代码加入到文章内容中的某个位置：

[recent-posts]

发布文章并在浏览器中打开，你将看到一个执行你最新文章的链接。