Описание post_thumbnail_html
— Filter
Хук post_thumbnail_html позволяет изменять HTML-код, который генерируется для миниатюры поста. Он срабатывает при выводе миниатюры в области содержимого поста и позволяет настраивать ее отображение, добавляя, например, дополнительные классы или атрибуты к изображению
Примеры использования
Пример добавления класса к миниатюре поста:
add_filter('post_thumbnail_html', function($html, $post_id) {
$html = str_replace('class="', 'class="custom-class ', $html);
return $html;
});
В этом примере мы добавляем класс ‘custom-class’ к миниатюре поста
Пример изменения атрибута alt миниатюры:
add_filter('post_thumbnail_html', function($html, $post_id) {
$html = preg_replace('/alt=""/', 'alt="Описание миниатюры"', $html);
return $html;
});
Здесь мы изменяем атрибут alt на ‘Описание миниатюры’
Пример добавления обертки вокруг миниатюры:
add_filter('post_thumbnail_html', function($html, $post_id) {
return '<div class="thumbnail-wrapper">' . $html . '</div>';
});
Мы оборачиваем миниатюру в div с классом ‘thumbnail-wrapper’
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить вывод миниатюры поста, например, для добавления кастомных атрибутов или классов
– Производительность
Хук не должен значительно влиять на производительность, так как изменения касаются только вывода HTML
– Предупреждения
Убедитесь, что изменения не нарушают доступность изображений, особенно атрибут alt
Альтернативы
Тип: filter
Этот хук позволяет изменить размеры миниатюры перед ее выводом
Используйте его, если нужно изменить размеры изображения, а не только его HTML
