Changeset 48321

Timestamp:

07/05/2020 03:05:02 PM (6 years ago)

Author:

SergeyBiryukov

Message:

Options, Meta APIs: Introduce register_setting and unregister_setting actions.

Props Howdy_McGee, Pionect.
Fixes #37245.

File:

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

trunk/src/wp-includes/option.php

@@ -2213 +2213 @@
 
         $new_whitelist_options[ $option_group ][] = $option_name;
+
         if ( ! empty( $args['sanitize_callback'] ) ) {
                 add_filter( "sanitize_option_{$option_name}", $args['sanitize_callback'] );
@@ -2220 +2221 @@
         }
 
+        /**
+         * Fires immediately before the setting is registered but after its filters are in place.
+         *
+         * @since 5.5.0
+         *
+         * @param string $option_group Setting group.
+         * @param string $option_name  Setting name.
+         * @param array  $args         Array of setting registration arguments.
+         */
+        do_action( 'register_setting', $option_group, $option_name, $args );
+
         $wp_registered_settings[ $option_name ] = $args;
 }
@@ -2232 +2244 @@
  * @global array $wp_registered_settings
  *
- * @param string   $option_group      The settings group name used during registration.
- * @param string   $option_name       The name of the option to unregister.
- * @param callable $deprecated        Deprecated.
+ * @param string   $option_group The settings group name used during registration.
+ * @param string   $option_name  The name of the option to unregister.
+ * @param callable $deprecated   Deprecated.
  */
 function unregister_setting( $option_group, $option_name, $deprecated = '' ) {
@@ -2266 +2278 @@
 
         $pos = array_search( $option_name, (array) $new_whitelist_options[ $option_group ], true );
+
         if ( false !== $pos ) {
                 unset( $new_whitelist_options[ $option_group ][ $pos ] );
         }
+
         if ( '' !== $deprecated ) {
                 _deprecated_argument(
@@ -2294 +2308 @@
                 }
 
+                /**
+                 * Fires immediately before the setting is unregistered and after its filters have been removed.
+                 *
+                 * @since 5.5.0
+                 *
+                 * @param string $option_group Setting group.
+                 * @param string $option_name  Setting name.
+                 */
+                do_action( 'unregister_setting', $option_group, $option_name );
+
                 unset( $wp_registered_settings[ $option_name ] );
         }