当然在看这篇教程之前你要确保自己会怎么去使用自定义文章模型和模型分类了,如果你不知道的话可以参考下官网的自定义文章模型专栏文章模型和栏目分类
本教程分为两部分:1.会说说怎么样创建一个自定义模型文章栏目,2.然后对这些栏目进行排序,当然我们为了简单在这里就列举两项栏目进行排序:
第二大部分:创建一个自定义模型文章栏目
前提准备
此教程我将会举例使用自定义文章电影模型:
movie:我自定义的电影模型播放时间
: 这个电影模型的一个自定义字段(元数据键值),用于记录电影的播放时间我在此之前就增加了几篇电影,下面是截图.
看起来很是简单丑陋,不过wordpress有很强大的功能,我自定义了一些function之后就漂亮多了,下面看我优化后的截图
现在是不是看起来舒服多了,我们可以增加一些此文章模型的相关信息,还可以利用元数据来进行排序
第一步就是要在这里显示出自定义栏目,我们可以利用wordpress一个很灵活的钩子功能来达到目的,它的使用方法是增加一个名字为manage_edit-自定义模型名_columns的钩子来对所有的自定义模型列表进行控制,此教程我们使用的是电影模型,自定义的post_type是movie,所以我们只需要在function.php(后面的代码都是放这里)里面增加一个名字为
manage_edit-movie_columns
的钩子即可
在这里我们就把原来默认的栏目去掉,然后设置我们自己需要显示的栏目,在这里我就列举了5项:
cb
: 就是多选框栏(用于全选和反选)title
: 电影的名字,可以点击进去查看电影详情duration
: 电影模型的元数据,记录电影的播放时间genre
: 系定义分类,用来分类电影的date
: 默认的数据娴熟栏目要筛选这些栏目的数据其实也很简单,只需要返回一个数组键值或者值,当然键值就是栏目的名字,变量就是lable标签的显示数据.看代码
add_filter( 'manage_edit-movie_columns', 'my_edit_movie_columns' ) ;
function my_edit_movie_columns( $columns ) {
$columns = array(
'cb' => '',
'title' => __( 'Movie' ),
'duration' => __( 'Duration' ),
'genre' => __( 'Genre' ),
'date' => __( 'Date' )
);
return $columns;
}
到处,我们已经把表格头部的栏目显示部分做好了,现在就来给每个自定义栏目增加相应的显示内容,你可能有点担心duration
和genre
这两栏的数据,因为其他的栏目像titile,wordpress是可以自动为其分配数据的。
针对这个我们就要使用到wordpress的名为manage_模型名_posts_custom_column
的action钩子. 上面说了此教程的模型名为movie
, 所以把“
模型名
”替换掉就是manage_movie_posts_custom_column.
我们需要使用到的是php的switch语句来显示相应的数据(当然你用if判断语句也是可以的)
duration
栏,只需要把默认的duration显示出来,如果没有数据就显示成:未知
genre
栏, 除了需要显示相应的分类,还要加上点击进去显示相应分类电影的链接下面我就列出了自己的代码段,你可以根据自己项目需求来修改和完善.
add_action( 'manage_movie_posts_custom_column', 'my_manage_movie_columns', 10, 2 );
function my_manage_movie_columns( $column, $post_id ) {
global $post;
/*当然你可以用if语句*/
switch( $column ) {
/* 如果栏目是'duration' 的时候 */
case 'duration' :
/* 得到文章的元数据. */
$duration = get_post_meta( $post_id, 'duration', true );
/* 如果没有数据的时候给出默认显示数据为未知. */
if ( empty( $duration ) )
echo __( '未知' );
/* 如果存在数据的话我们把描述也加上*/
else
printf( __( '%s minutes' ), $duration );
break;
/* 如果栏目是 'genre'的时候*/
case 'genre' :
/* 得到文章的相应分类. */
$terms = get_the_terms( $post_id, 'genre' );
/* 如果有数据的时候,显示并加链接 */
if ( !empty( $terms ) ) {
$out = array();
/* 循环输出,并加链接*/
foreach ( $terms as $term ) {
$out[] = sprintf( '%s',
/*这个链接地址不是自定义的,你在edit.php里面可以看到Wp_Query($arg),在这里只给arg增加即可*/
esc_url( add_query_arg( array( 'post_type' => $post->post_type, 'genre' => $term->slug ), 'edit.php' ) ),
esc_html( sanitize_term_field( 'name', $term->name, $term->term_id, 'genre', 'display' ) )
);
}
/* join数据,并用逗号分开 */
echo join( ', ', $out );
}
/* 如果没有数据的时候给出默认显示数据为未知. */
else {
_e( '没有分类' );
}
break;
/* 跳出switch语句 */
default :
break;
}
}
上面介绍了怎么增加自定义显示栏,下面只需要两步即可对自定义栏排序了.
第二大部分:最后的结果显示如图所示.
要注意的是我们实际上是使用元数据来排序的,也就是使用名为duration的meta_key排排序的,所以实际上得按照duration来进行正叙或者倒叙排
第一步就是通过名为manage_edit-{$post_type}_sortable_columns
的filter来排序duration栏,下面给出代码
add_filter( 'manage_edit-movie_sortable_columns', 'my_movie_sortable_columns' );
function my_movie_sortable_columns( $columns ) {
$columns['duration'] = 'duration';
return $columns;
}
request钩子
.
load-edit.php
的
request
钩子,来增加自定义钩子,我们需要检查下请求的参数里面是否需要我们自己来额外修改或增加的参数
/* 只要当管理员在'edit.php'的时候,才处理 */
add_action( 'load-edit.php', 'my_edit_movie_load' );
function my_edit_movie_load() {
add_filter( 'request', 'my_sort_movies' );
}
/*对电影排序 */
function my_sort_movies( $vars ) {
/* 判断是否浏览的是movie*/
if ( isset( $vars['post_type'] ) && 'movie' == $vars['post_type'] ) {
/* 看下是否已经对duration进行排序了*/
if ( isset( $vars['orderby'] ) && 'duration' == $vars['orderby'] ) {
/* 把自定义排序增加到$vars里面去 */
$vars = array_merge(
$vars,
array(
'meta_key' => 'duration',
'orderby' => 'meta_value_num'
)
);
}
}
return $vars;
}
用的参数是meta_key 和orderby. 让wordpress来根据durationd的键值和order正序或倒叙来显示
上面我使用的是meta_value_num(这个是Wp_Query的参数,不要解释吧)来排序的,因为duration是数字,如果你用的是 meta_value的话就会按照meta_value来排序的,meta_value_num是强制转化成数字类型之后来排序的
希望这篇教程对你有所帮助,当然你也不要觉得这个自定义排序很复杂,不复杂就不是程序了,呵呵,你也可以先尝试去掌握上面的列子,然后举一反三,不过这个排序也不一定是万能的,比如我在使用的时候想对序列化的数据进行排序就不行了,大家有什么好的方法可以提出来分享下!
好了,到此就结束了,里面有不当之处请指出,我会修改的!
译文原地址: Custom columns for custom post types