get_image_send_to_editor()WP 2.5.0

Retrieves the image HTML to send to the editor.

Хуки из функции

Возвращает

Строку. The HTML output to insert into the editor.

Использование

get_image_send_to_editor( $id, $caption, $title, $align, $url, $rel, $size, $alt );
$id(int) (обязательный)
Image attachment ID.
$caption(строка) (обязательный)
Image caption.
$title(строка) (обязательный)
Image title attribute.
$align(строка) (обязательный)
Image CSS alignment property.
$url(строка)
Image src URL.
По умолчанию: ''
$rel(true|false|строка)
Value for rel attribute or whether to add a default value.
По умолчанию: false
$size(строка|int[])
Image size. Accepts any registered image size name, or an array of width and height values in pixels (in that order).
По умолчанию: 'medium'
$alt(строка)
Image alt attribute.
По умолчанию: ''

Список изменений

С версии 2.5.0 Введена.

Код get_image_send_to_editor() WP 6.4.3

function get_image_send_to_editor( $id, $caption, $title, $align, $url = '', $rel = false, $size = 'medium', $alt = '' ) {

	$html = get_image_tag( $id, $alt, '', $align, $size );

	if ( $rel ) {
		if ( is_string( $rel ) ) {
			$rel = ' rel="' . esc_attr( $rel ) . '"';
		} else {
			$rel = ' rel="attachment wp-att-' . (int) $id . '"';
		}
	} else {
		$rel = '';
	}

	if ( $url ) {
		$html = '<a href="' . esc_url( $url ) . '"' . $rel . '>' . $html . '</a>';
	}

	/**
	 * Filters the image HTML markup to send to the editor when inserting an image.
	 *
	 * @since 2.5.0
	 * @since 5.6.0 The `$rel` parameter was added.
	 *
	 * @param string       $html    The image HTML markup to send.
	 * @param int          $id      The attachment ID.
	 * @param string       $caption The image caption.
	 * @param string       $title   The image title.
	 * @param string       $align   The image alignment.
	 * @param string       $url     The image source URL.
	 * @param string|int[] $size    Requested image size. Can be any registered image size name, or
	 *                              an array of width and height values in pixels (in that order).
	 * @param string       $alt     The image alternative, or alt, text.
	 * @param string       $rel     The image rel attribute.
	 */
	$html = apply_filters( 'image_send_to_editor', $html, $id, $caption, $title, $align, $url, $size, $alt, $rel );

	return $html;
}