云策 WordPress 开发者社区

函数文档

media_upload_gallery()

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

概述

media_upload_gallery() 函数用于在 iframe 中检索旧版媒体上传器表单，主要用于处理图库上传。它通过 wp_iframe() 输出表单，并处理可能的表单提交错误。

关键要点

  • 函数返回类型为 string|null，可能返回字符串或 null 值。
  • 如果存在 POST 数据，会调用 media_upload_form_handler() 处理表单提交，并根据返回类型处理错误或直接返回结果。
  • 函数会通过 wp_enqueue_script() 加载 'admin-gallery' 脚本，以支持图库上传功能。
  • 最终通过 wp_iframe() 输出 media_upload_gallery_form 表单，并传递错误数组。

相关函数

  • media_upload_form_handler() – 处理旧版媒体上传器的表单提交。
  • wp_iframe() – 输出 iframe 以显示媒体上传页面。
  • wp_enqueue_script() – 用于加载脚本。

更新日志

  • 2.5.0 – 函数首次引入。
📄 原文内容

Retrieves the legacy media uploader form in an iframe.

Return

string|null

Source

function media_upload_gallery() {
	$errors = array();

	if ( ! empty( $_POST ) ) {
		$return = media_upload_form_handler();

		if ( is_string( $return ) ) {
			return $return;
		}

		if ( is_array( $return ) ) {
			$errors = $return;
		}
	}

	wp_enqueue_script( 'admin-gallery' );
	return wp_iframe( 'media_upload_gallery_form', $errors );
}

View all references View on Trac View on GitHub

Uses Description
media_upload_form_handler()wp-admin/includes/media.php

Handles form submissions for the legacy media uploader.
wp_iframe()wp-admin/includes/media.php

Outputs the iframe to display the media upload page.
wp_enqueue_script()wp-includes/functions.wp-scripts.php

Enqueues a script.

Changelog

Version Description
2.5.0 Introduced.