Описание функции gallery_shortcode()
Функция gallery_shortcode() создает HTML-код для отображения галереи изображений на страницах и записях WordPress. Она используется для генерации визуально привлекательного представления изображений, которые были загружены в медиа-библиотеку.
Эта функция может принимать различные параметры для настройки отображения галереи, такие как количество колонок и размеры изображений.
Параметры
$atts
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив атрибутов для настройки галереи
Возможные значения:
ids: ID изображений через запятую
columns: Количество колонок (по умолчанию 3)
size: thumbnail, medium, large, full
link: none, file, post
Возвращаемое значение
Тип: string
Описание: HTML-код для галереи изображений
Возможные значения:
• HTML-код для отображения галереи при успешном выполнении
• Пустая строка если не указаны изображения
Примеры использования
Создание галереи с изображениями с ID 1, 2 и 3
Галерея будет отображена по умолчанию в 3 колонки
Создание галереи с 2 колонками и изображениями среднего размера
Изображения будут отображены в 2 колонки
Безопасность
Валидация входных данных: Все параметры проходят валидацию внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для атрибутов HTML
— Связанные функции
Получает HTML-код для одного изображения по ID
Получает метаданные для изображения
— Хуки
Фильтрует параметры галереи перед выводом
— Примечания
– Ограничения
Не поддерживает изображения, которые не находятся в медиа-библиотеке
– Частые проблемы
- Пустая галерея при отсутствии изображений
- Ошибки при неправильных ID изображений
