Changeset 59735

Timestamp:

01/30/2025 12:00:18 AM (3 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' );
     }