Описание
Поле Gallery предоставляет интерактивный интерфейс для управления коллекцией вложений.
Скриншоты
История изменений
- Настройка
Minimumдобавлена в версии 5.1.9. - Настройка
Maximumдобавлена в версии 5.1.9. - Настройка
Allowed File Typesдобавлена в версии 5.1.9.
Настройки
Return Format
Определяет формат возвращаемых данных. Доступные варианты: Array (массив), URL (строка) или ID (целое число).Preview Size
Размер изображения WordPress, отображаемый при редактировании.Insert
Определяет, куда добавляются новые вложения. Выберите Beginning или End.Library
Ограничивает выбор файлов только файлами, загруженными в эту запись, либо позволяет выбирать файлы из всей библиотеки.Minimum Selection
Минимальное количество вложений, необходимое для проверки поля.Maximum Selection
Максимальное количество вложений, разрешённое при проверке поля.Minimum
Добавляет проверку загружаемых файлов по минимальной ширине в пикселях (целое число), высоте в пикселях (целое число) и размеру файла в МБ (целое число). Размер файла также можно указать в виде строки с единицей измерения, например’400 KB’.Maxiumum
Добавляет проверку загружаемых файлов по максимальной ширине, высоте и размеру файла.Allowed File Types
Добавляет проверку загружаемых файлов по определённым типам. Укажите типы файлов через запятую, чтобы определить разрешённые типы, или оставьте поле пустым, чтобы разрешить все типы.
Использование в шаблоне
Поле Gallery возвращает массив вложений, где каждое вложение представлено массивом, строкой или целым числом в зависимости от выбранного значения Return Format.
Вывод списка изображений
В этом примере показано, как перебрать значение поля Gallery и вывести список изображений. Для создания HTML-кода изображения используется функция wp_get_attachment_image(). В этом примере для поля используется значение ID параметра Return Format.
Эта функция также создаёт атрибут srcset, обеспечивая поддержку от WooThemes. В этом примере для поля используется значение
Arrayпараметра Return Format.<?php $images = get_field('gallery'); if( $images ): ?> <div id="slider" class="flexslider"> <ul class="slides"> <?php foreach( $images as $image ): ?> <li> <img src="<?php echo esc_url($image['url']); ?>" alt="<?php echo esc_attr($image['alt']); ?>" /> <p><?php echo esc_html($image['caption']); ?></p> </li> <?php endforeach; ?> </ul> </div> <div id="carousel" class="flexslider"> <ul class="slides"> <?php foreach( $images as $image ): ?> <li> <img src="<?php echo esc_url($image['sizes']['thumbnail']); ?>" alt="Миниатюра: <?php echo esc_url($image['alt']); ?>" /> </li> <?php endforeach; ?> </ul> </div> <?php endif; ?>Создание галереи WordPress
В этом примере показано, как вывести изображения из поля Gallery в галерее WordPress, создав и обработав шорткод галереи. В этом примере для поля используется значение
IDпараметра Return Format.<?php // Получение значения (массив идентификаторов). $image_ids = get_field('gallery'); if( $image_ids ) { // Создание строки идентификаторов ("123,456,789"). $images_string = implode( ',', $image_ids ); // Создание и выполнение шорткода. // Примечание: следующая строка разделена, чтобы наш собственный сайт не обрабатывал шорткод галереи. $shortcode = sprintf( '[' . 'gallery ids="%s"]', esc_attr($images_string) ); echo do_shortcode( $shortcode ); }
Обновлено: 30.09.2026