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

Timestamp:

09/04/2020 08:39:47 PM (6 years ago)

Author:

johnbillion

Message:

Docs: Various docblock corrections and improvements.

See #50768

File:

• trunk/src/wp-includes/taxonomy.php (modified) (8 diffs)

trunk/src/wp-includes/taxonomy.php

@@ -887 +887 @@
          * Filters a taxonomy term object.
          *
+         * The {@see 'get_$taxonomy'} hook is also available for targeting a specific
+         * taxonomy.
+         *
          * @since 2.3.0
          * @since 4.4.0 `$_term` is now a `WP_Term` object.
@@ -1987 +1990 @@
          * Fires after a term is deleted from the database and the cache is cleaned.
          *
+         * The {@see 'delete_$taxonomy'} hook is also available for targeting a specific
+         * taxonomy.
+         *
          * @since 2.5.0
          * @since 4.5.0 Introduced the `$object_ids` argument.
@@ -1993 +1999 @@
          * @param int     $tt_id        Term taxonomy ID.
          * @param string  $taxonomy     Taxonomy slug.
-         * @param mixed   $deleted_term Copy of the already-deleted term, in the form specified
-         *                              by the parent function. WP_Error otherwise.
+         * @param WP_Term $deleted_term Copy of the already-deleted term.
          * @param array   $object_ids   List of term object IDs.
          */
@@ -2010 +2015 @@
          * @param int     $term         Term ID.
          * @param int     $tt_id        Term taxonomy ID.
-         * @param mixed   $deleted_term Copy of the already-deleted term, in the form specified
-         *                              by the parent function. WP_Error otherwise.
+         * @param WP_Term $deleted_term Copy of the already-deleted term.
          * @param array   $object_ids   List of term object IDs.
          */
@@ -2182 +2186 @@
  * @param string       $taxonomy The taxonomy to which to add the term.
  * @param array|string $args {
- *     Optional. Array or string of arguments for inserting a term.
+ *     Optional. Array or query string of arguments for inserting a term.
  *
  *     @type string $alias_of    Slug of the term to make this term an alias of.
@@ -3105 +3109 @@
 
         /**
-         * Fires immediately after the given terms are edited.
+         * Fires immediately after a term is updated in the database, but before its
+         * term-taxonomy relationship is updated.
          *
          * @since 2.9.0
@@ -3138 +3143 @@
         /**
          * Fires after a term has been updated, but before the term cache has been cleaned.
+         *
+         * The {@see 'edit_$taxonomy'} hook is also available for targeting a specific
+         * taxonomy.
          *
          * @since 2.3.0
@@ -3167 +3175 @@
         /**
          * Fires after a term has been updated, and the term cache has been cleaned.
+         *
+         * The {@see 'edited_$taxonomy'} hook is also available for targeting a specific
+         * taxonomy.
          *
          * @since 2.3.0