Ошибки и частые вопросы
Инструкции относятся к globalit.admindark 1.1.0. Начните с личного выбора и общего выключателя: светлая панель часто означает выбранный режим, а не ошибку установки.
Установка и требования · Общие и личные настройки · Конструктор темы
Быстро вернуть штатное оформление
Только для своего аккаунта: откройте «Сервисы → Оформление админки → Личная тема», в поле «Моя тема» выберите «Светлая» и нажмите «Сохранить».
Если навигация плохо читается, откройте страницу напрямую на своём сайте:
/bitrix/admin/globalit_admindark_preferences.php?lang=ru
Для всех пользователей: администратор открывает общие настройки, снимает «Включить тёмную тему в административной панели» и нажимает «Сохранить»:
/bitrix/admin/settings.php?mid=globalit.admindark&lang=ru
Оба действия сохраняют собственные палитры. Общий выключатель также сохраняет личный выбор сотрудников. Обновите остальные открытые страницы, чтобы увидеть результат.
Тема установлена, но панель осталась светлой
Проверьте по порядку:
- Вы вошли в административную часть сайта. Страница входа, публичный сайт, панель редактирования на публичной странице и публичные диалоги модулем не оформляются.
- В «Marketplace → Установленные решения» модуль установлен, а не только загружен.
- В личных настройках выбран тёмный вариант, а строка «Применяемая тема» показывает ожидаемую тему.
- Если выбран вариант «Как задано администратором», общая тема по умолчанию не установлена в «Светлая».
- Администратор не снял общий флажок включения. При выключенном оформлении личный выбор сохраняется, но применяется светлая тема.
- После сохранения страница обновилась. На другой ранее открытой вкладке обновите её вручную; при необходимости выполните принудительное обновление, например Ctrl+F5 в Windows.
Если настройки верны, передайте специалисту сведения об установке и проверьте загрузку файлов из /bitrix/css/globalit.admindark/. Ошибки доступа или отсутствие файлов могут мешать применению оформления. Не пытайтесь исправлять это удалением общих каталогов Битрикса.
Общая тема изменилась, а у сотрудника осталась прежняя
Тема по умолчанию влияет на пользователей с вариантом «Как задано администратором». Если сотрудник раньше выбрал «Чёрная», «Светлая» или другой конкретный вариант, его выбор имеет приоритет при включённом модуле.
Чтобы следовать общей настройке, сотрудник открывает вкладку «Личная тема», выбирает «Как задано администратором» и нажимает «Сохранить». Если нужно временно отключить оформление для всех, используйте общий выключатель.
Нет пункта «Оформление админки»
Убедитесь, что модуль установлен и вы авторизованы в административной части. Обновите страницу и проверьте раздел «Сервисы».
Затем откройте прямой путь:
/bitrix/admin/globalit_admindark_preferences.php?lang=ru
Если получен ответ о недоступной странице, специалисту нужно проверить установку административного файла модуля. Если показано сообщение «Модуль оформления админки не установлен или не может быть подключён», проверьте состояние модуля в списке решений и целостность его файлов.
Личная тема предназначена и для редакторов без прав администратора, у которых есть доступ к административной панели. Общие настройки доступны только администратору.
Сообщения при сохранении
| Сообщение | Что сделать |
|---|---|
| Сессия истекла. Обновите страницу и повторите сохранение. | Сохраните отдельно нужные несохранённые значения или файл палитры, затем обновите страницу. Если требуется, войдите снова и повторите действие. |
| Выберите тему из списка. | Повторно откройте вкладку «Личная тема», выберите доступный вариант и сохраните. Для «Моя тема» сначала должна существовать сохранённая собственная палитра. |
| Некорректное значение настройки темы. | Обновите общие настройки, выберите тему из штатного списка и снова нажмите «Сохранить». |
| Не удалось сохранить личную тему. Повторите сохранение. | Повторите действие после обновления страницы. Если ошибка остаётся, передайте её администратору: нужно проверить сохранение пользовательских настроек на сайте. |
| Настройки доступны только администратору. | Для личного выбора используйте «Сервисы → Оформление админки». Общий выключатель и тема по умолчанию требуют учётной записи администратора. |
Не перезагружайте страницу конструктора, если на ней остались нужные несохранённые цвета: сначала скопируйте их. Экспорт JSON содержит сохранённую палитру без несохранённых изменений в полях конструктора.
«Моя тема» недоступна или не включилась
Вариант «Моя тема» недоступен до первого успешного сохранения или импорта собственной палитры. Откройте вкладку «Конструктор темы», подготовьте цвета и нажмите «Сохранить палитру».
Для немедленного выбора палитры отметьте «Сразу включить мою тему». Если палитра уже сохранена, её можно выбрать отдельно на вкладке «Личная тема».
Проверьте общий выключатель. При выключенном оформлении палитра сохраняется, но административная панель остаётся светлой.
Если вы сняли флажок «Сразу включить мою тему», но цвета всё равно изменились, проверьте личный выбор. При уже активной «Моя тема» сохранение заменяет цвета используемой палитры. Флажок управляет переключением темы, а не созданием отдельного черновика.
Конструктор не принимает цвет или файл JSON
Для цвета нужен полный шестизначный HEX-код: например, #1F2937. Сокращённый #123, название black, rgb(...) и значение с прозрачностью не принимаются.
При сообщении «Не удалось принять тему» проверьте:
- файл имеет формат JSON, а не CSS, ZIP или изображение;
- его размер не превышает 16 КиБ;
- файл экспортирован из этого модуля либо соблюдает его формат темы;
- указаны
format: "globalit.admindark.theme"и целочисленнаяversion: 1; - есть непустое название длиной до 60 символов и ровно 24 предусмотренных цвета
#RRGGBB; - нет дополнительных полей, неизвестных цветов и HTML-разметки в названии.
Проще всего повторно скачать тему через «Скачать тему в JSON» и использовать полученный файл. Если не загружается даже он, проверьте ограничения загрузки файлов на сервере и сам факт успешной отправки файла.
Импорт заменяет собственную палитру текущего аккаунта. Перед заменой скачайте прежнюю палитру, если хотите сохранить её отдельно.
В JSON оказались прежние цвета
«Скачать тему в JSON» экспортирует сохранённую палитру. Нажмите «Сохранить палитру», а затем скачайте файл ещё раз.
Если собственная палитра ещё не создана, экспортируется текущая готовая тёмная тема. При светлом оформлении используется стандартная тёмная основа. Само скачивание файла не создаёт и не включает личную палитру.
Предпросмотр изменился, а остальная админка нет
До сохранения это ожидаемо. Конструктор показывает новые цвета в собственном блоке «Предпросмотр», не перекрашивая открытый административный экран.
Чтобы применить палитру, отметьте «Сразу включить мою тему» и нажмите «Сохранить палитру». После перезагрузки проверьте строку «Применяемая тема». Если общий выключатель снят, включить оформление сможет администратор.
Часть интерфейса осталась светлой
Модуль оформляет стандартные элементы административной панели. Собственные экраны сторонних модулей, отдельные новые компоненты и встроенные страницы в iframe могут использовать другую разметку и стили.
Изображения, значки, предпросмотр публичных страниц и содержимое редакторов сохраняют исходные цвета. Светлый лист документа или изображение сами по себе не означают ошибку темы.
Если проблема затрудняет работу:
- Переключитесь на «Светлая» и проверьте этот экран повторно.
- Сохраните адрес страницы без секретных параметров, название стороннего модуля и его версию.
- Сделайте скриншоты проблемного участка в светлом и тёмном оформлении.
- Передайте пример в поддержку, скрыв персональные данные и содержимое, которое нельзя публиковать.
В собственной палитре также проверьте контраст. Показатель конструктора сравнивает только основной текст и фон карточки; он не проверяет автоматически все ссылки, уведомления и состояния интерфейса.
Ошибка установки или удаления
При отказе из-за версии проверьте PHP 8.1+ и главный модуль 22.0.0+. При сообщении о сессии войдите заново и повторите штатное действие под администратором.
Если установка сообщает об ошибке файлов, специалисту нужно проверить запись в каталоги CSS и JavaScript модуля, а также установку административной страницы в /bitrix/admin/. Если очистка после неудачной установки завершилась не полностью, перед повторной попыткой проверьте состояние модуля и установленных им файлов.
При неудачном удалении проверьте права удаления файлов модуля и повторите операцию из списка установленных решений. Переустановка сохраняет прежние настройки и не заменяет их сброс.
Что передать в поддержку
Укажите версию модуля, версию главного модуля Битрикса и PHP сайта, название выбранной темы и значение строки «Применяемая тема». Опишите конкретный экран, действие и ожидаемый результат; приложите текст ошибки и скриншот проблемного участка.
Для собственной палитры полезно приложить экспортированный JSON. Не включайте в обращение пароли, ключи доступа и закрытые данные сайта. Поддержка сможет точнее воспроизвести проблему, если вы сообщите, повторяется ли она в готовой палитре и исчезает ли после выбора «Светлая».