enmi-conf.org: comparison wp/wp-includes/post.php

equal deleted inserted replaced

-:be944660c56a
+:3d72ae0968f4
 * See {@see 'init'}.
 *
 * @since 2.9.0
 */
 function create_initial_post_types() {
+	WP_Post_Type::reset_default_labels();
 	register_post_type(
 		'post',
 		array(
 			'labels'                => array(
 				'name_admin_bar' => _x( 'Post', 'add new from admin bar' ),
 	);
 	register_post_type(
 		'nav_menu_item',
 		array(
-			'labels'           => array(
+			'labels'                => array(
 				'name'          => __( 'Navigation Menu Items' ),
 				'singular_name' => __( 'Navigation Menu Item' ),
 			),
-			'public'           => false,
+			'public'                => false,
-			'_builtin'         => true, /* internal use only. don't use this when registering your own post type. */
+			'_builtin'              => true, /* internal use only. don't use this when registering your own post type. */
-			'hierarchical'     => false,
+			'hierarchical'          => false,
-			'rewrite'          => false,
+			'rewrite'               => false,
-			'delete_with_user' => false,
+			'delete_with_user'      => false,
-			'query_var'        => false,
+			'query_var'             => false,
+			'map_meta_cap'          => true,
+			'capability_type'       => array( 'edit_theme_options', 'edit_theme_options' ),
+			'capabilities'          => array(
+				// Meta Capabilities.
+				'edit_post'              => 'edit_post',
+				'read_post'              => 'read_post',
+				'delete_post'            => 'delete_post',
+				// Primitive Capabilities.
+				'edit_posts'             => 'edit_theme_options',
+				'edit_others_posts'      => 'edit_theme_options',
+				'delete_posts'           => 'edit_theme_options',
+				'publish_posts'          => 'edit_theme_options',
+				'read_private_posts'     => 'edit_theme_options',
+				'read'                   => 'read',
+				'delete_private_posts'   => 'edit_theme_options',
+				'delete_published_posts' => 'edit_theme_options',
+				'delete_others_posts'    => 'edit_theme_options',
+				'edit_private_posts'     => 'edit_theme_options',
+				'edit_published_posts'   => 'edit_theme_options',
+			),
+			'show_in_rest'          => true,
+			'rest_base'             => 'menu-items',
+			'rest_controller_class' => 'WP_REST_Menu_Items_Controller',
 		)
 	);
 	register_post_type(
 		'custom_css',
 	register_post_type(
 		'wp_template',
 		array(
 			'labels'                => array(
-				'name'                  => __( 'Templates' ),
+				'name'                  => _x( 'Templates', 'post type general name' ),
-				'singular_name'         => __( 'Template' ),
+				'singular_name'         => _x( 'Template', 'post type singular name' ),
 				'add_new'               => _x( 'Add New', 'Template' ),
 				'add_new_item'          => __( 'Add New Template' ),
 				'new_item'              => __( 'New Template' ),
 				'edit_item'             => __( 'Edit Template' ),
 				'view_item'             => __( 'View Template' ),
-				'all_items'             => __( 'All Templates' ),
+				'all_items'             => __( 'Templates' ),
 				'search_items'          => __( 'Search Templates' ),
 				'parent_item_colon'     => __( 'Parent Template:' ),
 				'not_found'             => __( 'No templates found.' ),
 				'not_found_in_trash'    => __( 'No templates found in Trash.' ),
 				'archives'              => __( 'Template archives' ),
 				'title',
 				'slug',
 				'excerpt',
 				'editor',
 				'revisions',
+				'author',
+			),
+		)
+	);
+	register_post_type(
+		'wp_template_part',
+		array(
+			'labels'                => array(
+				'name'                  => _x( 'Template Parts', 'post type general name' ),
+				'singular_name'         => _x( 'Template Part', 'post type singular name' ),
+				'add_new'               => _x( 'Add New', 'Template Part' ),
+				'add_new_item'          => __( 'Add New Template Part' ),
+				'new_item'              => __( 'New Template Part' ),
+				'edit_item'             => __( 'Edit Template Part' ),
+				'view_item'             => __( 'View Template Part' ),
+				'all_items'             => __( 'Template Parts' ),
+				'search_items'          => __( 'Search Template Parts' ),
+				'parent_item_colon'     => __( 'Parent Template Part:' ),
+				'not_found'             => __( 'No template parts found.' ),
+				'not_found_in_trash'    => __( 'No template parts found in Trash.' ),
+				'archives'              => __( 'Template part archives' ),
+				'insert_into_item'      => __( 'Insert into template part' ),
+				'uploaded_to_this_item' => __( 'Uploaded to this template part' ),
+				'filter_items_list'     => __( 'Filter template parts list' ),
+				'items_list_navigation' => __( 'Template parts list navigation' ),
+				'items_list'            => __( 'Template parts list' ),
+			),
+			'description'           => __( 'Template parts to include in your templates.' ),
+			'public'                => false,
+			'_builtin'              => true, /* internal use only. don't use this when registering your own post type. */
+			'has_archive'           => false,
+			'show_ui'               => false,
+			'show_in_menu'          => false,
+			'show_in_rest'          => true,
+			'rewrite'               => false,
+			'rest_base'             => 'template-parts',
+			'rest_controller_class' => 'WP_REST_Templates_Controller',
+			'map_meta_cap'          => true,
+			'capabilities'          => array(
+				'create_posts'           => 'edit_theme_options',
+				'delete_posts'           => 'edit_theme_options',
+				'delete_others_posts'    => 'edit_theme_options',
+				'delete_private_posts'   => 'edit_theme_options',
+				'delete_published_posts' => 'edit_theme_options',
+				'edit_posts'             => 'edit_theme_options',
+				'edit_others_posts'      => 'edit_theme_options',
+				'edit_private_posts'     => 'edit_theme_options',
+				'edit_published_posts'   => 'edit_theme_options',
+				'publish_posts'          => 'edit_theme_options',
+				'read'                   => 'edit_theme_options',
+				'read_private_posts'     => 'edit_theme_options',
+			),
+			'supports'              => array(
+				'title',
+				'slug',
+				'excerpt',
+				'editor',
+				'revisions',
+				'author',
+			),
+		)
+	);
+	register_post_type(
+		'wp_global_styles',
+		array(
+			'label'        => _x( 'Global Styles', 'post type general name' ),
+			'description'  => __( 'Global styles to include in themes.' ),
+			'public'       => false,
+			'_builtin'     => true, /* internal use only. don't use this when registering your own post type. */
+			'show_ui'      => false,
+			'show_in_rest' => false,
+			'rewrite'      => false,
+			'capabilities' => array(
+				'read'                   => 'edit_theme_options',
+				'create_posts'           => 'edit_theme_options',
+				'edit_posts'             => 'edit_theme_options',
+				'edit_published_posts'   => 'edit_theme_options',
+				'delete_published_posts' => 'edit_theme_options',
+				'edit_others_posts'      => 'edit_theme_options',
+				'delete_others_posts'    => 'edit_theme_options',
+			),
+			'map_meta_cap' => true,
+			'supports'     => array(
+				'title',
+				'editor',
+				'revisions',
+			),
+		)
+	);
+	register_post_type(
+		'wp_navigation',
+		array(
+			'labels'                => array(
+				'name'                  => _x( 'Navigation Menus', 'post type general name' ),
+				'singular_name'         => _x( 'Navigation Menu', 'post type singular name' ),
+				'add_new'               => _x( 'Add New', 'Navigation Menu' ),
+				'add_new_item'          => __( 'Add New Navigation Menu' ),
+				'new_item'              => __( 'New Navigation Menu' ),
+				'edit_item'             => __( 'Edit Navigation Menu' ),
+				'view_item'             => __( 'View Navigation Menu' ),
+				'all_items'             => __( 'Navigation Menus' ),
+				'search_items'          => __( 'Search Navigation Menus' ),
+				'parent_item_colon'     => __( 'Parent Navigation Menu:' ),
+				'not_found'             => __( 'No Navigation Menu found.' ),
+				'not_found_in_trash'    => __( 'No Navigation Menu found in Trash.' ),
+				'archives'              => __( 'Navigation Menu archives' ),
+				'insert_into_item'      => __( 'Insert into Navigation Menu' ),
+				'uploaded_to_this_item' => __( 'Uploaded to this Navigation Menu' ),
+				'filter_items_list'     => __( 'Filter Navigation Menu list' ),
+				'items_list_navigation' => __( 'Navigation Menus list navigation' ),
+				'items_list'            => __( 'Navigation Menus list' ),
+			),
+			'description'           => __( 'Navigation menus that can be inserted into your site.' ),
+			'public'                => false,
+			'_builtin'              => true, /* internal use only. don't use this when registering your own post type. */
+			'has_archive'           => false,
+			'show_ui'               => true,
+			'show_in_menu'          => false,
+			'show_in_admin_bar'     => false,
+			'show_in_rest'          => true,
+			'rewrite'               => false,
+			'map_meta_cap'          => true,
+			'capabilities'          => array(
+				'edit_others_posts'      => 'edit_theme_options',
+				'delete_posts'           => 'edit_theme_options',
+				'publish_posts'          => 'edit_theme_options',
+				'create_posts'           => 'edit_theme_options',
+				'read_private_posts'     => 'edit_theme_options',
+				'delete_private_posts'   => 'edit_theme_options',
+				'delete_published_posts' => 'edit_theme_options',
+				'delete_others_posts'    => 'edit_theme_options',
+				'edit_private_posts'     => 'edit_theme_options',
+				'edit_published_posts'   => 'edit_theme_options',
+				'edit_posts'             => 'edit_theme_options',
+			),
+			'rest_base'             => 'navigation',
+			'rest_controller_class' => 'WP_REST_Posts_Controller',
+			'supports'              => array(
+				'title',
+				'editor',
+				'revisions',
 			),
 		)
 	);
 	register_post_status(
 *
 * @since 1.5.1
 *
 * @global WP_Post $post Global post object.
 *
-* @param int|WP_Post|null $post   Optional. Post ID or post object. `null`, `false`, `0` and other PHP falsey
+* @param int|WP_Post|null $post   Optional. Post ID or post object. `null`, `false`, `0` and other PHP falsey values
-*                                 values return the current global post inside the loop. A numerically valid post
+*                                 return the current global post inside the loop. A numerically valid post ID that
-*                                 ID that points to a non-existent post returns `null`. Defaults to global $post.
+*                                 points to a non-existent post returns `null`. Defaults to global $post.
 * @param string           $output Optional. The required return type. One of OBJECT, ARRAY_A, or ARRAY_N, which
 *                                 correspond to a WP_Post object, an associative array, or a numeric array,
 *                                 respectively. Default OBJECT.
 * @param string           $filter Optional. Type of filter to apply. Accepts 'raw', 'edit', 'db',
 *                                 or 'display'. Default 'raw'.
 * If the post ID is of an attachment, then the parent post status will be given
 * instead.
 *
 * @since 2.0.0
 *
-* @param int|WP_Post $post Optional. Post ID or post object. Defaults to global $post..
+* @param int|WP_Post $post Optional. Post ID or post object. Defaults to global $post.
 * @return string|false Post status on success, false on failure.
 */
 function get_post_status( $post = null ) {
 	$post = get_post( $post );
 *
 * Arguments prefixed with an _underscore shouldn't be used by plugins and themes.
 *
 * @since 3.0.0
 *
-* @global array $wp_post_statuses Inserts new post status object into the list
+* @global stdClass[] $wp_post_statuses Inserts new post status object into the list
 *
 * @param string       $post_status Name of the post status.
 * @param array|string $args {
 *     Optional. Array or string of post status arguments.
 *
 /**
 * Retrieve a post status object by name.
 *
 * @since 3.0.0
 *
-* @global array $wp_post_statuses List of post statuses.
+* @global stdClass[] $wp_post_statuses List of post statuses.
 *
 * @see register_post_status()
 *
 * @param string $post_status The name of a registered post status.
-* @return object|null A post status object.
+* @return stdClass|null A post status object.
 */
 function get_post_status_object( $post_status ) {
 	global $wp_post_statuses;
 	if ( empty( $wp_post_statuses[ $post_status ] ) ) {
 /**
 * Get a list of post statuses.
 *
 * @since 3.0.0
 *
-* @global array $wp_post_statuses List of post statuses.
+* @global stdClass[] $wp_post_statuses List of post statuses.
 *
 * @see register_post_status()
 *
 * @param array|string $args     Optional. Array or string of post status arguments to compare against
 *                               properties of the global `$wp_post_statuses objects`. Default empty array.
 * @param string       $output   Optional. The type of output to return, either 'names' or 'objects'. Default 'names'.
 * @param string       $operator Optional. The logical operation to perform. 'or' means only one element
 *                               from the array needs to match; 'and' means all elements must match.
 *                               Default 'and'.
-* @return array A list of post status names or objects.
+* @return string[]|stdClass[] A list of post status names or objects.
 */
 function get_post_stati( $args = array(), $output = 'names', $operator = 'and' ) {
 	global $wp_post_statuses;
 	$field = ( 'names' === $output ) ? 'name' : false;
 * @since 4.6.0 Post type object returned is now an instance of `WP_Post_Type`.
 * @since 4.7.0 Introduced `show_in_rest`, `rest_base` and `rest_controller_class`
 *              arguments to register the post type in REST API.
 * @since 5.0.0 The `template` and `template_lock` arguments were added.
 * @since 5.3.0 The `supports` argument will now accept an array of arguments for a feature.
+* @since 5.9.0 The `rest_namespace` argument was added.
 *
 * @global array $wp_post_types List of post types.
 *
 * @param string       $post_type Post type key. Must not exceed 20 characters and may
 *                                only contain lowercase alphanumeric characters, dashes,
 *     @type string       $description           A short descriptive summary of what the post type is.
 *                                               Default empty.
 *     @type bool         $public                Whether a post type is intended for use publicly either via
 *                                               the admin interface or by front-end users. While the default
 *                                               settings of $exclude_from_search, $publicly_queryable, $show_ui,
-*                                               and $show_in_nav_menus are inherited from public, each does not
+*                                               and $show_in_nav_menus are inherited from $public, each does not
 *                                               rely on this relationship and controls a very specific intention.
 *                                               Default false.
 *     @type bool         $hierarchical          Whether the post type is hierarchical (e.g. page). Default false.
 *     @type bool         $exclude_from_search   Whether to exclude posts with this post type from front end search
 *                                               results. Default is the opposite value of $public.
 *     @type bool         $show_ui               Whether to generate and allow a UI for managing this post type in the
 *                                               admin. Default is value of $public.
 *     @type bool|string  $show_in_menu          Where to show the post type in the admin menu. To work, $show_ui
 *                                               must be true. If true, the post type is shown in its own top level
 *                                               menu. If false, no menu is shown. If a string of an existing top
-*                                               level menu (eg. 'tools.php' or 'edit.php?post_type=page'), the post
+*                                               level menu ('tools.php' or 'edit.php?post_type=page', for example), the
-*                                               type will be placed as a sub-menu of that.
+*                                               post type will be placed as a sub-menu of that.
 *                                               Default is value of $show_ui.
 *     @type bool         $show_in_nav_menus     Makes this post type available for selection in navigation menus.
 *                                               Default is value of $public.
 *     @type bool         $show_in_admin_bar     Makes this post type available via the admin bar. Default is value
 *                                               of $show_in_menu.
 *     @type bool         $show_in_rest          Whether to include the post type in the REST API. Set this to true
 *                                               for the post type to be available in the block editor.
-*     @type string       $rest_base             To change the base url of REST API route. Default is $post_type.
+*     @type string       $rest_base             To change the base URL of REST API route. Default is $post_type.
-*     @type string       $rest_controller_class REST API Controller class name. Default is 'WP_REST_Posts_Controller'.
+*     @type string       $rest_namespace        To change the namespace URL of REST API route. Default is wp/v2.
+*     @type string       $rest_controller_class REST API controller class name. Default is 'WP_REST_Posts_Controller'.
 *     @type int          $menu_position         The position in the menu order the post type should appear. To work,
 *                                               $show_in_menu must be true. Default null (at the bottom).
-*     @type string       $menu_icon             The url to the icon to be used for this menu. Pass a base64-encoded
+*     @type string       $menu_icon             The URL to the icon to be used for this menu. Pass a base64-encoded
 *                                               SVG using a data URI, which will be colored to match the color scheme
 *                                               -- this should begin with 'data:image/svg+xml;base64,'. Pass the name
 *                                               of a Dashicons helper class to use a font icon, e.g.
 *                                               'dashicons-chart-pie'. Pass 'none' to leave div.wp-menu-image empty
 *                                               so an icon can be added via CSS. Defaults to use the posts icon.
-*     @type string       $capability_type       The string to use to build the read, edit, and delete capabilities.
+*     @type string|array $capability_type       The string to use to build the read, edit, and delete capabilities.
 *                                               May be passed as an array to allow for alternative plurals when using
 *                                               this argument as a base to construct the capabilities, e.g.
 *                                               array('story', 'stories'). Default 'post'.
 *     @type string[]     $capabilities          Array of capabilities for this post type. $capability_type is used
 *                                               as a base to construct capabilities by default.
 	 * @param string       $post_type        Post type.
 	 * @param WP_Post_Type $post_type_object Arguments used to register the post type.
 	 */
 	do_action( 'registered_post_type', $post_type, $post_type_object );
+	/**
+	 * Fires after a specific post type is registered.
+	 *
+	 * The dynamic portion of the filter name, `$post_type`, refers to the post type key.
+	 *
+	 * Possible hook names include:
+	 *
+	 *  - `registered_post_type_post`
+	 *  - `registered_post_type_page`
+	 *
+	 * @since 6.0.0
+	 *
+	 * @param string       $post_type        Post type.
+	 * @param WP_Post_Type $post_type_object Arguments used to register the post type.
+	 */
+	do_action( "registered_post_type_{$post_type}", $post_type, $post_type_object );
 	return $post_type_object;
 }
 /**
 * Unregisters a post type.
 *
-* Can not be used to unregister built-in post types.
+* Cannot be used to unregister built-in post types.
 *
 * @since 4.5.0
 *
 * @global array $wp_post_types List of post types.
 *
 *
 * @param object|WP_Post_Type $post_type_object Post type object.
 * @return object Object with all the labels as member variables.
 */
 function get_post_type_labels( $post_type_object ) {
-	$nohier_vs_hier_defaults = array(
+	$nohier_vs_hier_defaults = WP_Post_Type::get_default_labels();
-		'name'                     => array( _x( 'Posts', 'post type general name' ), _x( 'Pages', 'post type general name' ) ),
-		'singular_name'            => array( _x( 'Post', 'post type singular name' ), _x( 'Page', 'post type singular name' ) ),
-		'add_new'                  => array( _x( 'Add New', 'post' ), _x( 'Add New', 'page' ) ),
-		'add_new_item'             => array( __( 'Add New Post' ), __( 'Add New Page' ) ),
-		'edit_item'                => array( __( 'Edit Post' ), __( 'Edit Page' ) ),
-		'new_item'                 => array( __( 'New Post' ), __( 'New Page' ) ),
-		'view_item'                => array( __( 'View Post' ), __( 'View Page' ) ),
-		'view_items'               => array( __( 'View Posts' ), __( 'View Pages' ) ),
-		'search_items'             => array( __( 'Search Posts' ), __( 'Search Pages' ) ),
-		'not_found'                => array( __( 'No posts found.' ), __( 'No pages found.' ) ),
-		'not_found_in_trash'       => array( __( 'No posts found in Trash.' ), __( 'No pages found in Trash.' ) ),
-		'parent_item_colon'        => array( null, __( 'Parent Page:' ) ),
-		'all_items'                => array( __( 'All Posts' ), __( 'All Pages' ) ),
-		'archives'                 => array( __( 'Post Archives' ), __( 'Page Archives' ) ),
-		'attributes'               => array( __( 'Post Attributes' ), __( 'Page Attributes' ) ),
-		'insert_into_item'         => array( __( 'Insert into post' ), __( 'Insert into page' ) ),
-		'uploaded_to_this_item'    => array( __( 'Uploaded to this post' ), __( 'Uploaded to this page' ) ),
-		'featured_image'           => array( _x( 'Featured image', 'post' ), _x( 'Featured image', 'page' ) ),
-		'set_featured_image'       => array( _x( 'Set featured image', 'post' ), _x( 'Set featured image', 'page' ) ),
-		'remove_featured_image'    => array( _x( 'Remove featured image', 'post' ), _x( 'Remove featured image', 'page' ) ),
-		'use_featured_image'       => array( _x( 'Use as featured image', 'post' ), _x( 'Use as featured image', 'page' ) ),
-		'filter_items_list'        => array( __( 'Filter posts list' ), __( 'Filter pages list' ) ),
-		'filter_by_date'           => array( __( 'Filter by date' ), __( 'Filter by date' ) ),
-		'items_list_navigation'    => array( __( 'Posts list navigation' ), __( 'Pages list navigation' ) ),
-		'items_list'               => array( __( 'Posts list' ), __( 'Pages list' ) ),
-		'item_published'           => array( __( 'Post published.' ), __( 'Page published.' ) ),
-		'item_published_privately' => array( __( 'Post published privately.' ), __( 'Page published privately.' ) ),
-		'item_reverted_to_draft'   => array( __( 'Post reverted to draft.' ), __( 'Page reverted to draft.' ) ),
-		'item_scheduled'           => array( __( 'Post scheduled.' ), __( 'Page scheduled.' ) ),
-		'item_updated'             => array( __( 'Post updated.' ), __( 'Page updated.' ) ),
-		'item_link'                => array(
-			_x( 'Post Link', 'navigation link block title' ),
-			_x( 'Page Link', 'navigation link block title' ),
-		),
-		'item_link_description'    => array(
-			_x( 'A link to a post.', 'navigation link block description' ),
-			_x( 'A link to a page.', 'navigation link block description' ),
-		),
-	);
 	$nohier_vs_hier_defaults['menu_name'] = $nohier_vs_hier_defaults['name'];
 	$labels = _get_custom_object_labels( $post_type_object, $nohier_vs_hier_defaults );
 * For all others, the 'publicly_queryable' value will be used.
 *
 * @since 4.4.0
 * @since 4.5.0 Added the ability to pass a post type name in addition to object.
 * @since 4.6.0 Converted the `$post_type` parameter to accept a `WP_Post_Type` object.
+* @since 5.9.0 Added `is_post_type_viewable` hook to filter the result.
 *
 * @param string|WP_Post_Type $post_type Post type name or object.
 * @return bool Whether the post type should be considered viewable.
 */
 function is_post_type_viewable( $post_type ) {
 	if ( ! is_object( $post_type ) ) {
 		return false;
 	}
-	return $post_type->publicly_queryable || ( $post_type->_builtin && $post_type->public );
+	$is_viewable = $post_type->publicly_queryable || ( $post_type->_builtin && $post_type->public );
+	/**
+	 * Filters whether a post type is considered "viewable".
+	 *
+	 * The returned filtered value must be a boolean type to ensure
+	 * `is_post_type_viewable()` only returns a boolean. This strictness
+	 * is by design to maintain backwards-compatibility and guard against
+	 * potential type errors in PHP 8.1+. Non-boolean values (even falsey
+	 * and truthy values) will result in the function returning false.
+	 *
+	 * @since 5.9.0
+	 *
+	 * @param bool         $is_viewable Whether the post type is "viewable" (strict type).
+	 * @param WP_Post_Type $post_type   Post type object.
+	 */
+	return true === apply_filters( 'is_post_type_viewable', $is_viewable, $post_type );
 }
 /**
 * Determine whether a post status is considered "viewable".
 *
-* For built-in post statuses such as publish and private, the 'public' value will be evaluted.
+* For built-in post statuses such as publish and private, the 'public' value will be evaluated.
 * For all others, the 'publicly_queryable' value will be used.
 *
 * @since 5.7.0
+* @since 5.9.0 Added `is_post_status_viewable` hook to filter the result.
 *
 * @param string|stdClass $post_status Post status name or object.
 * @return bool Whether the post status should be considered viewable.
 */
 function is_post_status_viewable( $post_status ) {
 		$post_status->protected
 	) {
 		return false;
 	}
-	return $post_status->publicly_queryable || ( $post_status->_builtin && $post_status->public );
+	$is_viewable = $post_status->publicly_queryable || ( $post_status->_builtin && $post_status->public );
+	/**
+	 * Filters whether a post status is considered "viewable".
+	 *
+	 * The returned filtered value must be a boolean type to ensure
+	 * `is_post_status_viewable()` only returns a boolean. This strictness
+	 * is by design to maintain backwards-compatibility and guard against
+	 * potential type errors in PHP 8.1+. Non-boolean values (even falsey
+	 * and truthy values) will result in the function returning false.
+	 *
+	 * @since 5.9.0
+	 *
+	 * @param bool     $is_viewable Whether the post status is "viewable" (strict type).
+	 * @param stdClass $post_status Post status object.
+	 */
+	return true === apply_filters( 'is_post_status_viewable', $is_viewable, $post_status );
 }
 /**
 * Determine whether a post is publicly viewable.
 *
 *
 * @see WP_Query
 * @see WP_Query::parse_query()
 *
 * @param array $args {
-*     Optional. Arguments to retrieve posts. See WP_Query::parse_query() for all
+*     Optional. Arguments to retrieve posts. See WP_Query::parse_query() for all available arguments.
-*     available arguments.
 *
 *     @type int        $numberposts      Total number of posts to retrieve. Is an alias of `$posts_per_page`
 *                                        in WP_Query. Accepts -1 for all. Default 5.
 *     @type int|string $category         Category ID or comma-separated list of IDs (this or any children).
 *                                        Is an alias of `$cat` in WP_Query. Default 0.
 *                           rows will only be removed that match the value.
 *                           Must be serializable if non-scalar. Default empty.
 * @return bool True on success, false on failure.
 */
 function delete_post_meta( $post_id, $meta_key, $meta_value = '' ) {
-	// Make sure meta is added to the post, not a revision.
+	// Make sure meta is deleted from the post, not from a revision.
 	$the_post = wp_is_post_revision( $post_id );
 	if ( $the_post ) {
 		$post_id = $the_post;
 	}
 * @return int|bool Meta ID if the key didn't exist, true on successful update,
 *                  false on failure or if the value passed to the function
 *                  is the same as the one that is already in the database.
 */
 function update_post_meta( $post_id, $meta_key, $meta_value, $prev_value = '' ) {
-	// Make sure meta is added to the post, not a revision.
+	// Make sure meta is updated for the post, not for a revision.
 	$the_post = wp_is_post_revision( $post_id );
 	if ( $the_post ) {
 		$post_id = $the_post;
 	}
 * The post meta fields are retrieved from the cache where possible,
 * so the function is optimized to be called more than once.
 *
 * @since 1.2.0
 *
-* @param int $post_id Optional. Post ID. Default is ID of the global $post.
+* @param int $post_id Optional. Post ID. Default is the ID of the global `$post`.
-* @return array Post meta for the given post.
+* @return mixed An array of values.
+*               False for an invalid `$post_id` (non-numeric, zero, or negative value).
+*               An empty string if a valid but non-existing post ID is passed.
 */
 function get_post_custom( $post_id = 0 ) {
 	$post_id = absint( $post_id );
 	if ( ! $post_id ) {
 		$post_id = get_the_ID();
 *
 * If there are no meta fields, then nothing (null) will be returned.
 *
 * @since 1.2.0
 *
-* @param int $post_id Optional. Post ID. Default is ID of the global $post.
+* @param int $post_id Optional. Post ID. Default is the ID of the global `$post`.
 * @return array|void Array of the keys, if retrieved.
 */
 function get_post_custom_keys( $post_id = 0 ) {
 	$custom = get_post_custom( $post_id );
 * will be retrieved and only the meta field key values returned.
 *
 * @since 1.2.0
 *
 * @param string $key     Optional. Meta field key. Default empty.
-* @param int    $post_id Optional. Post ID. Default is ID of the global $post.
+* @param int    $post_id Optional. Post ID. Default is the ID of the global `$post`.
 * @return array|null Meta field values.
 */
 function get_post_custom_values( $key = '', $post_id = 0 ) {
 	if ( ! $key ) {
 		return null;
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 2.7.0
 *
-* @param int $post_id Optional. Post ID. Default is ID of the global $post.
+* @param int $post_id Optional. Post ID. Default is the ID of the global `$post`.
 * @return bool Whether post is sticky.
 */
 function is_sticky( $post_id = 0 ) {
 	$post_id = absint( $post_id );
 	$post_id  = (int) $post_id;
 	$stickies = get_option( 'sticky_posts' );
 	$updated  = false;
 	if ( ! is_array( $stickies ) ) {
-		$stickies = array( $post_id );
+		$stickies = array();
 	} else {
 		$stickies = array_unique( array_map( 'intval', $stickies ) );
 	}
 	if ( ! in_array( $post_id, $stickies, true ) ) {
 *
 * @global wpdb $wpdb WordPress database abstraction object.
 *
 * @param string $type Optional. Post type to retrieve count. Default 'post'.
 * @param string $perm Optional. 'readable' or empty. Default empty.
-* @return object Number of posts for each status.
+* @return stdClass Number of posts for each status.
 */
 function wp_count_posts( $type = 'post', $perm = '' ) {
 	global $wpdb;
 	if ( ! post_type_exists( $type ) ) {
 	/**
 	 * Modify returned post counts by status for the current post type.
 	 *
 	 * @since 3.7.0
 	 *
-	 * @param object $counts An object containing the current post_type's post
+	 * @param stdClass $counts An object containing the current post_type's post
-	 *                       counts by status.
+	 *                         counts by status.
-	 * @param string $type   Post type.
+	 * @param string   $type   Post type.
-	 * @param string $perm   The permission to determine if the posts are 'readable'
+	 * @param string   $perm   The permission to determine if the posts are 'readable'
-	 *                       by the current user.
+	 *                         by the current user.
 	 */
 	return apply_filters( 'wp_count_posts', $counts, $type, $perm );
 }
 /**
 *
 * @global wpdb $wpdb WordPress database abstraction object.
 *
 * @param string|string[] $mime_type Optional. Array or comma-separated list of
 *                                   MIME patterns. Default empty.
-* @return object An object containing the attachment counts by mime type.
+* @return stdClass An object containing the attachment counts by mime type.
 */
 function wp_count_attachments( $mime_type = '' ) {
 	global $wpdb;
 	$and   = wp_post_mime_type_where( $mime_type );
 	/**
 	 * Modify returned attachment counts by mime type.
 	 *
 	 * @since 3.7.0
 	 *
-	 * @param object          $counts    An object containing the attachment counts by
+	 * @param stdClass        $counts    An object containing the attachment counts by
 	 *                                   mime type.
 	 * @param string|string[] $mime_type Array or comma-separated list of MIME patterns.
 	 */
 	return apply_filters( 'wp_count_attachments', (object) $counts, $mime_type );
 }
 				'Image <span class="count">(%s)</span>',
 				'Images <span class="count">(%s)</span>'
 			),
 		),
 		'audio'       => array(
-			__( 'Audio' ),
+			_x( 'Audio', 'file type group' ),
 			__( 'Manage Audio' ),
 			/* translators: %s: Number of audio files. */
 			_n_noop(
 				'Audio <span class="count">(%s)</span>',
 				'Audio <span class="count">(%s)</span>'
 			),
 		),
 		'video'       => array(
-			__( 'Video' ),
+			_x( 'Video', 'file type group' ),
 			__( 'Manage Video' ),
 			/* translators: %s: Number of video files. */
 			_n_noop(
 				'Video <span class="count">(%s)</span>',
 				'Video <span class="count">(%s)</span>'
 	/**
 	 * Filters whether a post deletion should take place.
 	 *
 	 * @since 4.4.0
 	 *
-	 * @param bool|null $delete       Whether to go forward with deletion.
+	 * @param WP_Post|false|null $delete       Whether to go forward with deletion. @TODO description
-	 * @param WP_Post   $post         Post object.
+	 * @param WP_Post            $post         Post object.
-	 * @param bool      $force_delete Whether to bypass the Trash.
+	 * @param bool               $force_delete Whether to bypass the Trash.
 	 */
 	$check = apply_filters( 'pre_delete_post', null, $post, $force_delete );
 	if ( null !== $check ) {
 		return $check;
 	}
 	// Point all attachments to this post up one level.
 	$wpdb->update( $wpdb->posts, $parent_data, $parent_where + array( 'post_type' => 'attachment' ) );
 	wp_defer_comment_counting( true );
-	$comment_ids = $wpdb->get_col( $wpdb->prepare( "SELECT comment_ID FROM $wpdb->comments WHERE comment_post_ID = %d", $postid ) );
+	$comment_ids = $wpdb->get_col( $wpdb->prepare( "SELECT comment_ID FROM $wpdb->comments WHERE comment_post_ID = %d ORDER BY comment_ID DESC", $postid ) );
 	foreach ( $comment_ids as $comment_id ) {
 		wp_delete_comment( $comment_id, true );
 	}
 	wp_defer_comment_counting( false );
 *
 * @since 2.9.0
 *
 * @see wp_delete_post()
 *
-* @param int $post_id Optional. Post ID. Default is ID of the global $post
+* @param int $post_id Optional. Post ID. Default is the ID of the global `$post`
-*                     if EMPTY_TRASH_DAYS equals true.
+*                     if `EMPTY_TRASH_DAYS` equals true.
 * @return WP_Post|false|null Post data on success, false or null on failure.
 */
 function wp_trash_post( $post_id = 0 ) {
 	if ( ! EMPTY_TRASH_DAYS ) {
 		return wp_delete_post( $post_id, true );
 *
 * @since 2.9.0
 * @since 5.6.0 An untrashed post is now returned to 'draft' status by default, except for
 *              attachments which are returned to their original 'inherit' status.
 *
-* @param int $post_id Optional. Post ID. Default is ID of the global `$post`.
+* @param int $post_id Optional. Post ID. Default is the ID of the global `$post`.
 * @return WP_Post|false|null Post data on success, false or null on failure.
 */
 function wp_untrash_post( $post_id = 0 ) {
 	$post = get_post( $post_id );
 *     @type int    $post_author           The ID of the user who added the post. Default is
 *                                         the current user ID.
 *     @type string $post_date             The date of the post. Default is the current time.
 *     @type string $post_date_gmt         The date of the post in the GMT timezone. Default is
 *                                         the value of `$post_date`.
-*     @type mixed  $post_content          The post content. Default empty.
+*     @type string $post_content          The post content. Default empty.
 *     @type string $post_content_filtered The filtered post content. Default empty.
 *     @type string $post_title            The post title. Default empty.
 *     @type string $post_excerpt          The post excerpt. Default empty.
 *     @type string $post_status           The post status. Default 'draft'.
 *     @type string $post_type             The post type. Default 'post'.
 *     @type int    $import_id             The post ID to be used when inserting a new post.
 *                                         If specified, must not match any existing post ID. Default 0.
 *     @type int[]  $post_category         Array of category IDs.
 *                                         Defaults to value of the 'default_category' option.
 *     @type array  $tags_input            Array of tag names, slugs, or IDs. Default empty.
-*     @type array  $tax_input             Array of taxonomy terms keyed by their taxonomy name. Default empty.
+*     @type array  $tax_input             An array of taxonomy terms keyed by their taxonomy name.
+*                                         If the taxonomy is hierarchical, the term list needs to be
+*                                         either an array of term IDs or a comma-separated string of IDs.
+*                                         If the taxonomy is non-hierarchical, the term list can be an array
+*                                         that contains term names or slugs, or a comma-separated string
+*                                         of names or slugs. This is because, in hierarchical taxonomy,
+*                                         child terms can have the same names with different parent terms,
+*                                         so the only way to connect them is using ID. Default empty.
 *     @type array  $meta_input            Array of post meta values keyed by their post meta key. Default empty.
 * }
 * @param bool  $wp_error         Optional. Whether to return a WP_Error on failure. Default false.
 * @param bool  $fire_after_hooks Optional. Whether to fire the after insert hooks. Default true.
 * @return int|WP_Error The post ID on success. The value 0 or WP_Error on failure.
 	if ( 'attachment' === $post_type ) {
 		/**
 		 * Filters attachment post data before it is updated in or added to the database.
 		 *
 		 * @since 3.9.0
-		 * @since 5.4.1 `$unsanitized_postarr` argument added.
+		 * @since 5.4.1 The `$unsanitized_postarr` parameter was added.
+		 * @since 6.0.0 The `$update` parameter was added.
 		 *
 		 * @param array $data                An array of slashed, sanitized, and processed attachment post data.
 		 * @param array $postarr             An array of slashed and sanitized attachment post data, but not processed.
 		 * @param array $unsanitized_postarr An array of slashed yet *unsanitized* and unprocessed attachment post data
 		 *                                   as originally passed to wp_insert_post().
+		 * @param bool  $update              Whether this is an existing attachment post being updated.
 		 */
-		$data = apply_filters( 'wp_insert_attachment_data', $data, $postarr, $unsanitized_postarr );
+		$data = apply_filters( 'wp_insert_attachment_data', $data, $postarr, $unsanitized_postarr, $update );
 	} else {
 		/**
 		 * Filters slashed post data just before it is inserted into the database.
 		 *
 		 * @since 2.7.0
-		 * @since 5.4.1 `$unsanitized_postarr` argument added.
+		 * @since 5.4.1 The `$unsanitized_postarr` parameter was added.
+		 * @since 6.0.0 The `$update` parameter was added.
 		 *
 		 * @param array $data                An array of slashed, sanitized, and processed post data.
 		 * @param array $postarr             An array of sanitized (and slashed) but otherwise unmodified post data.
 		 * @param array $unsanitized_postarr An array of slashed yet *unsanitized* and unprocessed post data as
 		 *                                   originally passed to wp_insert_post().
+		 * @param bool  $update              Whether this is an existing post being updated.
 		 */
-		$data = apply_filters( 'wp_insert_post_data', $data, $postarr, $unsanitized_postarr );
+		$data = apply_filters( 'wp_insert_post_data', $data, $postarr, $unsanitized_postarr, $update );
 	}
 	$data  = wp_unslash( $data );
 	$where = array( 'ID' => $post_ID );
 		 * Fires once an existing post has been updated.
 		 *
 		 * The dynamic portion of the hook name, `$post->post_type`, refers to
 		 * the post type slug.
 		 *
+		 * Possible hook names include:
+		 *
+		 *  - `edit_post_post`
+		 *  - `edit_post_page`
+		 *
 		 * @since 5.1.0
 		 *
 		 * @param int     $post_ID Post ID.
 		 * @param WP_Post $post    Post object.
 		 */
 	/**
 	 * Fires once a post has been saved.
 	 *
 	 * The dynamic portion of the hook name, `$post->post_type`, refers to
 	 * the post type slug.
+	 *
+	 * Possible hook names include:
+	 *
+	 *  - `save_post_post`
+	 *  - `save_post_page`
 	 *
 	 * @since 3.7.0
 	 *
 	 * @param int     $post_ID Post ID.
 	 * @param WP_Post $post    Post object.
 	if ( strlen( $slug ) > $length ) {
 		$decoded_slug = urldecode( $slug );
 		if ( $decoded_slug === $slug ) {
 			$slug = substr( $slug, 0, $length );
 		} else {
-			$slug = utf8_uri_encode( $decoded_slug, $length );
+			$slug = utf8_uri_encode( $decoded_slug, $length, true );
 		}
 	}
 	return rtrim( $slug, '-' );
 }
 	/**
 	 * Fires when a post is transitioned from one status to another.
 	 *
 	 * The dynamic portions of the hook name, `$new_status` and `$old_status`,
 	 * refer to the old and new post statuses, respectively.
+	 *
+	 * Possible hook names include:
+	 *
+	 *  - `draft_to_publish`
+	 *  - `publish_to_trash`
+	 *  - `pending_to_draft`
 	 *
 	 * @since 2.3.0
 	 *
 	 * @param WP_Post $post Post object.
 	 */
 	 *
 	 * Therefore, if you are looking to only fire a callback when a post is first
 	 * transitioned to a status, use the {@see 'transition_post_status'} hook instead.
 	 *
 	 * @since 2.3.0
-	 *
+	 * @since 5.9.0 Added `$old_status` parameter.
-	 * @param int     $post_id Post ID.
+	 *
-	 * @param WP_Post $post    Post object.
+	 * @param int     $post_id    Post ID.
+	 * @param WP_Post $post       Post object.
+	 * @param string  $old_status Old post status.
 	 */
-	do_action( "{$new_status}_{$post->post_type}", $post->ID, $post );
+	do_action( "{$new_status}_{$post->post_type}", $post->ID, $post, $old_status );
 }
 /**
 * Fires actions after a post, its terms and meta data has been saved.
 *
 	wp_cache_set( $cache_key, $foundid, 'posts' );
 	if ( $foundid ) {
 		return get_post( $foundid, $output );
 	}
+	return null;
 }
 /**
 * Retrieve a page given its title.
 *
 	$page = $wpdb->get_var( $sql );
 	if ( $page ) {
 		return get_post( $page, $output );
 	}
+	return null;
 }
 /**
 * Identify descendants of a given page ID in a list of page objects.
 *
 	/**
 	 * Filters whether an attachment deletion should take place.
 	 *
 	 * @since 5.5.0
 	 *
-	 * @param bool|null $delete       Whether to go forward with deletion.
+	 * @param WP_Post|false|null $delete       Whether to go forward with deletion. @TODO description
-	 * @param WP_Post   $post         Post object.
+	 * @param WP_Post            $post         Post object.
-	 * @param bool      $force_delete Whether to bypass the Trash.
+	 * @param bool               $force_delete Whether to bypass the Trash.
 	 */
 	$check = apply_filters( 'pre_delete_attachment', null, $post, $force_delete );
 	if ( null !== $check ) {
 		return $check;
 	}
 	$meta         = wp_get_attachment_metadata( $post_id );
 	$backup_sizes = get_post_meta( $post->ID, '_wp_attachment_backup_sizes', true );
 	$file         = get_attached_file( $post_id );
-	if ( is_multisite() ) {
+	if ( is_multisite() && is_string( $file ) && ! empty( $file ) ) {
 		clean_dirsize_cache( $file );
 	}
 	/**
 	 * Fires before an attachment is deleted, at the start of wp_delete_attachment().
 	// Delete all for any posts.
 	delete_metadata( 'post', null, '_thumbnail_id', $post_id, true );
 	wp_defer_comment_counting( true );
-	$comment_ids = $wpdb->get_col( $wpdb->prepare( "SELECT comment_ID FROM $wpdb->comments WHERE comment_post_ID = %d", $post_id ) );
+	$comment_ids = $wpdb->get_col( $wpdb->prepare( "SELECT comment_ID FROM $wpdb->comments WHERE comment_post_ID = %d ORDER BY comment_ID DESC", $post_id ) );
 	foreach ( $comment_ids as $comment_id ) {
 		wp_delete_comment( $comment_id, true );
 	}
 	wp_defer_comment_counting( false );
 *     @type int    $height     The height of the attachment.
 *     @type string $file       The file path relative to `wp-content/uploads`.
 *     @type array  $sizes      Keys are size slugs, each value is an array containing
 *                              'file', 'width', 'height', and 'mime-type'.
 *     @type array  $image_meta Image metadata.
+*     @type int    $filesize   File size of the attachment.
 * }
 */
 function wp_get_attachment_metadata( $attachment_id = 0, $unfiltered = false ) {
 	$attachment_id = (int) $attachment_id;
 /**
 * Retrieve the URL for an attachment.
 *
 * @since 2.1.0
 *
-* @global string $pagenow
+* @global string $pagenow The filename of the current screen.
 *
 * @param int $attachment_id Optional. Attachment post ID. Defaults to global $post.
 * @return string|false Attachment URL, otherwise false.
 */
 function wp_get_attachment_url( $attachment_id = 0 ) {
 /**
 * Retrieve thumbnail for an attachment.
 *
 * @since 2.1.0
 *
-* @param int $post_id Optional. Attachment ID. Default 0.
+* @param int $post_id Optional. Attachment ID. Default is the ID of the global `$post`.
 * @return string|false Thumbnail file path on success, false on failure.
 */
 function wp_get_attachment_thumb_file( $post_id = 0 ) {
 	$post_id = (int) $post_id;
 	$post    = get_post( $post_id );
 /**
 * Retrieve URL for an attachment thumbnail.
 *
 * @since 2.1.0
 *
-* @param int $post_id Optional. Attachment ID. Default 0.
+* @param int $post_id Optional. Attachment ID. Default is the ID of the global `$post`.
 * @return string|false Thumbnail URL on success, false on failure.
 */
 function wp_get_attachment_thumb_url( $post_id = 0 ) {
 	$post_id = (int) $post_id;
 	$post    = get_post( $post_id );
 function update_post_cache( &$posts ) {
 	if ( ! $posts ) {
 		return;
 	}
+	$data = array();
 	foreach ( $posts as $post ) {
-		wp_cache_add( $post->ID, $post, 'posts' );
+		if ( empty( $post->filter ) || 'raw' !== $post->filter ) {
-	}
+			$post = sanitize_post( $post, 'raw' );
+		}
+		$data[ $post->ID ] = $post;
+	}
+	wp_cache_add_multiple( $data, 'posts' );
 }
 /**
 * Will clean the post in the cache.
 *
 * Uses XMLRPC_REQUEST and WP_IMPORTING constants.
 *
 * @since 2.3.0
 * @access private
 *
-* @param int $post_id The ID in the database table of the post being published.
+* @param int $post_id The ID of the post being published.
 */
 function _publish_post_hook( $post_id ) {
 	if ( defined( 'XMLRPC_REQUEST' ) ) {
 		/**
 		 * Fires when _publish_post_hook() is called during an XML-RPC request.
 /**
 * Returns the ID of the post's parent.
 *
 * @since 3.1.0
-*
+* @since 5.9.0 The `$post` parameter was made optional.
-* @param int|WP_Post $post Post ID or post object. Defaults to global $post.
+*
+* @param int|WP_Post|null $post Optional. Post ID or post object. Defaults to global $post.
 * @return int|false Post parent ID (which can be 0 if there is no parent),
 *                   or false if the post does not exist.
 */
-function wp_get_post_parent_id( $post ) {
+function wp_get_post_parent_id( $post = null ) {
 	$post = get_post( $post );
 	if ( ! $post || is_wp_error( $post ) ) {
 		return false;
 	}
 	return (int) $post->post_parent;
 * For internal use.
 *
 * @since 4.5.0
 * @access private
 *
-* @param string $post_name Slug.
+* @param string $post_name Post slug.
 * @param int    $post_ID   Optional. Post ID that should be ignored. Default 0.
 */
 function wp_add_trashed_suffix_to_post_name_for_trashed_posts( $post_name, $post_ID = 0 ) {
 	$trashed_posts_with_desired_slug = get_posts(
 		array(

changeset 19	3d72ae0968f4
parent 18	be944660c56a
child 21	48c4eec2b7e6