Question

get_media_items( int $post_id,  array $errors )

Retrieve HTML for media items of post gallery.

---

description

The HTML markup retrieved will be created for the progress of SWF Upload component. Will also create link for showing and hiding the form to modify the image attachment.

---

参数

$post_id

(int) (Optional) Post ID.

$errors

(array) (Optional) Errors for attachment, if any.

---

返回值

(string)

---

源代码

File: wp-admin/includes/media.php

function get_media_items( $post_id, $errors ) {
	$attachments = array();
	if ( $post_id ) {
		$post = get_post($post_id);
		if ( $post && $post->post_type == 'attachment' )
			$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 ( $attachment->post_status == 'trash' )
			continue;
		if ( $item = get_media_item( $id, array( 'errors' => isset($errors[$id]) ? $errors[$id] : null) ) )
			$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;
}

---

更新日志

Version	description
2.5.0	Introduced.

---

相关函数

Uses

• wp-includes/post.php: get_children()
• wp-admin/includes/media.php: get_media_item()
• wp-includes/post.php: get_post()

---

Used By

• wp-admin/includes/media.php: media_upload_type_form()
• wp-admin/includes/media.php: media_upload_gallery_form()
• wp-admin/includes/media.php: media_upload_library_form()

---

User Contributed Notes