好得很程序员自学网

<tfoot draggable='sEl'></tfoot>

WordPress 自定义文章列表列的实现方法

上一篇,我们使用 Meta Box 为文章添加了一个[推荐指数]字段。添加后用了一段时间,似乎不那么方便,编辑文章虽然方便了,但是在文章列表里却不能直观的显示出文章推荐指数,而且不能根据推荐指数来排序文章,鉴于这些不足,今天就来完善一下,让他更方便好用。 

今天要实现的效果如下图,具体的功能就是在列表里添加一列[推荐指数],用来显示每篇文章的推荐指数,同时可以根据[推荐指数]来进行文章排序。 





首先要做的就是在表头添加[推荐指数]列。 

PHP Code 复制内容到剪贴板

function  add_rating_column( $columns ) {         $columns [ 'rating' ] =  '推荐指数' ;         return   $columns ;    }    add_filter( 'manage_posts_columns'  ,  'add_rating_column' );   


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

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

PHP Code 复制内容到剪贴板

function  rating_column_content( $column_name ,  $post_id ) {         if  ( $column_name  ==  'rating' ) {             $rating_value  = get_post_meta(  $post_id ,  '_rating' , true );             echo  ( $rating_value  / 2) .  '星' ;        }    }    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来指定哪些列可以用来排序。

PHP Code 复制内容到剪贴板

function  rating_column_table_sorting(  $columns  ) {         $columns [ 'rating' ] =  'rating' ;         return   $columns ;    }    add_filter(  'manage_edit-post_sortable_columns' ,  'rating_column_table_sorting'  );  

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

接下来就告诉WordPress如何根据’rating’排序。 

PHP Code 复制内容到剪贴板

function  rating_column_orderby(  $vars  ) {         if  ( isset(  $vars [ 'orderby' ] ) &&  $vars [ 'orderby' ] ==  'rating'  ) {             $vars [ 'orderby' ] =  'meta_value_num' ;             $vars [ 'meta_key' ] =  '_rating' ;        }         return   $vars ;    }    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即可(代码中注释的部分,删除了评论列)。 

PHP Code 复制内容到剪贴板

function  add_rating_column( $columns ) {         $new  =  array ();         foreach ( $columns   as   $key  =>  $title ) {             if  ( $key  ==  'comments' ) {                 $new [ 'rating' ] =  '推荐指数' ;            }             // if ($key == 'comments') {              //  continue;              // }              $new [ $key ] =  $title ;        }         return   $new ;    }  

 

 

查看更多关于WordPress 自定义文章列表列的实现方法的详细内容...

  阅读:55次