# get_media_items()

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

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

## Сигнатура

```php
get_media_items( int $post_id, array $errors ): string
```

## Описание

Полученная HTML-разметка создаётся для индикатора прогресса компонента SWF Upload. Также создаётся ссылка для показа и скрытия формы изменения изображения-вложения.

## Параметры

- `$post_id` `int` — обязательный. Идентификатор записи.
- `$errors` `array` — обязательный. Ошибки вложения, если есть.

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

`string`

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

Файл: `wp-admin/includes/media.php:1546`

```php
function get_media_items( $post_id, $errors ) {
	$attachments = array();

	if ( $post_id ) {
		$post = get_post( $post_id );

		if ( $post && 'attachment' === $post->post_type ) {
			$attachments = array( $post->ID => $post );
		} else {
			$attachments = get_children(
				array(
					'post_parent' => $post_id,
					'post_type'   => 'attachment',
					'orderby'     => 'menu_order ASC, ID',
					'order'       => 'DESC',
				)
			);
		}
	} else {
		if ( is_array( $GLOBALS['wp_the_query']->posts ) ) {
			foreach ( $GLOBALS['wp_the_query']->posts as $attachment ) {
				$attachments[ $attachment->ID ] = $attachment;
			}
		}
	}

	$output = '';
	foreach ( (array) $attachments as $id => $attachment ) {
		if ( 'trash' === $attachment->post_status ) {
			continue;
		}

		$item = get_media_item( $id, array( 'errors' => $errors[ $id ] ?? null ) );

		if ( $item ) {
			$output .= "\n<div id='media-item-$id' class='media-item child-of-$attachment->post_parent preloaded'><div class='progress hidden'><div class='bar'></div></div><div id='media-upload-error-$id' class='hidden'></div><div class='filename hidden'></div>$item\n</div>";
		}
	}

	return $output;
}
```

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

- 2.5.0 — Introduced.

## Связанные

Использует: [`get_children`](https://chugunov.pro/api-wordpress/functions/get_children/), [`get_media_item`](https://chugunov.pro/api-wordpress/functions/get_media_item/), [`get_post`](https://chugunov.pro/api-wordpress/functions/get_post/).
Используется в: [`media_upload_type_form`](https://chugunov.pro/api-wordpress/functions/media_upload_type_form/), [`media_upload_gallery_form`](https://chugunov.pro/api-wordpress/functions/media_upload_gallery_form/), [`media_upload_library_form`](https://chugunov.pro/api-wordpress/functions/media_upload_library_form/).

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