Что умеет
ACF Photo Gallery Field добавляет в Advanced Custom Fields новый тип поля — фотогалерею. В поле можно загрузить несколько изображений, изменить их порядок, задать заголовок, подпись и ссылку, а также указать, открывать ли ссылку в новой вкладке. Галерею можно подключить к записям, страницам и другим типам контента через стандартные правила размещения ACF.
Данные хранятся в обычных метаданных WordPress. Для вывода есть функция acf_photo_gallery(), возвращающая массив изображений: идентификатор, заголовок, подпись, адрес полной версии и миниатюры, ссылка и признак новой вкладки. Дополнительные поля, например alt или класс, можно добавить фильтром в functions.php. Данные галереи доступны и через REST API, а в Elementor их можно подключать через динамические теги ACF.
Установка и настройка
Сначала убедитесь, что установлен и активен ACF. Затем установите плагин, создайте группу полей, добавьте поле типа «Photo Gallery» и выберите, где оно показывается. В шаблоне вызовите acf_photo_gallery('имя_поля', $post->ID) и выведите изображения в цикле. Размер можно изменить вспомогательной функцией ресайза.
Подводные камни
Главное: разработчик сообщил, что с октября 2024 года плагин не поддерживается, и предлагает свой новый плагин ACF Galerie 4 со встроенной миграцией данных. Для нового сайта это серьёзный аргумент выбрать другое решение. Если плагин уже стоит на рабочем сайте, он будет работать, но исправления совместимости и безопасности выходить не будут. Поэтому следите за обновлениями ядра и ACF, а при возникновении проблем планируйте переход.
Если удалить плагин, поля галереи перестанут выводиться, а шаблоны с вызовом acf_photo_gallery() вызовут фатальную ошибку PHP. Перед удалением замените вызовы функции или оберните их проверкой function_exists.
В платной версии ACF есть собственное поле «Галерея», которое закрывает ту же задачу без стороннего плагина.
Кому подойдёт
Подойдёт тем, у кого плагин уже работает на сайте и нужно лишь сохранить его до миграции. Для новых проектов смотрите на Advanced Custom Fields, Meta Box или Pods: в них поддержка галерей есть в составе.
