get_upload_iframe_src( string $type = null, int $post_id = null, string $tab = null ): string
- Since
- 3.0.0
- Source
wp-admin/includes/media.php:714
Retrieves the upload iframe source URL.
Parameters
$typestringoptional- Media type.Default:
null $post_idintoptional- Post ID.Default:
null $tabstringoptional- Media upload tab.Default:
null
Return
string- Upload iframe source URL.
Hooks fired · 1
One hook fires while get_upload_iframe_src() runs, in this order:
- apply_filters( {$type}_upload_iframe_src )filterline 746 (+32 into the body)
Filters the upload iframe source URL for a specific media type.
Uses · 3
- add_query_arg()Retrieves a modified URL query string.
- 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.
Used by · 1
- _wp_post_thumbnail_html()Returns HTML for the post thumbnail meta box.
Source
function get_upload_iframe_src( $type = null, $post_id = null, $tab = null ) { global $post_ID; if ( empty( $post_id ) ) { $post_id = $post_ID; } $upload_iframe_src = add_query_arg( 'post_id', (int) $post_id, admin_url( 'media-upload.php' ) ); if ( $type && 'media' !== $type ) { $upload_iframe_src = add_query_arg( 'type', $type, $upload_iframe_src ); } if ( ! empty( $tab ) ) { $upload_iframe_src = add_query_arg( 'tab', $tab, $upload_iframe_src ); } /** * Filters the upload iframe source URL for a specific media type. * * The dynamic portion of the hook name, `$type`, refers to the type * of media uploaded. * * Possible hook names include: * * - `image_upload_iframe_src` * - `media_upload_iframe_src` * * @since 3.0.0 * * @param string $upload_iframe_src The upload iframe source URL. */ $upload_iframe_src = apply_filters( "{$type}_upload_iframe_src", $upload_iframe_src ); return add_query_arg( 'TB_iframe', true, $upload_iframe_src );}History
Introduced in 3.0.0. Unchanged from 6.7.7 through 7.1.0.
Signature, return type and hooks compared across 5 parsed releases.
About this page
- Parsed data
- Generated from the wordpress-develop 7.0.4 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.