Описание img_caption_shortcode
— Filter
Хук img_caption_shortcode позволяет изменить вывод подписей к изображениям в WordPress. Он срабатывает при рендеринге шорткода для подписи изображения и позволяет настроить HTML-разметку и содержимое подписи
Примеры использования
Изменение HTML-разметки для подписей:
add_filter('img_caption_shortcode', function($output, $attr, $content) {
$output = '<div class="custom-caption">' . $content . '</div>';
return $output;
}, 10, 3);
Этот пример изменяет HTML-код, оборачивая содержимое подписи в кастомный div
Добавление CSS-класса к подписи:
add_filter('img_caption_shortcode', function($output, $attr, $content) {
$attr['class'] .= ' my-custom-class';
$output = '<div class="' . esc_attr($attr['class']) . '">' . $content . '</div>';
return $output;
}, 10, 3);
Здесь мы добавляем дополнительный CSS-класс к контейнеру подписи
Изменение текста подписи в зависимости от содержимого:
add_filter('img_caption_shortcode', function($output, $attr, $content) {
if (empty($content)) {
$content = 'Нет подписи';
}
$output = '<div class="wp-caption">' . $content . '</div>';
return $output;
}, 10, 3);
В этом примере, если подпись пустая, мы добавляем текст ‘Нет подписи’
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить отображение подписей к изображениям в контенте WordPress
– Производительность
Хук не должен значительно влиять на производительность, так как изменения касаются только вывода HTML
– Предупреждения
Убедитесь, что изменения не нарушают доступность и семантику контента
Альтернативы
Тип: filter
Этот хук позволяет изменить HTML-код для миниатюр постов
Используйте его, если необходимо изменить вывод миниатюр, а не только подписей к изображениям
