apply_filters( 'customize_dynamic_setting_args', false|array $setting_args, string $setting_id )
- Since
- 4.2.0
Filters a dynamic setting's constructor args.
Description
For a dynamic setting to be registered, this filter must be employed to override the default false value with an array of args to pass to the WP_Customize_Setting constructor.
Compatibility
- WordPress
- since 4.2.0
- 6.7.7
- 6.8.8
- 6.9.7
- 7.0.4
- 7.1.0
Present in every tracked release (6.7.7 to 7.1.0).
Parameters
$setting_argsfalse|array- The arguments to the WP_Customize_Setting constructor.
$setting_idstring- ID for dynamic setting, usually coming from
$_POST['customized'].
Where this hook fires · 2
wp-includes/class-wp-customize-manager.php:3788WP_Customize_Manager::add_setting()wp-includes/class-wp-customize-manager.php:3837WP_Customize_Manager::add_dynamic_settings()
Source code
* * @since 4.2.0 * * @param false|array $setting_args The arguments to the WP_Customize_Setting constructor. * @param string $setting_id ID for dynamic setting, usually coming from `$_POST['customized']`. */ $setting_args = apply_filters( 'customize_dynamic_setting_args', $setting_args, $setting_id ); if ( false === $setting_args ) { continue; } /** * Allow non-statically created settings to be constructed with custom WP_Customize_Setting subclass.Changelog
Introduced in 4.2.0. Unchanged from 6.7.7 through 7.1.0.
Signature, return type and hooks compared across 5 parsed releases.
About this page
- Parsed data
- Generated from the wordpress-develop 6.8.8 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
- Corrections
- Something wrong on this page? Report it and it gets fixed in the next regeneration.