X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/61343b82c4f0da4c68e4c6373daafff4a81efdd1..9e77185fafaf4e60e2b73821e0e4b9b1a11fb85f:/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 a798a2c2..5914aea9 100644 --- a/wp-admin/includes/class-wp-posts-list-table.php +++ b/wp-admin/includes/class-wp-posts-list-table.php @@ -16,7 +16,7 @@ class WP_Posts_List_Table extends WP_List_Table { * @var bool * @access protected */ - var $hierarchical_display; + protected $hierarchical_display; /** * Holds the number of pending comments for each post @@ -25,7 +25,7 @@ class WP_Posts_List_Table extends WP_List_Table { * @var int * @access protected */ - var $comment_pending_count; + protected $comment_pending_count; /** * Holds the number of posts for this user @@ -34,7 +34,7 @@ class WP_Posts_List_Table extends WP_List_Table { * @var int * @access private */ - var $user_posts_count; + private $user_posts_count; /** * Holds the number of posts which are sticky. @@ -43,9 +43,19 @@ class WP_Posts_List_Table extends WP_List_Table { * @var int * @access private */ - var $sticky_posts_count = 0; + private $sticky_posts_count = 0; - function __construct( $args = array() ) { + /** + * Constructor. + * + * @since 3.1.0 + * @access public + * + * @see WP_List_Table::__construct() for more information on default arguments. + * + * @param array $args An associative array of arguments. + */ + public function __construct( $args = array() ) { global $post_type_object, $wpdb; parent::__construct( array( @@ -57,9 +67,10 @@ class WP_Posts_List_Table extends WP_List_Table { $post_type_object = get_post_type_object( $post_type ); if ( !current_user_can( $post_type_object->cap->edit_others_posts ) ) { + $exclude_states = get_post_stati( array( 'show_in_admin_all_list' => false ) ); $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' ) + WHERE post_type = %s AND post_status NOT IN ( '" . implode( "','", $exclude_states ) . "' ) AND post_author = %d ", $post_type, get_current_user_id() ) ); @@ -69,15 +80,15 @@ class WP_Posts_List_Table extends WP_List_Table { 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 ) ); } } - function ajax_user_can() { + public function ajax_user_can() { return current_user_can( get_post_type_object( $this->screen->post_type )->cap->edit_posts ); } - function prepare_items() { + public function prepare_items() { global $avail_post_stati, $wp_query, $per_page, $mode; $avail_post_stati = wp_edit_posts_query(); @@ -88,6 +99,8 @@ class WP_Posts_List_Table extends WP_List_Table { $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 ) @@ -95,7 +108,12 @@ class WP_Posts_List_Table extends WP_List_Table { else $total_pages = $wp_query->max_num_pages; - $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'; @@ -106,18 +124,18 @@ class WP_Posts_List_Table extends WP_List_Table { ) ); } - function has_items() { + public function has_items() { return have_posts(); } - function no_items() { + 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 get_post_type_object( $this->screen->post_type )->labels->not_found; } - function get_views() { + protected function get_views() { global $locked_post_status, $avail_post_stati; $post_type = $this->screen->post_type; @@ -178,7 +196,7 @@ class WP_Posts_List_Table extends WP_List_Table { return $status_links; } - function get_bulk_actions() { + protected function get_bulk_actions() { $actions = array(); if ( $this->is_trash ) @@ -194,7 +212,7 @@ class WP_Posts_List_Table extends WP_List_Table { return $actions; } - function extra_tablenav( $which ) { + protected function extra_tablenav( $which ) { global $cat; ?>
@@ -214,8 +232,18 @@ class WP_Posts_List_Table extends WP_List_Table { ); wp_dropdown_categories( $dropdown_options ); } + + /** + * 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 + */ do_action( 'restrict_manage_posts' ); - submit_button( __( 'Filter' ), 'button', false, false, array( 'id' => 'post-query-submit' ) ); + + submit_button( __( 'Filter' ), 'button', 'filter_action', false, array( 'id' => 'post-query-submit' ) ); } if ( $this->is_trash && current_user_can( get_post_type_object( $this->screen->post_type )->cap->edit_others_posts ) ) { @@ -226,14 +254,14 @@ class WP_Posts_List_Table extends WP_List_Table { view_switcher( $mode ); } - function get_table_classes() { + protected function get_table_classes() { return array( 'widefat', 'fixed', is_post_type_hierarchical( $this->screen->post_type ) ? 'pages' : 'posts' ); } - function get_columns() { + public function get_columns() { $post_type = $this->screen->post_type; $posts_columns = array(); @@ -256,14 +284,24 @@ 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' ); - - $taxonomies = array(); + } $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' ); @@ -280,20 +318,48 @@ class WP_Posts_List_Table extends WP_List_Table { $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'] = '
'; + $posts_columns['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 ); + } + + /** + * 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. + */ $posts_columns = apply_filters( "manage_{$post_type}_posts_columns", $posts_columns ); return $posts_columns; } - function get_sortable_columns() { + protected function get_sortable_columns() { return array( 'title' => 'title', 'parent' => 'parent', @@ -302,7 +368,7 @@ class WP_Posts_List_Table extends WP_List_Table { ); } - function display_rows( $posts = array(), $level = 0 ) { + public function display_rows( $posts = array(), $level = 0 ) { global $wp_query, $per_page; if ( empty( $posts ) ) @@ -317,7 +383,7 @@ class WP_Posts_List_Table extends WP_List_Table { } } - function _display_rows( $posts, $level = 0 ) { + private function _display_rows( $posts, $level = 0 ) { global $mode; // Create array of post IDs. @@ -332,7 +398,7 @@ class WP_Posts_List_Table extends WP_List_Table { $this->single_row( $post, $level ); } - function _display_rows_hierarchical( $pages, $pagenum = 1, $per_page = 20 ) { + private function _display_rows_hierarchical( $pages, $pagenum = 1, $per_page = 20 ) { global $wpdb; $level = 0; @@ -345,7 +411,7 @@ class WP_Posts_List_Table extends WP_List_Table { } /* - * 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 @@ -358,7 +424,7 @@ 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 ) ); @@ -393,7 +459,7 @@ class WP_Posts_List_Table extends WP_List_Table { $this->_page_rows( $children_pages, $count, $page->ID, $level + 1, $pagenum, $per_page ); } - // 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 ) { @@ -417,14 +483,14 @@ class WP_Posts_List_Table extends WP_List_Table { * * @since 3.1.0 (Standalone function exists since 2.6.0) * - * @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 */ - function _page_rows( &$children_pages, &$count, $parent, $level, $pagenum, $per_page ) { + private function _page_rows( &$children_pages, &$count, $parent, $level, $pagenum, $per_page ) { if ( ! isset( $children_pages[$parent] ) ) return; @@ -469,7 +535,7 @@ class WP_Posts_List_Table extends WP_List_Table { unset( $children_pages[$parent] ); //required in order to keep track of orphans } - function single_row( $post, $level = 0 ) { + public function single_row( $post, $level = 0 ) { global $mode; static $alternate; @@ -490,8 +556,15 @@ class WP_Posts_List_Table extends WP_List_Table { $classes .= ' wp-locked'; $lock_holder = get_userdata( $lock_holder ); } + + if ( $post->post_parent ) { + $count = count( get_post_ancestors( $post->ID ) ); + $classes .= ' level-'. $count; + } else { + $classes .= ' level-0'; + } ?> - + get_column_info(); @@ -528,7 +601,7 @@ class WP_Posts_List_Table extends WP_List_Table { $attributes = 'class="post-title page-title column-title"' . $style; if ( $this->hierarchical_display ) { if ( 0 == $level && (int) $post->post_parent > 0 ) { - //sent level 0 by accident, by default, or because we don't know the actual level + // 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 ); @@ -539,8 +612,10 @@ class WP_Posts_List_Table extends WP_List_Table { $level++; $find_main_page = (int) $parent->post_parent; - if ( !isset( $parent_name ) ) + 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 ); + } } } } @@ -595,14 +670,49 @@ class WP_Posts_List_Table extends WP_List_Table { } if ( $post_type_object->public ) { if ( in_array( $post->post_status, array( 'pending', 'draft', 'future' ) ) ) { - if ( $can_edit_post ) - $actions['view'] = '' . __( 'Preview' ) . ''; + if ( $can_edit_post ) { + $preview_link = set_url_scheme( get_permalink( $post->ID ) ); + /** This filter is documented in wp-admin/includes/meta-boxes.php */ + $preview_link = apply_filters( 'preview_post_link', add_query_arg( 'preview', 'true', $preview_link ), $post ); + $actions['view'] = '' . __( 'Preview' ) . ''; + } } elseif ( 'trash' != $post->post_status ) { $actions['view'] = '' . __( 'View' ) . ''; } } - $actions = apply_filters( is_post_type_hierarchical( $post->post_type ) ? 'page_row_actions' : 'post_row_actions', $actions, $post ); + 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 ); + } + echo $this->row_actions( $actions ); get_inline_data( $post ); @@ -627,10 +737,28 @@ class WP_Posts_List_Table extends WP_List_Table { } echo ''; - if ( 'excerpt' == $mode ) + 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 array $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, $column_name, $mode ); - else + } 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, $column_name, $mode ) . ''; + } echo '
'; if ( 'publish' == $post->post_status ) { _e( 'Published' ); @@ -709,10 +837,46 @@ class WP_Posts_List_Table extends WP_List_Table { } ?> >post_type ) ) + 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 + } else { + + /** + * Fires in each custom column in the Posts list table. + * + * This hook only fires if the current post type is non-hierarchical, + * such as posts. + * + * @since 1.5.0 + * + * @param string $column_name The name of the column to display. + * @param int $post_id The current post ID. + */ do_action( 'manage_posts_custom_column', $column_name, $post->ID ); + } + + /** + * Fires for each custom column of a specific post type in the Posts list table. + * + * The dynamic portion of the hook name, $post->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 ); ?> screen; @@ -829,7 +993,7 @@ class WP_Posts_List_Table extends WP_List_Table {
@@ -896,7 +1060,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 ); ?> @@ -1034,6 +1209,34 @@ class WP_Posts_List_Table extends WP_List_Table {
+ + post_type, 'post-formats' ) ) { + $post_formats = get_theme_support( 'post-formats' ); + + ?> + + +
$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 WP_Post $post_type The post type slug. + */ + do_action( 'quick_edit_custom_box', $column_name, $screen->post_type ); + } + } ?>

@@ -1057,6 +1284,9 @@ class WP_Posts_List_Table extends WP_List_Table { } ?> + post_type, 'author' ) ) { ?> + +