Описание image_send_to_editor
— Filter
Хук image_send_to_editor позволяет изменить HTML-код изображения перед его вставкой в редактор. Он срабатывает после загрузки изображения и перед его вставкой, что позволяет настраивать вывод изображения по своему усмотрению
Примеры использования
Пример добавления кастомного класса к изображению:
add_filter('image_send_to_editor', function($html, $id, $attachment) {
return str_replace('<img', '<img class="custom-class"', $html);
}, 10, 3);
В этом примере мы добавляем класс ‘custom-class’ к тегу перед вставкой в редактор
Пример изменения alt-текста изображения:
add_filter('image_send_to_editor', function($html, $id, $attachment) {
$new_alt = 'Мой кастомный alt';
return str_replace('alt="', 'alt="'.$new_alt.'" ', $html);
}, 10, 3);
Здесь мы изменяем alt-текст изображения на ‘Мой кастомный alt’
Пример добавления дополнительных атрибутов к изображению:
add_filter('image_send_to_editor', function($html, $id, $attachment) {
return str_replace('<img', '<img data-custom="value"', $html);
}, 10, 3);
Мы добавляем атрибут data-custom к изображению
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить HTML-код изображения перед вставкой в редактор
– Производительность
Хук не оказывает значительного влияния на производительность, но избегайте сложных операций с большими массивами данных
– Предупреждения
Следите за тем, чтобы изменения не нарушали структуру HTML и не вызывали ошибок в отображении изображений
Альтернативы
Тип: filter
Этот хук позволяет модифицировать все типы медиа перед их вставкой в редактор
Используйте его, если требуется изменить не только изображения, но и другие медиа-элементы
