Установка, обновление и удаление

Руководство относится к модулю «Глобал АйТи. Темная тема. Темы для панели управления» (globalit.admindark) версии 1.1.0. Модуль устанавливает администратор сайта. После установки каждый пользователь административной панели может выбрать собственную тему.

Описание модуля · Быстрый старт · Общие и личные настройки

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

Что проверить	Требование
PHP на сайте	8.1 или новее. Учитывайте версию PHP, с которой работает сайт, а не только версию в командной строке сервера.
Главный модуль 1С-Битрикс	22.0.0 или новее.
Права пользователя	Администратор сайта с действительной сессией.
Доступ к файлам	PHP-процесс сайта должен иметь возможность установить файлы в `/bitrix/css/globalit.admindark/`, `/bitrix/js/globalit.admindark/` и административную страницу в `/bitrix/admin/`.
Интерфейс	Классическая административная панель 1С-Битрикс.

Модуль проверяет минимальные версии PHP и главного модуля при установке. Совместимость самого Битрикса с установленной версией PHP также должна быть соблюдена.

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

Это серверный модуль. Он не устанавливается как приложение в облачный Битрикс24. Публичные страницы сайта, верхняя панель редактирования на сайте и страница входа также не входят в область оформления.

Установка через штатный раздел решений

Войдите в административную часть сайта под администратором.
Загрузите решение globalit.admindark штатными средствами Marketplace.
Откройте «Marketplace → Установленные решения».
Найдите «Глобал АйТи. Темная тема. Темы для панели управления» и выполните установку.
После успешной установки откройте новую страницу административной панели.

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

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

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

Если получен установочный архив

Этот способ предназначен для администратора или специалиста, который размещает файлы на сервере.

Проверьте, что архив предназначен для globalit.admindark.
В первичном установочном пакете откройте каталог .last_version.
Разместите содержимое этого каталога в /local/modules/globalit.admindark/ относительно корня сайта. Не создавайте дополнительный уровень .last_version внутри каталога модуля.
Откройте «Marketplace → Установленные решения» и установите модуль штатным действием.

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

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

Начните с тех экранов, на которых работают сотрудники:

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

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

Обновление установленного модуля

Перед обновлением сохраните резервную копию сайта и базы данных. Если вы создали собственную палитру, дополнительно скачайте её через «Сервисы → Оформление админки → Конструктор темы → Скачать тему в JSON».

Проведите обновление штатными средствами Marketplace, затем проверьте установленный номер версии в списке решений. Для этой документации ожидается 1.1.0.

После обновления:

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

Если браузер продолжает показывать прежние стили, выполните принудительное обновление страницы, например Ctrl+F5 в Windows. Дополнительные проверки приведены в разделе «Ошибки и вопросы».

Временно отключить оформление

Для своего аккаунта выберите «Светлая» на вкладке «Личная тема» и нажмите «Сохранить». Сохранённая собственная палитра при этом остаётся доступной.

Для всех пользователей администратор снимает флажок «Включить тёмную тему в административной панели» в общих настройках и нажимает «Сохранить». Личные предпочтения сохраняются и снова учитываются после включения. Подробный порядок.

Удаление и повторная установка

Войдите под администратором.
Откройте «Marketplace → Установленные решения».
Найдите globalit.admindark и выполните штатное удаление.
Обновите страницы административной панели.

Удаление отключает подключение темы и удаляет установленные модулем файлы оформления, скрипт конструктора и его административную страницу. Модуль сохраняет:

общий выключатель и тему по умолчанию;
выбор темы каждого пользователя;
сохранённую собственную палитру каждого пользователя.

Поэтому повторная установка не является сбросом настроек. Чтобы изменить оформление, достаточно использовать общие и личные настройки. Данные сайта и файлы сторонних решений модуль при штатном удалении не удаляет.

Если удаление завершилось ошибкой, проверьте права удаления установленных файлов и повторите штатную операцию. Не удаляйте целиком /bitrix/admin/, /bitrix/css/ или /bitrix/js/: это общие каталоги Битрикса.