Changeset 51965

Timestamp:

11/01/2021 02:29:42 PM (5 years ago)

Author:

SergeyBiryukov

Message:

Docs: Add a @since note for the rest_namespace argument of register_post_type() and register_taxonomy().

Use 3-digit, x.x.x-style semantic versioning for @since tags of the $rest_namespace property in WP_Post_Type and WP_Taxonomy.

Add a @since note to WP_REST_Taxonomies_Controller::get_item_schema() for the visibility and rest_namespace properties.

The rest_base property was also added after the method was initially introduced, but that happened during the same release cycle, so it doesn't need a separate @since note.

Follow-up to [38832], [39191], [42729], [51959], [51961], [51962], [51964].

See #53399.

Location:

trunk/src/wp-includes

Files:

• class-wp-post-type.php (modified) (1 diff)
• class-wp-taxonomy.php (modified) (1 diff)
• post.php (modified) (1 diff)
• rest-api/endpoints/class-wp-rest-taxonomies-controller.php (modified) (1 diff)
• taxonomy.php (modified) (1 diff)

trunk/src/wp-includes/class-wp-post-type.php

@@ -362 +362 @@
          * The namespace for this post type's REST API endpoints.
          *
-         * @since 5.9
+         * @since 5.9.0
          * @var string|bool $rest_namespace
          */

trunk/src/wp-includes/class-wp-taxonomy.php

@@ -203 +203 @@
          * The namespace for this taxonomy's REST API endpoints.
          *
-         * @since 5.9
+         * @since 5.9.0
          * @var string|bool $rest_namespace
          */

trunk/src/wp-includes/post.php

@@ -1372 +1372 @@
  * @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.

trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-taxonomies-controller.php

@@ -302 +302 @@
          *
          * @since 4.7.0
+         * @since 5.0.0 The `visibility` property was added.
+         * @since 5.9.0 The `rest_namespace` property was added.
          *
          * @return array Item schema data.

trunk/src/wp-includes/taxonomy.php

@@ -356 +356 @@
  * @since 5.4.0 Added the registered taxonomy object as a return value.
  * @since 5.5.0 Introduced `default_term` argument.
+ * @since 5.9.0 Introduced `rest_namespace` argument.
  *
  * @global WP_Taxonomy[] $wp_taxonomies Registered taxonomies.