3 * List Table API: WP_Posts_List_Table class
6 * @subpackage Administration
11 * Core class used to implement displaying posts in a list table.
18 class WP_Posts_List_Table extends WP_List_Table {
21 * Whether the items should be displayed hierarchically or linearly.
27 protected $hierarchical_display;
30 * Holds the number of pending comments for each post.
36 protected $comment_pending_count;
39 * Holds the number of posts for this user.
45 private $user_posts_count;
48 * Holds the number of posts which are sticky.
54 private $sticky_posts_count = 0;
59 * Current level for output.
65 protected $current_level = 0;
73 * @see WP_List_Table::__construct() for more information on default arguments.
75 * @global WP_Post_Type $post_type_object
78 * @param array $args An associative array of arguments.
80 public function __construct( $args = array() ) {
81 global $post_type_object, $wpdb;
83 parent::__construct( array(
85 'screen' => isset( $args['screen'] ) ? $args['screen'] : null,
88 $post_type = $this->screen->post_type;
89 $post_type_object = get_post_type_object( $post_type );
91 $exclude_states = get_post_stati( array(
92 'show_in_admin_all_list' => false,
94 $this->user_posts_count = intval( $wpdb->get_var( $wpdb->prepare( "
98 AND post_status NOT IN ( '" . implode( "','", $exclude_states ) . "' )
100 ", $post_type, get_current_user_id() ) ) );
102 if ( $this->user_posts_count && ! current_user_can( $post_type_object->cap->edit_others_posts ) && empty( $_REQUEST['post_status'] ) && empty( $_REQUEST['all_posts'] ) && empty( $_REQUEST['author'] ) && empty( $_REQUEST['show_sticky'] ) ) {
103 $_GET['author'] = get_current_user_id();
106 if ( 'post' === $post_type && $sticky_posts = get_option( 'sticky_posts' ) ) {
107 $sticky_posts = implode( ', ', array_map( 'absint', (array) $sticky_posts ) );
108 $this->sticky_posts_count = $wpdb->get_var( $wpdb->prepare( "SELECT COUNT( 1 ) FROM $wpdb->posts WHERE post_type = %s AND post_status NOT IN ('trash', 'auto-draft') AND ID IN ($sticky_posts)", $post_type ) );
113 * Sets whether the table layout should be hierarchical or not.
117 * @param bool $display Whether the table layout should be hierarchical.
119 public function set_hierarchical_display( $display ) {
120 $this->hierarchical_display = $display;
127 public function ajax_user_can() {
128 return current_user_can( get_post_type_object( $this->screen->post_type )->cap->edit_posts );
133 * @global array $avail_post_stati
134 * @global WP_Query $wp_query
135 * @global int $per_page
136 * @global string $mode
138 public function prepare_items() {
139 global $avail_post_stati, $wp_query, $per_page, $mode;
141 // is going to call wp()
142 $avail_post_stati = wp_edit_posts_query();
144 $this->set_hierarchical_display( is_post_type_hierarchical( $this->screen->post_type ) && 'menu_order title' === $wp_query->query['orderby'] );
146 $post_type = $this->screen->post_type;
147 $per_page = $this->get_items_per_page( 'edit_' . $post_type . '_per_page' );
149 /** This filter is documented in wp-admin/includes/post.php */
150 $per_page = apply_filters( 'edit_posts_per_page', $per_page, $post_type );
152 if ( $this->hierarchical_display ) {
153 $total_items = $wp_query->post_count;
154 } elseif ( $wp_query->found_posts || $this->get_pagenum() === 1 ) {
155 $total_items = $wp_query->found_posts;
157 $post_counts = (array) wp_count_posts( $post_type, 'readable' );
159 if ( isset( $_REQUEST['post_status'] ) && in_array( $_REQUEST['post_status'] , $avail_post_stati ) ) {
160 $total_items = $post_counts[ $_REQUEST['post_status'] ];
161 } elseif ( isset( $_REQUEST['show_sticky'] ) && $_REQUEST['show_sticky'] ) {
162 $total_items = $this->sticky_posts_count;
163 } elseif ( isset( $_GET['author'] ) && $_GET['author'] == get_current_user_id() ) {
164 $total_items = $this->user_posts_count;
166 $total_items = array_sum( $post_counts );
168 // Subtract post types that are not included in the admin all list.
169 foreach ( get_post_stati( array( 'show_in_admin_all_list' => false ) ) as $state ) {
170 $total_items -= $post_counts[ $state ];
175 if ( ! empty( $_REQUEST['mode'] ) ) {
176 $mode = $_REQUEST['mode'] === 'excerpt' ? 'excerpt' : 'list';
177 set_user_setting( 'posts_list_mode', $mode );
179 $mode = get_user_setting( 'posts_list_mode', 'list' );
182 $this->is_trash = isset( $_REQUEST['post_status'] ) && $_REQUEST['post_status'] === 'trash';
184 $this->set_pagination_args( array(
185 'total_items' => $total_items,
186 'per_page' => $per_page
194 public function has_items() {
201 public function no_items() {
202 if ( isset( $_REQUEST['post_status'] ) && 'trash' === $_REQUEST['post_status'] )
203 echo get_post_type_object( $this->screen->post_type )->labels->not_found_in_trash;
205 echo get_post_type_object( $this->screen->post_type )->labels->not_found;
209 * Determine if the current view is the "All" view.
213 * @return bool Whether the current view is the "All" view.
215 protected function is_base_request() {
217 unset( $vars['paged'] );
219 if ( empty( $vars ) ) {
221 } elseif ( 1 === count( $vars ) && ! empty( $vars['post_type'] ) ) {
222 return $this->screen->post_type === $vars['post_type'];
225 return 1 === count( $vars ) && ! empty( $vars['mode'] );
229 * Helper to create links to edit.php with params.
234 * @param array $args URL parameters for the link.
235 * @param string $label Link text.
236 * @param string $class Optional. Class attribute. Default empty string.
237 * @return string The formatted link string.
239 protected function get_edit_link( $args, $label, $class = '' ) {
240 $url = add_query_arg( $args, 'edit.php' );
243 if ( ! empty( $class ) ) {
244 $class_html = sprintf(
251 '<a href="%s"%s>%s</a>',
260 * @global array $locked_post_status This seems to be deprecated.
261 * @global array $avail_post_stati
264 protected function get_views() {
265 global $locked_post_status, $avail_post_stati;
267 $post_type = $this->screen->post_type;
269 if ( !empty($locked_post_status) )
272 $status_links = array();
273 $num_posts = wp_count_posts( $post_type, 'readable' );
274 $total_posts = array_sum( (array) $num_posts );
277 $current_user_id = get_current_user_id();
278 $all_args = array( 'post_type' => $post_type );
281 // Subtract post types that are not included in the admin all list.
282 foreach ( get_post_stati( array( 'show_in_admin_all_list' => false ) ) as $state ) {
283 $total_posts -= $num_posts->$state;
286 if ( $this->user_posts_count && $this->user_posts_count !== $total_posts ) {
287 if ( isset( $_GET['author'] ) && ( $_GET['author'] == $current_user_id ) ) {
292 'post_type' => $post_type,
293 'author' => $current_user_id
296 $mine_inner_html = sprintf(
298 'Mine <span class="count">(%s)</span>',
299 'Mine <span class="count">(%s)</span>',
300 $this->user_posts_count,
303 number_format_i18n( $this->user_posts_count )
306 $mine = $this->get_edit_link( $mine_args, $mine_inner_html, $class );
308 $all_args['all_posts'] = 1;
312 if ( empty( $class ) && ( $this->is_base_request() || isset( $_REQUEST['all_posts'] ) ) ) {
316 $all_inner_html = sprintf(
318 'All <span class="count">(%s)</span>',
319 'All <span class="count">(%s)</span>',
323 number_format_i18n( $total_posts )
326 $status_links['all'] = $this->get_edit_link( $all_args, $all_inner_html, $class );
328 $status_links['mine'] = $mine;
331 foreach ( get_post_stati(array('show_in_admin_status_list' => true), 'objects') as $status ) {
334 $status_name = $status->name;
336 if ( ! in_array( $status_name, $avail_post_stati ) || empty( $num_posts->$status_name ) ) {
340 if ( isset($_REQUEST['post_status']) && $status_name === $_REQUEST['post_status'] ) {
344 $status_args = array(
345 'post_status' => $status_name,
346 'post_type' => $post_type,
349 $status_label = sprintf(
350 translate_nooped_plural( $status->label_count, $num_posts->$status_name ),
351 number_format_i18n( $num_posts->$status_name )
354 $status_links[ $status_name ] = $this->get_edit_link( $status_args, $status_label, $class );
357 if ( ! empty( $this->sticky_posts_count ) ) {
358 $class = ! empty( $_REQUEST['show_sticky'] ) ? 'current' : '';
360 $sticky_args = array(
361 'post_type' => $post_type,
365 $sticky_inner_html = sprintf(
367 'Sticky <span class="count">(%s)</span>',
368 'Sticky <span class="count">(%s)</span>',
369 $this->sticky_posts_count,
372 number_format_i18n( $this->sticky_posts_count )
375 $sticky_link = array(
376 'sticky' => $this->get_edit_link( $sticky_args, $sticky_inner_html, $class )
379 // Sticky comes after Publish, or if not listed, after All.
380 $split = 1 + array_search( ( isset( $status_links['publish'] ) ? 'publish' : 'all' ), array_keys( $status_links ) );
381 $status_links = array_merge( array_slice( $status_links, 0, $split ), $sticky_link, array_slice( $status_links, $split ) );
384 return $status_links;
391 protected function get_bulk_actions() {
393 $post_type_obj = get_post_type_object( $this->screen->post_type );
395 if ( current_user_can( $post_type_obj->cap->edit_posts ) ) {
396 if ( $this->is_trash ) {
397 $actions['untrash'] = __( 'Restore' );
399 $actions['edit'] = __( 'Edit' );
403 if ( current_user_can( $post_type_obj->cap->delete_posts ) ) {
404 if ( $this->is_trash || ! EMPTY_TRASH_DAYS ) {
405 $actions['delete'] = __( 'Delete Permanently' );
407 $actions['trash'] = __( 'Move to Trash' );
415 * Displays a categories drop-down for filtering on the Posts list table.
420 * @global int $cat Currently selected category.
422 * @param string $post_type Post type slug.
424 protected function categories_dropdown( $post_type ) {
428 * Filters whether to remove the 'Categories' drop-down from the post list table.
432 * @param bool $disable Whether to disable the categories drop-down. Default false.
433 * @param string $post_type Post type slug.
435 if ( false !== apply_filters( 'disable_categories_dropdown', false, $post_type ) ) {
439 if ( is_object_in_taxonomy( $post_type, 'category' ) ) {
440 $dropdown_options = array(
441 'show_option_all' => get_taxonomy( 'category' )->labels->all_items,
449 echo '<label class="screen-reader-text" for="cat">' . __( 'Filter by category' ) . '</label>';
450 wp_dropdown_categories( $dropdown_options );
455 * @param string $which
457 protected function extra_tablenav( $which ) {
459 <div class="alignleft actions">
461 if ( 'top' === $which && !is_singular() ) {
463 $this->months_dropdown( $this->screen->post_type );
464 $this->categories_dropdown( $this->screen->post_type );
467 * Fires before the Filter button on the Posts and Pages list tables.
469 * The Filter button allows sorting by date and/or category on the
470 * Posts list table, and sorting by date on the Pages list table.
473 * @since 4.4.0 The `$post_type` parameter was added.
474 * @since 4.6.0 The `$which` parameter was added.
476 * @param string $post_type The post type slug.
477 * @param string $which The location of the extra table nav markup:
480 do_action( 'restrict_manage_posts', $this->screen->post_type, $which );
482 submit_button( __( 'Filter' ), 'button', 'filter_action', false, array( 'id' => 'post-query-submit' ) );
485 if ( $this->is_trash && current_user_can( get_post_type_object( $this->screen->post_type )->cap->edit_others_posts ) ) {
486 submit_button( __( 'Empty Trash' ), 'apply', 'delete_all', false );
492 * Fires immediately following the closing "actions" div in the tablenav for the posts
497 * @param string $which The location of the extra table nav markup: 'top' or 'bottom'.
499 do_action( 'manage_posts_extra_tablenav', $which );
506 public function current_action() {
507 if ( isset( $_REQUEST['delete_all'] ) || isset( $_REQUEST['delete_all2'] ) )
510 return parent::current_action();
517 protected function get_table_classes() {
518 return array( 'widefat', 'fixed', 'striped', is_post_type_hierarchical( $this->screen->post_type ) ? 'pages' : 'posts' );
525 public function get_columns() {
526 $post_type = $this->screen->post_type;
528 $posts_columns = array();
530 $posts_columns['cb'] = '<input type="checkbox" />';
532 /* translators: manage posts column name */
533 $posts_columns['title'] = _x( 'Title', 'column name' );
535 if ( post_type_supports( $post_type, 'author' ) ) {
536 $posts_columns['author'] = __( 'Author' );
539 $taxonomies = get_object_taxonomies( $post_type, 'objects' );
540 $taxonomies = wp_filter_object_list( $taxonomies, array( 'show_admin_column' => true ), 'and', 'name' );
543 * Filters the taxonomy columns in the Posts list table.
545 * The dynamic portion of the hook name, `$post_type`, refers to the post
550 * @param array $taxonomies Array of taxonomies to show columns for.
551 * @param string $post_type The post type.
553 $taxonomies = apply_filters( "manage_taxonomies_for_{$post_type}_columns", $taxonomies, $post_type );
554 $taxonomies = array_filter( $taxonomies, 'taxonomy_exists' );
556 foreach ( $taxonomies as $taxonomy ) {
557 if ( 'category' === $taxonomy )
558 $column_key = 'categories';
559 elseif ( 'post_tag' === $taxonomy )
560 $column_key = 'tags';
562 $column_key = 'taxonomy-' . $taxonomy;
564 $posts_columns[ $column_key ] = get_taxonomy( $taxonomy )->labels->name;
567 $post_status = !empty( $_REQUEST['post_status'] ) ? $_REQUEST['post_status'] : 'all';
568 if ( post_type_supports( $post_type, 'comments' ) && !in_array( $post_status, array( 'pending', 'draft', 'future' ) ) )
569 $posts_columns['comments'] = '<span class="vers comment-grey-bubble" title="' . esc_attr__( 'Comments' ) . '"><span class="screen-reader-text">' . __( 'Comments' ) . '</span></span>';
571 $posts_columns['date'] = __( 'Date' );
573 if ( 'page' === $post_type ) {
576 * Filters the columns displayed in the Pages list table.
580 * @param array $post_columns An array of column names.
582 $posts_columns = apply_filters( 'manage_pages_columns', $posts_columns );
586 * Filters the columns displayed in the Posts list table.
590 * @param array $posts_columns An array of column names.
591 * @param string $post_type The post type slug.
593 $posts_columns = apply_filters( 'manage_posts_columns', $posts_columns, $post_type );
597 * Filters the columns displayed in the Posts list table for a specific post type.
599 * The dynamic portion of the hook name, `$post_type`, refers to the post type slug.
603 * @param array $post_columns An array of column names.
605 return apply_filters( "manage_{$post_type}_posts_columns", $posts_columns );
612 protected function get_sortable_columns() {
615 'parent' => 'parent',
616 'comments' => 'comment_count',
617 'date' => array( 'date', true )
622 * @global WP_Query $wp_query
623 * @global int $per_page
624 * @param array $posts
627 public function display_rows( $posts = array(), $level = 0 ) {
628 global $wp_query, $per_page;
630 if ( empty( $posts ) )
631 $posts = $wp_query->posts;
633 add_filter( 'the_title', 'esc_html' );
635 if ( $this->hierarchical_display ) {
636 $this->_display_rows_hierarchical( $posts, $this->get_pagenum(), $per_page );
638 $this->_display_rows( $posts, $level );
643 * @param array $posts
646 private function _display_rows( $posts, $level = 0 ) {
647 // Create array of post IDs.
650 foreach ( $posts as $a_post )
651 $post_ids[] = $a_post->ID;
653 $this->comment_pending_count = get_pending_comments_num( $post_ids );
655 foreach ( $posts as $post )
656 $this->single_row( $post, $level );
661 * @global WP_Post $post
662 * @param array $pages
663 * @param int $pagenum
664 * @param int $per_page
666 private function _display_rows_hierarchical( $pages, $pagenum = 1, $per_page = 20 ) {
672 $pages = get_pages( array( 'sort_column' => 'menu_order' ) );
679 * Arrange pages into two parts: top level pages and children_pages
680 * children_pages is two dimensional array, eg.
681 * children_pages[10][] contains all sub-pages whose parent is 10.
682 * It only takes O( N ) to arrange this and it takes O( 1 ) for subsequent lookup operations
683 * If searching, ignore hierarchy and treat everything as top level
685 if ( empty( $_REQUEST['s'] ) ) {
687 $top_level_pages = array();
688 $children_pages = array();
690 foreach ( $pages as $page ) {
692 // Catch and repair bad pages.
693 if ( $page->post_parent == $page->ID ) {
694 $page->post_parent = 0;
695 $wpdb->update( $wpdb->posts, array( 'post_parent' => 0 ), array( 'ID' => $page->ID ) );
696 clean_post_cache( $page );
699 if ( 0 == $page->post_parent )
700 $top_level_pages[] = $page;
702 $children_pages[ $page->post_parent ][] = $page;
705 $pages = &$top_level_pages;
709 $start = ( $pagenum - 1 ) * $per_page;
710 $end = $start + $per_page;
711 $to_display = array();
713 foreach ( $pages as $page ) {
714 if ( $count >= $end )
717 if ( $count >= $start ) {
718 $to_display[$page->ID] = $level;
723 if ( isset( $children_pages ) )
724 $this->_page_rows( $children_pages, $count, $page->ID, $level + 1, $pagenum, $per_page, $to_display );
727 // If it is the last pagenum and there are orphaned pages, display them with paging as well.
728 if ( isset( $children_pages ) && $count < $end ){
729 foreach ( $children_pages as $orphans ){
730 foreach ( $orphans as $op ) {
731 if ( $count >= $end )
734 if ( $count >= $start ) {
735 $to_display[$op->ID] = 0;
743 $ids = array_keys( $to_display );
744 _prime_post_caches( $ids );
746 if ( ! isset( $GLOBALS['post'] ) ) {
747 $GLOBALS['post'] = reset( $ids );
750 foreach ( $to_display as $page_id => $level ) {
752 $this->single_row( $page_id, $level );
757 * Given a top level page ID, display the nested hierarchy of sub-pages
758 * together with paging support
760 * @since 3.1.0 (Standalone function exists since 2.6.0)
761 * @since 4.2.0 Added the `$to_display` parameter.
763 * @param array $children_pages
767 * @param int $pagenum
768 * @param int $per_page
769 * @param array $to_display List of pages to be displayed. Passed by reference.
771 private function _page_rows( &$children_pages, &$count, $parent, $level, $pagenum, $per_page, &$to_display ) {
772 if ( ! isset( $children_pages[$parent] ) )
775 $start = ( $pagenum - 1 ) * $per_page;
776 $end = $start + $per_page;
778 foreach ( $children_pages[$parent] as $page ) {
779 if ( $count >= $end )
782 // If the page starts in a subtree, print the parents.
783 if ( $count == $start && $page->post_parent > 0 ) {
784 $my_parents = array();
785 $my_parent = $page->post_parent;
786 while ( $my_parent ) {
787 // Get the ID from the list or the attribute if my_parent is an object
788 $parent_id = $my_parent;
789 if ( is_object( $my_parent ) ) {
790 $parent_id = $my_parent->ID;
793 $my_parent = get_post( $parent_id );
794 $my_parents[] = $my_parent;
795 if ( !$my_parent->post_parent )
797 $my_parent = $my_parent->post_parent;
799 $num_parents = count( $my_parents );
800 while ( $my_parent = array_pop( $my_parents ) ) {
801 $to_display[$my_parent->ID] = $level - $num_parents;
806 if ( $count >= $start ) {
807 $to_display[$page->ID] = $level;
812 $this->_page_rows( $children_pages, $count, $page->ID, $level + 1, $pagenum, $per_page, $to_display );
815 unset( $children_pages[$parent] ); //required in order to keep track of orphans
819 * Handles the checkbox column output.
824 * @param WP_Post $post The current WP_Post object.
826 public function column_cb( $post ) {
827 if ( current_user_can( 'edit_post', $post->ID ) ): ?>
828 <label class="screen-reader-text" for="cb-select-<?php the_ID(); ?>"><?php
829 printf( __( 'Select %s' ), _draft_or_post_title() );
831 <input id="cb-select-<?php the_ID(); ?>" type="checkbox" name="post[]" value="<?php the_ID(); ?>" />
832 <div class="locked-indicator"></div>
840 * @param WP_Post $post
841 * @param string $classes
842 * @param string $data
843 * @param string $primary
845 protected function _column_title( $post, $classes, $data, $primary ) {
846 echo '<td class="' . $classes . ' page-title" ', $data, '>';
847 echo $this->column_title( $post );
848 echo $this->handle_row_actions( $post, 'title', $primary );
853 * Handles the title column output.
858 * @global string $mode
860 * @param WP_Post $post The current WP_Post object.
862 public function column_title( $post ) {
865 if ( $this->hierarchical_display ) {
866 if ( 0 === $this->current_level && (int) $post->post_parent > 0 ) {
867 // Sent level 0 by accident, by default, or because we don't know the actual level.
868 $find_main_page = (int) $post->post_parent;
869 while ( $find_main_page > 0 ) {
870 $parent = get_post( $find_main_page );
872 if ( is_null( $parent ) ) {
876 $this->current_level++;
877 $find_main_page = (int) $parent->post_parent;
879 if ( ! isset( $parent_name ) ) {
880 /** This filter is documented in wp-includes/post-template.php */
881 $parent_name = apply_filters( 'the_title', $parent->post_title, $parent->ID );
887 $pad = str_repeat( '— ', $this->current_level );
890 $format = get_post_format( $post->ID );
892 $label = get_post_format_string( $format );
894 $format_class = 'post-state-format post-format-icon post-format-' . $format;
896 $format_args = array(
897 'post_format' => $format,
898 'post_type' => $post->post_type
901 echo $this->get_edit_link( $format_args, $label . ':', $format_class );
904 $can_edit_post = current_user_can( 'edit_post', $post->ID );
905 $title = _draft_or_post_title();
907 if ( $can_edit_post && $post->post_status != 'trash' ) {
909 '<a class="row-title" href="%s" aria-label="%s">%s%s</a>',
910 get_edit_post_link( $post->ID ),
911 /* translators: %s: post title */
912 esc_attr( sprintf( __( '“%s” (Edit)' ), $title ) ),
919 _post_states( $post );
921 if ( isset( $parent_name ) ) {
922 $post_type_object = get_post_type_object( $post->post_type );
923 echo ' | ' . $post_type_object->labels->parent_item_colon . ' ' . esc_html( $parent_name );
927 if ( $can_edit_post && $post->post_status != 'trash' ) {
928 $lock_holder = wp_check_post_lock( $post->ID );
930 if ( $lock_holder ) {
931 $lock_holder = get_userdata( $lock_holder );
932 $locked_avatar = get_avatar( $lock_holder->ID, 18 );
933 $locked_text = esc_html( sprintf( __( '%s is currently editing' ), $lock_holder->display_name ) );
935 $locked_avatar = $locked_text = '';
938 echo '<div class="locked-info"><span class="locked-avatar">' . $locked_avatar . '</span> <span class="locked-text">' . $locked_text . "</span></div>\n";
941 if ( ! is_post_type_hierarchical( $this->screen->post_type ) && 'excerpt' === $mode && current_user_can( 'read_post', $post->ID ) ) {
945 get_inline_data( $post );
949 * Handles the post date column output.
954 * @global string $mode
956 * @param WP_Post $post The current WP_Post object.
958 public function column_date( $post ) {
961 if ( '0000-00-00 00:00:00' === $post->post_date ) {
962 $t_time = $h_time = __( 'Unpublished' );
965 $t_time = get_the_time( __( 'Y/m/d g:i:s a' ) );
966 $m_time = $post->post_date;
967 $time = get_post_time( 'G', true, $post );
969 $time_diff = time() - $time;
971 if ( $time_diff > 0 && $time_diff < DAY_IN_SECONDS ) {
972 $h_time = sprintf( __( '%s ago' ), human_time_diff( $time ) );
974 $h_time = mysql2date( __( 'Y/m/d' ), $m_time );
978 if ( 'publish' === $post->post_status ) {
980 } elseif ( 'future' === $post->post_status ) {
981 if ( $time_diff > 0 ) {
982 echo '<strong class="error-message">' . __( 'Missed schedule' ) . '</strong>';
987 _e( 'Last Modified' );
990 if ( 'excerpt' === $mode ) {
992 * Filters the published time of the post.
994 * If `$mode` equals 'excerpt', the published time and date are both displayed.
995 * If `$mode` equals 'list' (default), the publish date is displayed, with the
996 * time and date together available as an abbreviation definition.
1000 * @param string $t_time The published time.
1001 * @param WP_Post $post Post object.
1002 * @param string $column_name The column name.
1003 * @param string $mode The list display mode ('excerpt' or 'list').
1005 echo apply_filters( 'post_date_column_time', $t_time, $post, 'date', $mode );
1008 /** This filter is documented in wp-admin/includes/class-wp-posts-list-table.php */
1009 echo '<abbr title="' . $t_time . '">' . apply_filters( 'post_date_column_time', $h_time, $post, 'date', $mode ) . '</abbr>';
1014 * Handles the comments column output.
1019 * @param WP_Post $post The current WP_Post object.
1021 public function column_comments( $post ) {
1023 <div class="post-com-count-wrapper">
1025 $pending_comments = isset( $this->comment_pending_count[$post->ID] ) ? $this->comment_pending_count[$post->ID] : 0;
1027 $this->comments_bubble( $post->ID, $pending_comments );
1034 * Handles the post author column output.
1039 * @param WP_Post $post The current WP_Post object.
1041 public function column_author( $post ) {
1043 'post_type' => $post->post_type,
1044 'author' => get_the_author_meta( 'ID' )
1046 echo $this->get_edit_link( $args, get_the_author() );
1050 * Handles the default column output.
1055 * @param WP_Post $post The current WP_Post object.
1056 * @param string $column_name The current column name.
1058 public function column_default( $post, $column_name ) {
1059 if ( 'categories' === $column_name ) {
1060 $taxonomy = 'category';
1061 } elseif ( 'tags' === $column_name ) {
1062 $taxonomy = 'post_tag';
1063 } elseif ( 0 === strpos( $column_name, 'taxonomy-' ) ) {
1064 $taxonomy = substr( $column_name, 9 );
1069 $taxonomy_object = get_taxonomy( $taxonomy );
1070 $terms = get_the_terms( $post->ID, $taxonomy );
1071 if ( is_array( $terms ) ) {
1073 foreach ( $terms as $t ) {
1074 $posts_in_term_qv = array();
1075 if ( 'post' != $post->post_type ) {
1076 $posts_in_term_qv['post_type'] = $post->post_type;
1078 if ( $taxonomy_object->query_var ) {
1079 $posts_in_term_qv[ $taxonomy_object->query_var ] = $t->slug;
1081 $posts_in_term_qv['taxonomy'] = $taxonomy;
1082 $posts_in_term_qv['term'] = $t->slug;
1085 $label = esc_html( sanitize_term_field( 'name', $t->name, $t->term_id, $taxonomy, 'display' ) );
1086 $out[] = $this->get_edit_link( $posts_in_term_qv, $label );
1088 /* translators: used between list items, there is a space after the comma */
1089 echo join( __( ', ' ), $out );
1091 echo '<span aria-hidden="true">—</span><span class="screen-reader-text">' . $taxonomy_object->labels->no_terms . '</span>';
1096 if ( is_post_type_hierarchical( $post->post_type ) ) {
1099 * Fires in each custom column on the Posts list table.
1101 * This hook only fires if the current post type is hierarchical,
1106 * @param string $column_name The name of the column to display.
1107 * @param int $post_id The current post ID.
1109 do_action( 'manage_pages_custom_column', $column_name, $post->ID );
1113 * Fires in each custom column in the Posts list table.
1115 * This hook only fires if the current post type is non-hierarchical,
1120 * @param string $column_name The name of the column to display.
1121 * @param int $post_id The current post ID.
1123 do_action( 'manage_posts_custom_column', $column_name, $post->ID );
1127 * Fires for each custom column of a specific post type in the Posts list table.
1129 * The dynamic portion of the hook name, `$post->post_type`, refers to the post type.
1133 * @param string $column_name The name of the column to display.
1134 * @param int $post_id The current post ID.
1136 do_action( "manage_{$post->post_type}_posts_custom_column", $column_name, $post->ID );
1140 * @global WP_Post $post
1142 * @param int|WP_Post $post
1145 public function single_row( $post, $level = 0 ) {
1146 $global_post = get_post();
1148 $post = get_post( $post );
1149 $this->current_level = $level;
1151 $GLOBALS['post'] = $post;
1152 setup_postdata( $post );
1154 $classes = 'iedit author-' . ( get_current_user_id() == $post->post_author ? 'self' : 'other' );
1156 $lock_holder = wp_check_post_lock( $post->ID );
1157 if ( $lock_holder ) {
1158 $classes .= ' wp-locked';
1161 if ( $post->post_parent ) {
1162 $count = count( get_post_ancestors( $post->ID ) );
1163 $classes .= ' level-'. $count;
1165 $classes .= ' level-0';
1168 <tr id="post-<?php echo $post->ID; ?>" class="<?php echo implode( ' ', get_post_class( $classes, $post->ID ) ); ?>">
1169 <?php $this->single_row_columns( $post ); ?>
1172 $GLOBALS['post'] = $global_post;
1176 * Gets the name of the default primary column.
1181 * @return string Name of the default primary column, in this case, 'title'.
1183 protected function get_default_primary_column_name() {
1188 * Generates and displays row action links.
1193 * @param object $post Post being acted upon.
1194 * @param string $column_name Current column name.
1195 * @param string $primary Primary column name.
1196 * @return string Row actions output for posts.
1198 protected function handle_row_actions( $post, $column_name, $primary ) {
1199 if ( $primary !== $column_name ) {
1203 $post_type_object = get_post_type_object( $post->post_type );
1204 $can_edit_post = current_user_can( 'edit_post', $post->ID );
1206 $title = _draft_or_post_title();
1208 if ( $can_edit_post && 'trash' != $post->post_status ) {
1209 $actions['edit'] = sprintf(
1210 '<a href="%s" aria-label="%s">%s</a>',
1211 get_edit_post_link( $post->ID ),
1212 /* translators: %s: post title */
1213 esc_attr( sprintf( __( 'Edit “%s”' ), $title ) ),
1216 $actions['inline hide-if-no-js'] = sprintf(
1217 '<a href="#" class="editinline" aria-label="%s">%s</a>',
1218 /* translators: %s: post title */
1219 esc_attr( sprintf( __( 'Quick edit “%s” inline' ), $title ) ),
1220 __( 'Quick Edit' )
1224 if ( current_user_can( 'delete_post', $post->ID ) ) {
1225 if ( 'trash' === $post->post_status ) {
1226 $actions['untrash'] = sprintf(
1227 '<a href="%s" aria-label="%s">%s</a>',
1228 wp_nonce_url( admin_url( sprintf( $post_type_object->_edit_link . '&action=untrash', $post->ID ) ), 'untrash-post_' . $post->ID ),
1229 /* translators: %s: post title */
1230 esc_attr( sprintf( __( 'Restore “%s” from the Trash' ), $title ) ),
1233 } elseif ( EMPTY_TRASH_DAYS ) {
1234 $actions['trash'] = sprintf(
1235 '<a href="%s" class="submitdelete" aria-label="%s">%s</a>',
1236 get_delete_post_link( $post->ID ),
1237 /* translators: %s: post title */
1238 esc_attr( sprintf( __( 'Move “%s” to the Trash' ), $title ) ),
1239 _x( 'Trash', 'verb' )
1242 if ( 'trash' === $post->post_status || ! EMPTY_TRASH_DAYS ) {
1243 $actions['delete'] = sprintf(
1244 '<a href="%s" class="submitdelete" aria-label="%s">%s</a>',
1245 get_delete_post_link( $post->ID, '', true ),
1246 /* translators: %s: post title */
1247 esc_attr( sprintf( __( 'Delete “%s” permanently' ), $title ) ),
1248 __( 'Delete Permanently' )
1253 if ( is_post_type_viewable( $post_type_object ) ) {
1254 if ( in_array( $post->post_status, array( 'pending', 'draft', 'future' ) ) ) {
1255 if ( $can_edit_post ) {
1256 $preview_link = get_preview_post_link( $post );
1257 $actions['view'] = sprintf(
1258 '<a href="%s" rel="permalink" aria-label="%s">%s</a>',
1259 esc_url( $preview_link ),
1260 /* translators: %s: post title */
1261 esc_attr( sprintf( __( 'Preview “%s”' ), $title ) ),
1265 } elseif ( 'trash' != $post->post_status ) {
1266 $actions['view'] = sprintf(
1267 '<a href="%s" rel="permalink" aria-label="%s">%s</a>',
1268 get_permalink( $post->ID ),
1269 /* translators: %s: post title */
1270 esc_attr( sprintf( __( 'View “%s”' ), $title ) ),
1276 if ( is_post_type_hierarchical( $post->post_type ) ) {
1279 * Filters the array of row action links on the Pages list table.
1281 * The filter is evaluated only for hierarchical post types.
1285 * @param array $actions An array of row action links. Defaults are
1286 * 'Edit', 'Quick Edit', 'Restore, 'Trash',
1287 * 'Delete Permanently', 'Preview', and 'View'.
1288 * @param WP_Post $post The post object.
1290 $actions = apply_filters( 'page_row_actions', $actions, $post );
1294 * Filters the array of row action links on the Posts list table.
1296 * The filter is evaluated only for non-hierarchical post types.
1300 * @param array $actions An array of row action links. Defaults are
1301 * 'Edit', 'Quick Edit', 'Restore, 'Trash',
1302 * 'Delete Permanently', 'Preview', and 'View'.
1303 * @param WP_Post $post The post object.
1305 $actions = apply_filters( 'post_row_actions', $actions, $post );
1308 return $this->row_actions( $actions );
1312 * Outputs the hidden row displayed when inline editing
1316 * @global string $mode
1318 public function inline_edit() {
1321 $screen = $this->screen;
1323 $post = get_default_post_to_edit( $screen->post_type );
1324 $post_type_object = get_post_type_object( $screen->post_type );
1326 $taxonomy_names = get_object_taxonomies( $screen->post_type );
1327 $hierarchical_taxonomies = array();
1328 $flat_taxonomies = array();
1329 foreach ( $taxonomy_names as $taxonomy_name ) {
1331 $taxonomy = get_taxonomy( $taxonomy_name );
1333 $show_in_quick_edit = $taxonomy->show_in_quick_edit;
1336 * Filters whether the current taxonomy should be shown in the Quick Edit panel.
1340 * @param bool $show_in_quick_edit Whether to show the current taxonomy in Quick Edit.
1341 * @param string $taxonomy_name Taxonomy name.
1342 * @param string $post_type Post type of current Quick Edit post.
1344 if ( ! apply_filters( 'quick_edit_show_taxonomy', $show_in_quick_edit, $taxonomy_name, $screen->post_type ) ) {
1348 if ( $taxonomy->hierarchical )
1349 $hierarchical_taxonomies[] = $taxonomy;
1351 $flat_taxonomies[] = $taxonomy;
1354 $m = ( isset( $mode ) && 'excerpt' === $mode ) ? 'excerpt' : 'list';
1355 $can_publish = current_user_can( $post_type_object->cap->publish_posts );
1356 $core_columns = array( 'cb' => true, 'date' => true, 'title' => true, 'categories' => true, 'tags' => true, 'comments' => true, 'author' => true );
1360 <form method="get"><table style="display: none"><tbody id="inlineedit">
1362 $hclass = count( $hierarchical_taxonomies ) ? 'post' : 'page';
1364 while ( $bulk < 2 ) { ?>
1366 <tr id="<?php echo $bulk ? 'bulk-edit' : 'inline-edit'; ?>" class="inline-edit-row inline-edit-row-<?php echo "$hclass inline-edit-" . $screen->post_type;
1367 echo $bulk ? " bulk-edit-row bulk-edit-row-$hclass bulk-edit-{$screen->post_type}" : " quick-edit-row quick-edit-row-$hclass inline-edit-{$screen->post_type}";
1368 ?>" style="display: none"><td colspan="<?php echo $this->get_column_count(); ?>" class="colspanchange">
1370 <fieldset class="inline-edit-col-left">
1371 <legend class="inline-edit-legend"><?php echo $bulk ? __( 'Bulk Edit' ) : __( 'Quick Edit' ); ?></legend>
1372 <div class="inline-edit-col">
1375 if ( post_type_supports( $screen->post_type, 'title' ) ) :
1377 <div id="bulk-title-div">
1378 <div id="bulk-titles"></div>
1381 <?php else : // $bulk ?>
1384 <span class="title"><?php _e( 'Title' ); ?></span>
1385 <span class="input-text-wrap"><input type="text" name="post_title" class="ptitle" value="" /></span>
1389 <span class="title"><?php _e( 'Slug' ); ?></span>
1390 <span class="input-text-wrap"><input type="text" name="post_name" value="" /></span>
1393 <?php endif; // $bulk
1394 endif; // post_type_supports title ?>
1396 <?php if ( !$bulk ) : ?>
1397 <fieldset class="inline-edit-date">
1398 <legend><span class="title"><?php _e( 'Date' ); ?></span></legend>
1399 <?php touch_time( 1, 1, 0, 1 ); ?>
1401 <br class="clear" />
1402 <?php endif; // $bulk
1404 if ( post_type_supports( $screen->post_type, 'author' ) ) :
1405 $authors_dropdown = '';
1407 if ( is_super_admin() || current_user_can( $post_type_object->cap->edit_others_posts ) ) :
1409 'hide_if_only_one_author' => false,
1411 'name' => 'post_author',
1412 'class'=> 'authors',
1415 'show' => 'display_name_with_login',
1418 $users_opt['show_option_none'] = __( '— No Change —' );
1420 if ( $authors = wp_dropdown_users( $users_opt ) ) :
1421 $authors_dropdown = '<label class="inline-edit-author">';
1422 $authors_dropdown .= '<span class="title">' . __( 'Author' ) . '</span>';
1423 $authors_dropdown .= $authors;
1424 $authors_dropdown .= '</label>';
1429 <?php if ( !$bulk ) echo $authors_dropdown;
1430 endif; // post_type_supports author
1432 if ( !$bulk && $can_publish ) :
1435 <div class="inline-edit-group wp-clearfix">
1436 <label class="alignleft">
1437 <span class="title"><?php _e( 'Password' ); ?></span>
1438 <span class="input-text-wrap"><input type="text" name="post_password" class="inline-edit-password-input" value="" /></span>
1441 <em class="alignleft inline-edit-or">
1443 /* translators: Between password field and private checkbox on post quick edit interface */
1444 _e( '–OR–' );
1447 <label class="alignleft inline-edit-private">
1448 <input type="checkbox" name="keep_private" value="private" />
1449 <span class="checkbox-title"><?php _e( 'Private' ); ?></span>
1457 <?php if ( count( $hierarchical_taxonomies ) && !$bulk ) : ?>
1459 <fieldset class="inline-edit-col-center inline-edit-categories"><div class="inline-edit-col">
1461 <?php foreach ( $hierarchical_taxonomies as $taxonomy ) : ?>
1463 <span class="title inline-edit-categories-label"><?php echo esc_html( $taxonomy->labels->name ) ?></span>
1464 <input type="hidden" name="<?php echo ( $taxonomy->name === 'category' ) ? 'post_category[]' : 'tax_input[' . esc_attr( $taxonomy->name ) . '][]'; ?>" value="0" />
1465 <ul class="cat-checklist <?php echo esc_attr( $taxonomy->name )?>-checklist">
1466 <?php wp_terms_checklist( null, array( 'taxonomy' => $taxonomy->name ) ) ?>
1469 <?php endforeach; //$hierarchical_taxonomies as $taxonomy ?>
1473 <?php endif; // count( $hierarchical_taxonomies ) && !$bulk ?>
1475 <fieldset class="inline-edit-col-right"><div class="inline-edit-col">
1478 if ( post_type_supports( $screen->post_type, 'author' ) && $bulk )
1479 echo $authors_dropdown;
1481 if ( post_type_supports( $screen->post_type, 'page-attributes' ) ) :
1483 if ( $post_type_object->hierarchical ) :
1486 <span class="title"><?php _e( 'Parent' ); ?></span>
1488 $dropdown_args = array(
1489 'post_type' => $post_type_object->name,
1490 'selected' => $post->post_parent,
1491 'name' => 'post_parent',
1492 'show_option_none' => __( 'Main Page (no parent)' ),
1493 'option_none_value' => 0,
1494 'sort_column' => 'menu_order, post_title',
1498 $dropdown_args['show_option_no_change'] = __( '— No Change —' );
1501 * Filters the arguments used to generate the Quick Edit page-parent drop-down.
1505 * @see wp_dropdown_pages()
1507 * @param array $dropdown_args An array of arguments.
1509 $dropdown_args = apply_filters( 'quick_edit_dropdown_pages_args', $dropdown_args );
1511 wp_dropdown_pages( $dropdown_args );
1516 endif; // hierarchical
1521 <span class="title"><?php _e( 'Order' ); ?></span>
1522 <span class="input-text-wrap"><input type="text" name="menu_order" class="inline-edit-menu-order-input" value="<?php echo $post->menu_order ?>" /></span>
1525 <?php endif; // !$bulk
1527 if ( 'page' === $screen->post_type ) :
1531 <span class="title"><?php _e( 'Template' ); ?></span>
1532 <select name="page_template">
1533 <?php if ( $bulk ) : ?>
1534 <option value="-1"><?php _e( '— No Change —' ); ?></option>
1535 <?php endif; // $bulk ?>
1537 /** This filter is documented in wp-admin/includes/meta-boxes.php */
1538 $default_title = apply_filters( 'default_page_template_title', __( 'Default Template' ), 'quick-edit' );
1540 <option value="default"><?php echo esc_html( $default_title ); ?></option>
1541 <?php page_template_dropdown() ?>
1546 endif; // page post_type
1547 endif; // page-attributes
1550 <?php if ( count( $flat_taxonomies ) && !$bulk ) : ?>
1552 <?php foreach ( $flat_taxonomies as $taxonomy ) : ?>
1553 <?php if ( current_user_can( $taxonomy->cap->assign_terms ) ) : ?>
1554 <label class="inline-edit-tags">
1555 <span class="title"><?php echo esc_html( $taxonomy->labels->name ) ?></span>
1556 <textarea cols="22" rows="1" name="tax_input[<?php echo esc_attr( $taxonomy->name )?>]" class="tax_input_<?php echo esc_attr( $taxonomy->name )?>"></textarea>
1560 <?php endforeach; //$flat_taxonomies as $taxonomy ?>
1562 <?php endif; // count( $flat_taxonomies ) && !$bulk ?>
1564 <?php if ( post_type_supports( $screen->post_type, 'comments' ) || post_type_supports( $screen->post_type, 'trackbacks' ) ) :
1567 <div class="inline-edit-group wp-clearfix">
1568 <?php if ( post_type_supports( $screen->post_type, 'comments' ) ) : ?>
1569 <label class="alignleft">
1570 <span class="title"><?php _e( 'Comments' ); ?></span>
1571 <select name="comment_status">
1572 <option value=""><?php _e( '— No Change —' ); ?></option>
1573 <option value="open"><?php _e( 'Allow' ); ?></option>
1574 <option value="closed"><?php _e( 'Do not allow' ); ?></option>
1577 <?php endif; if ( post_type_supports( $screen->post_type, 'trackbacks' ) ) : ?>
1578 <label class="alignright">
1579 <span class="title"><?php _e( 'Pings' ); ?></span>
1580 <select name="ping_status">
1581 <option value=""><?php _e( '— No Change —' ); ?></option>
1582 <option value="open"><?php _e( 'Allow' ); ?></option>
1583 <option value="closed"><?php _e( 'Do not allow' ); ?></option>
1589 <?php else : // $bulk ?>
1591 <div class="inline-edit-group wp-clearfix">
1592 <?php if ( post_type_supports( $screen->post_type, 'comments' ) ) : ?>
1593 <label class="alignleft">
1594 <input type="checkbox" name="comment_status" value="open" />
1595 <span class="checkbox-title"><?php _e( 'Allow Comments' ); ?></span>
1597 <?php endif; if ( post_type_supports( $screen->post_type, 'trackbacks' ) ) : ?>
1598 <label class="alignleft">
1599 <input type="checkbox" name="ping_status" value="open" />
1600 <span class="checkbox-title"><?php _e( 'Allow Pings' ); ?></span>
1605 <?php endif; // $bulk
1606 endif; // post_type_supports comments or pings ?>
1608 <div class="inline-edit-group wp-clearfix">
1609 <label class="inline-edit-status alignleft">
1610 <span class="title"><?php _e( 'Status' ); ?></span>
1611 <select name="_status">
1612 <?php if ( $bulk ) : ?>
1613 <option value="-1"><?php _e( '— No Change —' ); ?></option>
1614 <?php endif; // $bulk ?>
1615 <?php if ( $can_publish ) : // Contributors only get "Unpublished" and "Pending Review" ?>
1616 <option value="publish"><?php _e( 'Published' ); ?></option>
1617 <option value="future"><?php _e( 'Scheduled' ); ?></option>
1618 <?php if ( $bulk ) : ?>
1619 <option value="private"><?php _e( 'Private' ) ?></option>
1620 <?php endif; // $bulk ?>
1622 <option value="pending"><?php _e( 'Pending Review' ); ?></option>
1623 <option value="draft"><?php _e( 'Draft' ); ?></option>
1627 <?php if ( 'post' === $screen->post_type && $can_publish && current_user_can( $post_type_object->cap->edit_others_posts ) ) : ?>
1629 <?php if ( $bulk ) : ?>
1631 <label class="alignright">
1632 <span class="title"><?php _e( 'Sticky' ); ?></span>
1633 <select name="sticky">
1634 <option value="-1"><?php _e( '— No Change —' ); ?></option>
1635 <option value="sticky"><?php _e( 'Sticky' ); ?></option>
1636 <option value="unsticky"><?php _e( 'Not Sticky' ); ?></option>
1640 <?php else : // $bulk ?>
1642 <label class="alignleft">
1643 <input type="checkbox" name="sticky" value="sticky" />
1644 <span class="checkbox-title"><?php _e( 'Make this post sticky' ); ?></span>
1647 <?php endif; // $bulk ?>
1649 <?php endif; // 'post' && $can_publish && current_user_can( 'edit_others_cap' ) ?>
1655 if ( $bulk && current_theme_supports( 'post-formats' ) && post_type_supports( $screen->post_type, 'post-formats' ) ) {
1656 $post_formats = get_theme_support( 'post-formats' );
1659 <label class="alignleft">
1660 <span class="title"><?php _ex( 'Format', 'post format' ); ?></span>
1661 <select name="post_format">
1662 <option value="-1"><?php _e( '— No Change —' ); ?></option>
1663 <option value="0"><?php echo get_post_format_string( 'standard' ); ?></option>
1665 if ( is_array( $post_formats[0] ) ) {
1666 foreach ( $post_formats[0] as $format ) {
1668 <option value="<?php echo esc_attr( $format ); ?>"><?php echo esc_html( get_post_format_string( $format ) ); ?></option>
1683 list( $columns ) = $this->get_column_info();
1685 foreach ( $columns as $column_name => $column_display_name ) {
1686 if ( isset( $core_columns[$column_name] ) )
1692 * Fires once for each column in Bulk Edit mode.
1696 * @param string $column_name Name of the column to edit.
1697 * @param WP_Post $post_type The post type slug.
1699 do_action( 'bulk_edit_custom_box', $column_name, $screen->post_type );
1703 * Fires once for each column in Quick Edit mode.
1707 * @param string $column_name Name of the column to edit.
1708 * @param string $post_type The post type slug.
1710 do_action( 'quick_edit_custom_box', $column_name, $screen->post_type );
1715 <p class="submit inline-edit-save">
1716 <button type="button" class="button-secondary cancel alignleft"><?php _e( 'Cancel' ); ?></button>
1717 <?php if ( ! $bulk ) {
1718 wp_nonce_field( 'inlineeditnonce', '_inline_edit', false );
1720 <button type="button" class="button-primary save alignright"><?php _e( 'Update' ); ?></button>
1721 <span class="spinner"></span>
1723 submit_button( __( 'Update' ), 'button-primary alignright', 'bulk_edit', false );
1725 <input type="hidden" name="post_view" value="<?php echo esc_attr( $m ); ?>" />
1726 <input type="hidden" name="screen" value="<?php echo esc_attr( $screen->id ); ?>" />
1727 <?php if ( ! $bulk && ! post_type_supports( $screen->post_type, 'author' ) ) { ?>
1728 <input type="hidden" name="post_author" value="<?php echo esc_attr( $post->post_author ); ?>" />
1730 <span class="error" style="display:none"></span>
1731 <br class="clear" />
1738 </tbody></table></form>