WP hooks navigation: Home/browse • Actions index • Filters index
To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).
The best way to understand what a hook does is to look at where it occurs in the source code.
do_action( "hook_name" )apply_filters( "hook_name", "what_to_filter" ).Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.
This hook occurs 2 times in this file.
| Line | Code |
|---|---|
| 2834 | * @return WP_Customize_Setting The instance of the setting that was added. |
| 2835 | */ |
| 2836 | public function add_setting( $id, $args = array() ) { |
| 2837 | if ( $id instanceof WP_Customize_Setting ) { |
| 2838 | $setting = $id; |
| 2839 | } else { |
| 2840 | $class = 'WP_Customize_Setting'; |
| 2841 | |
| 2842 | /** This filter is documented in wp-includes/class-wp-customize-manager.php */ |
| 2843 | $args = apply_filters( 'customize_dynamic_setting_args', $args, $id ); |
| 2844 | |
| 2845 | /** This filter is documented in wp-includes/class-wp-customize-manager.php */ |
| 2846 | $class = apply_filters( 'customize_dynamic_setting_class', $class, $id, $args ); |
| 2847 | |
| 2848 | $setting = new $class( $this, $id, $args ); |
| 2849 | } |
| 2850 | |
| 2851 | $this->settings[ $setting->id ] = $setting; |
| 2852 | return $setting; |
| Line | Code |
| 2884 | * For a dynamic setting to be registered, this filter must be employed |
| 2885 | * to override the default false value with an array of args to pass to |
| 2886 | * the WP_Customize_Setting constructor. |
| 2887 | * |
| 2888 | * @since 4.2.0 |
| 2889 | * |
| 2890 | * @param false|array $setting_args The arguments to the WP_Customize_Setting constructor. |
| 2891 | * @param string $setting_id ID for dynamic setting, usually coming from `$_POST['customized']`. |
| 2892 | */ |
| 2893 | $setting_args = apply_filters( 'customize_dynamic_setting_args', $setting_args, $setting_id ); |
| 2894 | if ( false === $setting_args ) { |
| 2895 | continue; |
| 2896 | } |
| 2897 | |
| 2898 | /** |
| 2899 | * Allow non-statically created settings to be constructed with custom WP_Customize_Setting subclass. |
| 2900 | * |
| 2901 | * @since 4.2.0 |
| 2902 | * |