Changeset 50505 for trunk/src/wp-includes/taxonomy.php

Timestamp:

03/07/2021 12:30:38 PM (11 months 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/taxonomy.php (modified) (7 diffs)

trunk/src/wp-includes/taxonomy.php

@@ -628 +628 @@
      * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
      *
+     * Possible hook names include:
+     *
+     *  - `taxonomy_labels_category`
+     *  - `taxonomy_labels_post_tag`
+     *
      * @since 4.4.0
      *
@@ -2032 +2037 @@
      * taxonomy the term belonged to.
      *
+     * Possible hook names include:
+     *
+     *  - `delete_category`
+     *  - `delete_post_tag`
+     *
      * @since 2.3.0
      * @since 4.5.0 Introduced the `$object_ids` argument.
@@ -2475 +2485 @@
      * to the slug of the taxonomy the term was created for.
      *
+     * Possible hook names include:
+     *
+     *  - `create_category`
+     *  - `create_post_tag`
+     *
      * @since 2.3.0
      *
@@ -2513 +2528 @@
      *
      * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
+     *
+     * Possible hook names include:
+     *
+     *  - `created_category`
+     *  - `created_post_tag`
      *
      * @since 2.3.0
@@ -2541 +2561 @@
      *
      * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
+     *
+     * Possible hook names include:
+     *
+     *  - `saved_category`
+     *  - `saved_post_tag`
      *
      * @since 5.5.0
@@ -3187 +3212 @@
      * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
      *
+     * Possible hook names include:
+     *
+     *  - `edit_category`
+     *  - `edit_post_tag`
+     *
      * @since 2.3.0
      *
@@ -3218 +3248 @@
      *
      * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
+     *
+     * Possible hook names include:
+     *
+     *  - `edited_category`
+     *  - `edited_post_tag`
      *
      * @since 2.3.0