Question

wp_get_attachment_id3_keys( WP_Post $attachment,  string $context = 'display' )

Returns useful keys to use to lookup data from an attachment’s stored metadata.

---

description

---

参数

$attachment

(WP_Post) (Required) The current attachment, provided for context.

$context

(string) (Optional) The context. Accepts 'edit', 'display'.

Default value: 'display'

---

返回值

(array) Key/value pairs of field keys to labels.

---

源代码

File: wp-includes/media.php

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 );
}

---

更新日志

Version	description
3.9.0	Introduced.

---

相关函数

Uses

• wp-includes/l10n.php: __()
• wp-includes/l10n.php: _x()
• wp-includes/plugin.php: apply_filters()
• wp-includes/media.php: wp_get_attachment_id3_keys

---

Used By

• wp-admin/includes/post.php: edit_post()
• wp-admin/includes/ajax-actions.php: wp_ajax_save_attachment()
• wp-admin/includes/meta-boxes.php: attachment_id3_data_meta_box()
• wp-includes/media.php: wp_prepare_attachment_for_js()
• wp-includes/media.php: wp_playlist_shortcode()

---

User Contributed Notes