Docs: Fix various incorrect `@since` mentions.
Props costdev, mukesh27. Fixes #58834. See #57840. Built from https://develop.svn.wordpress.org/trunk@56256 git-svn-id: http://core.svn.wordpress.org/trunk@55768 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
parent
780ddef241
commit
114ab18d18
|
@ -9,7 +9,7 @@
|
||||||
/**
|
/**
|
||||||
* Converts a Classic Menu to Block Menu blocks.
|
* Converts a Classic Menu to Block Menu blocks.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
* @access public
|
* @access public
|
||||||
*/
|
*/
|
||||||
class WP_Classic_To_Block_Menu_Converter {
|
class WP_Classic_To_Block_Menu_Converter {
|
||||||
|
@ -17,7 +17,7 @@ class WP_Classic_To_Block_Menu_Converter {
|
||||||
/**
|
/**
|
||||||
* Converts a Classic Menu to blocks.
|
* Converts a Classic Menu to blocks.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @param WP_Term $menu The Menu term object of the menu to convert.
|
* @param WP_Term $menu The Menu term object of the menu to convert.
|
||||||
* @return string the serialized and normalized parsed blocks.
|
* @return string the serialized and normalized parsed blocks.
|
||||||
|
@ -58,7 +58,7 @@ class WP_Classic_To_Block_Menu_Converter {
|
||||||
/**
|
/**
|
||||||
* Returns an array of menu items grouped by the id of the parent menu item.
|
* Returns an array of menu items grouped by the id of the parent menu item.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @param array $menu_items An array of menu items.
|
* @param array $menu_items An array of menu items.
|
||||||
* @return array
|
* @return array
|
||||||
|
@ -76,7 +76,7 @@ class WP_Classic_To_Block_Menu_Converter {
|
||||||
/**
|
/**
|
||||||
* Turns menu item data into a nested array of parsed blocks
|
* Turns menu item data into a nested array of parsed blocks
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @param array $menu_items An array of menu items that represent
|
* @param array $menu_items An array of menu items that represent
|
||||||
* an individual level of a menu.
|
* an individual level of a menu.
|
||||||
|
|
|
@ -13,14 +13,14 @@
|
||||||
* Manages fallback behavior for Navigation menus.
|
* Manages fallback behavior for Navigation menus.
|
||||||
*
|
*
|
||||||
* @access public
|
* @access public
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*/
|
*/
|
||||||
class WP_Navigation_Fallback {
|
class WP_Navigation_Fallback {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Gets (and/or creates) an appropriate fallback Navigation Menu.
|
* Gets (and/or creates) an appropriate fallback Navigation Menu.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @return WP_Post|null the fallback Navigation Post or null.
|
* @return WP_Post|null the fallback Navigation Post or null.
|
||||||
*/
|
*/
|
||||||
|
@ -61,7 +61,7 @@ class WP_Navigation_Fallback {
|
||||||
/**
|
/**
|
||||||
* Finds the most recently published `wp_navigation` post type.
|
* Finds the most recently published `wp_navigation` post type.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @return WP_Post|null the first non-empty Navigation or null.
|
* @return WP_Post|null the first non-empty Navigation or null.
|
||||||
*/
|
*/
|
||||||
|
@ -90,7 +90,7 @@ class WP_Navigation_Fallback {
|
||||||
/**
|
/**
|
||||||
* Creates a Navigation Menu post from a Classic Menu.
|
* Creates a Navigation Menu post from a Classic Menu.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @return int|WP_Error The post ID of the default fallback menu or a WP_Error object.
|
* @return int|WP_Error The post ID of the default fallback menu or a WP_Error object.
|
||||||
*/
|
*/
|
||||||
|
@ -127,7 +127,7 @@ class WP_Navigation_Fallback {
|
||||||
/**
|
/**
|
||||||
* Determine the most appropriate classic navigation menu to use as a fallback.
|
* Determine the most appropriate classic navigation menu to use as a fallback.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @return WP_Term|null The most appropriate classic navigation menu to use as a fallback.
|
* @return WP_Term|null The most appropriate classic navigation menu to use as a fallback.
|
||||||
*/
|
*/
|
||||||
|
@ -157,7 +157,7 @@ class WP_Navigation_Fallback {
|
||||||
/**
|
/**
|
||||||
* Sorts the classic menus and returns the most recently created one.
|
* Sorts the classic menus and returns the most recently created one.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @param WP_Term[] $classic_nav_menus Array of classic nav menu term objects.
|
* @param WP_Term[] $classic_nav_menus Array of classic nav menu term objects.
|
||||||
* @return WP_Term The most recently created classic nav menu.
|
* @return WP_Term The most recently created classic nav menu.
|
||||||
|
@ -176,7 +176,7 @@ class WP_Navigation_Fallback {
|
||||||
/**
|
/**
|
||||||
* Returns the classic menu with the slug `primary` if it exists.
|
* Returns the classic menu with the slug `primary` if it exists.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @param WP_Term[] $classic_nav_menus Array of classic nav menu term objects.
|
* @param WP_Term[] $classic_nav_menus Array of classic nav menu term objects.
|
||||||
* @return WP_Term|null The classic nav menu with the slug `primary` or null.
|
* @return WP_Term|null The classic nav menu with the slug `primary` or null.
|
||||||
|
@ -196,7 +196,7 @@ class WP_Navigation_Fallback {
|
||||||
* Gets the classic menu assigned to the `primary` navigation menu location
|
* Gets the classic menu assigned to the `primary` navigation menu location
|
||||||
* if it exists.
|
* if it exists.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @return WP_Term|null The classic nav menu assigned to the `primary` location or null.
|
* @return WP_Term|null The classic nav menu assigned to the `primary` location or null.
|
||||||
*/
|
*/
|
||||||
|
@ -217,7 +217,7 @@ class WP_Navigation_Fallback {
|
||||||
/**
|
/**
|
||||||
* Creates a default Navigation Block Menu fallback.
|
* Creates a default Navigation Block Menu fallback.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @return int|WP_Error The post ID of the default fallback menu or a WP_Error object.
|
* @return int|WP_Error The post ID of the default fallback menu or a WP_Error object.
|
||||||
*/
|
*/
|
||||||
|
@ -243,7 +243,7 @@ class WP_Navigation_Fallback {
|
||||||
/**
|
/**
|
||||||
* Gets the rendered markup for the default fallback blocks.
|
* Gets the rendered markup for the default fallback blocks.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @return string default blocks markup to use a the fallback.
|
* @return string default blocks markup to use a the fallback.
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -12,14 +12,14 @@
|
||||||
/**
|
/**
|
||||||
* REST Controller to fetch a fallback Navigation Block Menu. If needed it creates one.
|
* REST Controller to fetch a fallback Navigation Block Menu. If needed it creates one.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*/
|
*/
|
||||||
class WP_REST_Navigation_Fallback_Controller extends WP_REST_Controller {
|
class WP_REST_Navigation_Fallback_Controller extends WP_REST_Controller {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* The Post Type for the Controller
|
* The Post Type for the Controller
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @var string
|
* @var string
|
||||||
*/
|
*/
|
||||||
|
@ -28,7 +28,7 @@ class WP_REST_Navigation_Fallback_Controller extends WP_REST_Controller {
|
||||||
/**
|
/**
|
||||||
* Constructs the controller.
|
* Constructs the controller.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*/
|
*/
|
||||||
public function __construct() {
|
public function __construct() {
|
||||||
$this->namespace = 'wp-block-editor/v1';
|
$this->namespace = 'wp-block-editor/v1';
|
||||||
|
@ -39,7 +39,7 @@ class WP_REST_Navigation_Fallback_Controller extends WP_REST_Controller {
|
||||||
/**
|
/**
|
||||||
* Registers the controllers routes.
|
* Registers the controllers routes.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @return void
|
* @return void
|
||||||
*/
|
*/
|
||||||
|
@ -64,7 +64,7 @@ class WP_REST_Navigation_Fallback_Controller extends WP_REST_Controller {
|
||||||
/**
|
/**
|
||||||
* Checks if a given request has access to read fallbacks.
|
* Checks if a given request has access to read fallbacks.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @param WP_REST_Request $request Full details about the request.
|
* @param WP_REST_Request $request Full details about the request.
|
||||||
* @return true|WP_Error True if the request has read access, WP_Error object otherwise.
|
* @return true|WP_Error True if the request has read access, WP_Error object otherwise.
|
||||||
|
@ -96,7 +96,7 @@ class WP_REST_Navigation_Fallback_Controller extends WP_REST_Controller {
|
||||||
/**
|
/**
|
||||||
* Gets the most appropriate fallback Navigation Menu.
|
* Gets the most appropriate fallback Navigation Menu.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @param WP_REST_Request $request Full details about the request.
|
* @param WP_REST_Request $request Full details about the request.
|
||||||
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
|
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
|
||||||
|
@ -116,7 +116,7 @@ class WP_REST_Navigation_Fallback_Controller extends WP_REST_Controller {
|
||||||
/**
|
/**
|
||||||
* Retrieves the fallbacks' schema, conforming to JSON Schema.
|
* Retrieves the fallbacks' schema, conforming to JSON Schema.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @return array Item schema data.
|
* @return array Item schema data.
|
||||||
*/
|
*/
|
||||||
|
@ -145,7 +145,7 @@ class WP_REST_Navigation_Fallback_Controller extends WP_REST_Controller {
|
||||||
/**
|
/**
|
||||||
* Matches the post data to the schema we want.
|
* Matches the post data to the schema we want.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @param WP_Post $item The wp_navigation Post object whose response is being prepared.
|
* @param WP_Post $item The wp_navigation Post object whose response is being prepared.
|
||||||
* @param WP_REST_Request $request Request object.
|
* @param WP_REST_Request $request Request object.
|
||||||
|
@ -177,7 +177,7 @@ class WP_REST_Navigation_Fallback_Controller extends WP_REST_Controller {
|
||||||
/**
|
/**
|
||||||
* Prepares the links for the request.
|
* Prepares the links for the request.
|
||||||
*
|
*
|
||||||
* @since 6.3.0.
|
* @since 6.3.0
|
||||||
*
|
*
|
||||||
* @param WP_Post $post the Navigation Menu post object.
|
* @param WP_Post $post the Navigation Menu post object.
|
||||||
* @return array Links for the given request.
|
* @return array Links for the given request.
|
||||||
|
|
|
@ -16,7 +16,7 @@
|
||||||
*
|
*
|
||||||
* @global string $wp_version
|
* @global string $wp_version
|
||||||
*/
|
*/
|
||||||
$wp_version = '6.3-beta4-56255';
|
$wp_version = '6.3-beta4-56256';
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
|
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
|
||||||
|
|
Loading…
Reference in New Issue