Changeset 48314

Timestamp:

07/05/2020 11:11:46 AM (4 years ago)

Author:

SergeyBiryukov

Message:

Taxonomy: Introduce saved_term and saved_{$taxonomy} actions to complement created_term and created_{$taxonomy}.

This allows for hooking into both the create and update events with a single callback, in the same way that is already possible for posts via the save_post and save_post_{$post->post_type} actions.

Props dlh.
Fixes #48416.

Location:

trunk/src/wp-includes

Files:

• post.php (modified) (3 diffs)
• taxonomy.php (modified) (2 diffs)

trunk/src/wp-includes/post.php

@@ -4208 +4208 @@
      * @param int     $post_ID Post ID.
      * @param WP_Post $post    Post object.
-     * @param bool    $update  Whether this is an existing post being updated or not.
+     * @param bool    $update  Whether this is an existing post being updated.
      */
     do_action( "save_post_{$post->post_type}", $post_ID, $post, $update );
@@ -4219 +4219 @@
      * @param int     $post_ID Post ID.
      * @param WP_Post $post    Post object.
-     * @param bool    $update  Whether this is an existing post being updated or not.
+     * @param bool    $update  Whether this is an existing post being updated.
      */
     do_action( 'save_post', $post_ID, $post, $update );
@@ -4230 +4230 @@
      * @param int     $post_ID Post ID.
      * @param WP_Post $post    Post object.
-     * @param bool    $update  Whether this is an existing post being updated or not.
+     * @param bool    $update  Whether this is an existing post being updated.
      */
     do_action( 'wp_insert_post', $post_ID, $post, $update );

trunk/src/wp-includes/taxonomy.php

@@ -2415 +2415 @@
     do_action( "created_{$taxonomy}", $term_id, $tt_id );
 
+    /**
+     * Fires after a term has been saved, and the term cache has been cleared.
+     *
+     * @since 5.5.0
+     *
+     * @param int    $term_id  Term ID.
+     * @param int    $tt_id    Term taxonomy ID.
+     * @param string $taxonomy Taxonomy slug.
+     * @param bool   $update   Whether this is an existing term being updated.
+     */
+    do_action( 'saved_term', $term_id, $tt_id, $taxonomy, false );
+
+    /**
+     * Fires after a term in a specific taxonomy has been saved, and the term
+     * cache has been cleared.
+     *
+     * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
+     *
+     * @since 5.5.0
+     *
+     * @param int  $term_id Term ID.
+     * @param int  $tt_id   Term taxonomy ID.
+     * @param bool $update  Whether this is an existing term being updated.
+     */
+    do_action( "saved_{$taxonomy}", $term_id, $tt_id, false );
+
     return array(
         'term_id'          => $term_id,
@@ -3078 +3104 @@
      */
     do_action( "edited_{$taxonomy}", $term_id, $tt_id );
+
+    /** This action is documented in wp-includes/taxonomy.php */
+    do_action( 'saved_term', $term_id, $tt_id, $taxonomy, true );
+
+    /** This action is documented in wp-includes/taxonomy.php */
+    do_action( "saved_{$taxonomy}", $term_id, $tt_id, true );
 
     return array(