WordPress短代码使用教程

教程解读：

自从2.5版本推出以来，WordPress短代码已经被证明是最有用的功能之一。通过简短的代码，普通编辑用户无需专业编程能力即可发布动态内容。

当一个短代码被放入一篇文章或一个页面时，它将被替换为其他内容。换句话说，我们会在一篇文章或页面中找到方括号([])中的内容，根据一个PHP函数，用一个合适的动态内容替换它。

WordPress短代码的使用非常简单。比如说我们想显示给定的最新文章，我们可以使用类似下面的代码：

[recent–posts]

再进一步的，我们可以通过设定一个参数来控制现实的文章的数量：

[recent–posts posts=“5”]

更进一步的，我们可以为文章列表增加一个标题：

[recent–posts posts=“5”]Posts Heading[/recent–posts]

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

[recent–posts]

创建的过程非常简单，不需要高深的PHP知识。

创建过程如下:

创建一个当WordPress找到一个短代码时将被调用的函数；
通过设置唯一的名称来注册短代码；
将注册的功能绑定到Wordpress的动作。
本教程的所有代码可以直接放入functions.php或一个单独的PHP文件，将包括在functions.php。

创建回调函数
当找到一个短代码时，它将被一段叫做回调函数的代码所替代。所以我们首先创建一个函数从数据库中获取最新的文章。

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;
}

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

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

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

当在文章内容中找到短码【recent-posts】时，会自动调用recent_posts_function()函数。我们需要确保短代码的名称是唯一的，以避免重复。

挂钩到WordPress
为了能够执行recent_posts_function()函数，我们需要将其绑定在WordPress的初始化钩子中。

add_action( ‘init’, ‘register_shortcodes’);

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

[recent–posts]

发布文章并在浏览器中打开，你将看到一个执行你最新文章的链接，如下图所示：

转载请注明：汇站网 » WordPress短代码使用教程