enmi-conf.org: comparison wp/wp-admin/includes/class-wp-posts-list-table.php

equal deleted inserted replaced

-:34716fd837a4
+:be944660c56a
 		);
 		$post_type        = $this->screen->post_type;
 		$post_type_object = get_post_type_object( $post_type );
-		$exclude_states         = get_post_stati(
+		$exclude_states = get_post_stati(
 			array(
 				'show_in_admin_all_list' => false,
 			)
 		);
-		$this->user_posts_count = intval(
-			$wpdb->get_var(
+		$this->user_posts_count = (int) $wpdb->get_var(
-				$wpdb->prepare(
+			$wpdb->prepare(
-					"
+				"SELECT COUNT( 1 )
-			SELECT COUNT( 1 )
+				FROM $wpdb->posts
-			FROM $wpdb->posts
+				WHERE post_type = %s
-			WHERE post_type = %s
+				AND post_status NOT IN ( '" . implode( "','", $exclude_states ) . "' )
-			AND post_status NOT IN ( '" . implode( "','", $exclude_states ) . "' )
+				AND post_author = %d",
-			AND post_author = %d
+				$post_type,
-		",
+				get_current_user_id()
-					$post_type,
-					get_current_user_id()
-				)
 			)
 		);
-		if ( $this->user_posts_count && ! current_user_can( $post_type_object->cap->edit_others_posts ) && empty( $_REQUEST['post_status'] ) && empty( $_REQUEST['all_posts'] ) && empty( $_REQUEST['author'] ) && empty( $_REQUEST['show_sticky'] ) ) {
+		if ( $this->user_posts_count
+			&& ! current_user_can( $post_type_object->cap->edit_others_posts )
+			&& empty( $_REQUEST['post_status'] ) && empty( $_REQUEST['all_posts'] )
+			&& empty( $_REQUEST['author'] ) && empty( $_REQUEST['show_sticky'] )
+		) {
 			$_GET['author'] = get_current_user_id();
 		}
 		$sticky_posts = get_option( 'sticky_posts' );
 		if ( 'post' === $post_type && $sticky_posts ) {
-			$sticky_posts             = implode( ', ', array_map( 'absint', (array) $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 NOT IN ('trash', 'auto-draft') AND ID IN ($sticky_posts)", $post_type ) );
+			$this->sticky_posts_count = (int) $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
+				)
+			);
 		}
 	}
 	/**
 	 * Sets whether the table layout should be hierarchical or not.
 		}
 		// Is going to call wp().
 		$avail_post_stati = wp_edit_posts_query();
-		$this->set_hierarchical_display( is_post_type_hierarchical( $this->screen->post_type ) && 'menu_order title' === $wp_query->query['orderby'] );
+		$this->set_hierarchical_display(
+			is_post_type_hierarchical( $this->screen->post_type )
+			&& 'menu_order title' === $wp_query->query['orderby']
+		);
 		$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 */
 			if ( isset( $_REQUEST['post_status'] ) && in_array( $_REQUEST['post_status'], $avail_post_stati, true ) ) {
 				$total_items = $post_counts[ $_REQUEST['post_status'] ];
 			} elseif ( isset( $_REQUEST['show_sticky'] ) && $_REQUEST['show_sticky'] ) {
 				$total_items = $this->sticky_posts_count;
-			} elseif ( isset( $_GET['author'] ) && get_current_user_id() == $_GET['author'] ) {
+			} elseif ( isset( $_GET['author'] ) && get_current_user_id() === (int) $_GET['author'] ) {
 				$total_items = $this->user_posts_count;
 			} else {
 				$total_items = array_sum( $post_counts );
 				// Subtract post types that are not included in the admin all list.
 	protected function get_edit_link( $args, $label, $class = '' ) {
 		$url = add_query_arg( $args, 'edit.php' );
 		$class_html   = '';
 		$aria_current = '';
 		if ( ! empty( $class ) ) {
 			$class_html = sprintf(
 				' class="%s"',
 				esc_attr( $class )
 			);
 		foreach ( get_post_stati( array( 'show_in_admin_all_list' => false ) ) as $state ) {
 			$total_posts -= $num_posts->$state;
 		}
 		if ( $this->user_posts_count && $this->user_posts_count !== $total_posts ) {
-			if ( isset( $_GET['author'] ) && ( $_GET['author'] == $current_user_id ) ) {
+			if ( isset( $_GET['author'] ) && ( $current_user_id === (int) $_GET['author'] ) ) {
 				$class = 'current';
 			}
 			$mine_args = array(
 				'post_type' => $post_type,
 			),
 			number_format_i18n( $total_posts )
 		);
 		$status_links['all'] = $this->get_edit_link( $all_args, $all_inner_html, $class );
 		if ( $mine ) {
 			$status_links['mine'] = $mine;
 		}
 		foreach ( get_post_stati( array( 'show_in_admin_status_list' => true ), 'objects' ) as $status ) {
 				'show_count'      => 0,
 				'orderby'         => 'name',
 				'selected'        => $cat,
 			);
-			echo '<label class="screen-reader-text" for="cat">' . __( 'Filter by category' ) . '</label>';
+			echo '<label class="screen-reader-text" for="cat">' . get_taxonomy( 'category' )->labels->filter_by_item . '</label>';
 			wp_dropdown_categories( $dropdown_options );
 		}
 	}
 	/**
 			foreach ( $used_post_formats as $used_post_format ) {
 				// Post format slug.
 				$slug = str_replace( 'post-format-', '', $used_post_format->slug );
 				// Pretty, translated version of the post format slug.
 				$pretty_name = get_post_format_string( $slug );
 				// Skip the standard post format.
 				if ( 'standard' === $slug ) {
 					continue;
 				}
 				?>
 				echo $output;
 				submit_button( __( 'Filter' ), '', '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 ) && $this->has_items() ) {
+		if ( $this->is_trash && $this->has_items()
+			&& current_user_can( get_post_type_object( $this->screen->post_type )->cap->edit_others_posts )
+		) {
 			submit_button( __( 'Empty Trash' ), 'apply', 'delete_all', false );
 		}
 		?>
 		</div>
 		<?php
 	protected function get_table_classes() {
 		global $mode;
 		$mode_class = esc_attr( 'table-view-' . $mode );
-		return array( 'widefat', 'fixed', 'striped', $mode_class, is_post_type_hierarchical( $this->screen->post_type ) ? 'pages' : 'posts' );
+		return array(
+			'widefat',
+			'fixed',
+			'striped',
+			$mode_class,
+			is_post_type_hierarchical( $this->screen->post_type ) ? 'pages' : 'posts',
+		);
 	}
 	/**
 	 * @return array
 	 */
 		/**
 		 * Filters the taxonomy columns in the Posts list table.
 		 *
 		 * The dynamic portion of the hook name, `$post_type`, refers to the post
 		 * type slug.
+		 *
+		 * Possible hook names include:
+		 *
+		 *  - `manage_taxonomies_for_post_columns`
+		 *  - `manage_taxonomies_for_page_columns`
 		 *
 		 * @since 3.5.0
 		 *
 		 * @param string[] $taxonomies Array of taxonomy names to show columns for.
 		 * @param string   $post_type  The post type.
 			$posts_columns[ $column_key ] = get_taxonomy( $taxonomy )->labels->name;
 		}
 		$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' ), true ) ) {
-			$posts_columns['comments'] = '<span class="vers comment-grey-bubble" title="' . esc_attr__( 'Comments' ) . '"><span class="screen-reader-text">' . __( 'Comments' ) . '</span></span>';
+		if ( post_type_supports( $post_type, 'comments' )
+			&& ! in_array( $post_status, array( 'pending', 'draft', 'future' ), true )
+		) {
+			$posts_columns['comments'] = sprintf(
+				'<span class="vers comment-grey-bubble" title="%1$s"><span class="screen-reader-text">%2$s</span></span>',
+				esc_attr__( 'Comments' ),
+				__( 'Comments' )
+			);
 		}
 		$posts_columns['date'] = __( 'Date' );
 		if ( 'page' === $post_type ) {
 		/**
 		 * Filters 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.
 		 *
+		 * Possible hook names include:
+		 *
+		 *  - `manage_post_posts_columns`
+		 *  - `manage_page_posts_columns`
+		 *
 		 * @since 3.0.0
 		 *
 		 * @param string[] $post_columns An associative array of column headings.
 		 */
 		return apply_filters( "manage_{$post_type}_posts_columns", $posts_columns );
 		 * 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
 		 * If searching, ignore hierarchy and treat everything as top level
 		 */
 		if ( empty( $_REQUEST['s'] ) ) {
 			$top_level_pages = array();
 			$children_pages  = array();
 			foreach ( $pages as $page ) {
 				// Catch and repair bad pages.
-				if ( $page->post_parent == $page->ID ) {
+				if ( $page->post_parent === $page->ID ) {
 					$page->post_parent = 0;
 					$wpdb->update( $wpdb->posts, array( 'post_parent' => 0 ), array( 'ID' => $page->ID ) );
 					clean_post_cache( $page );
 				}
-				if ( 0 == $page->post_parent ) {
+				if ( $page->post_parent > 0 ) {
+					$children_pages[ $page->post_parent ][] = $page;
+				} else {
 					$top_level_pages[] = $page;
-				} else {
-					$children_pages[ $page->post_parent ][] = $page;
 				}
 			}
 			$pages = &$top_level_pages;
 		}
 			if ( $count >= $end ) {
 				break;
 			}
 			// If the page starts in a subtree, print the parents.
-			if ( $count == $start && $page->post_parent > 0 ) {
+			if ( $count === $start && $page->post_parent > 0 ) {
 				$my_parents = array();
 				$my_parent  = $page->post_parent;
 				while ( $my_parent ) {
 					// Get the ID from the list or the attribute if my_parent is an object.
 					$parent_id = $my_parent;
 					if ( is_object( $my_parent ) ) {
 						$parent_id = $my_parent->ID;
 					}
 					$my_parent    = get_post( $parent_id );
 					$my_parents[] = $my_parent;
 					if ( ! $my_parent->post_parent ) {
 						break;
 					}
 					$my_parent = $my_parent->post_parent;
 				}
 				$num_parents = count( $my_parents );
 				while ( $my_parent = array_pop( $my_parents ) ) {
 					$to_display[ $my_parent->ID ] = $level - $num_parents;
 					$num_parents--;
 				}
 			}
 	 * @since 4.3.0
 	 *
 	 * @param WP_Post $post The current WP_Post object.
 	 */
 	public function column_cb( $post ) {
-		if ( current_user_can( 'edit_post', $post->ID ) ) :
+		$show = current_user_can( 'edit_post', $post->ID );
+		/**
+		 * Filters whether to show the bulk edit checkbox for a post in its list table.
+		 *
+		 * By default the checkbox is only shown if the current user can edit the post.
+		 *
+		 * @since 5.7.0
+		 *
+		 * @param bool    $show Whether to show the checkbox.
+		 * @param WP_Post $post The current WP_Post object.
+		 */
+		if ( apply_filters( 'wp_list_table_show_post_checkbox', $show, $post ) ) :
 			?>
 			<label class="screen-reader-text" for="cb-select-<?php the_ID(); ?>">
 				<?php
 					/* translators: %s: Post title. */
 					printf( __( 'Select %s' ), _draft_or_post_title() );
 		if ( $this->hierarchical_display ) {
 			if ( 0 === $this->current_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;
 		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 "</strong>\n";
 		if ( 'excerpt' === $mode
 			&& ! is_post_type_hierarchical( $this->screen->post_type )
 			&& current_user_can( 'read_post', $post->ID )
 			$time_diff = 0;
 		} else {
 			$t_time = sprintf(
 				/* translators: 1: Post date, 2: Post time. */
 				__( '%1$s at %2$s' ),
-				/* translators: Post date format. See https://www.php.net/date */
+				/* translators: Post date format. See https://www.php.net/manual/datetime.format.php */
 				get_the_time( __( 'Y/m/d' ), $post ),
-				/* translators: Post time format. See https://www.php.net/date */
+				/* translators: Post time format. See https://www.php.net/manual/datetime.format.php */
 				get_the_time( __( 'g:i a' ), $post )
 			);
 			$time      = get_post_timestamp( $post );
 			$time_diff = time() - $time;
 		} 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 ) ) {
 				$term_links = 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;
 				 * @param WP_Term[] $terms      Array of term objects appearing in the post row.
 				 */
 				$term_links = apply_filters( 'post_column_taxonomy_links', $term_links, $taxonomy, $terms );
 				/* translators: Used between list items, there is a space after the comma. */
-				echo join( __( ', ' ), $term_links );
+				echo implode( __( ', ' ), $term_links );
 			} else {
 				echo '<span aria-hidden="true">&#8212;</span><span class="screen-reader-text">' . $taxonomy_object->labels->no_terms . '</span>';
 			}
 			return;
 		}
 		/**
 		 * 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.
 		 *
+		 * Possible hook names include:
+		 *
+		 *  - `manage_post_posts_custom_column`
+		 *  - `manage_page_posts_custom_column`
+		 *
 		 * @since 3.1.0
 		 *
 		 * @param string $column_name The name of the column to display.
 		 * @param int    $post_id     The current post ID.
 		 */
 		$this->current_level = $level;
 		$GLOBALS['post'] = $post;
 		setup_postdata( $post );
-		$classes = 'iedit author-' . ( get_current_user_id() == $post->post_author ? 'self' : 'other' );
+		$classes = 'iedit author-' . ( get_current_user_id() === (int) $post->post_author ? 'self' : 'other' );
 		$lock_holder = wp_check_post_lock( $post->ID );
 		if ( $lock_holder ) {
 			$classes .= ' wp-locked';
 		}
 		if ( $post->post_parent ) {
 	/**
 	 * Generates and displays row action links.
 	 *
 	 * @since 4.3.0
 	 *
-	 * @param object $post        Post being acted upon.
+	 * @param WP_Post $post        Post being acted upon.
-	 * @param string $column_name Current column name.
+	 * @param string  $column_name Current column name.
-	 * @param string $primary     Primary column name.
+	 * @param string  $primary     Primary column name.
 	 * @return string Row actions output for posts, or an empty string
 	 *                if the current column is not the primary column.
 	 */
 	protected function handle_row_actions( $post, $column_name, $primary ) {
 		if ( $primary !== $column_name ) {
 					/* translators: %s: Post title. */
 					esc_attr( sprintf( __( 'Move &#8220;%s&#8221; to the Trash' ), $title ) ),
 					_x( 'Trash', 'verb' )
 				);
 			}
 			if ( 'trash' === $post->post_status || ! EMPTY_TRASH_DAYS ) {
 				$actions['delete'] = sprintf(
 					'<a href="%s" class="submitdelete" aria-label="%s">%s</a>',
 					get_delete_post_link( $post->ID, '', true ),
 					/* translators: %s: Post title. */
 		$taxonomy_names          = get_object_taxonomies( $screen->post_type );
 		$hierarchical_taxonomies = array();
 		$flat_taxonomies         = array();
 		foreach ( $taxonomy_names as $taxonomy_name ) {
 			$taxonomy = get_taxonomy( $taxonomy_name );
 			$show_in_quick_edit = $taxonomy->show_in_quick_edit;
 			/**
 			'categories' => true,
 			'tags'       => true,
 			'comments'   => true,
 			'author'     => true,
 		);
 		?>
 		<form method="get">
 		<table style="display: none"><tbody id="inlineedit">
 		<?php
 		$inline_edit_classes = "inline-edit-row inline-edit-row-$hclass";
 		$bulk_edit_classes   = "bulk-edit-row bulk-edit-row-$hclass bulk-edit-{$screen->post_type}";
 		$quick_edit_classes  = "quick-edit-row quick-edit-row-$hclass inline-edit-{$screen->post_type}";
 		$bulk = 0;
 		while ( $bulk < 2 ) :
 			$classes  = $inline_edit_classes . ' ';
 			$classes .= $bulk ? $bulk_edit_classes : $quick_edit_classes;
 			?>
 			<tr id="<?php echo $bulk ? 'bulk-edit' : 'inline-edit'; ?>" class="<?php echo $classes; ?>" style="display: none">
 					</fieldset>
 					<br class="clear" />
 				<?php endif; // $bulk ?>
 				<?php
-				if ( post_type_supports( $screen->post_type, 'author' ) ) :
+				if ( post_type_supports( $screen->post_type, 'author' ) ) {
 					$authors_dropdown = '';
-					if ( current_user_can( $post_type_object->cap->edit_others_posts ) ) :
+					if ( current_user_can( $post_type_object->cap->edit_others_posts ) ) {
 						$users_opt = array(
 							'hide_if_only_one_author' => false,
 							'who'                     => 'authors',
 							'name'                    => 'post_author',
 							'class'                   => 'authors',
 						if ( $bulk ) {
 							$users_opt['show_option_none'] = __( '&mdash; No Change &mdash;' );
 						}
+						/**
+						 * Filters the arguments used to generate the Quick Edit authors drop-down.
+						 *
+						 * @since 5.6.0
+						 *
+						 * @see wp_dropdown_users()
+						 *
+						 * @param array $users_opt An array of arguments passed to wp_dropdown_users().
+						 * @param bool  $bulk      A flag to denote if it's a bulk action.
+						 */
+						$users_opt = apply_filters( 'quick_edit_dropdown_authors_args', $users_opt, $bulk );
 						$authors = wp_dropdown_users( $users_opt );
-						if ( $authors ) :
+						if ( $authors ) {
 							$authors_dropdown  = '<label class="inline-edit-author">';
 							$authors_dropdown .= '<span class="title">' . __( 'Author' ) . '</span>';
 							$authors_dropdown .= $authors;
 							$authors_dropdown .= '</label>';
-						endif;
+						}
-					endif; // current_user_can( 'edit_others_posts' )
+					} // current_user_can( 'edit_others_posts' )
-					?>
-					<?php
 					if ( ! $bulk ) {
 						echo $authors_dropdown;
 					}
-				endif; // post_type_supports( ... 'author' )
+				} // post_type_supports( ... 'author' )
 				?>
 				<?php if ( ! $bulk && $can_publish ) : ?>
 					<div class="inline-edit-group wp-clearfix">
 							/**
 							 * Filters the arguments used to generate the Quick Edit page-parent drop-down.
 							 *
 							 * @since 2.7.0
+							 * @since 5.6.0 The `$bulk` parameter was added.
 							 *
 							 * @see wp_dropdown_pages()
 							 *
-							 * @param array $dropdown_args An array of arguments.
+							 * @param array $dropdown_args An array of arguments passed to wp_dropdown_pages().
+							 * @param bool  $bulk          A flag to denote if it's a bulk action.
 							 */
-							$dropdown_args = apply_filters( 'quick_edit_dropdown_pages_args', $dropdown_args );
+							$dropdown_args = apply_filters( 'quick_edit_dropdown_pages_args', $dropdown_args, $bulk );
 							wp_dropdown_pages( $dropdown_args );
 							?>
 						</label>

changeset 18	be944660c56a
parent 16	a86126ab1dd4
child 19	3d72ae0968f4