PearCMS Docs v2.4
Документация / Шаблоны / Темы оформления

Темы оформления

Темы оформления публичной части лежат в каталоге templates/. Каждая — это набор PHP-шаблонов и статических ассетов; переключаются темы из админки одним кликом.

Актуально для v2.4 Обновлено 1 июля 2026

Какие темы есть #

ТемаСтильОсобенности
AuroraСветлаяПо умолчанию. Бумажная палитра, тонкая типографика.
AureliaТёмнаяКонтрастный night-mode.
defaultБазоваяИспользуется как фолбэк, когда в активной теме нет нужного шаблона.

Переключение — Темы в меню админки (/s-panel/themes). Активная тема пишется в ключ settings.active_theme.

Анатомия темы #

templates/Aurora/text
Aurora/
├── theme.json              # имя, версия, автор, превью
├── assets/                # статика: css, js, шрифты, картинки
│   ├── style.css
│   ├── main.js
│   └── img/
├── layout.php              # обёртка: <head>, header, footer
├── home.php                # главная
├── page.php                # статическая страница
├── post.php                # запись блога
├── partials/              # шапка, футер, меню, формы
│   ├── header.php
│   └── footer.php
└── 404.php

Никакого Twig — обычный PHP. Внутри шаблона доступны: $page, $site, хелперы e(), __(), и компилируемые шорткоды {lang, 'key'}, {settings, 'site_name'}. Подробнее — на странице View-движок.

Активная тема и фолбэк #

Когда модуль или контроллер вызывает View::render('news/list', $data), движок ищет файл в таком порядке:

  1. templates/{active_theme}/news/list.php
  2. templates/default/news/list.php
  3. modules/MNews/views/default/news/list.php — встроенный шаблон модуля

Это позволяет переопределить шаблон модуля прямо в теме, не трогая сам модуль: просто положите свою версию по тому же пути в Aurora/.

Не правьте defaultБазовая тема — это последний рубеж фолбэка. Если хотите кастомить — копируйте в свою тему и меняйте там, чтобы обновления ядра не затёрли правки.