今天要實(shí)現(xiàn)的效果如下圖,具體的功能就是在列表里添加一列“推薦指數(shù)”,用來(lái)顯示每篇文章的推薦指數(shù),同時(shí)可以根據(jù)“推薦指數(shù)”來(lái)進(jìn)行文章排序。
首先要做的就是在表頭添加“推薦指數(shù)”列。
- function add_rating_column($columns) {
- $columns['rating'] = '推薦指數(shù)';
- return $columns;
- }
- add_filter('manage_posts_columns' , 'add_rating_column');
manage_posts_columns Filter可以應(yīng)用管理文章頁(yè)面的表頭里,用來(lái)修改表頭信息。注意該Filter不會(huì)應(yīng)用到Page的列表頁(yè)面,如需用到,請(qǐng)使用manage_pages_columns 或者 manage_${post_type}_posts_columns
有了表頭,只是添加了這一列,但是該列還沒有內(nèi)容,我們來(lái)為該列填充數(shù)據(jù)。
- 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可以用來(lái)添加或修改列表的列,包括內(nèi)建的以及自定義的列表列。該Action 接受兩個(gè)參數(shù),第一個(gè)是列表列的名字($column_name,即第一步中的’rating’,而非’推薦指數(shù)’),第二個(gè)是當(dāng)前的文章ID($post_id)。根據(jù)這兩個(gè)參數(shù),我們就可以根據(jù)當(dāng)前列的名字來(lái)獲取文章的相關(guān)信息了。
這里通過(guò)判斷當(dāng)前列表列是不是’rating’,是則根據(jù)文章ID獲取到推薦指數(shù)的值,并格式化輸出。
接下來(lái)讓他能夠進(jìn)行排序。通過(guò) manage_edit-post_sortable_columns Filter來(lái)指定哪些列可以用來(lái)排序。
- function rating_column_table_sorting( $columns ) {
- $columns['rating'] = 'rating';
- return $columns;
- }
- add_filter( 'manage_edit-post_sortable_columns', 'rating_column_table_sorting' );
接下來(lái)就告訴WordPress如何根據(jù)’rating’排序。
- 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' );
至此,自定義文章列表列的功能已經(jīng)實(shí)現(xiàn)。這里只是一個(gè)示例,稍作修改,便可以將“推薦指數(shù)”換成你文章中的任何數(shù)據(jù),從而實(shí)現(xiàn)不同站點(diǎn)的不同需求。
另外,你是不是又注意到自己根據(jù)教程實(shí)現(xiàn)的效果有點(diǎn)不一樣?你的“推薦指數(shù)”在最后一列?
告訴你一個(gè)小技巧,在第一段代碼中,傳給Filter的參數(shù)$columns,是一個(gè)列的數(shù)組,包含了所有的列的信息,在沒有自定義列的情況下,返回的就是內(nèi)建的列,其順序如下:cb(復(fù)選框)、title(標(biāo)題)、author(作者)、categories(分類目錄)、tags(標(biāo)簽)、comments(評(píng)論)、date(日期)。如果要將自定義的列加到特定位置,就需要循環(huán)該數(shù)組,到特定位置時(shí),再添加自定義的列,代碼如下。如果需要?jiǎng)h除某些列,在循環(huán)中刪除該key=>value即可(代碼中注釋的部分,刪除了評(píng)論列)。
- function add_rating_column($columns) {
- $new = array();
- foreach($columns as $key => $title) {
- if ($key == 'comments') {
- $new['rating'] = '推薦指數(shù)';
- }
- // if ($key == 'comments') {
- // continue;
- // }
- $new[$key] = $title;
- }
- return $new;
- }