# get_image_send_to_editor()

URL: https://chugunov.pro/api-wordpress/functions/get_image_send_to_editor/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 2.5.0.

## Сигнатура

```php
get_image_send_to_editor( int $id, string $caption, string $title, string $align, string $url = '', bool|string $rel = false, string|int[] $size = 'medium', string $alt = '' ): string
```

## Описание

Извлекает HTML изображения для отправки в редактор.

## Параметры

- `$id` `int` — обязательный. Идентификатор вложения-изображения.
- `$caption` `string` — обязательный. Подпись изображения.
- `$title` `string` — обязательный. Атрибут title изображения.
- `$align` `string` — обязательный. Свойство CSS-выравнивания изображения.
- `$url` `string` — необязательный, по умолчанию `''`. URL изображения (src).
- `$rel` `bool|string` — необязательный, по умолчанию `false`. Значение атрибута rel или указание, добавлять ли значение по умолчанию.
- `$size` `string|int[]` — необязательный, по умолчанию `'medium'`. Размер изображения. Принимает имя любого зарегистрированного размера изображения или массив значений ширины и высоты в пикселях (именно в таком порядке). Значение по умолчанию 'medium'.
- `$alt` `string` — необязательный, по умолчанию `''`. Атрибут alt изображения.

## Возвращаемое значение

`string`

## Исходный код

Файл: `wp-admin/includes/media.php:133`

```php
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;
}
```

## История изменений

- 2.5.0 — Introduced.

## Связанные

Использует: [`get_image_tag`](https://chugunov.pro/api-wordpress/functions/get_image_tag/), [`esc_attr`](https://chugunov.pro/api-wordpress/functions/esc_attr/), [`esc_url`](https://chugunov.pro/api-wordpress/functions/esc_url/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: [`image_media_send_to_editor`](https://chugunov.pro/api-wordpress/functions/image_media_send_to_editor/), [`wp_ajax_send_attachment_to_editor`](https://chugunov.pro/api-wordpress/functions/wp_ajax_send_attachment_to_editor/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/get_image_send_to_editor/