display_media_states хук-фильтрWP 3.2.0

Filters the default media display states for items in the Media list table.

Использование

add_filter( 'display_media_states', 'wp_kama_display_media_states_filter', 10, 2 );

/**
 * Function for `display_media_states` filter-hook.
 * 
 * @param string[] $media_states An array of media states.
 * @param WP_Post  $post         The current attachment object.
 *
 * @return string[]
 */
function wp_kama_display_media_states_filter( $media_states, $post ){

	// filter...
	return $media_states;
}
$media_states(string[])
An array of media states.
По умолчанию: 'Header Image', 'Background Image', 'Site Icon', 'Logo'
$post(WP_Post)
The current attachment object.

Список изменений

С версии 3.2.0 Введена.
С версии 4.8.0 Added the $post parameter.

Где вызывается хук

get_media_states()
display_media_states
wp-admin/includes/template.php 2469
return apply_filters( 'display_media_states', $media_states, $post );

Где используется хук в WordPress

wp-includes/widgets/class-wp-widget-media.php 126
add_filter( 'display_media_states', array( $this, 'display_media_state' ), 10, 2 );