Яндекс Диск слайдер на сайт

Описание

YaDisk Sliders решает одну неприятную задачу: сделать так, чтобы владелец сайта мог сам обновлять фотогалереи, ни разу не открыв админку. Он складывает снимки в папку на Яндекс Диске — со смартфона, из приложения или через браузер — а сайт подхватывает изменения и перестраивает слайдер.

Каждая подпапка на Диске — отдельный слайдер. «Кухни», «Отзывы», «Объекты», «Партнёры» — сколько папок, столько независимых галерей на разных страницах.

Как это работает

1. Папка на Диске. Клиент кладёт фото туда, куда привык.
2. Синхронизация. С заданным интервалом сайт сверяет контрольные суммы файлов и скачивает только то, что появилось или изменилось.
3. Слайдер. На странице показываются локальные копии — Яндекс Диск в этот момент уже не участвует.

Это принципиальный момент: посетители сайта никогда не обращаются к Яндекс Диску. Картинки лежат в папке загрузок сайта, поэтому страница грузится быстро и не зависит от доступности внешнего сервиса. Диск нужен только в момент синхронизации.

Что это даёт владельцу сайта

• Обновление галерей без обучения работе с админкой — достаточно уметь пользоваться Яндекс Диском.
• Ни одного лишнего файла в медиатеке: библиотека остаётся чистой, бэкапы не разрастаются.
• Удалили фото на Диске — оно пропадёт с сайта после ближайшей синхронизации. Добавили — появится.
• Работа с одной галереей не мешает остальным: у каждой папки свой цикл обновления.

Вставка на страницу: четыре способа

• Блок Gutenberg «Слайдер с Яндекс Диска» — выпадающий список папок, настройки на правой панели, реальный слайдер виден прямо в редакторе.
• Виджет Elementor — тот же список папок и переключатели, находится поиском по слову «слайдер» или «яндекс».
• Элемент Bricks — для сайтов на Bricks Builder.
• Шорткод [yadisk_slider folder="Кухни"] — для тем, виджетов и вставки в шаблон через do_shortcode().

Все четыре способа собирают одну и ту же разметку, поэтому переключаться между ними можно свободно. В админке есть конструктор с живым предпросмотром на реальных фото: подобрали вид — скопировали готовый шорткод.

Возможности слайдера

• Пропорция кадра (16/9, 4/3, 1/1 и другие) или фиксированная высота.
• От одного до шести слайдов в кадре — для лент логотипов, отзывов и плиточных галерей.
• Автопрокрутка с паузой при наведении и в неактивной вкладке, сдвиг или растворение.
• Стрелки, точки, счётчик слайдов, лента миниатюр.
• Лайтбокс: клик открывает фото на весь экран, листается стрелками, клавиатурой и свайпом.
• Подписи из имён файлов: 02_дуб-сонома.jpg превращается в «Дуб сонома».
• Свайп на телефоне и перетаскивание мышью, управление с клавиатуры, корректная ARIA-разметка, учёт системной настройки «уменьшить движение».
• Порядок фото: по имени файла, в обратном порядке, случайный или заданный вручную.

Ручной порядок и скрытие фото

Если клиенту неудобно нумеровать файлы на Диске, порядок задаётся мышью: отдельная вкладка в админке показывает сетку миниатюр, плитки перетаскиваются, двигаются стрелками и клавишами.

Раскладка хранится отдельно от списка файлов, поэтому переживает синхронизацию: новые фото встают в конец, удалённые исчезают из порядка сами. Значок глаза скрывает отдельный кадр с сайта, не удаляя файл с Диска — удобно, когда в папку попало лишнее, а стирать её содержимое клиент не готов.

Скорость и SEO

• Фото с телефона весят 5–12 МБ — плагин уменьшает их при скачивании до заданной ширины (по умолчанию 1600 px) и сохраняет с настраиваемым качеством.
• Создаются WebP-копии: современные браузеры получают их через <picture>, остальные — исходный JPEG.
• У каждого изображения проставлены width и height — вёрстка не прыгает при загрузке, показатель CLS не страдает.
• Первые кадры грузятся сразу, остальные — отложенно.
• Атрибут alt заполняется из имени файла, а не остаётся пустым.
• CSS и JavaScript подключаются штатным способом WordPress и попадают на страницу только там, где слайдер действительно есть.

Подключение Диска и безопасность

• Два режима на выбор: OAuth-токен с правом только на чтение или публичная ссылка на папку — когда клиент не хочет давать доступ к аккаунту.
• Токен не выводится в HTML админки после сохранения и может храниться константой в wp-config.php, минуя базу данных.
• Скачиваются только изображения: расширения проверяются по белому списку, а каждый файл после загрузки проверяется на то, что он действительно картинка.
• Папка кеша закрыта от просмотра списка файлов и от выполнения PHP.
• Большие папки обрабатываются порциями, поэтому синхронизация не обрывается по таймауту и не роняет сайт.
• Журнал в админке показывает, что и когда скачалось, а что не удалось и почему.

Параметры шорткода

Атрибут	По умолчанию	Назначение
folder	—	Имя папки на Диске. Обязательный.
ratio	—	Пропорция кадра: 16/9, 4/3, 1/1.
height	420px	Фиксированная высота, если пропорция не задана.
fit	cover	Заполнить кадр с обрезкой или показать фото целиком.
per_view	1	Сколько слайдов видно одновременно, до шести.
autoplay	0	Секунды между слайдами, 0 — листает только посетитель.
effect	slide	Сдвиг или растворение.
order	auto	Ручной порядок из админки, по имени файла, обратный или случайный.
lightbox	0	Открывать фото на весь экран по клику.
thumbs, dots, arrows, counter	—	Миниатюры, точки, стрелки, счётчик слайдов.
caption	0	Подписи из имён файлов.
limit	0	Показать не больше указанного числа фото.

Полный список атрибутов, инструкция по выпуску токена и разбор типовых ошибок встроены в плагин — вкладка «Инструкция» в его меню.

Требования

• WordPress 5.6 и новее, PHP 7.4 и новее.
• Расширение GD или Imagick — для уменьшения картинок и WebP.
• Исходящий доступ к cloud-api.yandex.net.
• Работающий планировщик WordPress или системный cron.

Частые вопросы

Придётся отдавать плагину доступ к аккаунту Яндекса?

Нет. Токен выпускается с единственным правом — чтение Диска, изменить или удалить что-либо на нём плагин технически не может. А можно вообще обойтись без токена и работать по публичной ссылке на папку.

Что будет, если Яндекс Диск станет недоступен?

Ничего. Сайт показывает локальные копии файлов, поэтому галереи продолжают работать. Не сработает только очередная синхронизация — и она подхватится следующей.

Фото попадут в медиатеку?

Нет. Файлы лежат в отдельной папке внутри каталога загрузок, библиотека остаётся чистой.

Сколько фотографий выдерживает одна папка?

Сотни. Скачивание идёт порциями, прогресс сохраняется между заходами, поэтому большая папка просто обрабатывается за несколько проходов.

Можно поставить несколько слайдеров на одну страницу?

Да, из разных папок и с разными настройками. Стили и скрипт подключаются один раз.

Как быстро изменения с Диска попадают на сайт?

По расписанию — интервал настраивается от пяти минут до суток. Кроме того, синхронизацию можно запустить вручную кнопкой в админке, целиком или по одной папке.