WP_Customize_Setting::multidimensional_replace() WordPress Method
The WP_Customize_Setting::multidimensional_replace() method is used to recursively update a multidimensional array of Customizer settings. This is useful when replacing settings with updated values, or when resetting settings to their default values.
WP_Customize_Setting::multidimensional_replace( array $root, array $keys, mixed $value ) #
Will attempt to replace a specific value in a multidimensional array.
Parameters
- $root
(array)(Required)
- $keys
(array)(Required)
- $value
(mixed)(Required)The value to update.
Return
(mixed)
Source
File: wp-includes/class-wp-customize-setting.php
final protected function multidimensional_replace( $root, $keys, $value ) {
if ( ! isset( $value ) ) {
return $root;
} elseif ( empty( $keys ) ) { // If there are no keys, we're replacing the root.
return $value;
}
$result = $this->multidimensional( $root, $keys, true );
if ( isset( $result ) ) {
$result['node'][ $result['key'] ] = $value;
}
return $root;
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 3.4.0 | Introduced. |