WordPress 自定义文章列表列的实例

下面来看一篇关于WordPress 自定义文章列表列的实例,这个功能在wp系统默认是没有的我们是看一站长开发了,下面整理和各位分享.

今天要实现具体的功能就是在列表里添加一列“推荐指数”,用来显示每篇文章的推荐指数,同时可以根据“推荐指数”来进行文章排序.

首先要做的就是在表头添加“推荐指数”列,代码如下:

1. function add_rating_column($columns) { 
2.     $columns['rating'] = '推荐指数'; 
3.     return $columns; 
4. } 
5. add_filter('manage_posts_columns' , 'add_rating_column'); 

manage_posts_columns Filter可以应用管理文章页面的表头里,用来修改表头信息,注意该Filter不会应用到Page的列表页面,如需用到,请使用manage_pages_columns 或者 manage_${post_type}_posts_columns

有了表头,只是添加了这一列,但是该列还没有内容,我们来为该列填充数据,代码如下:

1. function rating_column_content($column_name, $post_id) { 
2.     if ($column_name == 'rating') { 
3.         $rating_value = get_post_meta( $post_id, '_rating', true ); 
4.         echo ($rating_value / 2) . '星'; 
5.     } //开源软件:Vevb.com 
6. } 
7. add_action('manage_posts_custom_column', 'rating_column_content', 10, 2); 

这里用到了 manage_posts_custom_column Action，查看该Action的文档,我们可以知道该Action可以用来添加或修改列表的列,包括内建的以及自定义的列表列,该Action 接受两个参数,第一个是列表列的名字（$column_name,即第一步中的’rating’,而非’推荐指数’),第二个是当前的文章ID（$post_id）,根据这两个参数,我们就可以根据当前列的名字来获取文章的相关信息了.

这里通过判断当前列表列是不是’rating’,是则根据文章ID获取到推荐指数的值,并格式化输出.

接下来让他能够进行排序,通过 manage_edit-post_sortable_columns Filter来指定哪些列可以用来排序,代码如下:

1. function rating_column_table_sorting( $columns ) { 
2.     $columns['rating'] = 'rating'; 
3.     return $columns; 
4. } //开源软件:Vevb.com 
5. add_filter( 'manage_edit-post_sortable_columns', 'rating_column_table_sorting' ); 

添加后，点击“推荐指数”列表头,可以看到页面的地址已经变到了排序的页面（/wp-admin/edit.php?orderby=rating&order=asc）,但是列表却并没有排序,这是因为WordPress并不如何根据’rating’来排序.

接下来就告诉WordPress如何根据’rating’排序,代码如下:

1. function rating_column_orderby( $vars ) { 
2.     if ( isset( $vars['orderby'] ) && $vars['orderby'] == 'rating' ) { 
3.         $vars['orderby'] = 'meta_value_num'; 
4.         $vars['meta_key'] = '_rating'; 
5.     } 
6.     return $vars; 
7. } 
8. add_filter( 'request', 'rating_column_orderby' ); 

这里我们通过改变request Filter,判断当前是否有’orderby’参数,以及是否等于’rating’,如果是,则将orderby=meta_value_num和meta_key=_rating加入到了当前请求的query vars中,这样WordPress就知道需要根据自定义字段’_rating’的整数顺序来排序.

至此,自定义文章列表列的功能已经实现,这里只是一个示例,稍作修改,便可以将“推荐指数”换成你文章中的任何数据,从而实现不同站点的不同需求.

另外,你是不是又注意到自己根据教程实现的效果有点不一样？你的“推荐指数”在最后一列？

告诉你一个小技巧,在第一段代码中,传给Filter的参数$columns，是一个列的数组，包含了所有的列的信息,在没有自定义列的情况下，返回的就是内建的列，其顺序如下：cb（复选框）、title（标题）、author（作者）、categories（分类目录）、tags（标签）、comments（评论）、date（日期）。如果要将自定义的列加到特定位置,就需要循环该数组，到特定位置时，再添加自定义的列，代码如下。如果需要删除某些列,在循环中删除该key=>value即可（代码中注释的部分，删除了评论列）,代码如下:

1. function add_rating_column($columns) { 
2.     $new = array(); 
3.     foreach($columns as $key => $title) { 
4.         if ($key == 'comments') { 
5.             $new['rating'] = '推荐指数'; 
6.         } 
7.         // if ($key == 'comments') { 
8.         //  continue; 
9.         // } 
10.         $new[$key] = $title; 
11.     } 
12.     return $new; 
13. }