函数文档

media_upload_header()

💡 云策文档标注

概述

media_upload_header() 函数用于输出旧版媒体上传页面的头部内容,主要处理 post_id 参数并调用相关 UI 函数。

关键要点

  • 函数检查 $_REQUEST['post_id'] 参数,若存在则转换为整数,否则默认为 0。
  • 当 $_GET['chromeless'] 为空时,输出 HTML 结构并调用 the_media_upload_tabs() 函数来显示上传标签页。
  • 该函数自 WordPress 2.5.0 版本引入,属于旧版媒体上传系统的一部分。

代码示例

function media_upload_header() {
    $post_id = isset( $_REQUEST['post_id'] ) ? (int) $_REQUEST['post_id'] : 0;

    echo '';

    if ( empty( $_GET['chromeless'] ) ) {
        echo '';
        the_media_upload_tabs();
        echo '';
    }
}

注意事项

此函数是旧版媒体上传界面的组成部分,在现代 WordPress 开发中可能已过时,建议优先使用新的媒体 API 和界面。


📄 原文内容

Outputs the legacy media upload header.

Source

function media_upload_header() {
	$post_id = isset( $_REQUEST['post_id'] ) ? (int) $_REQUEST['post_id'] : 0;

	echo '<script type="text/javascript">post_id = ' . $post_id . ';</script>';

	if ( empty( $_GET['chromeless'] ) ) {
		echo '<div id="media-upload-header">';
		the_media_upload_tabs();
		echo '</div>';
	}
}

Changelog

Version Description
2.5.0 Introduced.