Changeset 59735

Timestamp:

01/30/2025 12:00:18 AM (19 months ago)

Author:

peterwilsoncc

Message:

Options/Meta APIs: Rename setted_(site_)_transient to set_....

Deprecate the actions setted_transient and setted_site_transient in favour of set_transient and set_site_transient respectively.

This serves two purposes, the name is consistent with the transient specific actions set_(site_)_transient_{$transient}, and to make the names grammatically correct.

Props sukhendu2002, swissspidy, johnbillion, peterwilsoncc.
Fixes #62849.

File:

• trunk/src/wp-includes/option.php (modified) (4 diffs)

trunk/src/wp-includes/option.php

@@ -1597 +1597 @@
                  * Fires after the value for a transient has been set.
                  *
-                 * @since 3.0.0
-                 * @since 3.6.0 The `$value` and `$expiration` parameters were added.
+                 * @since 6.8.0
                  *
                  * @param string $transient  The name of the transient.
@@ -1604 +1603 @@
                  * @param int    $expiration Time until expiration in seconds.
                  */
-                do_action( 'setted_transient', $transient, $value, $expiration );
+                do_action( 'set_transient', $transient, $value, $expiration );
+
+                /**
+                 * Fires after the transient is set.
+                 *
+                 * @since 3.0.0
+                 * @since 3.6.0 The `$value` and `$expiration` parameters were added.
+                 * @deprecated 6.8.0 Use {@see 'set_transient'} instead.
+                 *
+                 * @param string $transient  The name of the transient.
+                 * @param mixed  $value      Transient value.
+                 * @param int    $expiration Time until expiration in seconds.
+                 */
+                do_action_deprecated( 'setted_transient', array( $transient, $value, $expiration ), '6.8.0', 'set_transient' );
         }
 
@@ -2677 +2689 @@
                  * Fires after the value for a site transient has been set.
                  *
-                 * @since 3.0.0
+                 * @since 6.8.0
                  *
                  * @param string $transient  The name of the site transient.
@@ -2683 +2695 @@
                  * @param int    $expiration Time until expiration in seconds.
                  */
-                do_action( 'setted_site_transient', $transient, $value, $expiration );
+                do_action( 'set_site_transient', $transient, $value, $expiration );
+
+                /**
+                 * Fires after the value for a site transient has been set.
+                 *
+                 * @since 3.0.0
+                 * @deprecated 6.8.0 Use {@see 'set_site_transient'} instead.
+                 *
+                 * @param string $transient  The name of the site transient.
+                 * @param mixed  $value      Site transient value.
+                 * @param int    $expiration Time until expiration in seconds.
+                 */
+                do_action_deprecated( 'setted_site_transient', array( $transient, $value, $expiration ), '6.8.0', 'set_site_transient' );
         }