Inline documentation for hooks in wp-admin/media-upload.php.

Props piontkowski for the initial patch.
Fixes #26075.

Built from https://develop.svn.wordpress.org/trunk@26917


git-svn-id: http://core.svn.wordpress.org/trunk@26798 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Drew Jaynes 2014-01-08 04:00:11 +00:00
parent 76ad336c2c
commit b3b3316102
1 changed files with 42 additions and 8 deletions

View File

@ -38,10 +38,19 @@ if ( isset($action) && $action == 'edit' && !$ID )
wp_die( __( 'Cheatin’ uh?' ) ); wp_die( __( 'Cheatin’ uh?' ) );
// upload type: image, video, file, ..? // upload type: image, video, file, ..?
if ( isset($_GET['type']) ) if ( isset($_GET['type']) ) {
$type = strval($_GET['type']); $type = strval($_GET['type']);
else } else {
$type = apply_filters('media_upload_default_type', 'file'); /**
* 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 // tab: gallery, library, or type-specific
if ( isset($_GET['tab']) ) { if ( isset($_GET['tab']) ) {
@ -52,7 +61,7 @@ if ( isset($action) && $action == 'edit' && !$ID )
* *
* @since 2.5.0 * @since 2.5.0
* *
* @param string $type The default media popup tab. * @param string $type The default media popup tab. Default 'type' (From Computer).
*/ */
$tab = apply_filters( 'media_upload_default_tab', 'type' ); $tab = apply_filters( 'media_upload_default_tab', 'type' );
} }
@ -60,7 +69,32 @@ if ( isset($action) && $action == 'edit' && !$ID )
$body_id = 'media-upload'; $body_id = 'media-upload';
// let the action code decide how to handle the request // let the action code decide how to handle the request
if ( $tab == 'type' || $tab == 'type_url' || ! array_key_exists( $tab , media_upload_tabs() ) ) if ( $tab == 'type' || $tab == 'type_url' || ! array_key_exists( $tab , media_upload_tabs() ) ) {
do_action("media_upload_$type"); /**
else * Fires inside specific upload-type views in the legacy (pre-3.5.0)
do_action("media_upload_$tab"); * 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" );
}