Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

Source View: customize_dynamic_setting_args

To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).

Understanding Source Code

The best way to understand what a hook does is to look at where it occurs in the source code.

Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.

Source View

This hook occurs 2 times in this file.

Line Code
3661       * @return WP_Customize_Setting             The instance of the setting that was added.
3662       */
3663      public function add_setting( $id, $args = array() ) {
3664           if ( $id instanceof WP_Customize_Setting ) {
3665                $setting = $id;
3666           } else {
3667                $class = 'WP_Customize_Setting';
3668
3669                /** This filter is documented in wp-includes/class-wp-customize-manager.php */
3670                $args = apply_filters( 'customize_dynamic_setting_args', $args, $id );
3671
3672                /** This filter is documented in wp-includes/class-wp-customize-manager.php */
3673                $class = apply_filters( 'customize_dynamic_setting_class', $class, $id, $args );
3674
3675                $setting = new $class( $this, $id, $args );
3676           }
3677
3678           $this->settings[ $setting->id ] = $setting;
3679           return $setting;
 
Line Code
3710                 * For a dynamic setting to be registered, this filter must be employed
3711                 * to override the default false value with an array of args to pass to
3712                 * the WP_Customize_Setting constructor.
3713                 *
3714                 * @since 4.2.0
3715                 *
3716                 * @param false|array $setting_args The arguments to the WP_Customize_Setting constructor.
3717                 * @param string      $setting_id   ID for dynamic setting, usually coming from `$_POST['customized']`.
3718                 */
3719                $setting_args = apply_filters( 'customize_dynamic_setting_args', $setting_args, $setting_id );
3720                if ( false === $setting_args ) {
3721                     continue;
3722                }
3723
3724                /**
3725                 * Allow non-statically created settings to be constructed with custom WP_Customize_Setting subclass.
3726                 *
3727                 * @since 4.2.0
3728                 *