media_upload_library_form( array $errors )

Parameters

$errorsarray

Hooks fired · 2

2 hooks fire while media_upload_library_form() runs, in this order:

1. 1
   apply_filters( media_upload_form_url )filterline 2726 (+9 into the body)

   Filters the media upload form action URL.

2. 2
   apply_filters( media_upload_mime_type_links )filterline 2827 (+110 into the body)

   Filters the media upload mime type list items.

Uses · 23

• media_upload_header()Outputs the legacy media upload header.
• admin_url()Retrieves the URL to the admin area for the current site.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• get_user_setting()Retrieves user interface setting value based on setting name.
• wp_edit_attachments_query()Executes a query for attachments. An array of WP_Query arguments can be passed in, which will override the arguments set by this function.
• esc_attr()Escaping for HTML attributes.
• _e()Displays translated text.
• the_search_query()Displays the contents of the search query variable.
• submit_button()Echoes a submit button, with provided text and appropriate class(es).
• __()Retrieves the translation of $text.
• wp_count_attachments()Counts number of attachments for the mime type(s).
• wp_match_mime_types()Checks a MIME-Type against a list.

Source

View on Trac ↗View on GitHub ↗

2717function media_upload_library_form( $errors ) {2718	global $wpdb, $wp_query, $wp_locale, $type, $tab, $post_mime_types;2719 2720	media_upload_header();2721 2722	$post_id = isset( $_REQUEST['post_id'] ) ? (int) $_REQUEST['post_id'] : 0;2723 2724	$form_action_url = admin_url( "media-upload.php?type=$type&tab=library&post_id=$post_id" );2725	/** This filter is documented in wp-admin/includes/media.php */2726	$form_action_url = apply_filters( 'media_upload_form_url', $form_action_url, $type );2727	$form_class      = 'media-upload-form validate';2728 2729	if ( get_user_setting( 'uploader' ) ) {2730		$form_class .= ' html-uploader';2731	}2732 2733	$q                   = $_GET;2734	$q['posts_per_page'] = 10;2735	$q['paged']          = isset( $q['paged'] ) ? (int) $q['paged'] : 0;2736	if ( $q['paged'] < 1 ) {2737		$q['paged'] = 1;2738	}2739	$q['offset'] = ( $q['paged'] - 1 ) * 10;2740	if ( $q['offset'] < 1 ) {2741		$q['offset'] = 0;2742	}2743 2744	list($post_mime_types, $avail_post_mime_types) = wp_edit_attachments_query( $q );2745 2746	?>2747	<form id="filter" method="get">2748	<input type="hidden" name="type" value="<?php echo esc_attr( $type ); ?>" />2749	<input type="hidden" name="tab" value="<?php echo esc_attr( $tab ); ?>" />2750	<input type="hidden" name="post_id" value="<?php echo (int) $post_id; ?>" />2751	<input type="hidden" name="post_mime_type" value="<?php echo isset( $_GET['post_mime_type'] ) ? esc_attr( $_GET['post_mime_type'] ) : ''; ?>" />2752	<input type="hidden" name="context" value="<?php echo isset( $_GET['context'] ) ? esc_attr( $_GET['context'] ) : ''; ?>" />2753 2754	<p id="media-search" class="search-box">2755		<label class="screen-reader-text" for="media-search-input">2756			<?php2757			/* translators: Hidden accessibility text. */2758			_e( 'Search Media:' );2759			?>2760		</label>2761		<input type="search" id="media-search-input" name="s" value="<?php the_search_query(); ?>" />2762		<?php submit_button( __( 'Search Media' ), '', '', false ); ?>2763	</p>2764 2765	<ul class="subsubsub">2766		<?php2767		$type_links = array();2768		$_num_posts = (array) wp_count_attachments();2769		$matches    = wp_match_mime_types( array_keys( $post_mime_types ), array_keys( $_num_posts ) );2770		foreach ( $matches as $_type => $reals ) {2771			foreach ( $reals as $real ) {2772				if ( isset( $num_posts[ $_type ] ) ) {2773					$num_posts[ $_type ] += $_num_posts[ $real ];2774				} else {2775					$num_posts[ $_type ] = $_num_posts[ $real ];2776				}2777			}2778		}2779		// If available type specified by media button clicked, filter by that type.2780		if ( empty( $_GET['post_mime_type'] ) && ! empty( $num_posts[ $type ] ) ) {2781			$_GET['post_mime_type']                        = $type;2782			list($post_mime_types, $avail_post_mime_types) = wp_edit_attachments_query();2783		}2784		if ( empty( $_GET['post_mime_type'] ) || 'all' === $_GET['post_mime_type'] ) {2785			$class = ' class="current"';2786		} else {2787			$class = '';2788		}2789		$type_links[] = '<li><a href="' . esc_url(2790			add_query_arg(2791				array(2792					'post_mime_type' => 'all',2793					'paged'          => false,2794					'm'              => false,2795				)2796			)

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.8.8 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.