media_buttons() – Adds the media button to the editor

You appear to be a bot. Output may be restricted

Description

Adds the media button to the editor.

Usage

media_buttons( $editor_id );

Parameters

$editor_id
( string ) optional default: content –

Returns

void

Source

File name: wordpress/wp-admin/includes/media.php
Lines:

1 to 43 of 43
function media_buttons( $editor_id = 'content' ) {
  static $instance = 0;
  $instance++;

  $post = get_post();

  if ( ! $post && ! empty( $GLOBALS['post_ID'] ) ) {
    $post = $GLOBALS['post_ID'];
  }

  wp_enqueue_media( array( 'post' => $post ) );

  $img = '<span class="wp-media-buttons-icon"></span> ';

  $id_attribute = 1 === $instance ? ' id="insert-media-button"' : '';

  printf(
    '<button type="button"%s class="button insert-media add_media" data-editor="%s">%s</button>',
    $id_attribute,
    esc_attr( $editor_id ),
    $img . __( 'Add Media' )
  );

  
/**
 * Filters the legacy (pre-3.5.0) media buttons.
 *
 * Use {@see 'media_buttons'} action instead.
 *
 * @since 2.5.0
 * @deprecated 3.5.0 Use {@see 'media_buttons'} action instead.
 *
 * @param string $string Media buttons context. Default empty.
 */
  $legacy_filter = apply_filters_deprecated( 'media_buttons_context', array( '' ), '3.5.0', 'media_buttons' );

  if ( $legacy_filter ) {
    // #WP22559. Close <a> if a plugin started by closing <a> to open their own <a> tag.
    if ( 0 === stripos( trim( $legacy_filter ), '</a>' ) ) {
      $legacy_filter .= '</a>';
    }
    echo $legacy_filter;
  }
}
 

 View on GitHub View on Trac