функция
since 3.9.0
wp_get_attachment_id3_keys()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
wp_get_attachment_id3_keys( WP_Post $attachment, string $context = 'display' ): string[]
Описание
Возвращает полезные ключи для поиска данных в сохранённых метаданных вложения.
Параметры
$attachment
WP_Post
обязательный
Текущее вложение, предоставленное для контекста.
$context
string
необязательный
= 'display'
Контекст. Принимает 'edit', 'display'. Значение по умолчанию 'display'.
Возвращаемое значение
string[]
Исходный код
wp-includes/media.php:3345
function wp_get_attachment_id3_keys( $attachment, $context = 'display' ) {
$fields = array(
'artist' => __( 'Artist' ),
'album' => __( 'Album' ),
);
if ( 'display' === $context ) {
$fields['genre'] = __( 'Genre' );
$fields['year'] = __( 'Year' );
$fields['length_formatted'] = _x( 'Length', 'video or audio' );
} elseif ( 'js' === $context ) {
$fields['bitrate'] = __( 'Bitrate' );
$fields['bitrate_mode'] = __( 'Bitrate Mode' );
}
/**
* Filters the editable list of keys to look up data from an attachment's metadata.
*
* @since 3.9.0
*
* @param array $fields Key/value pairs of field keys to labels.
* @param WP_Post $attachment Attachment object.
* @param string $context The context. Accepts 'edit', 'display'. Default 'display'.
*/
return apply_filters( 'wp_get_attachment_id3_keys', $fields, $attachment, $context );
}
История изменений
| Версия | Описание |
|---|---|
| 3.9.0 | Introduced. |

