X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/6d3aa5fe58b2f91735fe04e94a2c12b7dd9adb09..888fa4ed68091f3314f711c5f6fe75858bf5410b:/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 50054111..1e763f2f 100644
--- a/wp-admin/includes/class-wp-posts-list-table.php
+++ b/wp-admin/includes/class-wp-posts-list-table.php
@@ -89,6 +89,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 )
@@ -215,7 +217,17 @@ 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' ) );
}
@@ -265,6 +277,17 @@ class WP_Posts_List_Table extends WP_List_Table {
$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,14 +304,42 @@ 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;
@@ -346,7 +397,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
@@ -499,7 +550,7 @@ class WP_Posts_List_Table extends WP_List_Table {
$classes .= ' level-0';
}
?>
-
+
get_column_info();
@@ -605,14 +656,48 @@ 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 )
+ if ( $can_edit_post ) {
+
+ /** This filter is documented in wp-admin/includes/meta-boxes.php */
$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 );
@@ -637,10 +722,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' );
@@ -719,10 +822,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 );
?>