# _media_states()

URL: https://chugunov.pro/api-wordpress/functions/_media_states/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 3.2.0.

## Сигнатура

```php
_media_states( WP_Post $post, bool $display = true ): string
```

## Описание

Выводит медиа-состояния вложения в виде HTML.

## Параметры

- `$post` `WP_Post` — обязательный. Запись вложения, для которой нужно получить состояния.
- `$display` `bool` — необязательный, по умолчанию `true`. Выводить ли состояния записи в виде HTML-строки.

## Возвращаемое значение

`string`

## Исходный код

Файл: `wp-admin/includes/template.php:2382`

```php
function _media_states( $post, $display = true ) {
	$media_states        = get_media_states( $post );
	$media_states_string = '';

	if ( ! empty( $media_states ) ) {
		$state_count = count( $media_states );
		$separator   = wp_get_list_item_separator();

		$i = 0;

		$media_states_string .= ' — ';

		foreach ( $media_states as $state ) {
			++$i;

			$suffix = ( $i < $state_count ) ? $separator : '';

			$media_states_string .= "<span class='post-state'>{$state}{$suffix}</span>";
		}
	}

	if ( $display ) {
		echo $media_states_string;
	}

	return $media_states_string;
}
```

## История изменений

- 5.6.0 — Added the $display parameter and a return value.
- 3.2.0 — Introduced.

## Связанные

Использует: [`wp_get_list_item_separator`](https://chugunov.pro/api-wordpress/functions/wp_get_list_item_separator/), [`get_media_states`](https://chugunov.pro/api-wordpress/functions/get_media_states/).
Используется в: `WP_Media_List_Table::column_title`.

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/_media_states/