$ID = isset($ID) ? (int) $ID : 0;
$post_id = isset($post_id)? (int) $post_id : 0;
-// Require an ID for the edit screen
+// Require an ID for the edit screen.
if ( isset($action) && $action == 'edit' && !$ID )
wp_die( __( 'Cheatin’ uh?' ) );
if ( ! empty( $_REQUEST['post_id'] ) && ! current_user_can( 'edit_post' , $_REQUEST['post_id'] ) )
wp_die( __( 'Cheatin’ uh?' ) );
- // upload type: image, video, file, ..?
- if ( isset($_GET['type']) )
+ // Upload type: image, video, file, ..?
+ if ( isset($_GET['type']) ) {
$type = strval($_GET['type']);
- else
- $type = apply_filters('media_upload_default_type', 'file');
+ } else {
+ /**
+ * Filter the default media upload type in the legacy (pre-3.5.0) media popup.
+ *
+ * @since 2.5.0
+ *
+ * @param string $type The default media upload type. Possible values include
+ * 'image', 'audio', 'video', 'file', etc. Default 'file'.
+ */
+ $type = apply_filters( 'media_upload_default_type', 'file' );
+ }
- // tab: gallery, library, or type-specific
- if ( isset($_GET['tab']) )
+ // Tab: gallery, library, or type-specific.
+ if ( isset($_GET['tab']) ) {
$tab = strval($_GET['tab']);
- else
- $tab = apply_filters('media_upload_default_tab', 'type');
+ } else {
+ /**
+ * Filter the default tab in the legacy (pre-3.5.0) media popup.
+ *
+ * @since 2.5.0
+ *
+ * @param string $type The default media popup tab. Default 'type' (From Computer).
+ */
+ $tab = apply_filters( 'media_upload_default_tab', 'type' );
+ }
$body_id = 'media-upload';
- // let the action code decide how to handle the request
- if ( $tab == 'type' || $tab == 'type_url' || ! array_key_exists( $tab , media_upload_tabs() ) )
- do_action("media_upload_$type");
- else
- do_action("media_upload_$tab");
+ // Let the action code decide how to handle the request.
+ if ( $tab == 'type' || $tab == 'type_url' || ! array_key_exists( $tab , media_upload_tabs() ) ) {
+ /**
+ * Fires inside specific upload-type views in the legacy (pre-3.5.0)
+ * media popup based on the current tab.
+ *
+ * The dynamic portion of the hook name, $type, refers to the specific
+ * media upload type. Possible values include 'image', 'audio', 'video',
+ * 'file', etc.
+ *
+ * The hook only fires if the current $tab is 'type' (From Computer),
+ * 'type_url' (From URL), or, if the tab does not exist (i.e., has not
+ * been registered via the 'media_upload_tabs' filter.
+ *
+ * @since 2.5.0
+ */
+ do_action( "media_upload_$type" );
+ } else {
+ /**
+ * Fires inside limited and specific upload-tab views in the legacy
+ * (pre-3.5.0) media popup.
+ *
+ * The dynamic portion of the hook name, $tab, refers to the specific
+ * media upload tab. Possible values include 'library' (Media Library),
+ * or any custom tab registered via the 'media_upload_tabs' filter.
+ *
+ * @since 2.5.0
+ */
+ do_action( "media_upload_$tab" );
+ }