X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/5aa86a9053fb0fa15846bb60aac2fb8fdfff524a..refs/tags/wordpress-4.4:/wp-admin/includes/class-wp-posts-list-table.php diff --git a/wp-admin/includes/class-wp-posts-list-table.php b/wp-admin/includes/class-wp-posts-list-table.php index 290939c2..d52ebc98 100644 --- a/wp-admin/includes/class-wp-posts-list-table.php +++ b/wp-admin/includes/class-wp-posts-list-table.php @@ -1,40 +1,48 @@ post_type; - $post_type_object = get_post_type_object( $post_type ); + parent::__construct( array( + 'plural' => 'posts', + 'screen' => isset( $args['screen'] ) ? $args['screen'] : null, + ) ); - if ( !current_user_can( $post_type_object->cap->edit_others_posts ) ) { - $this->user_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 post_author = %d - ", $post_type, get_current_user_id() ) ); + $post_type = $this->screen->post_type; + $post_type_object = get_post_type_object( $post_type ); - if ( $this->user_posts_count && empty( $_REQUEST['post_status'] ) && empty( $_REQUEST['all_posts'] ) && empty( $_REQUEST['author'] ) && empty( $_REQUEST['show_sticky'] ) ) - $_GET['author'] = get_current_user_id(); + $exclude_states = get_post_stati( array( + 'show_in_admin_all_list' => false, + ) ); + $this->user_posts_count = intval( $wpdb->get_var( $wpdb->prepare( " + SELECT COUNT( 1 ) + FROM $wpdb->posts + WHERE post_type = %s + AND post_status NOT IN ( '" . implode( "','", $exclude_states ) . "' ) + AND post_author = %d + ", $post_type, get_current_user_id() ) ) ); + + 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'] ) ) { + $_GET['author'] = get_current_user_id(); } - if ( 'post' == $post_type && $sticky_posts = get_option( 'sticky_posts' ) ) { + if ( 'post' === $post_type && $sticky_posts = get_option( 'sticky_posts' ) ) { $sticky_posts = implode( ', ', array_map( 'absint', (array) $sticky_posts ) ); - $this->sticky_posts_count = $wpdb->get_var( $wpdb->prepare( "SELECT COUNT( 1 ) FROM $wpdb->posts WHERE post_type = %s AND post_status != 'trash' AND ID IN ($sticky_posts)", $post_type ) ); + $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 ) ); } - - parent::__construct( array( - 'plural' => 'posts', - ) ); } - function ajax_user_can() { - global $post_type_object; + /** + * Sets whether the table layout should be hierarchical or not. + * + * @since 4.2.0 + * + * @param bool $display Whether the table layout should be hierarchical. + */ + public function set_hierarchical_display( $display ) { + $this->hierarchical_display = $display; + } - return current_user_can( $post_type_object->cap->edit_posts ); + /** + * + * @return bool + */ + public function ajax_user_can() { + return current_user_can( get_post_type_object( $this->screen->post_type )->cap->edit_posts ); } - function prepare_items() { - global $post_type_object, $avail_post_stati, $wp_query, $per_page, $mode; + /** + * + * @global array $avail_post_stati + * @global WP_Query $wp_query + * @global int $per_page + * @global string $mode + */ + public function prepare_items() { + global $avail_post_stati, $wp_query, $per_page, $mode; + // is going to call wp() $avail_post_stati = wp_edit_posts_query(); - $this->hierarchical_display = ( $post_type_object->hierarchical && 'menu_order title' == $wp_query->query['orderby'] ); - - $total_items = $this->hierarchical_display ? $wp_query->post_count : $wp_query->found_posts; + $this->set_hierarchical_display( is_post_type_hierarchical( $this->screen->post_type ) && 'menu_order title' === $wp_query->query['orderby'] ); - $post_type = $post_type_object->name; + $post_type = $this->screen->post_type; $per_page = $this->get_items_per_page( 'edit_' . $post_type . '_per_page' ); + + /** This filter is documented in wp-admin/includes/post.php */ $per_page = apply_filters( 'edit_posts_per_page', $per_page, $post_type ); - if ( $this->hierarchical_display ) - $total_pages = ceil( $total_items / $per_page ); - else - $total_pages = $wp_query->max_num_pages; + if ( $this->hierarchical_display ) { + $total_items = $wp_query->post_count; + } elseif ( $wp_query->found_posts || $this->get_pagenum() === 1 ) { + $total_items = $wp_query->found_posts; + } else { + $post_counts = (array) wp_count_posts( $post_type, 'readable' ); + + if ( isset( $_REQUEST['post_status'] ) && in_array( $_REQUEST['post_status'] , $avail_post_stati ) ) { + $total_items = $post_counts[ $_REQUEST['post_status'] ]; + } elseif ( isset( $_REQUEST['show_sticky'] ) && $_REQUEST['show_sticky'] ) { + $total_items = $this->sticky_posts_count; + } elseif ( isset( $_GET['author'] ) && $_GET['author'] == get_current_user_id() ) { + $total_items = $this->user_posts_count; + } else { + $total_items = array_sum( $post_counts ); + + // Subtract post types that are not included in the admin all list. + foreach ( get_post_stati( array( 'show_in_admin_all_list' => false ) ) as $state ) { + $total_items -= $post_counts[ $state ]; + } + } + } - $mode = empty( $_REQUEST['mode'] ) ? 'list' : $_REQUEST['mode']; + if ( ! empty( $_REQUEST['mode'] ) ) { + $mode = $_REQUEST['mode'] === 'excerpt' ? 'excerpt' : 'list'; + set_user_setting ( 'posts_list_mode', $mode ); + } else { + $mode = get_user_setting ( 'posts_list_mode', 'list' ); + } - $this->is_trash = isset( $_REQUEST['post_status'] ) && $_REQUEST['post_status'] == 'trash'; + $this->is_trash = isset( $_REQUEST['post_status'] ) && $_REQUEST['post_status'] === 'trash'; $this->set_pagination_args( array( 'total_items' => $total_items, - 'total_pages' => $total_pages, 'per_page' => $per_page ) ); } - function has_items() { + /** + * + * @return bool + */ + public function has_items() { return have_posts(); } - function no_items() { - global $post_type_object; - - if ( isset( $_REQUEST['post_status'] ) && 'trash' == $_REQUEST['post_status'] ) - echo $post_type_object->labels->not_found_in_trash; + /** + * @access public + */ + public function no_items() { + if ( isset( $_REQUEST['post_status'] ) && 'trash' === $_REQUEST['post_status'] ) + echo get_post_type_object( $this->screen->post_type )->labels->not_found_in_trash; else - echo $post_type_object->labels->not_found; + echo get_post_type_object( $this->screen->post_type )->labels->not_found; } - function get_views() { - global $post_type_object, $locked_post_status, $avail_post_stati; + /** + * Determine if the current view is the "All" view. + * + * @since 4.2.0 + * + * @return bool Whether the current view is the "All" view. + */ + protected function is_base_request() { + $vars = $_GET; + unset( $vars['paged'] ); + + if ( empty( $vars ) ) { + return true; + } elseif ( 1 === count( $vars ) && ! empty( $vars['post_type'] ) ) { + return $this->screen->post_type === $vars['post_type']; + } - $post_type = $post_type_object->name; + return 1 === count( $vars ) && ! empty( $vars['mode'] ); + } + + /** + * Helper to create links to edit.php with params. + * + * @since 4.4.0 + * @access protected + * + * @param array $args URL parameters for the link. + * @param string $label Link text. + * @param string $class Optional. Class attribute. Default empty string. + * @return string The formatted link string. + */ + protected function get_edit_link( $args, $label, $class = '' ) { + $url = add_query_arg( $args, 'edit.php' ); + + $class_html = ''; + if ( ! empty( $class ) ) { + $class_html = sprintf( + ' class="%s"', + esc_attr( $class ) + ); + } + + return sprintf( + '%s', + esc_url( $url ), + $class_html, + $label + ); + } + + /** + * + * @global array $locked_post_status This seems to be deprecated. + * @global array $avail_post_stati + * @return array + */ + protected function get_views() { + global $locked_post_status, $avail_post_stati; + + $post_type = $this->screen->post_type; if ( !empty($locked_post_status) ) return array(); $status_links = array(); $num_posts = wp_count_posts( $post_type, 'readable' ); + $total_posts = array_sum( (array) $num_posts ); $class = ''; - $allposts = ''; $current_user_id = get_current_user_id(); + $all_args = array( 'post_type' => $post_type ); + $mine = ''; - if ( $this->user_posts_count ) { - if ( isset( $_GET['author'] ) && ( $_GET['author'] == $current_user_id ) ) - $class = ' class="current"'; - $status_links['mine'] = "" . sprintf( _nx( 'Mine (%s)', 'Mine (%s)', $this->user_posts_count, 'posts' ), number_format_i18n( $this->user_posts_count ) ) . ''; - $allposts = '&all_posts=1'; + // Subtract post types that are not included in the admin all list. + foreach ( get_post_stati( array( 'show_in_admin_all_list' => false ) ) as $state ) { + $total_posts -= $num_posts->$state; } - $total_posts = array_sum( (array) $num_posts ); + if ( $this->user_posts_count && $this->user_posts_count !== $total_posts ) { + if ( isset( $_GET['author'] ) && ( $_GET['author'] == $current_user_id ) ) { + $class = 'current'; + } - // Subtract post types that are not included in the admin all list. - foreach ( get_post_stati( array('show_in_admin_all_list' => false) ) as $state ) - $total_posts -= $num_posts->$state; + $mine_args = array( + 'post_type' => $post_type, + 'author' => $current_user_id + ); - $class = empty( $class ) && empty( $_REQUEST['post_status'] ) && empty( $_REQUEST['show_sticky'] ) ? ' class="current"' : ''; - $status_links['all'] = "" . sprintf( _nx( 'All (%s)', 'All (%s)', $total_posts, 'posts' ), number_format_i18n( $total_posts ) ) . ''; + $mine_inner_html = sprintf( + _nx( + 'Mine (%s)', + 'Mine (%s)', + $this->user_posts_count, + 'posts' + ), + number_format_i18n( $this->user_posts_count ) + ); + + $mine = $this->get_edit_link( $mine_args, $mine_inner_html, $class ); + + $all_args['all_posts'] = 1; + $class = ''; + } + + if ( empty( $class ) && ( $this->is_base_request() || isset( $_REQUEST['all_posts'] ) ) ) { + $class = 'current'; + } + + $all_inner_html = sprintf( + _nx( + 'All (%s)', + 'All (%s)', + $total_posts, + 'posts' + ), + number_format_i18n( $total_posts ) + ); + + $status_links['all'] = $this->get_edit_link( $all_args, $all_inner_html, $class ); + if ( $mine ) { + $status_links['mine'] = $mine; + } foreach ( get_post_stati(array('show_in_admin_status_list' => true), 'objects') as $status ) { $class = ''; $status_name = $status->name; - if ( !in_array( $status_name, $avail_post_stati ) ) + if ( ! in_array( $status_name, $avail_post_stati ) || empty( $num_posts->$status_name ) ) { continue; + } - if ( empty( $num_posts->$status_name ) ) - continue; + if ( isset($_REQUEST['post_status']) && $status_name === $_REQUEST['post_status'] ) { + $class = 'current'; + } + + $status_args = array( + 'post_status' => $status_name, + 'post_type' => $post_type, + ); - if ( isset($_REQUEST['post_status']) && $status_name == $_REQUEST['post_status'] ) - $class = ' class="current"'; + $status_label = sprintf( + translate_nooped_plural( $status->label_count, $num_posts->$status_name ), + number_format_i18n( $num_posts->$status_name ) + ); - $status_links[$status_name] = "" . sprintf( translate_nooped_plural( $status->label_count, $num_posts->$status_name ), number_format_i18n( $num_posts->$status_name ) ) . ''; + $status_links[ $status_name ] = $this->get_edit_link( $status_args, $status_label, $class ); } if ( ! empty( $this->sticky_posts_count ) ) { - $class = ! empty( $_REQUEST['show_sticky'] ) ? ' class="current"' : ''; - - $sticky_link = array( 'sticky' => "" . sprintf( _nx( 'Sticky (%s)', 'Sticky (%s)', $this->sticky_posts_count, 'posts' ), number_format_i18n( $this->sticky_posts_count ) ) . '' ); + $class = ! empty( $_REQUEST['show_sticky'] ) ? 'current' : ''; + + $sticky_args = array( + 'post_type' => $post_type, + 'show_sticky' => 1 + ); + + $sticky_inner_html = sprintf( + _nx( + 'Sticky (%s)', + 'Sticky (%s)', + $this->sticky_posts_count, + 'posts' + ), + number_format_i18n( $this->sticky_posts_count ) + ); + + $sticky_link = array( + 'sticky' => $this->get_edit_link( $sticky_args, $sticky_inner_html, $class ) + ); // Sticky comes after Publish, or if not listed, after All. $split = 1 + array_search( ( isset( $status_links['publish'] ) ? 'publish' : 'all' ), array_keys( $status_links ) ); @@ -181,83 +384,118 @@ class WP_Posts_List_Table extends WP_List_Table { return $status_links; } - function get_bulk_actions() { + /** + * + * @return array + */ + protected function get_bulk_actions() { $actions = array(); + $post_type_obj = get_post_type_object( $this->screen->post_type ); - if ( $this->is_trash ) - $actions['untrash'] = __( 'Restore' ); - else - $actions['edit'] = __( 'Edit' ); + if ( current_user_can( $post_type_obj->cap->edit_posts ) ) { + if ( $this->is_trash ) { + $actions['untrash'] = __( 'Restore' ); + } else { + $actions['edit'] = __( 'Edit' ); + } + } - if ( $this->is_trash || !EMPTY_TRASH_DAYS ) - $actions['delete'] = __( 'Delete Permanently' ); - else - $actions['trash'] = __( 'Move to Trash' ); + if ( current_user_can( $post_type_obj->cap->delete_posts ) ) { + if ( $this->is_trash || ! EMPTY_TRASH_DAYS ) { + $actions['delete'] = __( 'Delete Permanently' ); + } else { + $actions['trash'] = __( 'Move to Trash' ); + } + } return $actions; } - function extra_tablenav( $which ) { - global $post_type_object, $cat; + /** + * @global int $cat + * @param string $which + */ + protected function extra_tablenav( $which ) { + global $cat; ?>
months_dropdown( $post_type_object->name ); + $this->months_dropdown( $this->screen->post_type ); - if ( is_object_in_taxonomy( $post_type_object->name, 'category' ) ) { + if ( is_object_in_taxonomy( $this->screen->post_type, 'category' ) ) { $dropdown_options = array( - 'show_option_all' => __( 'View all categories' ), + 'show_option_all' => __( 'All categories' ), 'hide_empty' => 0, 'hierarchical' => 1, 'show_count' => 0, 'orderby' => 'name', 'selected' => $cat ); + + echo ''; wp_dropdown_categories( $dropdown_options ); } - do_action( 'restrict_manage_posts' ); - submit_button( __( 'Filter' ), 'secondary', false, false, array( 'id' => 'post-query-submit' ) ); + + /** + * Fires before the Filter button on the Posts and Pages list tables. + * + * The Filter button allows sorting by date and/or category on the + * Posts list table, and sorting by date on the Pages list table. + * + * @since 2.1.0 + * @since 4.4.0 The `$post_type` parameter was added. + * + * @param string $post_type The post type slug. + */ + do_action( 'restrict_manage_posts', $this->screen->post_type ); + + submit_button( __( 'Filter' ), 'button', 'filter_action', false, array( 'id' => 'post-query-submit' ) ); } - if ( $this->is_trash && current_user_can( $post_type_object->cap->edit_others_posts ) ) { - submit_button( __( 'Empty Trash' ), 'button-secondary apply', 'delete_all', false ); + if ( $this->is_trash && current_user_can( get_post_type_object( $this->screen->post_type )->cap->edit_others_posts ) ) { + submit_button( __( 'Empty Trash' ), 'apply', 'delete_all', false ); } ?>
hierarchical ) - $this->view_switcher( $mode ); - } - - function get_table_classes() { - global $post_type_object; - - return array( 'widefat', 'fixed', $post_type_object->hierarchical ? 'pages' : 'posts' ); + /** + * + * @return array + */ + protected function get_table_classes() { + return array( 'widefat', 'fixed', 'striped', is_post_type_hierarchical( $this->screen->post_type ) ? 'pages' : 'posts' ); } - function get_columns() { - $screen = get_current_screen(); - - if ( empty( $screen ) ) - $post_type = 'post'; - else - $post_type = $screen->post_type; + /** + * + * @return array + */ + public function get_columns() { + $post_type = $this->screen->post_type; $posts_columns = array(); @@ -266,42 +504,100 @@ class WP_Posts_List_Table extends WP_List_Table { /* translators: manage posts column name */ $posts_columns['title'] = _x( 'Title', 'column name' ); - if ( post_type_supports( $post_type, 'author' ) ) + if ( post_type_supports( $post_type, 'author' ) ) { $posts_columns['author'] = __( 'Author' ); + } - if ( empty( $post_type ) || is_object_in_taxonomy( $post_type, 'category' ) ) - $posts_columns['categories'] = __( 'Categories' ); + $taxonomies = get_object_taxonomies( $post_type, 'objects' ); + $taxonomies = wp_filter_object_list( $taxonomies, array( 'show_admin_column' => true ), 'and', 'name' ); + + /** + * Filter the taxonomy columns in the Posts list table. + * + * The dynamic portion of the hook name, `$post_type`, refers to the post + * type slug. + * + * @since 3.5.0 + * + * @param array $taxonomies Array of taxonomies to show columns for. + * @param string $post_type The post type. + */ + $taxonomies = apply_filters( "manage_taxonomies_for_{$post_type}_columns", $taxonomies, $post_type ); + $taxonomies = array_filter( $taxonomies, 'taxonomy_exists' ); + + foreach ( $taxonomies as $taxonomy ) { + if ( 'category' === $taxonomy ) + $column_key = 'categories'; + elseif ( 'post_tag' === $taxonomy ) + $column_key = 'tags'; + else + $column_key = 'taxonomy-' . $taxonomy; - if ( empty( $post_type ) || is_object_in_taxonomy( $post_type, 'post_tag' ) ) - $posts_columns['tags'] = __( 'Tags' ); + $posts_columns[ $column_key ] = get_taxonomy( $taxonomy )->labels->name; + } $post_status = !empty( $_REQUEST['post_status'] ) ? $_REQUEST['post_status'] : 'all'; if ( post_type_supports( $post_type, 'comments' ) && !in_array( $post_status, array( 'pending', 'draft', 'future' ) ) ) - $posts_columns['comments'] = '' . esc_attr__( 'Comments' ) . ''; + $posts_columns['comments'] = '' . __( 'Comments' ) . ''; $posts_columns['date'] = __( 'Date' ); - if ( 'page' == $post_type ) + if ( 'page' === $post_type ) { + + /** + * Filter the columns displayed in the Pages list table. + * + * @since 2.5.0 + * + * @param array $post_columns An array of column names. + */ $posts_columns = apply_filters( 'manage_pages_columns', $posts_columns ); - else + } else { + + /** + * Filter the columns displayed in the Posts list table. + * + * @since 1.5.0 + * + * @param array $posts_columns An array of column names. + * @param string $post_type The post type slug. + */ $posts_columns = apply_filters( 'manage_posts_columns', $posts_columns, $post_type ); - $posts_columns = apply_filters( "manage_{$post_type}_posts_columns", $posts_columns ); + } - return $posts_columns; + /** + * Filter the columns displayed in the Posts list table for a specific post type. + * + * The dynamic portion of the hook name, `$post_type`, refers to the post type slug. + * + * @since 3.0.0 + * + * @param array $post_columns An array of column names. + */ + return apply_filters( "manage_{$post_type}_posts_columns", $posts_columns ); } - function get_sortable_columns() { + /** + * + * @return array + */ + protected function get_sortable_columns() { return array( 'title' => 'title', - 'author' => 'author', 'parent' => 'parent', 'comments' => 'comment_count', 'date' => array( 'date', true ) ); } - function display_rows( $posts = array() ) { - global $wp_query, $post_type_object, $per_page; + /** + * @global WP_Query $wp_query + * @global int $per_page + * @param array $posts + * @param int $level + */ + public function display_rows( $posts = array(), $level = 0 ) { + global $wp_query, $per_page; if ( empty( $posts ) ) $posts = $wp_query->posts; @@ -311,13 +607,15 @@ class WP_Posts_List_Table extends WP_List_Table { if ( $this->hierarchical_display ) { $this->_display_rows_hierarchical( $posts, $this->get_pagenum(), $per_page ); } else { - $this->_display_rows( $posts ); + $this->_display_rows( $posts, $level ); } } - function _display_rows( $posts ) { - global $post, $mode; - + /** + * @param array $posts + * @param int $level + */ + private function _display_rows( $posts, $level = 0 ) { // Create array of post IDs. $post_ids = array(); @@ -327,10 +625,17 @@ class WP_Posts_List_Table extends WP_List_Table { $this->comment_pending_count = get_pending_comments_num( $post_ids ); foreach ( $posts as $post ) - $this->single_row( $post ); + $this->single_row( $post, $level ); } - function _display_rows_hierarchical( $pages, $pagenum = 1, $per_page = 20 ) { + /** + * @global wpdb $wpdb + * @global WP_Post $post + * @param array $pages + * @param int $pagenum + * @param int $per_page + */ + private function _display_rows_hierarchical( $pages, $pagenum = 1, $per_page = 20 ) { global $wpdb; $level = 0; @@ -339,11 +644,11 @@ class WP_Posts_List_Table extends WP_List_Table { $pages = get_pages( array( 'sort_column' => 'menu_order' ) ); if ( ! $pages ) - return false; + return; } /* - * arrange pages into two parts: top level pages and children_pages + * Arrange pages into two parts: top level pages and children_pages * children_pages is two dimensional array, eg. * children_pages[10][] contains all sub-pages whose parent is 10. * It only takes O( N ) to arrange this and it takes O( 1 ) for subsequent lookup operations @@ -356,11 +661,11 @@ class WP_Posts_List_Table extends WP_List_Table { foreach ( $pages as $page ) { - // catch and repair bad pages + // Catch and repair bad pages. if ( $page->post_parent == $page->ID ) { $page->post_parent = 0; $wpdb->update( $wpdb->posts, array( 'post_parent' => 0 ), array( 'ID' => $page->ID ) ); - clean_page_cache( $page->ID ); + clean_post_cache( $page ); } if ( 0 == $page->post_parent ) @@ -375,32 +680,49 @@ class WP_Posts_List_Table extends WP_List_Table { $count = 0; $start = ( $pagenum - 1 ) * $per_page; $end = $start + $per_page; + $to_display = array(); foreach ( $pages as $page ) { if ( $count >= $end ) break; - if ( $count >= $start ) - echo "\t" . $this->single_row( $page, $level ); + if ( $count >= $start ) { + $to_display[$page->ID] = $level; + } $count++; if ( isset( $children_pages ) ) - $this->_page_rows( $children_pages, $count, $page->ID, $level + 1, $pagenum, $per_page ); + $this->_page_rows( $children_pages, $count, $page->ID, $level + 1, $pagenum, $per_page, $to_display ); } - // if it is the last pagenum and there are orphaned pages, display them with paging as well + // If it is the last pagenum and there are orphaned pages, display them with paging as well. if ( isset( $children_pages ) && $count < $end ){ foreach ( $children_pages as $orphans ){ foreach ( $orphans as $op ) { if ( $count >= $end ) break; - if ( $count >= $start ) - echo "\t" . $this->single_row( $op, 0 ); + + if ( $count >= $start ) { + $to_display[$op->ID] = 0; + } + $count++; } } } + + $ids = array_keys( $to_display ); + _prime_post_caches( $ids ); + + if ( ! isset( $GLOBALS['post'] ) ) { + $GLOBALS['post'] = reset( $ids ); + } + + foreach ( $to_display as $page_id => $level ) { + echo "\t"; + $this->single_row( $page_id, $level ); + } } /** @@ -408,16 +730,17 @@ class WP_Posts_List_Table extends WP_List_Table { * together with paging support * * @since 3.1.0 (Standalone function exists since 2.6.0) + * @since 4.2.0 Added the `$to_display` parameter. * - * @param unknown_type $children_pages - * @param unknown_type $count - * @param unknown_type $parent - * @param unknown_type $level - * @param unknown_type $pagenum - * @param unknown_type $per_page + * @param array $children_pages + * @param int $count + * @param int $parent + * @param int $level + * @param int $pagenum + * @param int $per_page + * @param array $to_display List of pages to be displayed. Passed by reference. */ - function _page_rows( &$children_pages, &$count, $parent, $level, $pagenum, $per_page ) { - + private function _page_rows( &$children_pages, &$count, $parent, $level, $pagenum, $per_page, &$to_display ) { if ( ! isset( $children_pages[$parent] ) ) return; @@ -425,7 +748,6 @@ class WP_Posts_List_Table extends WP_List_Table { $end = $start + $per_page; foreach ( $children_pages[$parent] as $page ) { - if ( $count >= $end ) break; @@ -434,7 +756,13 @@ class WP_Posts_List_Table extends WP_List_Table { $my_parents = array(); $my_parent = $page->post_parent; while ( $my_parent ) { - $my_parent = get_post( $my_parent ); + // Get the ID from the list or the attribute if my_parent is an object + $parent_id = $my_parent; + if ( is_object( $my_parent ) ) { + $parent_id = $my_parent->ID; + } + + $my_parent = get_post( $parent_id ); $my_parents[] = $my_parent; if ( !$my_parent->post_parent ) break; @@ -442,252 +770,479 @@ class WP_Posts_List_Table extends WP_List_Table { } $num_parents = count( $my_parents ); while ( $my_parent = array_pop( $my_parents ) ) { - echo "\t" . $this->single_row( $my_parent, $level - $num_parents ); + $to_display[$my_parent->ID] = $level - $num_parents; $num_parents--; } } - if ( $count >= $start ) - echo "\t" . $this->single_row( $page, $level ); + if ( $count >= $start ) { + $to_display[$page->ID] = $level; + } $count++; - $this->_page_rows( $children_pages, $count, $page->ID, $level + 1, $pagenum, $per_page ); + $this->_page_rows( $children_pages, $count, $page->ID, $level + 1, $pagenum, $per_page, $to_display ); } unset( $children_pages[$parent] ); //required in order to keep track of orphans } - function single_row( $a_post, $level = 0 ) { - global $post, $mode; - static $alternate; + /** + * Handles the checkbox column output. + * + * @since 4.3.0 + * @access public + * + * @param WP_Post $post The current WP_Post object. + */ + public function column_cb( $post ) { + if ( current_user_can( 'edit_post', $post->ID ) ): ?> + + +
+ '; + echo $this->column_title( $post ); + echo $this->handle_row_actions( $post, 'title', $primary ); + echo ''; + } - $edit_link = get_edit_post_link( $post->ID ); - $title = _draft_or_post_title(); - $post_type_object = get_post_type_object( $post->post_type ); - $can_edit_post = current_user_can( $post_type_object->cap->edit_post, $post->ID ); + /** + * Handles the title column output. + * + * @since 4.3.0 + * @access public + * + * @global string $mode + * + * @param WP_Post $post The current WP_Post object. + */ + public function column_title( $post ) { + global $mode; - $alternate = 'alternate' == $alternate ? '' : 'alternate'; - $classes = $alternate . ' iedit author-' . ( get_current_user_id() == $post->post_author ? 'self' : 'other' ); - ?> - - hierarchical_display ) { + if ( 0 === $this->current_level && (int) $post->post_parent > 0 ) { + // Sent level 0 by accident, by default, or because we don't know the actual level. + $find_main_page = (int) $post->post_parent; + while ( $find_main_page > 0 ) { + $parent = get_post( $find_main_page ); - list( $columns, $hidden ) = $this->get_column_info(); + if ( is_null( $parent ) ) { + break; + } - foreach ( $columns as $column_name => $column_display_name ) { - $class = "class=\"$column_name column-$column_name\""; + $this->current_level++; + $find_main_page = (int) $parent->post_parent; - $style = ''; - if ( in_array( $column_name, $hidden ) ) - $style = ' style="display:none;"'; + if ( ! isset( $parent_name ) ) { + /** This filter is documented in wp-includes/post-template.php */ + $parent_name = apply_filters( 'the_title', $parent->post_title, $parent->ID ); + } + } + } + } - $attributes = "$class$style"; + $pad = str_repeat( '— ', $this->current_level ); + echo ""; - switch ( $column_name ) { + $format = get_post_format( $post->ID ); + if ( $format ) { + $label = get_post_format_string( $format ); - case 'cb': - ?> - - hierarchical_display ) { - $attributes = 'class="post-title page-title column-title"' . $style; + $format_args = array( + 'post_format' => $format, + 'post_type' => $post->post_type + ); - if ( 0 == $level && (int) $post->post_parent > 0 ) { - //sent level 0 by accident, by default, or because we don't know the actual level - $find_main_page = (int) $post->post_parent; - while ( $find_main_page > 0 ) { - $parent = get_page( $find_main_page ); + echo $this->get_edit_link( $format_args, $label . ':', $format_class ); + } - if ( is_null( $parent ) ) - break; + $can_edit_post = current_user_can( 'edit_post', $post->ID ); + $title = _draft_or_post_title(); - $level++; - $find_main_page = (int) $parent->post_parent; + if ( $can_edit_post && $post->post_status != 'trash' ) { + $edit_link = get_edit_post_link( $post->ID ); + echo '' . $pad . $title . ''; + } else { + echo $pad . $title; + } + _post_states( $post ); - if ( !isset( $parent_name ) ) - $parent_name = apply_filters( 'the_title', $parent->post_title, $parent->ID ); - } - } + if ( isset( $parent_name ) ) { + $post_type_object = get_post_type_object( $post->post_type ); + echo ' | ' . $post_type_object->labels->parent_item_colon . ' ' . esc_html( $parent_name ); + } + echo "\n"; - $pad = str_repeat( '— ', $level ); -?> - >post_status != 'trash' ) { ?>labels->parent_item_colon . ' ' . esc_html( $parent_name ) : ''; ?> - - >post_status != 'trash' ) { ?> -post_status != 'trash' ) { + $lock_holder = wp_check_post_lock( $post->ID ); - $actions = array(); - if ( $can_edit_post && 'trash' != $post->post_status ) { - $actions['edit'] = '' . __( 'Edit' ) . ''; - $actions['inline hide-if-no-js'] = '' . __( 'Quick Edit' ) . ''; - } - if ( current_user_can( $post_type_object->cap->delete_post, $post->ID ) ) { - if ( 'trash' == $post->post_status ) - $actions['untrash'] = "ID ) ), 'untrash-' . $post->post_type . '_' . $post->ID ) . "'>" . __( 'Restore' ) . ""; - elseif ( EMPTY_TRASH_DAYS ) - $actions['trash'] = "" . __( 'Trash' ) . ""; - if ( 'trash' == $post->post_status || !EMPTY_TRASH_DAYS ) - $actions['delete'] = "" . __( 'Delete Permanently' ) . ""; - } - if ( $post_type_object->public ) { - if ( in_array( $post->post_status, array( 'pending', 'draft', 'future' ) ) ) { - if ( $can_edit_post ) - $actions['view'] = '' . __( 'Preview' ) . ''; - } elseif ( 'trash' != $post->post_status ) { - $actions['view'] = '' . __( 'View' ) . ''; - } - } + if ( $lock_holder ) { + $lock_holder = get_userdata( $lock_holder ); + $locked_avatar = get_avatar( $lock_holder->ID, 18 ); + $locked_text = esc_html( sprintf( __( '%s is currently editing' ), $lock_holder->display_name ) ); + } else { + $locked_avatar = $locked_text = ''; + } - $actions = apply_filters( is_post_type_hierarchical( $post->post_type ) ? 'page_row_actions' : 'post_row_actions', $actions, $post ); - echo $this->row_actions( $actions ); + echo '
' . $locked_avatar . ' ' . $locked_text . "
\n"; + } - get_inline_data( $post ); - echo ''; - break; + if ( ! is_post_type_hierarchical( $this->screen->post_type ) && 'excerpt' === $mode && current_user_can( 'read_post', $post->ID ) ) { + the_excerpt(); + } - case 'date': - if ( '0000-00-00 00:00:00' == $post->post_date && 'date' == $column_name ) { - $t_time = $h_time = __( 'Unpublished' ); - $time_diff = 0; - } else { - $t_time = get_the_time( __( 'Y/m/d g:i:s A' ) ); - $m_time = $post->post_date; - $time = get_post_time( 'G', true, $post ); + get_inline_data( $post ); + } - $time_diff = time() - $time; + /** + * Handles the post date column output. + * + * @since 4.3.0 + * @access public + * + * @global string $mode + * + * @param WP_Post $post The current WP_Post object. + */ + public function column_date( $post ) { + global $mode; - if ( $time_diff > 0 && $time_diff < 24*60*60 ) - $h_time = sprintf( __( '%s ago' ), human_time_diff( $time ) ); - else - $h_time = mysql2date( __( 'Y/m/d' ), $m_time ); - } + if ( '0000-00-00 00:00:00' === $post->post_date ) { + $t_time = $h_time = __( 'Unpublished' ); + $time_diff = 0; + } else { + $t_time = get_the_time( __( 'Y/m/d g:i:s a' ) ); + $m_time = $post->post_date; + $time = get_post_time( 'G', true, $post ); - echo ''; - if ( 'excerpt' == $mode ) - echo apply_filters( 'post_date_column_time', $t_time, $post, $column_name, $mode ); - else - echo '' . apply_filters( 'post_date_column_time', $h_time, $post, $column_name, $mode ) . ''; - echo '
'; - if ( 'publish' == $post->post_status ) { - _e( 'Published' ); - } elseif ( 'future' == $post->post_status ) { - if ( $time_diff > 0 ) - echo '' . __( 'Missed schedule' ) . ''; - else - _e( 'Scheduled' ); - } else { - _e( 'Last Modified' ); - } - echo ''; - break; + $time_diff = time() - $time; - case 'categories': - ?> - >%s', - esc_url( add_query_arg( array( 'post_type' => $post->post_type, 'category_name' => $c->slug ), 'edit.php' ) ), - esc_html( sanitize_term_field( 'name', $c->name, $c->term_id, 'category', 'display' ) ) - ); - } - echo join( ', ', $out ); - } else { - _e( 'Uncategorized' ); - } - ?> - 0 && $time_diff < DAY_IN_SECONDS ) { + $h_time = sprintf( __( '%s ago' ), human_time_diff( $time ) ); + } else { + $h_time = mysql2date( __( 'Y/m/d' ), $m_time ); + } + } - case 'tags': - ?> - >ID ); - if ( !empty( $tags ) ) { - $out = array(); - foreach ( $tags as $c ) { - $out[] = sprintf( '%s', - esc_url( add_query_arg( array( 'post_type' => $post->post_type, 'tag' => $c->slug ), 'edit.php' ) ), - esc_html( sanitize_term_field( 'name', $c->name, $c->term_id, 'tag', 'display' ) ) - ); + if ( 'publish' === $post->post_status ) { + _e( 'Published' ); + } elseif ( 'future' === $post->post_status ) { + if ( $time_diff > 0 ) { + echo '' . __( 'Missed schedule' ) . ''; + } else { + _e( 'Scheduled' ); + } + } else { + _e( 'Last Modified' ); + } + echo '
'; + if ( 'excerpt' === $mode ) { + /** + * Filter the published time of the post. + * + * If `$mode` equals 'excerpt', the published time and date are both displayed. + * If `$mode` equals 'list' (default), the publish date is displayed, with the + * time and date together available as an abbreviation definition. + * + * @since 2.5.1 + * + * @param string $t_time The published time. + * @param WP_Post $post Post object. + * @param string $column_name The column name. + * @param string $mode The list display mode ('excerpt' or 'list'). + */ + echo apply_filters( 'post_date_column_time', $t_time, $post, 'date', $mode ); + } else { + + /** This filter is documented in wp-admin/includes/class-wp-posts-list-table.php */ + echo '' . apply_filters( 'post_date_column_time', $h_time, $post, 'date', $mode ) . ''; + } + } + + /** + * Handles the comments column output. + * + * @since 4.3.0 + * @access public + * + * @param WP_Post $post The current WP_Post object. + */ + public function column_comments( $post ) { + ?> +
+ comment_pending_count[$post->ID] ) ? $this->comment_pending_count[$post->ID] : 0; + + $this->comments_bubble( $post->ID, $pending_comments ); + ?> +
+ $post->post_type, + 'author' => get_the_author_meta( 'ID' ) + ); + echo $this->get_edit_link( $args, get_the_author() ); + } + + /** + * Handles the default column output. + * + * @since 4.3.0 + * @access public + * + * @param WP_Post $post The current WP_Post object. + * @param string $column_name The current column name. + */ + public function column_default( $post, $column_name ) { + if ( 'categories' === $column_name ) { + $taxonomy = 'category'; + } elseif ( 'tags' === $column_name ) { + $taxonomy = 'post_tag'; + } elseif ( 0 === strpos( $column_name, 'taxonomy-' ) ) { + $taxonomy = substr( $column_name, 9 ); + } else { + $taxonomy = false; + } + if ( $taxonomy ) { + $taxonomy_object = get_taxonomy( $taxonomy ); + $terms = get_the_terms( $post->ID, $taxonomy ); + if ( is_array( $terms ) ) { + $out = array(); + foreach ( $terms as $t ) { + $posts_in_term_qv = array(); + if ( 'post' != $post->post_type ) { + $posts_in_term_qv['post_type'] = $post->post_type; + } + if ( $taxonomy_object->query_var ) { + $posts_in_term_qv[ $taxonomy_object->query_var ] = $t->slug; + } else { + $posts_in_term_qv['taxonomy'] = $taxonomy; + $posts_in_term_qv['term'] = $t->slug; } - echo join( ', ', $out ); - } else { - _e( 'No Tags' ); + + $label = esc_html( sanitize_term_field( 'name', $t->name, $t->term_id, $taxonomy, 'display' ) ); + $out[] = $this->get_edit_link( $posts_in_term_qv, $label ); } - ?> - ' . $taxonomy_object->labels->no_terms . ''; + } + return; + } - case 'comments': - ?> - >
- comment_pending_count[$post->ID] ) ? $this->comment_pending_count[$post->ID] : 0; + if ( is_post_type_hierarchical( $post->post_type ) ) { + + /** + * Fires in each custom column on the Posts list table. + * + * This hook only fires if the current post type is hierarchical, + * such as pages. + * + * @since 2.5.0 + * + * @param string $column_name The name of the column to display. + * @param int $post_id The current post ID. + */ + do_action( 'manage_pages_custom_column', $column_name, $post->ID ); + } else { - $this->comments_bubble( $post->ID, $pending_comments ); - ?> -
- ID ); + } - case 'author': - ?> - >%s', - esc_url( add_query_arg( array( 'post_type' => $post->post_type, 'author' => get_the_author_meta( 'ID' ) ), 'edit.php' )), - get_the_author() - ); - ?> - post_type`, refers to the post type. + * + * @since 3.1.0 + * + * @param string $column_name The name of the column to display. + * @param int $post_id The current post ID. + */ + do_action( "manage_{$post->post_type}_posts_custom_column", $column_name, $post->ID ); + } - default: - ?> - >post_type ) ) - do_action( 'manage_pages_custom_column', $column_name, $post->ID ); - else - do_action( 'manage_posts_custom_column', $column_name, $post->ID ); - do_action( "manage_{$post->post_type}_posts_custom_column", $column_name, $post->ID ); - ?> - current_level = $level; + + $GLOBALS['post'] = $post; + setup_postdata( $post ); + + $classes = 'iedit author-' . ( get_current_user_id() == $post->post_author ? 'self' : 'other' ); + + $lock_holder = wp_check_post_lock( $post->ID ); + if ( $lock_holder ) { + $classes .= ' wp-locked'; + } + + if ( $post->post_parent ) { + $count = count( get_post_ancestors( $post->ID ) ); + $classes .= ' level-'. $count; + } else { + $classes .= ' level-0'; } - } ?> + + single_row_columns( $post ); ?> post_type ); + $can_edit_post = current_user_can( 'edit_post', $post->ID ); + $actions = array(); + + if ( $can_edit_post && 'trash' != $post->post_status ) { + $actions['edit'] = '' . __( 'Edit' ) . ''; + $actions['inline hide-if-no-js'] = '' . __( 'Quick Edit' ) . ''; + } + + if ( current_user_can( 'delete_post', $post->ID ) ) { + if ( 'trash' === $post->post_status ) + $actions['untrash'] = "ID ) ), 'untrash-post_' . $post->ID ) . "'>" . __( 'Restore' ) . ""; + elseif ( EMPTY_TRASH_DAYS ) + $actions['trash'] = "" . __( 'Trash' ) . ""; + if ( 'trash' === $post->post_status || !EMPTY_TRASH_DAYS ) + $actions['delete'] = "" . __( 'Delete Permanently' ) . ""; + } + + if ( is_post_type_viewable( $post_type_object ) ) { + $title = _draft_or_post_title(); + if ( in_array( $post->post_status, array( 'pending', 'draft', 'future' ) ) ) { + if ( $can_edit_post ) { + $unpublished_link = set_url_scheme( get_permalink( $post ) ); + $preview_link = get_preview_post_link( $post, array(), $unpublished_link ); + $actions['view'] = '' . __( 'Preview' ) . ''; + } + } elseif ( 'trash' != $post->post_status ) { + $actions['view'] = '' . __( 'View' ) . ''; + } + } + + if ( is_post_type_hierarchical( $post->post_type ) ) { + + /** + * Filter the array of row action links on the Pages list table. + * + * The filter is evaluated only for hierarchical post types. + * + * @since 2.8.0 + * + * @param array $actions An array of row action links. Defaults are + * 'Edit', 'Quick Edit', 'Restore, 'Trash', + * 'Delete Permanently', 'Preview', and 'View'. + * @param WP_Post $post The post object. + */ + $actions = apply_filters( 'page_row_actions', $actions, $post ); + } else { + + /** + * Filter the array of row action links on the Posts list table. + * + * The filter is evaluated only for non-hierarchical post types. + * + * @since 2.8.0 + * + * @param array $actions An array of row action links. Defaults are + * 'Edit', 'Quick Edit', 'Restore, 'Trash', + * 'Delete Permanently', 'Preview', and 'View'. + * @param WP_Post $post The post object. + */ + $actions = apply_filters( 'post_row_actions', $actions, $post ); + } + + return $this->row_actions( $actions ); } /** * Outputs the hidden row displayed when inline editing * * @since 3.1.0 + * + * @global string $mode */ - function inline_edit() { + public function inline_edit() { global $mode; - $screen = get_current_screen(); + $screen = $this->screen; $post = get_default_post_to_edit( $screen->post_type ); $post_type_object = get_post_type_object( $screen->post_type ); @@ -696,10 +1251,23 @@ class WP_Posts_List_Table extends WP_List_Table { $hierarchical_taxonomies = array(); $flat_taxonomies = array(); foreach ( $taxonomy_names as $taxonomy_name ) { + $taxonomy = get_taxonomy( $taxonomy_name ); - if ( !$taxonomy->show_ui ) + $show_in_quick_edit = $taxonomy->show_in_quick_edit; + + /** + * Filter whether the current taxonomy should be shown in the Quick Edit panel. + * + * @since 4.2.0 + * + * @param bool $show_in_quick_edit Whether to show the current taxonomy in Quick Edit. + * @param string $taxonomy_name Taxonomy name. + * @param string $post_type Post type of current Quick Edit post. + */ + if ( ! apply_filters( 'quick_edit_show_taxonomy', $show_in_quick_edit, $taxonomy_name, $screen->post_type ) ) { continue; + } if ( $taxonomy->hierarchical ) $hierarchical_taxonomies[] = $taxonomy; @@ -707,24 +1275,25 @@ class WP_Posts_List_Table extends WP_List_Table { $flat_taxonomies[] = $taxonomy; } - $m = ( isset( $mode ) && 'excerpt' == $mode ) ? 'excerpt' : 'list'; + $m = ( isset( $mode ) && 'excerpt' === $mode ) ? 'excerpt' : 'list'; $can_publish = current_user_can( $post_type_object->cap->publish_posts ); $core_columns = array( 'cb' => true, 'date' => true, 'title' => true, 'categories' => true, 'tags' => true, 'comments' => true, 'author' => true ); ?> -
+
- post_type "; - 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"; + post_type; + 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}"; ?>" style="display: none">
-
-

+
+ +
post_type, 'title' ) ) : @@ -749,10 +1318,10 @@ class WP_Posts_List_Table extends WP_List_Table { endif; // post_type_supports title ?> - -
- -
+
+ + +

@@ -792,15 +1361,15 @@ class WP_Posts_List_Table extends WP_List_Table { - +
@@ -814,11 +1383,8 @@ class WP_Posts_List_Table extends WP_List_Table { - labels->name ) ?> - - - - + labels->name ) ?> +
    $taxonomy->name ) ) ?>
@@ -853,7 +1419,18 @@ class WP_Posts_List_Table extends WP_List_Table { if ( $bulk ) $dropdown_args['show_option_no_change'] = __( '— No Change —' ); + + /** + * Filter the arguments used to generate the Quick Edit page-parent drop-down. + * + * @since 2.7.0 + * + * @see wp_dropdown_pages() + * + * @param array $dropdown_args An array of arguments. + */ $dropdown_args = apply_filters( 'quick_edit_dropdown_pages_args', $dropdown_args ); + wp_dropdown_pages( $dropdown_args ); ?> @@ -870,7 +1447,7 @@ class WP_Posts_List_Table extends WP_List_Table { post_type ) : + if ( 'page' === $screen->post_type ) : ?> @@ -966,7 +1547,7 @@ class WP_Posts_List_Table extends WP_List_Table { - post_type && $can_publish && current_user_can( $post_type_object->cap->edit_others_posts ) ) : ?> + post_type && $can_publish && current_user_can( $post_type_object->cap->edit_others_posts ) ) : ?> @@ -992,27 +1573,32 @@ class WP_Posts_List_Table extends WP_List_Table {
- post_type, 'post-formats' ) && current_theme_supports( 'post-formats' ) ) : + post_type, 'post-formats' ) ) { $post_formats = get_theme_support( 'post-formats' ); - if ( isset( $post_formats[0] ) && is_array( $post_formats[0] ) ) : - $all_post_formats = get_post_format_strings(); ?> -
- -
- - + + ?> + +
@@ -1022,22 +1608,48 @@ class WP_Posts_List_Table extends WP_List_Table { foreach ( $columns as $column_name => $column_display_name ) { if ( isset( $core_columns[$column_name] ) ) continue; - do_action( $bulk ? 'bulk_edit_custom_box' : 'quick_edit_custom_box', $column_name, $screen->post_type ); + + if ( $bulk ) { + + /** + * Fires once for each column in Bulk Edit mode. + * + * @since 2.7.0 + * + * @param string $column_name Name of the column to edit. + * @param WP_Post $post_type The post type slug. + */ + do_action( 'bulk_edit_custom_box', $column_name, $screen->post_type ); + } else { + + /** + * Fires once for each column in Quick Edit mode. + * + * @since 2.7.0 + * + * @param string $column_name Name of the column to edit. + * @param string $post_type The post type slug. + */ + do_action( 'quick_edit_custom_box', $column_name, $screen->post_type ); + } + } ?>

- + - - + + 's' ) ); + submit_button( __( 'Update' ), 'button-primary alignright', 'bulk_edit', false ); } ?> + post_type, 'author' ) ) { ?> + +

@@ -1050,5 +1662,3 @@ class WP_Posts_List_Table extends WP_List_Table {