云策 WordPress 开发者社区

函数文档

attachment_id3_data_meta_box()

查看官方原文 ↗
💡 云策文档标注

概述

attachment_id3_data_meta_box() 是一个 WordPress 函数，用于在附件编辑页面显示 ID3 数据的字段。它通过获取附件元数据并循环处理 ID3 键来生成输入框。

关键要点

  • 函数接受一个必需的参数 $post，类型为 WP_Post，表示当前附件对象。
  • 使用 wp_get_attachment_metadata() 获取附件的元数据。
  • 通过 wp_get_attachment_id3_keys() 获取 ID3 键和标签，用于生成表单字段。
  • 输出 HTML 输入框，每个字段对应一个 ID3 键，值从元数据中提取。
  • 相关函数包括 wp_get_attachment_id3_keys()、wp_get_attachment_metadata() 和 esc_attr()。
  • 该函数自 WordPress 3.9.0 版本引入。
📄 原文内容

Displays fields for ID3 data.

Parameters

$postWP_Postrequired
Current post object.

Source

function attachment_id3_data_meta_box( $post ) {

	$meta = array();

	if ( ! empty( $post->ID ) ) {

		$meta = wp_get_attachment_metadata( $post->ID );

	}


	foreach ( wp_get_attachment_id3_keys( $post, 'edit' ) as $key => $label ) :

		$value = '';

		if ( ! empty( $meta[ $key ] ) ) {

			$value = $meta[ $key ];

		}

		?>

	<p>

		<label for="title"></label><br />

		<input type="text" name="id3_<?php echo esc_attr( $key ); ?>" id="id3_<?php echo esc_attr( $key ); ?>" class="large-text" value="<?php echo esc_attr( $value ); ?>" />

	</p>

		</pre><p class="wporg-dot-link-list"><a href="https://developer.wordpress.org/reference/files/wp-admin/includes/meta-boxes.php/">View all references</a> <a href="https://core.trac.wordpress.org/browser/tags/6.9.4/src/wp-admin/includes/meta-boxes.php#L1497">View on Trac</a> <a href="https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-admin/includes/meta-boxes.php#L1497-L1515">View on GitHub</a></p></section>


		<section class="wp-block-wporg-code-reference-related" data-nosnippet="true"><h2 id="related" class="is-toc-heading wp-block-heading has-heading-5-font-size" tabindex="-1" ><a href="#related">Related</a></h2> <section style="margin-top:var(--wp--preset--spacing--20)" class="wp-block-wporg-code-table" id="uses"><figure class="wp-block-table "><table><thead><tr><th scope="col">Uses</th><th scope="col">Description</th></tr></thead><tbody><tr class=""><td><a href="https://developer.wordpress.org/reference/functions/wp_get_attachment_id3_keys/">wp_get_attachment_id3_keys()</a><code>wp-includes/media.php


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




wp_get_attachment_metadata()wp-includes/post.php


Retrieves attachment metadata for attachment ID.




esc_attr()wp-includes/formatting.php


Escaping for HTML attributes.







Show 1 moreShow less

Changelog

Version Description
3.9.0 Introduced.