функция
since 2.5.0
get_image_send_to_editor()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
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
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. |

