Описание post_gallery
— Filter
Хук post_gallery позволяет изменить вывод галереи изображений в записи WordPress. Он срабатывает при использовании функции wp_gallery и позволяет настроить HTML-код, используемый для отображения галереи, передавая массив вложений.
Примеры использования
Пример изменения HTML-кода галереи:
add_filter('post_gallery', function($output, $attr) {
return '<div class="custom-gallery">' . $output . '</div>';
}, 10, 2);
В этом примере мы оборачиваем стандартный вывод галереи в кастомный div с классом ‘custom-gallery’.
Пример изменения атрибутов галереи:
add_filter('post_gallery', function($output, $attr) {
$attr['columns'] = '4';
return gallery_shortcode($attr);
}, 10, 2);
Здесь мы изменяем количество колонок галереи на 4.
Пример добавления кастомного класса к галерее:
add_filter('post_gallery', function($output, $attr) {
$output = str_replace('gallery', 'gallery custom-gallery', $output);
return $output;
}, 10, 2);
Мы добавляем класс ‘custom-gallery’ к стандартному классу ‘gallery’.
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо настроить вывод галереи изображений в записях WordPress
– Производительность
Изменения могут повлиять на производительность, если используются сложные операции с массивами изображений
– Предупреждения
Следите за тем, чтобы изменения не нарушали общую структуру и стилизацию галерей на сайте
Альтернативы
Тип: function
Функция для получения HTML-ссылки на изображение
Используйте, если необходимо управлять выводом отдельных изображений, а не целой галереи
Тип: function
Функция для генерации галереи на основе атрибутов
Используйте, когда нужно создать галерею программно без использования хука
