WP_Widget_Media::display_media_state()publicWP 4.8.0

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

Method of the class: WP_Widget_Media{}

No Hooks.

Return

Array.

Usage

$WP_Widget_Media = new WP_Widget_Media();
$WP_Widget_Media->display_media_state( $states, $post );
$states(array) (required)
An array of media states.
$post(WP_Post)
The current attachment object.
Default: null

Changelog

Since 4.8.0 Introduced.

WP_Widget_Media::display_media_state() code WP 6.4.3

public function display_media_state( $states, $post = null ) {
	if ( ! $post ) {
		$post = get_post();
	}

	// Count how many times this attachment is used in widgets.
	$use_count = 0;
	foreach ( $this->get_settings() as $instance ) {
		if ( isset( $instance['attachment_id'] ) && $instance['attachment_id'] === $post->ID ) {
			++$use_count;
		}
	}

	if ( 1 === $use_count ) {
		$states[] = $this->l10n['media_library_state_single'];
	} elseif ( $use_count > 0 ) {
		$states[] = sprintf( translate_nooped_plural( $this->l10n['media_library_state_multi'], $use_count ), number_format_i18n( $use_count ) );
	}

	return $states;
}