ACF Photo Gallery Field v3.0

Важное примечание для новых пользователей поля фотогалереи ACF

Если вы впервые устанавливаете поле фотогалереи ACF на свой веб-сайт WordPress, мы хотели бы сообщить вам, что этот плагин больше не будет поддерживаться с октября 2024 года. В качестве альтернативы мы запустили новый улучшенный плагин под названием ACF Galerie 4.

Мы рекомендуем вам ознакомиться с ACF Galerie 4, чтобы получить расширенные функции и постоянную поддержку. ACF Galerie 4 включает в себя встроенный инструмент миграции, который легко переносит данные из ACF Photo Gallery Field или ACF Gallery Pro в ACF Galerie 4. Узнайте больше.

Спасибо

Облегченное расширение Advanced Custom Field (ACF), которое добавляет поле "Фотогалерея" в любые записи/страницы вашего веб-сайта WordPress.

- Визуально создавайте поля.

- Добавьте несколько фотографий, а также сможете изменить заголовок, подпись и ссылку на что угодно.

- Назначьте поля нескольким страницам редактирования (с помощью пользовательских правил расположения).

- Легко загружайте данные с помощью простого и удобного API.

- Использует собственный тип записи WordPress для простоты использования и быстрой обработки.

- Использует собственные метаданные WordPress для простоты использования и быстрой обработки.

- Поддерживает классический редактор WordPress и редактор Gutenberg.

- RESTFul API

Пожертвование

Навнеил Найкер - единственный разработчик, работающий над этим бесплатным плагином WordPress в свободное время. Он хотел бы интегрировать его с плагинами премиум-класса, такими как Elementor Pro и Advanced Custom Fields Pro. Пожалуйста, сделайте пожертвование, чтобы поддержать Navneil в продолжении разработки этого плагина. Нажмите на ссылку "https://www.buymeacoffee.com/navzme", чтобы сделать пожертвование.

Использование

acf_photo_gallery - это вспомогательная функция, которая принимает ACF_FIELD_NAME и POST_ID, выполняет запрос к базе данных и компилирует изображения для вас. Результатом этой функции будет массив.

acf_photo_gallery (ACF_FIELD_NAME, POST_ID);

Пример

В следующем примере для макета используется платформа Twitter Bootstrap. Вы можете использовать любую структуру по вашему выбору.

<?php
//Получаем идентификаторы изображений из post_metadata
$images = acf_photo_gallery("vacation_photos", $post->ID);
//Проверяем, есть ли в возвращаемом массиве что-нибудь
если (количество ($ изображений)):
//Отлично, у нас есть данные, давайте пройдемся по ним
foreach($images как $image):
$id = $image["id"]; // Идентификатор вложения медиафайла
$title = $image["title"]; //Заголовок
$caption= $image["caption"]; //Заголовок
$full_image_url= $image["full_image_url"]; //URL полноразмерного изображения
$full_image_url = acf_photo_gallery_resize_image($full_image_url, 262, 160); //Изменен размер до ширины 262 пикселей и высоты 160 пикселей URL-адрес изображения
$thumbnail_image_url= $image["thumbnail_image_url"]; //Получаем URL-адрес миниатюры изображения размером 150х150 пикселей
$url= $image["url"]; //Переходим к любой ссылке при нажатии
$target= $image["target"]; //Открываем обычную или новую вкладку
$alt = get_field("photo_gallery_alt", $id); //Получаем alt, который является дополнительным полем (см. ниже, как добавить дополнительные поля)
$class = get_field("photo_gallery_class", $id); //Получаем класс, который является дополнительным полем (см. ниже, как добавлять дополнительные поля)
?>
<div class="col-xs-6 col-md-3">
<div class="миниатюра">
<?php if( !empty($url)){ ?><a href="<?php echo $url; ?>" <?php echo ($target == "true")? "target="_blank"": ""; ?>><?php } ?>
<img src="<?php echo $full_image_url; ?>" alt="<?php echo $title; ?>" title="<?php echo $title; ?>">
<?php if( !empty($url)){ ?></a><?php } ?>
</div>
</div>
<?php endforeach; эндиф; ?>

Добавить дополнительные поля

Чтобы добавить дополнительные поля, добавьте следующее в файл функций.php вашей темы.

//Создаем дополнительные поля под названием "Альтернативный текст" и "Статус".
функция my_extra_gallery_fields($args, $attachment_id, $acf_key){
$args["альт"] = массив(
"тип" => "текст",
"label" => "Альтернативный текст",
"имя" => "альт",
"value" => get_field($field. "_alt", $attachment_id)
);
$args["статус"] = массив(
"тип" => "выбрать",
"метка" => "Статус",
"имя" => "статус",
"значение" => массив(
массив(
"1" => "Активный",
"2" => "Неактивно"
),
get_field($field. "_status", $attachment_id)
)
);
вернуть $арги;
}
add_filter("acf_photo_gallery_image_fields", "my_extra_gallery_fields", 10, 3);

Поддерживаемые типы полей:

* текст, дата, цвет, дата-время-местное, адрес электронной почты, номер, телефон, время, URL-адрес, неделя, диапазон, флажок, радио, текстовая область, выбор

Как получить значения дополнительных полей

Вы можете использовать вспомогательную функцию ACF get_field

get_field("photo_gallery_alt", $id);
get_field("photo_gallery_class", $id);

Извлечь заголовок из поля заголовка вложения

По умолчанию заголовок извлекается из поля описания. Добавьте следующий фильтр в свой function.php, чтобы извлечь заголовок из поля заголовка вложения.

add_filter("acf_photo_gallery_caption_from_attachment", "__return_true");

REST API

Отправьте HTTP-запрос на URL-адрес, чтобы получить ответ JSON на все сообщения.

http://{домен}/wp-json/wp/v2/{POST_TYPE}/

Отправьте HTTP-запрос на URL-адрес, чтобы получить ответ JSON на конкретную публикацию.

http://{домен}/wp-json/wp/v2/{POST_TYPE}/{POST_ID}/

Когда вы получите ответ, просмотрите элемент ACF, который содержит имя фотогалереи ACF и массив изображений.

Руководство по установке и базовому использованию

**АКФ П