Changeset 48321

Timestamp:

07/05/2020 03:05:02 PM (4 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 ] );
     }