media_upload_form( array $errors = null )

Parameters

$errorsarrayoptional

Default: null

Hooks fired · 9

9 hooks fire while media_upload_form() runs, in this order:

1. 1
   do_action( upload_ui_over_quota )actionline 2141 (+49 into the body)

   Fires when an upload will exceed the defined upload space quota for a network site.

2. 2
   do_action( pre-upload-ui )actionline 2150 (+58 into the body)

   Fires just before the legacy (pre-3.5.0) upload interface is loaded.

3. 3
   apply_filters( upload_post_params )filterline 2168 (+76 into the body)

   Filters the media upload post parameters.

4. 4
   apply_filters( plupload_init )filterline 2214 (+122 into the body)

   Filters the default Plupload settings.

5. 5
   do_action( pre-plupload-upload-ui )actionline 2245 (+153 into the body)

   Fires before the upload interface loads.

6. 6
   do_action( post-plupload-upload-ui )actionline 2262 (+170 into the body)

   Fires after the upload interface loads.

7. 7
   do_action( pre-html-upload-ui )actionline 2273 (+181 into the body)

   Fires before the upload button in the media upload interface.

8. 8
   do_action( post-html-upload-ui )actionline 2294 (+202 into the body)

   Fires after the upload button in the media upload interface.

9. 9
   do_action( post-upload-ui )actionline 2314 (+222 into the body)

   Fires on the post upload UI screen.

Uses · 22

• _device_can_upload()Tests if the current device has the capability to upload files.
• __()Retrieves the translation of $text.
• admin_url()Retrieves the URL to the admin area for the current site.
• wp_max_upload_size()Determines the maximum upload size allowed in php.ini.
• is_wp_error()Checks whether the given variable is a WordPress Error.
• is_multisite()Determines whether Multisite is enabled.
• is_upload_space_available()Determines if there is any upload space left in the current blog's quota.
• do_action()Calls the callback functions that have been added to an action hook.
• wp_create_nonce()Creates a cryptographic token tied to a specific action, user, user session, and window of time.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• wp_is_mobile()Test if the current browser runs on a mobile device (smart phone, tablet, etc.).
• str_contains()Polyfill for `str_contains()` function added in PHP 8.0.

Used by · 1

• media_upload_type_form()Outputs the legacy media upload form for a given media type.

Source

View on Trac ↗View on GitHub ↗

2092function media_upload_form( $errors = null ) {2093	global $type, $tab;2094 2095	if ( ! _device_can_upload() ) {2096		echo '<p>' . sprintf(2097			/* translators: %s: https://apps.wordpress.org/ */2098			__( 'The web browser on your device cannot be used to upload files. You may be able to use the <a href="%s">native app for your device</a> instead.' ),2099			'https://apps.wordpress.org/'2100		) . '</p>';2101		return;2102	}2103 2104	$upload_action_url = admin_url( 'async-upload.php' );2105	$post_id           = isset( $_REQUEST['post_id'] ) ? (int) $_REQUEST['post_id'] : 0;2106	$_type             = isset( $type ) ? $type : '';2107	$_tab              = isset( $tab ) ? $tab : '';2108 2109	$max_upload_size = wp_max_upload_size();2110	if ( ! $max_upload_size ) {2111		$max_upload_size = 0;2112	}2113 2114	?>2115	<div id="media-upload-notice">2116	<?php2117 2118	if ( isset( $errors['upload_notice'] ) ) {2119		echo $errors['upload_notice'];2120	}2121 2122	?>2123	</div>2124	<div id="media-upload-error">2125	<?php2126 2127	if ( isset( $errors['upload_error'] ) && is_wp_error( $errors['upload_error'] ) ) {2128		echo $errors['upload_error']->get_error_message();2129	}2130 2131	?>2132	</div>2133	<?php2134 2135	if ( is_multisite() && ! is_upload_space_available() ) {2136		/**2137		 * Fires when an upload will exceed the defined upload space quota for a network site.2138		 *2139		 * @since 3.5.02140		 */2141		do_action( 'upload_ui_over_quota' );2142		return;2143	}2144 2145	/**2146	 * Fires just before the legacy (pre-3.5.0) upload interface is loaded.2147	 *2148	 * @since 2.6.02149	 */2150	do_action( 'pre-upload-ui' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores2151 2152	$post_params = array(2153		'post_id'  => $post_id,2154		'_wpnonce' => wp_create_nonce( 'media-form' ),2155		'type'     => $_type,2156		'tab'      => $_tab,2157		'short'    => '1',2158	);2159 2160	/**2161	 * Filters the media upload post parameters.2162	 *2163	 * @since 3.1.0 As 'swfupload_post_params'2164	 * @since 3.3.02165	 *2166	 * @param array $post_params An array of media upload parameters used by Plupload.2167	 */2168	$post_params = apply_filters( 'upload_post_params', $post_params );2169 2170	/*2171	* Since 4.9 the `runtimes` setting is hardcoded in our version of Plupload to `html5,html4`,

History

Introduced in 2.5.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.7.7 tag, from src/wp-admin/includes/media.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.