WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

media_upload_tabs()

media_upload_tabs(): string[]

In this article

Back to top

Defines the default media upload tabs.

Return

string[] Default tabs.

Source

function media_upload_tabs() {
	$_default_tabs = array(
		'type'     => __( 'From Computer' ), // Handler action suffix => tab text.
		'type_url' => __( 'From URL' ),
		'gallery'  => __( 'Gallery' ),
		'library'  => __( 'Media Library' ),
	);

	/**
	 * Filters the available tabs in the legacy (pre-3.5.0) media popup.
	 *
	 * @since 2.5.0
	 *
	 * @param string[] $_default_tabs An array of media tabs.
	 */
	return apply_filters( 'media_upload_tabs', $_default_tabs );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘media_upload_tabs’, string[] $_default_tabs )

Filters the available tabs in the legacy (pre-3.5.0) media popup.

UsesDescription
__()wp-includes/l10n.php

Retrieves the translation of $text.

apply_filters()wp-includes/plugin.php

Calls the callback functions that have been added to a filter hook.

Used byDescription
the_media_upload_tabs()wp-admin/includes/media.php

Outputs the legacy media upload tabs UI.

Changelog

VersionDescription
2.5.0Introduced.

User Contributed Notes

  1. Skip to note 2 content
    publicJorn
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    This is a 2.5.0 filter. You can also use a newer filter (3.5.0) to achieve the same:
    https://developer.wordpress.org/reference/hooks/media_view_settings/

    So for example use:

    add_filter('media_view_settings', 'addTab');

function addTab($settings) {
  $settings['tabs'] = array('photogrid' => 'Photogrid');
  return $settings;
}

You must log in before being able to contribute a note or feedback.