months_dropdown( $this->screen->post_type );
-
- if ( is_object_in_taxonomy( $this->screen->post_type, 'category' ) ) {
- $dropdown_options = array(
- 'show_option_all' => __( 'View all categories' ),
- 'hide_empty' => 0,
- 'hierarchical' => 1,
- 'show_count' => 0,
- 'orderby' => 'name',
- 'selected' => $cat
- );
- wp_dropdown_categories( $dropdown_options );
+ $this->categories_dropdown( $this->screen->post_type );
+
+ /**
+ * 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.
+ * @since 4.6.0 The `$which` parameter was added.
+ *
+ * @param string $post_type The post type slug.
+ * @param string $which The location of the extra table nav markup:
+ * 'top' or 'bottom'.
+ */
+ do_action( 'restrict_manage_posts', $this->screen->post_type, $which );
+
+ $output = ob_get_clean();
+
+ if ( ! empty( $output ) ) {
+ echo $output;
+ submit_button( __( 'Filter' ), '', 'filter_action', false, array( 'id' => 'post-query-submit' ) );
}
- do_action( 'restrict_manage_posts' );
- submit_button( __( 'Filter' ), 'button', false, 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 ) ) {
@@ -225,29 +494,41 @@ class WP_Posts_List_Table extends WP_List_Table {
?>
screen->post_type ) )
- $this->view_switcher( $mode );
- }
-
- function get_table_classes() {
- return array( 'widefat', 'fixed', is_post_type_hierarchical( $this->screen->post_type ) ? '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() {
+ /**
+ *
+ * @return array
+ */
+ public function get_columns() {
$post_type = $this->screen->post_type;
$posts_columns = array();
@@ -257,21 +538,31 @@ 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' );
+ /**
+ * Filters 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 )
+ if ( 'category' === $taxonomy )
$column_key = 'categories';
- elseif ( 'post_tag' == $taxonomy )
+ elseif ( 'post_tag' === $taxonomy )
$column_key = 'tags';
else
$column_key = 'taxonomy-' . $taxonomy;
@@ -281,20 +572,50 @@ 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'] = '
- get_column_info();
+ $pad = str_repeat( '— ', $this->current_level );
+ echo "";
- foreach ( $columns as $column_name => $column_display_name ) {
- $class = "class=\"$column_name column-$column_name\"";
+ $format = get_post_format( $post->ID );
+ if ( $format ) {
+ $label = get_post_format_string( $format );
- $style = '';
- if ( in_array( $column_name, $hidden ) )
- $style = ' style="display:none;"';
+ $format_class = 'post-state-format post-format-icon post-format-' . $format;
- $attributes = "$class$style";
+ $format_args = array(
+ 'post_format' => $format,
+ 'post_type' => $post->post_type
+ );
- switch ( $column_name ) {
+ echo $this->get_edit_link( $format_args, $label . ':', $format_class );
+ }
- case 'cb':
- ?>
- |
-
-
-
-
-
- |
- 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
- $find_main_page = (int) $post->post_parent;
- while ( $find_main_page > 0 ) {
- $parent = get_post( $find_main_page );
-
- if ( is_null( $parent ) )
- break;
-
- $level++;
- $find_main_page = (int) $parent->post_parent;
-
- 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 );
- }
- }
- }
- }
+ if ( $can_edit_post && $post->post_status != 'trash' ) {
+ printf(
+ '%s%s',
+ get_edit_post_link( $post->ID ),
+ /* translators: %s: post title */
+ esc_attr( sprintf( __( '“%s” (Edit)' ), $title ) ),
+ $pad,
+ $title
+ );
+ } else {
+ echo $pad . $title;
+ }
+ _post_states( $post );
- $pad = str_repeat( '— ', $level );
- echo "";
+ 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";
- if ( $format = get_post_format( $post->ID ) ) {
- $label = get_post_format_string( $format );
+ if ( ! is_post_type_hierarchical( $this->screen->post_type ) && 'excerpt' === $mode && current_user_can( 'read_post', $post->ID ) ) {
+ the_excerpt();
+ }
- echo '' . $label . ": ";
- }
+ get_inline_data( $post );
+ }
- if ( $can_edit_post && $post->post_status != 'trash' ) {
- echo '' . $pad . $title . '';
- } else {
- echo $pad . $title;
- }
- _post_states( $post );
+ /**
+ * 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 ( isset( $parent_name ) )
- echo ' | ' . $post_type_object->labels->parent_item_colon . ' ' . esc_html( $parent_name );
+ 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 "\n";
+ $time_diff = time() - $time;
- if ( $can_edit_post && $post->post_status != 'trash' ) {
- if ( $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 = '';
- }
+ if ( $time_diff > 0 && $time_diff < DAY_IN_SECONDS ) {
+ $h_time = sprintf( __( '%s ago' ), human_time_diff( $time ) );
+ } else {
+ $h_time = mysql2date( __( 'Y/m/d' ), $m_time );
+ }
+ }
- echo ' ' . $locked_avatar . ' ' . $locked_text . " \n";
- }
+ 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 ) {
+ /**
+ * Filters 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 {
- if ( ! $this->hierarchical_display && 'excerpt' == $mode && current_user_can( 'read_post', $post->ID ) )
- the_excerpt();
+ /** 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 ) . '';
+ }
+ }
- $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 ( $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' ) . '';
+ /**
+ * 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;
}
+
+ $label = esc_html( sanitize_term_field( 'name', $t->name, $t->term_id, $taxonomy, 'display' ) );
+ $out[] = $this->get_edit_link( $posts_in_term_qv, $label );
}
+ /* translators: used between list items, there is a space after the comma */
+ echo join( __( ', ' ), $out );
+ } else {
+ echo '—' . $taxonomy_object->labels->no_terms . '';
+ }
+ return;
+ }
- $actions = apply_filters( is_post_type_hierarchical( $post->post_type ) ? 'page_row_actions' : 'post_row_actions', $actions, $post );
- echo $this->row_actions( $actions );
+ 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 {
- get_inline_data( $post );
- echo ' | ';
- break;
+ /**
+ * 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 );
+ }
- case 'date':
- 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 );
+ /**
+ * 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 );
+ }
- $time_diff = time() - $time;
+ /**
+ * @global WP_Post $post
+ *
+ * @param int|WP_Post $post
+ * @param int $level
+ */
+ public function single_row( $post, $level = 0 ) {
+ $global_post = get_post();
- if ( $time_diff > 0 && $time_diff < DAY_IN_SECONDS )
- $h_time = sprintf( __( '%s ago' ), human_time_diff( $time ) );
- else
- $h_time = mysql2date( __( 'Y/m/d' ), $m_time );
- }
+ $post = get_post( $post );
+ $this->current_level = $level;
- 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;
+ $GLOBALS['post'] = $post;
+ setup_postdata( $post );
- case 'comments':
- ?>
- >
- comment_pending_count[$post->ID] ) ? $this->comment_pending_count[$post->ID] : 0;
+ $classes = 'iedit author-' . ( get_current_user_id() == $post->post_author ? 'self' : 'other' );
- $this->comments_bubble( $post->ID, $pending_comments );
- ?>
- |
- ID );
+ if ( $lock_holder ) {
+ $classes .= ' wp-locked';
+ }
- 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()
- );
- ?> |
- ';
- if ( $terms = get_the_terms( $post->ID, $taxonomy ) ) {
- $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;
- }
-
- $out[] = sprintf( '%s',
- esc_url( add_query_arg( $posts_in_term_qv, 'edit.php' ) ),
- esc_html( sanitize_term_field( 'name', $t->name, $t->term_id, $taxonomy, 'display' ) )
- );
- }
- /* translators: used between list items, there is a space after the comma */
- echo join( __( ', ' ), $out );
- } else {
- echo '—';
- }
- echo '';
- break;
- }
- ?>
- >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 );
- ?> |
- 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();
+ $title = _draft_or_post_title();
+
+ if ( $can_edit_post && 'trash' != $post->post_status ) {
+ $actions['edit'] = sprintf(
+ '%s',
+ get_edit_post_link( $post->ID ),
+ /* translators: %s: post title */
+ esc_attr( sprintf( __( 'Edit “%s”' ), $title ) ),
+ __( 'Edit' )
+ );
+ $actions['inline hide-if-no-js'] = sprintf(
+ '%s',
+ /* translators: %s: post title */
+ esc_attr( sprintf( __( 'Quick edit “%s” inline' ), $title ) ),
+ __( 'Quick Edit' )
+ );
+ }
+
+ if ( current_user_can( 'delete_post', $post->ID ) ) {
+ if ( 'trash' === $post->post_status ) {
+ $actions['untrash'] = sprintf(
+ '%s',
+ wp_nonce_url( admin_url( sprintf( $post_type_object->_edit_link . '&action=untrash', $post->ID ) ), 'untrash-post_' . $post->ID ),
+ /* translators: %s: post title */
+ esc_attr( sprintf( __( 'Restore “%s” from the Trash' ), $title ) ),
+ __( 'Restore' )
+ );
+ } elseif ( EMPTY_TRASH_DAYS ) {
+ $actions['trash'] = sprintf(
+ '%s',
+ get_delete_post_link( $post->ID ),
+ /* translators: %s: post title */
+ esc_attr( sprintf( __( 'Move “%s” to the Trash' ), $title ) ),
+ _x( 'Trash', 'verb' )
+ );
+ }
+ if ( 'trash' === $post->post_status || ! EMPTY_TRASH_DAYS ) {
+ $actions['delete'] = sprintf(
+ '%s',
+ get_delete_post_link( $post->ID, '', true ),
+ /* translators: %s: post title */
+ esc_attr( sprintf( __( 'Delete “%s” permanently' ), $title ) ),
+ __( 'Delete Permanently' )
+ );
+ }
+ }
+
+ if ( is_post_type_viewable( $post_type_object ) ) {
+ if ( in_array( $post->post_status, array( 'pending', 'draft', 'future' ) ) ) {
+ if ( $can_edit_post ) {
+ $preview_link = get_preview_post_link( $post );
+ $actions['view'] = sprintf(
+ '%s',
+ esc_url( $preview_link ),
+ /* translators: %s: post title */
+ esc_attr( sprintf( __( 'Preview “%s”' ), $title ) ),
+ __( 'Preview' )
+ );
+ }
+ } elseif ( 'trash' != $post->post_status ) {
+ $actions['view'] = sprintf(
+ '%s',
+ get_permalink( $post->ID ),
+ /* translators: %s: post title */
+ esc_attr( sprintf( __( 'View “%s”' ), $title ) ),
+ __( 'View' )
+ );
+ }
+ }
+
+ if ( is_post_type_hierarchical( $post->post_type ) ) {
+
+ /**
+ * Filters 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 {
+
+ /**
+ * Filters 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 = $this->screen;
@@ -745,10 +1343,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;
+
+ /**
+ * Filters 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;
@@ -756,13 +1367,13 @@ 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 );
?>
-