WP_Customize_Widgets::sanitize_sidebar_widgets( string[] $widget_ids ): string[]

In this article

Ensures sidebar widget arrays only ever contain widget IDS.

Description

Used as the ‘sanitize_callback’ for each $sidebars_widgets setting.

Parameters

$widget_idsstring[]required
Array of widget IDs.

Return

string[] Array of sanitized widget IDs.

Source

public function sanitize_sidebar_widgets( $widget_ids ) {
	$widget_ids           = array_map( 'strval', (array) $widget_ids );
	$sanitized_widget_ids = array();
	foreach ( $widget_ids as $widget_id ) {
		$sanitized_widget_ids[] = preg_replace( '/[^a-z0-9_\-]/', '', $widget_id );
	}
	return $sanitized_widget_ids;
}

Changelog

VersionDescription
3.9.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.