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

Timestamp:

03/07/2021 12:30:38 PM (6 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/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