Темы

⚠️ Управление темами в Pano требует права доступа «Управление представлением» (View Management).
Если вы не вошли в систему как администратор, у вас должно быть право доступа на просмотр, чтобы открыть страницу тем и выполнять связанные с ними действия.

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

Темы работают независимо от аддонов бэкенда, что означает, что вы можете переключать темы без перезапуска Pano и без влияния на работу аддонов.

🎨 Создание собственной темы

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

Каждая тема представляет собой отдельное приложение SvelteKit, упакованное в .zip архив после сборки.
В отличие от традиционных тем, здесь нет папок assets/ или build/, которыми нужно управлять вручную — процесс сборки сделает всё за вас.

Тема может:

• Определять собственные макеты, маршруты или виджеты.
• Добавлять собственную систему стилей и конфигурацию переменных.
• Взаимодействовать с бэкендом Pano через REST API.
• Опционально зависеть от конкретных аддонов или предоставлять пользовательские API для других.

Темы могут получать данные бэкенда только через слой API Pano, но при этом они работают как настоящие UI-приложения.

📘 Узнайте, как создать и упаковать свою тему, здесь:
👉 Руководство по разработке тем →

💡 Почему темы важны

Темы — это то, что формирует пользовательский опыт сайта вашего сервера.
Они определяют, как посетители взаимодействуют с вашим контентом и как сообщество видит ваш бренд.

Темы позволяют вам:

• Настраивать индивидуальность и дизайн вашего сайта.
• Изменять цветовые схемы, макет и структуру.
• Создавать разные стили для разных аудиторий.
• Интегрироваться с аддонами для расширения функциональности.
• Публиковать и делиться своей темой с другими в Pano Marketplace.

Некоторым аддонам могут требоваться определенные темы, а некоторым темам — определенные аддоны для правильной работы.
Кроме того, некоторые темы расширяют или переопределяют стандартное поведение API Pano для предоставления расширенных функций.

⚙️ Как работают темы (за кулисами)

Pano загружает темы как независимые UI-приложения из директории themes/.
Каждая тема содержит файл манифеста manifest.json, в котором хранятся метаданные (id, версия, автор, совместимость и т. д.).
Этот файл автоматически создается и управляется Pano — не редактируйте его вручную.

При запуске Pano:

1. Сканирует папку themes/ на наличие валидных тем.
2. Невалидные или поврежденные темы автоматически пропускаются.
3. Только валидные темы отображаются в разделе Панель → Вид → Темы.
4. Pano перезагружает все доступные темы при запуске.
5. Только что установленные темы автоматически обнаруживаются и отображаются — ручная перезагрузка не требуется.

Стандартные интерфейсы в Pano

По умолчанию Pano поставляется с тремя встроенными UI-приложениями:

• panel-ui → Панель администратора.
• setup-ui → Интерфейс настройки (отображается при первой конфигурации).
• vanilla-theme → Стандартная тема публичного сайта.

Только vanilla-theme является полноценной темой.
Остальные два приложения (panel-ui, setup-ui) являются UI-приложениями, а не темами, и не будут отображаться в списке тем.

Если Pano еще не был настроен, он автоматически показывает Setup UI до завершения установки.

Чтобы получить доступ к панели администратора, перейдите по адресу /panel в вашем браузере — если вы вошли в систему и имеете необходимые права, вы будете перенаправлены в интерфейс панели.

📦 Установка тем

Вы можете установить темы двумя способами:

1. С вашего локального компьютера

1. Откройте раздел Панель → Вид → Темы.
2. Нажмите Установить тему.
3. Перетащите ваш .zip файл темы или выберите его вручную.
4. Новая тема будет автоматически загружена и отображена в списке — перезагрузка не требуется.

⚠️ Предупреждение о непроверенных темах:
Установка тем из неизвестных или неофициальных источников осуществляется на ваш страх и риск.
Непроверенные темы могут содержать небезопасный или несовместимый код.
Устанавливайте только те темы, которым вы доверяете, или те, что опубликованы в Pano Store.

2. Из Pano Store

1. В окне Установить тему нажмите Browse Store.
2. Выберите тему — бесплатную или премиум.
3. Нажмите Install и позвольте Pano сделать всё автоматически.
4. Тема появится автоматически после установки.

🛍️ Для использования Маркетплейса требуется привязанный аккаунт Pano.

🧩 Активация и управление темами

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

Чтобы управлять вашими темами:

1. Перейдите в раздел Панель → Вид → Темы.
2. Выберите тему.
3. Нажмите Start или Stop, чтобы активировать или деактивировать её.

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

⚙️ Настройка тем

Каждая тема имеет свои собственные параметры конфигурации, которые могут отличаться от темы к теме.
В целом вы можете настроить:

• Цвета и цветовые переменные
• Макет шапки (header) и подвала (footer)
• Шрифты и типографику
• Фоновые изображения и градиенты
• Ширину макета, отступы и размеры контейнеров
• Логотип сайта, фавиконку или брендинг

Вы можете просмотреть и изменить настройки активной темы в разделе:
Панель → Вид → Настройки темы

Изменения применяются мгновенно — перезапуск не требуется.

⚠️ Удаление темы

Темы можно удалить только со страницы их подробного описания — не из общего списка тем.

При удалении:

• Если тема активна в данный момент, Pano автоматически переключится обратно на vanilla-theme.
• Встроенные UI-приложения (panel-ui, setup-ui, vanilla-theme) нельзя удалить, изменить или обновить по отдельности.
• Pano автоматически переустанавливает любые отсутствующие встроенные приложения во время запуска, если они были повреждены или удалены.

Чтобы удалить пользовательскую тему:

1. Перейдите в раздел Панель → Вид → Темы → [Подробнее о теме].
2. Нажмите Удалить.
3. Подтвердите действие.

🧱 Структура директорий

Пример структуры директории Pano с темами:

/pano/
├── Pano-1.0.0.jar
├── config.conf
├── panel-ui/
├── setup-ui/
├── themes/
│    ├── vanilla-theme/
│    ├── dark-matter-theme/
└── file-uploads/

Важно:

• Не изменяйте и не заменяйте panel-ui, setup-ui или vanilla-theme.
• Они управляются Pano внутренне и будут автоматически переустановлены при запуске, если будут отсутствовать или повреждены.
• Вручную управляйте только папками тем, установленных пользователем.

🧠 Резюме

Действие	Расположение	Описание
Установить (локально)	Панель → Вид → Темы → Установить тему	Перетащите или загрузите
Установить (магазин)	Панель → Вид → Темы → Установить тему → Browse Store	Загрузка напрямую из маркетплейса
Активировать / Остановить	Панель → Вид → Темы → Start/Stop	Включить или отключить тему
Настроить	Панель → Вид → Настройки темы	Изменить цвета, макет, шрифты
Удалить	Панель → Вид → Темы → Подробнее о теме → Удалить	Безопасно удалить кастомную тему

🧩 Продвинутые примечания

• Только валидные темы отображаются в списке; поврежденные или неполные темы игнорируются.
• Каждая тема упаковывается в виде сборки SvelteKit (.zip архив).
• Каждая тема содержит файл manifest.json, генерируемый автоматически — не редактируйте вручную.
• Некоторые аддоны зависят от определенных тем, и наоборот.
• Некоторые темы предоставляют или переопределяют стандартные API для расширенной функциональности.
• Встроенные UI-приложения (panel-ui, setup-ui, vanilla-theme) защищены и не могут быть изменены.
• Если они повреждены или отсутствуют, Pano автоматически переустановит их во время запуска.
• Темы не изолированы (не в песочнице), но их доступ к бэкенду ограничен HTTP API эндпоинтами.

🌈 Темы определяют индивидуальность вашего Pano — ваш мир, ваш дизайн, ваше лицо.