WP_Customize_Widgets::filter_wp_kses_allowed_data_attributes() WordPress Method
The WP_Customize_Widgets::filter_wp_kses_allowed_data_attributes() method is used to filter the allowed data attributes for widgets. This is useful for making sure that only the allowed data attributes are saved for widgets.
WP_Customize_Widgets::filter_wp_kses_allowed_data_attributes( array $allowed_html ) #
Ensures the HTML data-* attributes for selective refresh are allowed by kses.
Description
This is needed in case the $before_widget
is run through wp_kses() when printed.
Parameters
- $allowed_html
(array)(Required)Allowed HTML.
Return
(array) (Maybe) modified allowed HTML.
Source
File: wp-includes/class-wp-customize-widgets.php
public function filter_wp_kses_allowed_data_attributes( $allowed_html ) { foreach ( array_keys( $this->before_widget_tags_seen ) as $tag_name ) { if ( ! isset( $allowed_html[ $tag_name ] ) ) { $allowed_html[ $tag_name ] = array(); } $allowed_html[ $tag_name ] = array_merge( $allowed_html[ $tag_name ], array_fill_keys( array( 'data-customize-partial-id', 'data-customize-partial-type', 'data-customize-partial-placement-context', 'data-customize-partial-widget-id', 'data-customize-partial-options', ), true ) ); } return $allowed_html; }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
4.5.0 | Introduced. |