# wp_add_id3_tag_data()

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

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

## Сигнатура

```php
wp_add_id3_tag_data( array $metadata, array $data )
```

## Описание

Разбирает комментарии ID3v2, ID3v1 и getID3 для извлечения пригодных данных.

## Параметры

- `$metadata` `array` — обязательный. Существующий массив с данными.
- `$data` `array` — обязательный. Данные, предоставленные ID3-тегами.

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

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

```php
function wp_add_id3_tag_data( &$metadata, $data ) {
	foreach ( array( 'id3v2', 'id3v1' ) as $version ) {
		if ( ! empty( $data[ $version ]['comments'] ) ) {
			foreach ( $data[ $version ]['comments'] as $key => $list ) {
				if ( 'length' !== $key && ! empty( $list ) ) {
					$metadata[ $key ] = is_array( $list ) ? wp_kses_post_deep( reset( $list ) ) : wp_kses_post( $list );
					// Fix bug in byte stream analysis.
					if ( 'terms_of_use' === $key && str_starts_with( $metadata[ $key ], 'yright notice.' ) ) {
						$metadata[ $key ] = 'Cop' . $metadata[ $key ];
					}
				}
			}
			break;
		}
	}

	if ( ! empty( $data['id3v2']['APIC'] ) ) {
		$image = reset( $data['id3v2']['APIC'] );
		if ( ! empty( $image['data'] ) ) {
			$metadata['image'] = array(
				'data'   => $image['data'],
				'mime'   => $image['image_mime'],
				'width'  => $image['image_width'],
				'height' => $image['image_height'],
			);
		}
	} elseif ( ! empty( $data['comments']['picture'] ) ) {
		$image = reset( $data['comments']['picture'] );
		if ( ! empty( $image['data'] ) ) {
			$metadata['image'] = array(
				'data' => $image['data'],
				'mime' => $image['image_mime'],
			);
		}
	}
}
```

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

- 3.6.0 — Introduced.

## Связанные

Использует: [`wp_kses_post_deep`](https://chugunov.pro/api-wordpress/functions/wp_kses_post_deep/), [`wp_kses_post`](https://chugunov.pro/api-wordpress/functions/wp_kses_post/).
Используется в: [`wp_read_video_metadata`](https://chugunov.pro/api-wordpress/functions/wp_read_video_metadata/), [`wp_read_audio_metadata`](https://chugunov.pro/api-wordpress/functions/wp_read_audio_metadata/).

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