RokGallery - Плагин WordPress

Руководство по RokGallery для WordPress: галереи, теги и безопасная проверка совместимости

RokGallery имеет смысл разбирать не как обычную современную галерею из каталога WordPress, а как старый инструмент RocketTheme для сайтов, где уже используется экосистема Gantry, RokCommon, RokSprocket или темы RocketTheme. В этом руководстве мы не повторяем краткое описание продукта, а разбираем практику: как подготовить сайт, как понять логику тегов, как собрать галерею, где искать проблемы с выводом и когда разумнее выбрать другое решение.

Главный риск RokGallery связан не с самой идеей галереи, а с возрастом продукта. В официальной матрице RocketTheme он указан как legacy-плагин для WP5, поэтому любые действия лучше делать на копии сайта. Это особенно важно, если у вас новый WordPress, современный PHP, агрессивная оптимизация JavaScript или тема, которая не была рассчитана на старые RocketTheme-расширения.

Ниже есть настройка после установки, пример страницы портфолио, диагностика миниатюр и lightbox, аккуратный CSS для контейнера, сравнение с похожими решениями и FAQ. Формулировки по функциям даны осторожно: подтверждённые факты отделены от практических рекомендаций для старых галерей WordPress.

Где RokGallery действительно полезен

RokGallery стоит рассматривать прежде всего для существующих сайтов, которые уже построены на старом стеке RocketTheme. Если сайт использует тему RocketTheme, виджеты RokSprocket, библиотеку RokCommon и прежний дизайн, замена галереи может оказаться дороже, чем аккуратная поддержка текущего решения. В таком сценарии задача администратора - не «поставить ещё один плагин», а сохранить рабочий визуальный блок и не нарушить структуру сайта.

Сильная идея RokGallery - теговая организация изображений. Вместо жёсткой папки «альбом 1» и отдельной папки «альбом 2» один и тот же снимок можно отнести к нескольким тематическим подборкам через теги. Это удобно для портфолио, каталога работ, архива мероприятий, раздела «проекты» или фотоподборки, где одно изображение логично показывать в нескольких контекстах.

Когда продукт подходит

RokGallery может быть удачным выбором, если сайт уже работает с этим плагином, галереи встроены в виджеты или страницы, а владелец хочет сохранить привычный вид без полной миграции. Также он полезен, если контент-менеджер привык к логике тегов и у проекта есть готовый архив изображений, разбитый по существующим правилам.

• Сайт использует старую тему RocketTheme, где RokGallery уже был частью демо или визуального оформления.
• Нужно поддержать существующие подборки изображений без полного переезда на новый плагин.
• Галереи строятся вокруг тегов: тип работы, место, формат, сезон, клиентская категория.
• Команда готова тестировать изменения на копии сайта и не ждёт регулярных современных обновлений.

Когда лучше не начинать с RokGallery

Для нового сайта на актуальной версии WordPress RokGallery обычно не лучший первый выбор. В новых проектах важны поддержка редактора блоков, регулярные обновления, проверенная совместимость с PHP, доступная документация и активный канал поддержки. У RokGallery эти пункты нужно проверять отдельно, потому что продукт относится к старому поколению RocketTheme.

Практический вывод: если RokGallery уже работает на сайте, его можно аккуратно обслуживать. Если вы только выбираете галерею для нового проекта, сначала сравните его с современными плагинами и оцените цену будущей поддержки.

Что проверить перед установкой на WordPress

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

Копия сайта и точка отката

Перед установкой сделайте резервную копию файлов и базы данных, а лучше повторите сайт на тестовом адресе. Если хостинг умеет staging, используйте его. Если staging нет, создайте локальную или временную копию. Не начинайте проверку RokGallery с боевого сайта, где уже есть трафик, формы заявок или магазин.

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

Минимальный набор для отката

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

Совместимость WordPress, PHP и зависимостей

Официальная матрица RocketTheme подтверждает RokGallery как legacy-решение для WP5. Это не означает, что плагин обязательно не запустится на более новом сайте, но означает другое: совместимость нужно проверять, а не предполагать. Особое внимание уделите PHP, потому что старые расширения часто содержат код, который на новом сервере вызывает предупреждения или критические ошибки.

План отката

Запишите порядок действий на случай ошибки: отключить RokGallery, отключить RokCommon только после RokGallery, очистить кеш, вернуть базу из копии, проверить страницу галереи. Если плагин вызывает критическую ошибку и админ-панель недоступна, безопасный вариант - временно переименовать папку плагина через файловый менеджер. Это отключит его без удаления данных.

Установка и первое включение без риска для сайта

Установка RokGallery похожа на обычную установку ZIP-плагина, но порядок включения важнее, чем в современных автономных расширениях. Если у вас есть архивы RocketTheme, сначала убедитесь, что это именно WordPress-пакеты, а не Joomla-компонент. У RokGallery существовали версии для разных CMS, и путаница между ними даст ошибку ещё до настройки.

Порядок установки

1. Откройте тестовую копию сайта и убедитесь, что резервная копия сделана.
2. Перейдите в Plugins и проверьте, установлен ли RokCommon.
3. Если RokCommon отсутствует, установите его первым и активируйте.
4. Загрузите ZIP RokGallery через Plugins - Add New - Upload Plugin.
5. Активируйте RokGallery и сразу откройте журнал ошибок WordPress или хостинга.
6. Проверьте, появился ли пункт RokGallery или связанный раздел управления галереями в админ-панели.
7. Не добавляйте галерею на публичную страницу, пока не создана тестовая подборка изображений.

Если после активации сайт показывает критическую ошибку, не пытайтесь править файлы плагина. Отключите RokGallery, проверьте версию PHP, наличие RokCommon и конфликт с другими расширениями. Для старого плагина правка ядра почти всегда создаёт будущую проблему: её сложно повторить, документировать и откатить.

Первая проверка после активации

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

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

Что считать успешным первым тестом

Успешный тест - это не только отсутствие ошибки при активации. Минимум одно изображение должно загрузиться, получить тег, появиться в выбранной галерее, открыться на публичной странице и не оставить ошибок JavaScript в консоли браузера. Только после этого есть смысл переносить настройки на большой набор файлов.

Теги, срезы и логика отбора изображений

Самая важная особенность RokGallery - галерея строится вокруг тегов. Это отличается от простого подхода «создать альбом и загрузить туда фото». В теговой модели изображение может участвовать в нескольких подборках без повторной загрузки исходника. Например, один снимок интерьера может иметь теги interior, office и featured. Тогда он попадёт и в полную галерею интерьеров, и в подборку офисных работ, и в блок избранных изображений.

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

Как проектировать теги

Перед загрузкой изображений составьте короткий словарь тегов. Он должен быть понятен редактору, который будет работать с сайтом через месяц или через полгода. Не используйте хаотичные метки вроде photo1, new, nice. Тег должен отвечать на вопрос, по какому признаку пользователь или администратор будет отбирать изображения.

• Тип работы: portrait, interior, event, product.
• Место вывода: home, portfolio, footer, archive.
• Статус: featured, draft, client-approved.
• Сезон или серия: spring, studio, conference.

Почему не стоит смешивать теги и структуру страниц

Ошибка многих старых галерей - теги начинают повторять меню сайта. В результате появляются метки about, contacts, page1, хотя они ничего не говорят об изображениях. Лучше разделить два уровня: теги описывают контент, а страницы решают, какой набор тегов показать. Тогда одна страница может выводить «портреты», другая - «избранное», а третья - «архив мероприятий» без дублирования файлов.

Редакционная карта тегов для старого архива

Если RokGallery уже используется на сайте несколько лет, перед изменениями полезно составить редакционную карту. Это обычная таблица в документе проекта: тег, что он означает, где выводится, кто может его менять и какие изображения нельзя туда добавлять. Такая карта особенно помогает после смены администратора сайта. Без неё новый редактор видит набор старых меток и начинает добавлять похожие дубли: portfolio, portfolios, works, work. Через несколько месяцев галереи становятся непредсказуемыми.

Для RokGallery лучше держать небольшой стабильный словарь. Теги уровня «тип работы» меняются редко, теги уровня «показать на главной» можно менять чаще, а временные теги лучше удалять после окончания кампании. Если нужно проверить новую подборку, создайте тестовый тег вроде review, покажите страницу только администратору, а после утверждения замените его постоянной меткой. Так вы не смешаете рабочую структуру с черновиками.

Полезное правило для контент-менеджера: один тег должен иметь одно назначение. Если featured означает «вывести на главной», не используйте его одновременно как «лучшие работы в портфолио» и «показать в футере». Для второй задачи лучше создать отдельную метку. Чем точнее словарь, тем меньше риск, что старый виджет внезапно покажет лишние изображения.

Подготовка изображений до загрузки

Даже если галерея умеет создавать миниатюры, исходники нужно подготовить. Слишком большие файлы увеличивают время обработки, расходуют память PHP и делают публичную страницу тяжёлой. Оптимальный подход - сохранить мастер-файлы отдельно, а на сайт загрузить копии с разумными размерами. Для портфолио обычно достаточно изображения, которое хорошо выглядит в крупном lightbox, но не является многомегабайтным оригиналом с камеры.

Проверьте имена файлов. Кириллица, пробелы и длинные названия иногда работают, но на старых плагинах и при миграции могут создавать лишний риск. Надёжнее использовать короткие латинские имена: studio-portrait-01.jpg, office-interior-03.jpg, event-stage-12.jpg. Описание и подпись лучше хранить в полях галереи или медиабиблиотеки, а не пытаться вложить всё в имя файла.

Галереи, подборки и вывод на странице

После загрузки и разметки изображений нужно решить, как именно посетитель увидит галерею. В старых RocketTheme-сайтах вывод мог быть привязан к виджетной области, позиции темы или интеграции с другими Rok-расширениями. В WordPress это часто означает выбор между отдельной страницей, виджетом в футере, блоком в сайдбаре или дополнительным shortcode-аддоном.

Виджетный сценарий

Официальная документация по демо-темам RocketTheme показывает, что RokGallery использовался в виджетных позициях, например в футере. Это важный сигнал: если вы обслуживаете старый сайт, сначала ищите галерею не в тексте записи, а в разделе виджетов или в настройках темы. Иногда пользователь видит галерею на главной, но её источник находится в виджетной области, назначенной только для определённого шаблона или override темы.

Проверка простая: временно переименуйте тестовую галерею или измените один тег и посмотрите, обновился ли блок. Если блок не изменился, возможно, на странице стоит другой виджет, кешированная копия или вообще не RokGallery, а RokSprocket с поддержкой изображений.

Страница с галереей

Если нужно сделать полноценную страницу «Портфолио», лучше не смешивать галерею с большим количеством сторонних блоков. Сначала создайте чистую страницу с коротким вводным текстом и галереей. Потом проверьте миниатюры, открытие изображения, адаптивность и скорость. Только после этого добавляйте фильтры, дополнительные тексты, форму заявки или связанные проекты.

Shortcode и старые дополнительные плагины

Для RokGallery существовали сторонние дополнения, которые добавляли shortcode или список страниц галерей. Их нельзя считать современной частью основного продукта. Если на старом сайте shortcode уже используется, не удаляйте его вслепую. Но если вы только выбираете способ вывода, сначала проверьте штатный виджет или нативный механизм темы. Старый shortcode-аддон может работать в классическом редакторе и не работать в редакторе блоков или конструкторе страниц.

Если shortcode отображается обычным текстом, это не всегда ошибка RokGallery. Часто причина в том, что дополнительный shortcode-плагин отключён, блок редактора не выполняет shortcodes или кеш показывает старую версию страницы.

Подробная настройка после установки

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

Размеры миниатюр и крупных изображений

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

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

Проверка на разных типах кадров

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

Обрезка и пропорции

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

Подписи, описания и данные изображения

Подпись нужна там, где изображение без контекста непонятно: проект, место, тип работы, материал, событие. Но подписи не должны превращаться в SEO-спам. Для галереи портфолио полезны короткие описания, которые помогают пользователю ориентироваться. Для изображений, где важна доступность и поиск, проверьте alt в медиабиблиотеке или в доступных полях галереи.

Поведение клика

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

Настройки, которые зависят от версии RokGallery или темы, лучше фиксировать в рабочей заметке проекта. Старые сайты часто поддерживает не один человек, и через несколько месяцев важно понять, почему выбран именно такой размер миниатюр или почему отключена часть оптимизации JavaScript.

Практический пример: портфолио с фильтрацией по типу работ

Возьмём реальную задачу: студии нужно показать 40 изображений в портфолио. Часть работ относится к интерьерам, часть к портретам, часть к мероприятиям. На главной странице должны быть только избранные изображения, а на отдельной странице - полный архив. Такой сценарий хорошо раскрывает RokGallery, потому что использует теги, разные подборки и проверку вывода на сайте.

Цель

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

Подготовка

Подготовьте изображения заранее. Для каждого файла задайте понятное имя, отберите сильные кадры для первого экрана и уменьшите слишком тяжёлые исходники. Создайте словарь тегов: interior, portrait, event, featured. Не добавляйте десять меток сразу. Сначала соберите простую систему, которую легко проверить.

Шаги

1. Загрузите 6-8 тестовых изображений, а не весь архив.
2. Назначьте каждому изображению один тематический тег и при необходимости тег featured.
3. Создайте основную галерею для страницы портфолио, которая берёт теги interior, portrait и event.
4. Создайте малую подборку для главной страницы или футера по тегу featured.
5. Настройте размеры миниатюр так, чтобы они соответствовали сетке темы.
6. Проверьте клик по миниатюре и убедитесь, что lightbox или выбранный тип перехода работает одинаково для всех изображений.
7. Добавьте оставшиеся изображения партиями по 10-12 файлов, проверяя результат после каждой партии.

Проверка

Откройте страницу портфолио в приватном окне браузера. Проверьте, что пользователь видит не служебные названия файлов, а понятные изображения и подписи. Кликните по нескольким миниатюрам из разных групп, затем откройте страницу на узком экране. Если сетка съезжает, сначала меняйте размеры и контейнер, а не сами изображения.

Нюанс

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

Проверка результата: сетка, lightbox, скорость и SEO-аккуратность

После настройки не ограничивайтесь фразой «галерея открывается». Проверка должна имитировать поведение обычного посетителя и администратора. Пользователь смотрит миниатюры, открывает несколько изображений, возвращается назад, листает страницу на мобильном экране. Администратор добавляет новый файл, меняет тег и ждёт, что изображение появится в нужной подборке.

Что проверить на публичной странице

• Миниатюры загружаются без пустых серых блоков и битых ссылок.
• Сетка не выходит за контейнер темы и не создаёт горизонтальный скролл.
• Клик по изображению работает одинаково для всех элементов галереи.
• Подписи не перекрывают изображение и читаются на мобильном экране.
• После очистки кеша не пропадают стили, а JavaScript не даёт ошибок в консоли.
• Новая картинка с нужным тегом попадает в ожидаемую подборку.

Скорость и изображения

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

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

SEO и доступность без переспама

Для галереи важны понятные alt, подписи и контекст вокруг изображения. Но нет смысла вставлять название продукта или один ключ в каждый alt. Alt должен описывать изображение: «портрет в студии», «интерьер переговорной», «сцена мероприятия». Текст вокруг галереи объясняет раздел, а не пытается заменить метаданные каждого файла.

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

Производительность и безопасные улучшения без правки ядра

Для RokGallery не стоит начинать с PHP-правок. Большинство проблем старой галереи решается настройками, подготовкой изображений, кешем, темой или безопасным CSS-контейнером. Код нужен только тогда, когда у него есть понятная задача и быстрый откат.

Регламент обслуживания для legacy-галереи

Если RokGallery остаётся на сайте, ему нужен простой регламент. Не обязательно писать большую техническую документацию, но нужно зафиксировать несколько вещей: где находится галерея, какие теги используются, какие страницы зависят от виджетов, какие настройки кеша нельзя менять без проверки, какая версия PHP сейчас работает без ошибок. Это снижает риск случайного ремонта, когда новый администратор видит старый плагин и пытается «обновить всё сразу».

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

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

CSS-контейнер для аккуратной ширины

Если галерея визуально съезжает из-за темы, лучше добавить внешний контейнер и аккуратные правила для изображений. Классы внутри RokGallery могут отличаться по версии и теме, поэтому самый надёжный вариант - обернуть вывод галереи в свой контейнер, если редактор или шаблон это позволяет.

<div class="rokgallery-guide-wrap">
  <!-- Здесь находится вывод RokGallery: виджет, shortcode или блок темы -->
</div>

CSS можно добавить через Appearance - Customize - Additional CSS, через дочернюю тему или через проверенный сниппет CSS. Он не меняет файлы RokGallery и легко удаляется.

.rokgallery-guide-wrap {
  max-width: 1180px;
  margin: 0 auto;
}

.rokgallery-guide-wrap img {
  max-width: 100%;
  height: auto;
}

.rokgallery-guide-wrap .rok-gallery,
.rokgallery-guide-wrap .rokgallery,
.rokgallery-guide-wrap [class*="rok"] {
  box-sizing: border-box;
}

После добавления CSS откройте страницу на рабочем столе и мобильном экране. Проверьте, что изображения не растягиваются, lightbox по-прежнему работает, а контейнер не ломает другие блоки страницы. Если стало хуже, удалите CSS и вернитесь к диагностике темы.

Что не стоит делать

Не редактируйте файлы RokGallery, RokCommon, темы RocketTheme или ядра WordPress. Не отключайте все скрипты оптимизации на сайте только потому, что галерея не открывается. Не скрывайте ошибки PHP через настройки сервера вместо поиска причины. Любое временное отключение конфликтного скрипта должно выполняться только на тестовой копии и только после того, как вы знаете точный handle скрипта.

Частые проблемы с сеткой, миниатюрами и lightbox

Диагностика RokGallery должна идти от симптома. Не нужно сразу переустанавливать плагин или менять тему. Сначала определите, что именно не работает: админка, загрузка изображений, создание миниатюр, выбор тегов, вывод виджета, lightbox, мобильная сетка или кеш. Так вы быстрее найдёте безопасное решение.

Диагностика типичных проблем RokGallery

Симптом	Возможная причина	Что проверить	Как исправить	Когда откатить
Галерея не появляется на странице.	Не выбран нужный тег, виджет смотрит на пустую галерею, RokCommon отключён.	Активные плагины, выбранную галерею, наличие опубликованных изображений.	Включить RokCommon, пересохранить галерею и виджет, очистить кеш.	Если после включения появляется критическая ошибка.
Миниатюры пустые или битые.	Проблема с правами файлов, обработкой изображений или путями после миграции.	Прямой URL файла, папку uploads, журнал ошибок, наличие GD или Imagick.	Исправить права через хостинг, уменьшить исходники, пересоздать миниатюры на копии.	Если изменения прав открывают лишний доступ или ломают медиабиблиотеку.
Lightbox не открывается.	Конфликт нескольких lightbox-скриптов, отложенная загрузка JavaScript, ошибка кеша.	Консоль браузера, настройки кеша, наличие RokBox или другого lightbox.	Оставить один обработчик клика, исключить нужные скрипты из объединения и отложенной загрузки.	Если отключение оптимизации ухудшает работу других важных страниц.
Shortcode виден как текст.	Shortcode-аддон отключён или блок редактора не выполняет shortcode.	Активность дополнительного плагина, тип блока, кеш страницы.	Использовать штатный виджет или dedicated shortcode block, если аддон нужен старому сайту.	Если аддон вызывает ошибки совместимости.
Галерея съехала в сторону.	CSS темы, ширина контейнера, конфликт старых Gantry-override.	Computed styles в браузере, ширину родительского блока, страницу с нормальным выводом.	Добавить точечный CSS-контейнер через дочернюю тему или Additional CSS.	Если CSS начинает влиять на другие блоки сайта.
После перехода на HTTPS часть изображений не загружается.	Старые абсолютные URL, mixed content, кешированные пути.	Console и Network в браузере, настройки адреса сайта, старые ссылки в базе.	На копии выполнить корректную замену URL, пересохранить настройки галереи, очистить кеш.	Если замена URL затронула лишние данные или сломала ссылки.

Что смотреть в консоли браузера

Откройте инструменты разработчика и вкладку Console. Ошибки JavaScript часто сразу показывают конфликт: не найден файл, запрещён mixed content, отсутствует функция, не загружена библиотека. Затем откройте Network и отфильтруйте изображения. Если full image отдаёт 403 или 404, проблема не в визуальной настройке галереи, а в пути, правах или защите сервера.

Порядок проверки без лишних изменений

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

Когда лучше прекратить ремонт

Если для работы RokGallery приходится понижать PHP, отключать важную оптимизацию на всём сайте, держать заброшенный shortcode-аддон и править файлы плагина, поддержка становится слишком дорогой. В таком случае разумнее сохранить контент и планировать миграцию на современную галерею. Это особенно верно для нового дизайна, где нет обязанности повторять старые виджетные позиции RocketTheme.

Как подготовить миграцию, если RokGallery больше не подходит

Миграция старой галереи не должна начинаться с удаления плагина. Сначала нужно понять, что именно нужно сохранить: исходные изображения, подписи, порядок работ, теги, страницы вывода, виджеты в футере, ссылки из меню и привычное поведение клика. Если сразу поставить новый плагин и начать перенос вручную, легко потерять логику старых подборок. Пользователь заметит не техническую чистоту, а то, что исчезла важная категория или избранные работы перемешались с архивом.

Инвентаризация перед переносом

Составьте список всех мест, где используется RokGallery. Проверьте не только очевидную страницу портфолио, но и главную страницу, футер, сайдбар, архивные записи, шаблоны темы и старые landing-страницы. Для каждого места запишите, какая галерея или тег там выводится, сколько изображений должно быть видно, есть ли подписи и что происходит при клике. После этого можно выбрать новый плагин по реальной задаче, а не по красивому демо.

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

Переход без потери результата на сайте

Лучше переносить галереи параллельно. На копии сайта создайте новую страницу с современным плагином, повторите одну старую подборку и сравните результат: сетка, подписи, lightbox, мобильный вид, скорость, порядок изображений. Только после этого переносите остальные разделы. Когда новая страница готова, поменяйте ссылку в меню и оставьте старую страницу скрытой на короткий период проверки. Такой подход позволяет быстро вернуться назад, если посетители или редактор заметят пропавшие изображения.

Не пытайтесь воспроизвести RokGallery один к одному, если новый плагин предлагает более простую модель. Иногда лучше отказаться от части старых тегов, объединить мелкие категории и сделать понятную структуру для будущего. Главная цель миграции - не сохранить каждую историческую настройку, а оставить пользователю рабочую галерею, которую можно обновлять без страха перед следующим обновлением WordPress или PHP.

Когда RokGallery стоит оставить в проекте

RokGallery будет удачным выбором там, где он уже встроен в старый сайт RocketTheme, где редакторы понимают теговую логику, а визуальный блок важен для текущего дизайна. В таком случае задача не в том, чтобы немедленно заменить продукт, а в том, чтобы документировать настройки, держать резервные копии, проверять обновления на staging и не вносить опасные правки в файлы плагина.

Для нового проекта критерии другие. Если вам нужна активная поддержка, редактор блоков, подтверждённая совместимость с современным PHP и понятная документация, лучше начать с NextGEN Gallery, FooGallery, Modula, Envira Gallery или стандартного блока WordPress. Это снизит долг поддержки и упростит будущие обновления.

Если после проверки совместимости вам нужен именно старый рабочий сценарий RocketTheme с тегами, галереями и существующими виджетными позициями, можно перейти к скачать установочный файл и сначала протестировать плагин на копии сайта. После успешного теста сохраните заметку с версиями, зависимостями, используемыми тегами и правилами отката.

Итог простой: RokGallery не стоит воспринимать как универсальный современный выбор для любой галереи. Это инструмент для конкретного старого стека, где главное - аккуратная совместимость, понятная теговая структура и дисциплина проверки результата.

Видео по настройке RokGallery

Это видео дополняет руководство: видео по продукту. Откройте его после базовой настройки, чтобы сверить интерфейс и последовательность действий.