教程解读:
自从 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 短代码使用教程