media_send_to_editor │ filter-hook │ WP 2.5.0

Filters the HTML markup for a media item sent to the editor.

Usage

add_filter( 'media_send_to_editor', 'wp_kama_media_send_to_editor_filter', 10, 3 );

/**
 * Function for `media_send_to_editor` filter-hook.
 * 
 * @param string $html       HTML markup for a media item sent to the editor.
 * @param int    $send_id    The first key from the $_POST['send'] data.
 * @param array  $attachment Array of attachment metadata.
 *
 * @return string
 */
function wp_kama_media_send_to_editor_filter( $html, $send_id, $attachment ){

	// filter...
	return $html;
}

$html(string)

HTML markup for a media item sent to the editor.

$send_id(int)

The first key from the $_POST['send'] data.

$attachment(array)

Array of attachment metadata.

Changelog

Where the hook is called

$html = apply_filters( 'media_send_to_editor', $html, $send_id, $attachment );

$html = apply_filters( 'media_send_to_editor', $html, $id, $attachment );

Where the hook is used in WordPress

remove_filter( 'media_send_to_editor', 'image_media_send_to_editor' );

add_filter( 'media_send_to_editor', 'image_media_send_to_editor', 10, 3 );