RokUtilities - Плагин WordPress

RokUtilities для WordPress: руководство по зависимостям RocketTheme, проверке RokCommon и безопасной настройке

RokUtilities стоит разбирать не как обычный плагин, который после активации сразу добавляет видимый блок на сайт, а как служебный набор для старой экосистемы RocketTheme. Внутри него важны три разные части: RokCommon, RokSocialButtons и GantryBuddyPress. У каждой части своя задача, свой риск и свой сценарий проверки.

Это руководство поможет понять, когда RokUtilities действительно нужен WordPress-сайту, как не включить лишний legacy-компонент, как проверить зависимые плагины RocketTheme и что делать, если после переноса или обновления появляются ошибки вокруг wp_rokcommon. Материал полезен прежде всего владельцам старых сайтов на темах RocketTheme, администраторам, которые получили такой проект на поддержку, и разработчикам, которым нужно аккуратно стабилизировать сборку перед миграцией.

Главная мысль простая: RokUtilities не стоит устанавливать на новый сайт “на всякий случай”. Его нужно рассматривать как инструмент поддержки существующей сборки. Если на сайте нет RokSprocket, RokGallery, старой темы RocketTheme, Gantry-связки или старой интеграции BuddyPress, польза от пакета будет сомнительной, а риск совместимости может оказаться выше пользы.

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

Что входит в RokUtilities и почему это не обычный функциональный плагин

На официальной странице RocketTheme RokUtilities описан как раздел с utility plugins. Это важная формулировка: продукт объединяет вспомогательные плагины, которые поддерживают основные плагины или темы. Поэтому после активации пользователь может не увидеть новой красивой панели, нового блока редактора или отдельного публичного виджета. Нормальная роль RokUtilities - дать недостающую библиотеку, простую интеграцию или совместимость старой связке.

RokCommon как библиотечная основа

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

Именно поэтому RokCommon не нужно оценивать как плагин с пользовательским результатом. Если он установлен правильно, вы можете вообще не увидеть отдельной “красивой” функции на публичной части сайта. Зато RokSprocket или RokGallery перестанут жаловаться на отсутствующие классы, контейнеры или библиотеку. Если зависимых Rok-плагинов нет, RokCommon обычно не даёт самостоятельной пользы.

RokSocialButtons как небольшой контентный модуль

RokSocialButtons описан как базовый контентный плагин для вывода социальных ссылок, например Facebook и Twitter, с несколькими вариантами вставки. Это уже ближе к привычной пользовательской функции: кнопки могут появляться в материалах, рядом с содержимым или в местах, которые поддерживает конкретная версия компонента.

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

GantryBuddyPress как legacy-интеграция

GantryBuddyPress на странице RokUtilities прямо отмечен как legacy-компонент. Его задача была связана с интеграцией BuddyPress в шаблоны RocketTheme, но официальное описание также говорит, что такая интеграция теперь встроена непосредственно в Gantry. Для администратора это сигнал не включать GantryBuddyPress без точной причины.

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

Зачем RokUtilities нужен на старом RocketTheme-сайте

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

Сайт использует RokSprocket или RokGallery

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

Важно не лечить симптом вслепую. Пустой блок RokSprocket может быть связан с RokCommon, но также с кешем, старым PHP-кодом, сломанной картинкой, конфликтом JavaScript, правами на файлы или неправильным переносом базы. Поэтому RokUtilities - это не универсальная кнопка “исправить”, а один из пунктов диагностики.

Сайт повторяет демо старой темы RocketTheme

В старых документациях тем RocketTheme RokCommon часто упоминается рядом с Gantry Framework, RokAjaxSearch, RokBox, RokGallery и RokSprocket. Такой набор характерен для сайтов, созданных из RocketLauncher или вручную собранных по документации демо. Если вы поддерживаете именно такой проект, удаление RokCommon может неожиданно сломать не саму тему, а отдельный блок демо: витрину записей, галерею, слайдер, вкладки или секцию на главной.

Перед изменениями выпишите, какие элементы страницы реально завязаны на Rok-плагины. Если слайдер уже заменён на блоки WordPress, галерея не используется, а тема давно переделана, RokCommon может оказаться остатком старой сборки. Если же бизнес-важная главная страница всё ещё держится на RokSprocket, действовать нужно аккуратнее.

Нужны простые социальные ссылки в старом стиле темы

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

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

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

RokUtilities относится к тем пакетам, которые безопаснее проверять на копии сайта. Причина не в том, что сам продукт обязательно опасен, а в его роли: он связан с зависимостями, старым кодом и компонентами, которые могли годами не обновляться в конкретной сборке. Ошибка в таком слое часто проявляется не “кнопка не появилась”, а “страница не открылась”.

Сделайте карту зависимостей сайта

Откройте список плагинов и отметьте все компоненты RocketTheme: RokSprocket, RokGallery, RokBox, RokAjaxSearch, Gantry, старые виджеты и любые элементы с префиксом Rok. Затем посмотрите активную тему. Если тема от RocketTheme или основана на Gantry, зависимость от RokCommon вероятнее, чем на обычной блочной теме.

Карта зависимостей должна отвечать на четыре вопроса:

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

Проверьте резервную копию и тестовую площадку

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

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

Зафиксируйте рабочие страницы до изменений

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

• Страница с RokSprocket-блоком, слайдером, мозаикой или лентой материалов.
• Страница с галереей или медиаблоком, если используется RokGallery.
• Запись, где должны появляться социальные кнопки.
• Страницы BuddyPress, если сайт использует профили, группы или активность.
• Раздел админ-панели, где редактируются соответствующие элементы.

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

Установка через WordPress и первый запуск компонентов

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

Установка ZIP-пакета

Стандартный безопасный путь в WordPress выглядит так: откройте Plugins, затем Add New, затем Upload Plugin. Выберите ZIP-файл RokUtilities или нужного компонента из пакета, нажмите Install Now и не активируйте всё сразу, если установщик показывает несколько частей.

Если в архиве есть отдельные компоненты, включайте их по одному. Сначала RokCommon, если сайт использует RokSprocket или RokGallery. Затем проверка зависимых страниц. Только после этого RokSocialButtons или GantryBuddyPress, если они действительно нужны.

Порядок активации

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

1. Включить RokCommon и проверить, что админ-панель открывается без фатальных ошибок.
2. Открыть раздел RokSprocket или RokGallery, если они используются, и убедиться, что редактор загружается.
3. Сохранить один тестовый элемент без изменения публичного дизайна, если это безопасно.
4. Очистить кеш сайта и браузера, затем открыть контрольную страницу.
5. Только после этого включать RokSocialButtons или GantryBuddyPress, если они нужны сценарию.

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

Что делать, если админ-панель недоступна

Если сайт сломался сразу после включения компонента, сначала откройте журнал ошибок хостинга или debug.log, если он был настроен заранее. Ищите строки с wp_rokcommon, RokCommon, RokSprocket или названием активной темы. Если админ-панель недоступна, временное переименование папки проблемного плагина через файловый менеджер хостинга может вернуть доступ, но это уже аварийный путь.

Не редактируйте файлы внутри wp-content/plugins/wp_rokcommon/ вручную. Такие правки трудно поддерживать, они теряются при замене пакета и могут скрыть настоящую причину. Безопаснее восстановить чистую папку компонента из проверенного архива или откатить сайт из резервной копии.

Разбор состава: RokCommon, RokSocialButtons и GantryBuddyPress

Этот раздел полезен перед настройкой, потому что у RokUtilities нет единого сценария “включить всё”. Для старого сайта часто нужно оставить один компонент, отключить второй и полностью проигнорировать третий. Ошибка начинающих администраторов - активировать весь набор, а потом искать, почему появились дубли, предупреждения или конфликт с темой.

Почему не стоит активировать всё сразу

Вспомогательные компоненты меняют не только внешний вид, но и внутреннюю загрузку сайта. RokCommon добавляет библиотечный слой, RokSocialButtons вмешивается в вывод контента, GantryBuddyPress может влиять на шаблоны страниц сообщества. Если включить всё одновременно, при ошибке будет сложнее понять, какой компонент виноват.

Разделите проверку на короткие итерации. Включили один компонент - проверили админ-панель, публичную часть, журналы ошибок и контрольную страницу. Если всё стабильно, переходите к следующему. Такой подход медленнее на несколько минут, зато он даёт понятную точку отката.

Как вести журнал изменений

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

Записывайте не только успешные действия, но и отказ от действия. Например: “GantryBuddyPress не включали, потому что BuddyPress на сайте не используется”. Через несколько месяцев эта запись сэкономит время и не даст другому администратору включить legacy-компонент из любопытства.

Когда RokCommon действительно нужен, а когда его лучше отключить

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

Проверка RokSprocket

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

Если интерфейс не загружается, не делайте вывод сразу. Посмотрите логи. Ошибка вида “не найден класс RokCommon” или путь к wp_rokcommon усиливает гипотезу о проблеме с библиотекой. Ошибка JavaScript, проблема загрузки изображения или конфликт с другим плагином может требовать другого решения.

Проверка RokGallery

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

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

Когда библиотеку можно оставить выключенной

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

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

Настройка RokSocialButtons без дублей и конфликтов

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

Где искать настройки

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

Не придумывайте отсутствующие параметры. Если в вашей версии нет выбора сетей, позиции или типа записи, не пытайтесь “починить” это кодом. Лучше ограничить применение компонента тем, что он реально поддерживает, или заменить его более актуальным решением.

Проверка мест вывода

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

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

Когда лучше заменить RokSocialButtons

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

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

GantryBuddyPress: legacy-компонент для узкого сценария

GantryBuddyPress - часть RokUtilities, к которой стоит относиться особенно осторожно. В официальном описании она отмечена как legacy, а интеграция BuddyPress указана как встроенная в Gantry. Это значит, что компонент нужен не “для BuddyPress вообще”, а для старых проектов, где конкретная тема или сборка ожидает именно этот слой совместимости.

Когда компонент может быть оправдан

Сценарий выглядит так: сайт работает на старой теме RocketTheme, использует BuddyPress, а страницы сообщества исторически были оформлены через Gantry/RocketTheme-интеграцию. После переноса или смены окружения страницы профилей, групп или активности выглядят неправильно. В такой ситуации GantryBuddyPress можно проверить как один из элементов старой цепочки.

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

Почему legacy-статус важен

Legacy не означает автоматически “не работает”. Это означает, что компонент относится к старой архитектуре и может не учитывать современные изменения WordPress, BuddyPress, PHP, темы или Gantry. Чем старше связка, тем больше зависимость от конкретной версии окружения и старых шаблонных ожиданий.

Для нового BuddyPress-сайта GantryBuddyPress не должен быть первым выбором. Лучше начать с актуальной темы, поддерживаемых шаблонов BuddyPress и документации самой платформы. GantryBuddyPress имеет смысл только как мост для уже существующего старого проекта.

Что проверять после включения

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

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

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

Представим реальную задачу: сайт на старой теме RocketTheme перенесли на новый хостинг. Главная страница открывается, но блок RokSprocket не редактируется, на некоторых страницах появляются пустые области, а владелец просит “просто обновить RokUtilities”. Правильный подход - не начинать с замены файлов, а провести короткий аудит.

Цель и подготовка

Цель - понять, какие компоненты RokUtilities реально нужны и что именно сломалось после переноса. Перед началом сделайте резервную копию, включите журналирование ошибок на тестовой копии, выпишите активные RocketTheme-плагины и выберите три контрольные страницы: главную с RokSprocket, страницу с галереей и запись, где должны быть социальные кнопки.

Дополнительно откройте Tools - Site Health - Info и сохраните сведения о WordPress, PHP, активной теме и активных плагинах. Эти данные помогут сравнить старое и новое окружение, если владелец сайта предоставит информацию о прежнем хостинге.

Порядок действий

1. Откройте контрольные страницы без изменений и зафиксируйте текущие симптомы.
2. Проверьте журналы ошибок на упоминания wp_rokcommon, RokCommon, RokSprocket или активной темы.
3. Убедитесь, что RokCommon установлен и активен, если RokSprocket или RokGallery действительно используются.
4. Если RokCommon отсутствует или повреждён, установите чистый пакет через ZIP на тестовой копии.
5. Откройте редактор RokSprocket, сохраните тестовое изменение только в безопасном элементе или просто проверьте загрузку интерфейса.
6. Очистите кеш и проверьте публичные страницы в обычном окне браузера и в приватном режиме.
7. Если проблема сохраняется, временно отключайте неключевые плагины по одному, начиная с кеша, оптимизации и дублирующих социальных плагинов.

Проверка результата

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

Нюанс этого сценария в том, что старые RocketTheme-сайты часто ломаются слоями. Сначала обнаруживается RokCommon, потом устаревшая тема, потом конфликт кеша, затем старый плагин SEO или формы. Поэтому фиксируйте каждый шаг. Так вы не перепутаете причину и следствие.

Как понять, что всё работает после настройки

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

Проверка в админ-панели

Откройте список плагинов и убедитесь, что активны только нужные части. Затем перейдите в разделы зависимых компонентов. Для RokSprocket важно, чтобы загружались списки элементов, фильтры, медиавыбор и окно редактирования. Для RokGallery - список галерей и отдельные изображения. Для RokSocialButtons - доступные настройки или ожидаемый способ вывода, если компонент управляется через тему.

Если админ-интерфейс открывается, но сохранение не работает, проверьте консоль браузера и сетевые запросы. Старые Ajax-интерфейсы могут ломаться из-за JavaScript-конфликтов, блокировок безопасности, кеширования админ-скриптов или несовместимости с другими плагинами.

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

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

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

Проверка журналов и кеша

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

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

Диагностика типичных проблем legacy Rok-плагинов

Большинство проблем с RokUtilities связано не с тем, что пользователь “не нашёл настройку”, а с зависимостями и старым окружением. Ниже собраны симптомы, которые чаще всего подходят именно этому классу компонентов. Используйте таблицу как карту диагностики, а не как автоматический рецепт.

Частые проблемы и безопасные проверки

Симптом	Возможная причина	Что проверить	Как действовать
Белый экран после переноса или смены PHP.	Старый RokCommon, повреждённая папка wp_rokcommon или конфликт темы.	PHP error log, пути к RokCommon, активную тему, последние изменения хостинга.	Откатить на копии, восстановить чистый компонент из проверенного архива, проверить зависимые плагины.
RokSprocket не открывает редактор или медиавыбор.	RokCommon не загружен, старый Ajax-интерфейс конфликтует с другим плагином.	Консоль браузера, сетевые запросы, активность кеша, версии RokSprocket и RokCommon.	Включить RokCommon, отключить кеш админки, временно изолировать конфликтующие плагины.
Социальные кнопки появились дважды.	RokSocialButtons работает вместе с кнопками темы или другим share-плагином.	Настройки темы, активные социальные плагины, места вывода в записи и шаблоне.	Оставить один источник кнопок, отключить лишний компонент, очистить кеш.
BuddyPress-страницы выглядят по-разному для гостей и участников.	Legacy-интеграция, права доступа, кеширование страниц сообщества.	Профили, группы, активность, роли пользователей, исключения кеша.	Тестировать под разными ролями, исключить динамические BuddyPress-страницы из агрессивного кеша.
После отключения RokCommon пропал блок на главной.	Осталась зависимость старого RokSprocket или RokGallery.	Виджеты, шорткоды, настройки темы, список элементов RokSprocket.	Вернуть RokCommon или заменить зависимый блок современным решением перед удалением библиотеки.

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

Откат нужен, если после включения компонента появились фатальные ошибки, сломалась админ-панель, перестали сохраняться записи или публичная часть стала нестабильной. Не пытайтесь “дожать” настройку на рабочем сайте. Верните прежнее состояние, перенесите эксперимент на копию и только там выясняйте, какая часть связки конфликтует.

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

Ограничения поддержки и план выхода из legacy-зависимости

RokUtilities часто появляется в проектах, где технический долг копился годами: старая тема, старые виджеты, старый способ сборки главной страницы, ручные правки, которые никто не документировал. В такой ситуации задача администратора не сводится к установке последнего доступного ZIP. Нужно решить, что именно поддерживать сейчас, что заменить в ближайшей итерации и какие части сайта больше не должны зависеть от старой RocketTheme-связки.

Самая частая ошибка - воспринимать RokCommon как “обновление безопасности” для всего сайта. Это библиотека для конкретных зависимых компонентов. Если она нужна, её нужно держать в рабочем состоянии. Если она не нужна, её нужно вывести из проекта. Но оставлять её активной без потребителей, просто потому что она когда-то была в RocketLauncher, не лучший подход.

Разделите поддержку и модернизацию

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

В рабочем плане удобно выделить три группы элементов:

• Критичные элементы, которые прямо сейчас нужны сайту: например главный слайдер, галерея портфолио или страница сообщества.
• Исторические элементы, которые активны в админ-панели, но больше не используются в публичной части.
• Заменяемые элементы, которые дают понятную функцию, но могут быть перенесены в современный блок, тему или поддерживаемый плагин.

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

Как проверять риск совместимости

Для RokUtilities риск совместимости лучше оценивать по цепочке, а не по одному названию плагина. Смотрите на WordPress, PHP, активную тему, Gantry, RokSprocket, RokGallery, BuddyPress и кеш. Если изменился только один слой, например версия PHP на хостинге, проблема может проявиться в RokCommon, хотя настоящая причина - старый код зависимого компонента или темы.

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

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

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

План замены RokSprocket или RokGallery

Если сайт держится на RokCommon только из-за одного RokSprocket-блока, подумайте о постепенной замене этого блока. Не обязательно делать это в тот же день. Начните с инвентаризации: где используется элемент, какие записи он подтягивает, есть ли у него ручные изображения, какие фильтры и сортировки заданы, какие стили использует тема.

Шаг первый: описать текущий результат

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

Шаг второй: собрать замену на копии сайта

На копии сайта создайте новый блок средствами темы, редактора WordPress или отдельного поддерживаемого плагина. Не удаляйте старый RokSprocket до тех пор, пока новый вариант не пройдёт проверку. Сравните скорость загрузки, мобильный вид, поведение ссылок, alt-тексты изображений и удобство редактирования для контент-менеджера.

Шаг третий: отключить зависимость только после переноса

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

Что записать в документацию проекта

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

Хорошая запись выглядит предметно: “RokCommon оставлен активным, потому что главная страница использует RokSprocket Showcase; проверены главная, архив новостей и редактор RokSprocket; цель на следующую итерацию - заменить Showcase на блок темы”. Плохая запись: “RokUtilities нужен для сайта”. Вторая формулировка ничего не объясняет и не помогает следующему специалисту.

Когда RokUtilities стоит оставить, а когда пора убирать

RokUtilities будет удачным выбором, если вы поддерживаете старый WordPress-сайт на RocketTheme, где RokSprocket, RokGallery или старая Gantry/BuddyPress-связка реально зависят от компонентов пакета. В таком случае задача администратора - не “модернизировать всё за один вечер”, а стабилизировать сайт, проверить зависимости и подготовить план дальнейшей замены устаревших частей.

Если сайт новый, уже работает на современной теме или больше не использует Rok-плагины, держать RokUtilities ради исторической привычки не стоит. Отключайте лишние компоненты постепенно, проверяйте контрольные страницы и оставляйте только то, что реально используется.

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

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