=== S1 Gallery — Фотогалереи (карусель / masonry) ===
Author: S1
Author URI: https://1studi.ru
Plugin URI: https://1studi.ru
Requires at least: 5.9
Requires PHP: 7.4

Универсальный плагин фотогалерей для WordPress. Не привязан к конкретному
сайту или теме — можно ставить на любой проект студии.

== Как пользоваться ==

1. В меню админки появляется пункт «Фотогалереи» — создайте новую запись.
2. В блоке «Изображения галереи» нажмите «Добавить изображения», выберите
   нужные в медиабиблиотеке. Порядок показа задаётся перетаскиванием
   миниатюр.
3. В блоке «Настройки вывода» выберите режим:
   — Карусель — изображения в ряд, со стрелками, настраивается количество
     видимых одновременно, высота, скорость перемотки, автопрокрутка и
     задержка автопрокрутки;
   — Masonry — плиточная раскладка с сохранением пропорций каждого фото,
     настраивается число колонок и сколько «рядов» показывать сразу, затем
     кнопка «Показать ещё» подгружает следующую порцию.
4. Сохраните галерею — справа появится готовый шорткод вида
   [s1_gallery id="123"]. Скопируйте его и вставьте в контент нужной
   страницы или записи (в блочном редакторе — в блок «Шорткод», в обычном
   контенте — прямо текстом).

Шорткод также поддерживает переопределение настроек прямо в атрибутах,
например: [s1_gallery id="123" autoplay="0" visible="4"].

== Дизайн ==

Единый на оба режима: скругление углов 15px, отступ между изображениями
15px. В карусели все изображения приводятся к одной высоте с сохранением
пропорций (object-fit: cover) — так «разношёрстные» по размеру фото
выглядят аккуратно в ряд. В masonry, наоборот, пропорции каждого фото
сохраняются полностью (в этом суть плиточной раскладки).

Плагин не задаёт фон страницы и не подключает никаких глобальных стилей —
только сама галерея. Фон остаётся тем, что уже задан текущей темой/страницей.
Цвет акцентных элементов (стрелки при наведении, кнопка «Показать ещё»)
берётся из CSS-переменной темы --primary, если она объявлена; если нет —
используется собственный фолбэк-цвет.

== Lazy-load ==

— Masonry: нативный loading="lazy" у изображений — подходящий и надёжный
  способ именно для вертикальной плитки.
— Карусель: изображения вне видимой области хранятся в data-src и
  подгружаются скриптом только когда становятся текущим/соседним слайдом.
  Нативный loading="lazy" здесь не подходит: браузер не учитывает, что
  слайд скрыт через overflow:hidden, и может загрузить всё сразу.

== Технически ==

— Отдельный тип записи s1_gallery (не публичный, без фронтенд-URL).
— CSS/JS плагина подключаются только на страницах, где реально есть
  шорткод — не грузятся сайтом «про запас».
— Никаких внешних библиотек на фронтенде — чистый JS.
— alt для изображений подтягивается из медиабиблиотеки (поле «Alt-текст»
  вложения); если пусто — используется название файла.
