X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/fa11948979fd6a4ea5705dc613b239699a459db3..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 016a726b..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( @@ -74,11 +84,11 @@ class WP_Posts_List_Table extends WP_List_Table { } } - 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(); @@ -89,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 ) @@ -96,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'; @@ -107,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; @@ -179,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 ) @@ -195,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; ?>
@@ -215,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 ) ) { @@ -227,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(); @@ -257,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' ); @@ -281,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', @@ -303,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 ) ) @@ -318,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. @@ -333,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; @@ -346,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 @@ -359,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 ) ); @@ -394,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 ) { @@ -425,7 +490,7 @@ class WP_Posts_List_Table extends WP_List_Table { * @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; @@ -470,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; @@ -491,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(); @@ -529,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 ); @@ -598,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 ); @@ -630,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' ); @@ -712,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; @@ -832,7 +993,7 @@ class WP_Posts_List_Table extends WP_List_Table {
@@ -899,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 ); ?> @@ -1040,19 +1212,20 @@ class WP_Posts_List_Table extends WP_List_Table { post_type, 'post-formats' ) ) { - $all_post_formats = get_post_format_strings(); + if ( $bulk && current_theme_supports( 'post-formats' ) && post_type_supports( $screen->post_type, 'post-formats' ) ) { + $post_formats = get_theme_support( 'post-formats' ); ?>