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 );
+ }
+
}
?>