Changeset 50505 for trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php

Timestamp:

03/07/2021 12:30:38 PM (4 years ago)

Author:

johnbillion

Message:

Docs: Add examples of possible names for various hooks whose name contains a dynamic portion.

This provides greater discoverability of such hooks in search results on the Code Reference site as well as increased clarity when reading the source.

See #50734, #52628

File:

• trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php (modified) (6 diffs)

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

@@ -238 +238 @@
          * The dynamic portion of the hook name, `$this->taxonomy`, refers to the taxonomy slug.
          *
+         * Possible hook names include:
+         *
+         *  - `rest_category_query`
+         *  - `rest_post_tag_query`
+         *
          * Enables adding extra arguments or setting defaults for a terms
          * collection request.
@@ -476 +481 @@
          * The dynamic portion of the hook name, `$this->taxonomy`, refers to the taxonomy slug.
          *
+         * Possible hook names include:
+         *
+         *  - `rest_insert_category`
+         *  - `rest_insert_post_tag`
+         *
          * @since 4.7.0
          *
@@ -505 +515 @@
          *
          * The dynamic portion of the hook name, `$this->taxonomy`, refers to the taxonomy slug.
+         *
+         * Possible hook names include:
+         *
+         *  - `rest_after_insert_category`
+         *  - `rest_after_insert_post_tag`
          *
          * @since 5.0.0
@@ -703 +718 @@
          * The dynamic portion of the hook name, `$this->taxonomy`, refers to the taxonomy slug.
          *
+         * Possible hook names include:
+         *
+         *  - `rest_delete_category`
+         *  - `rest_delete_post_tag`
+         *
          * @since 4.7.0
          *
@@ -762 +782 @@
          * The dynamic portion of the hook name, `$this->taxonomy`, refers to the taxonomy slug.
          *
+         * Possible hook names include:
+         *
+         *  - `rest_pre_insert_category`
+         *  - `rest_pre_insert_post_tag`
+         *
          * @since 4.7.0
          *
@@ -833 +858 @@
          * The dynamic portion of the hook name, `$this->taxonomy`, refers to the taxonomy slug.
          *
-         * Possible filter names include:
+         * Possible hook names include:
          *
          *  - `rest_prepare_category`