wp_parse_slug_list( mixed[]|string $input_list ): string[]

Cleans up an array, comma- or space-separated list of slugs.

Parameters

$input_listmixed[]|stringrequired: List of slugs.

Return

string[] Sanitized array of slugs. May include an empty string. Keys are preserved from the input and array_unique() may leave gaps, so the result is not necessarily a list.

Source

function wp_parse_slug_list( $input_list ): array {
	$input_list = wp_parse_list( $input_list );

	return array_unique(
		array_map(
			'sanitize_title',
			array_map(
				/*
				 * Cast booleans, integers, and floats to strings. Non-scalar types
				 * (including null) have already been filtered out by wp_parse_list().
				 */
				'strval',
				$input_list
			)
		)
	);
}

View all references View on Trac View on GitHub

Uses	Description
wp_parse_list()`wp-includes/functions.php`	Converts a comma- or space-separated list of scalar values to an array.

Used by	Description
WP_REST_Search_Controller::sanitize_subtypes()`wp-includes/rest-api/endpoints/class-wp-rest-search-controller.php`	Sanitizes the list of subtypes, to ensure only subtypes of the passed type are included.
WP_REST_Themes_Controller::sanitize_theme_status()`wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php`	Sanitizes and validates the list of theme status.
WP_REST_Posts_Controller::sanitize_post_statuses()`wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php`	Sanitizes and validates the list of post statuses, including whether the user can query private statuses.

Changelog

Version	Description
5.1.0	Refactored to use wp_parse_list() .
4.7.0	Introduced.

User Contributed Notes

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