新闻中心

WordPress开发：自定义一个短代码Shortcode的具体步骤（一）

作者 / 无忧主机时间 2015-03-21 10:24:49

无忧小编也在使用Wordpress程序在无忧主机php空间中建站哦，快来与我们交流下经验把。这次和大家介绍下wordpress Shortcode；这个东西是干嘛的呢？这个是让用户通过wordpress短代码可以非常方便快速地在编辑文章或页面的时候插入动态内容，短代码的常见应用有插入最新文章、插入广告、插入音频视频、插入下载按钮等。由于这个短代码功能是在2.5版本引进来的，一直到现在都在沿用，所以很多模板定制商都会这个功能，如果你是站长，或者是Wordpress的学习者可以学习一下哦，今天无忧主机小编给大家介绍第一步，利用简单的代码创建回调函数。考虑到初次接触这块的站长们的操作，无忧小编就先由简到繁的讲解一下：在使用Wordpress程序时，我们想显示给定的最新文章，那么我们可以通过下面的代码来实现：[recent-posts] 有变量的话，那么如何控制变量的值呢？当然要通过设定一个参数来控制现实的文章的数量：[recent-posts posts="5"] 文章调用出来了，是不是得给文章列表增加一个标题呢？需求代码如下： [recent-posts posts="5"]Posts Heading[/recent-posts] 懂编程的可能一下就知道无忧小编上面所说的，不懂的，请继续往下看：第一步：创建回调函数利用短代码创建一个函数方法，这里是用代码实现的功能，从数据库中获取最新的文章：

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

上面的代码可以查询数据库获取出最新的文章并且返回一个带有<a>链接字符串，需要注意的是这个函数返回的是字符串而非直接输出的内容。第二步：注册短代码功能代码写完了，怎么让这个功能在Wordpress中使用呢？那么就是第二步的功能注册短代码啦，方法很简单，利用代码：

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

上面这段代码就可以让调用短代码：[recent-posts]而实现调用获取文章回调函数recent_posts_function()，这里需要注意的是短代码的命名要有意义，避免重复错乱。第三步：Hook into WordPress 短代码也封装好了，就只剩下嵌套使用了，为了能让recent_posts_function() 函数顺利执行，我们需要绑定到WordPress 的初始化钩子中去。重要代码：add_action( 'init', 'register_shortcodes'); 第四步：测试功能一个简单而又复杂的获取最新文章的短代码已经完成，现在就是测试，怎么测试呢？在wp后台新建一篇文章，或者再编辑原文章也可以，然后把短代码：[recent-posts]加入到文章内容的某个位置即可。在浏览器中打开后，就可以看到如下图所示：