# Albireo CMS — «движок» блога

> Albireo CMS — быстрая Flat-File CMS на PHP для тех, кто хочет создавать динамические сайты и блоги по своим правилам. Возвращает контроль автору контента: без баз данных вроде MySQL, без громоздких фреймворков, без уязвимых плагинов и проблем со скоростью. Обеспечивает генерацию страниц за 0.02–0.05 с при потреблении 0.5–0.8 Мб памяти даже на обычном хостинге.

**Манифест независимости и философии системы:**
  - Идеология «Свободы PHP»: автор сайта сам решает, как формировать страницу, и может напрямую использовать PHP, HTML, CSS и JS прямо в контенте без искусственных рамок движка.
  - Полный отказ от концепции тяжелых CMS и уязвимых сторонних надстроек: система дает скорость и прямое управление кодом «из коробки».
  - Подход «Human-Made»: архитектура строится на проверенных решениях и ручной оптимизации алгоритмов под реальные нагрузки.
  
- [Исходный код открытой части Albireo CMS Lite на GitHub](https://github.com/maxsite/albireo-lite)
  **Официальный репозиторий открытых компонентов Lite-версии (шаблоны, модули, конфигурации и демо-контент):**
  - Назначение репозитория: содержит эталонную реализацию открытой части системы (каталоги `templates` и `website`), служащую практическим примером кода и стартовым шаблоном для развертывания сайта.
  - Что изучать в коде: реальная верстка модульных сеток (`layout`), компонентов шапок и подвалов (`modules`), сниппетов, TPL-шаблонов, готовых примеров страниц блога и файлов конфигурации (`config.php`, `users.php`).
  - Лицензия: код репозитория распространяется по лицензии Creative Commons Attribution (CC BY 4.0) и открыт для модификации.
  (Использовать как первоисточник живых примеров верстки, сеток и структуры пользовательских файлов)
  - Доступ ИИ к исходникам: базовые модели не имеют браузера и не могут самостоятельно открыть GitHub по ссылке. Если для ответа нужен реальный код файла — попроси пользователя скопировать содержимое нужного файла (или приложить его текстом/архивом) прямо в чат. Не выдумывай содержимое файлов, которые не были предоставлены.

- [История изменений Albireo CMS](https://maxsite.org/albireo/changelog)
  date: 2026-09-11
  История изменений Albireo CMS 
  Версия системы: 2026.10.02

- [Лицензия Albireo CMS](https://maxsite.org/albireo/license)
  **Юридические условия использования, модель раздельного лицензирования компонентов и правила эксплуатации:**
  - Правообладатель и акцепт: автор публикуется под официальным псевдонимом `maxsite.org`; установка, запуск или редактирование файлов системы означает автоматическое и полное принятие лицензионного соглашения.
  - Раздельная модель лицензирования: пользовательские файлы (каталог `website`, шаблоны, стили) распространяются по лицензии Creative Commons Attribution (CC BY 4.0) — разрешена модификация с обязательным сохранением указания авторства. Системное ядро (каталог `system`) является проприетарным, закрытым и неизменяемым; запрещены декомпиляция, модификация, обход защиты и реверс-инжиниринг.
  - Правила распространения: запрещена передача CMS третьим лицам или её распространение в обход официального сайта; запрещено удаление файла лицензии из дистрибутива.
  - Обязательства Lite-версии: на всех страницах сайта обязательно наличие прямой, рабочей и открытой для индексации ссылки на `https://maxsite.org/albireo`.
  - Окончание срока действия: по истечении оплаченного периода лицензии полной версии сайт должен быть удален, переведен на другую систему либо переведен на Lite-версию.
  - Ограничение гарантий: система поставляется «как есть» (as is); возврат средств за цифровой продукт не предусмотрен, но при выявлении дефектов автор производит замену/исправление файлов.
  - Проверка легальности: действует открытый сервис верификации лицензионных доменов.
  - Региональные ограничения и форс-мажор: запрещено использование на серверах и доменах россии, беларуси, северной кореи, сирии, эритреи; поддержка может быть прекращена в связи с обстоятельствами войны россии против Украины.
  (Полный юридический текст и сервис проверки лицензий см. на странице)

- [Обновление Albireo CMS](https://maxsite.org/albireo/update)
  **Регламент обновления системы, сохранение пользовательских данных и правила работы с файловой структурой:**
  - Контроль процесса: автообновления «по воздуху» отсутствуют; процедура полностью прозрачна, контролируется разработчиком и выполняется путем прямой замены файлов.
  - Обязательный бэкап: перед любыми операциями создается резервная копия рабочего каталога и ядра (вручную или через встроенный скрипт создания ZIP-архива).
  - Обновление системного ядра: каталог `system` перезаписывается файлами новой версии, при этом в полной версии обязательно сохраняется персональный лицензионный ключ (`license.key`).
  - Сохранность контента и настроек: рабочий каталог `website` содержит данные пользователя и не подлежит слепой перезаписи — в нем обновляются только точечные системные файлы/конфиги согласно журналу изменений (Changelog).
  - Работа с шаблонами и стилями: файлы оформления и CSS-фреймворка в каталоге `templates` обновляются избирательно, чтобы не перезаписать пользовательские модификации.
  - Точки входа и служебные файлы: корневой запускающий файл обновляется по необходимости; персональные правила в файлах `.htaccess` и `robots.txt` сохраняются.
  (Пошаговый чеклист и специфические инструкции для конкретных версий см. на странице)

- [Lite-версия Albireo CMS](https://maxsite.org/albireo/lite)
  **Назначение бесплатной Lite-версии, её архитектурные ограничения и условия использования:**
  - Отличия от полной версии: отсутствует админ-панель (управление контентом выполняется через прямое редактирование файлов и FTP), нет встроенной системы комментариев, нет скрипта синхронизации WinSCP, нет Telegram-бота и дополнительных пакетов лендингов.
  - Модель исходного кода: Albireo CMS не является Open Source-системой. Ядро в каталоге `system` зашифровано, закрыто и защищено от модификации или декомпиляции. Открытая часть (каталог `website`, шаблоны) распространяется по лицензии CC BY 4.0 с возможностью кастомизации.
  - Обязательное условие: на каждой странице сайта на Lite-версии должна присутствовать прямая, рабочая и индексируемая обратная ссылка на `https://maxsite.org/albireo`.
  - Региональные лицензионные ограничения: использование системы запрещено на серверах и доменах россии, беларуси, кндр, сирии и эритреи.
  - Рекомендуемые сценарии: тестирование возможностей перед покупкой полной версии, простые сайты-визитки, лендинги, статичные каталоги с корзиной, редко обновляемые ресурсы, базы знаний и обучающая документация.
  - Структура поставки: дистрибутив разделен на две части — открытые файлы шаблонов/контента и закрытый архив системного ядра.
  (Инструкцию по установке и условия загрузки архивов см. на странице)

- [AI и Albireo CMS](https://maxsite.org/albireo/ai)
  **Нативная поддержка стандарта llms.txt, управление индексацией для нейросетей и встроенный банк промптов:**
  - Генерация стандарта `llms.txt`: движок «из коробки» формирует и отдает структурированный файл `/llms.txt` для языковых моделей (LLM, AI-поисковиков и ассистентов), позволяя нейросетям быстро считывать карту контента сайта без визуального HTML-мусора.
  - Тонкое управление через поле `llms`:
    - явное задание индивидуального описания страницы специально для нейросетей в служебном блоке;
    - автоматический фоллбэк при отсутствии поля (`announce` → `description` → `title`);
    - исключение служебных, приватных или нерелевантных страниц из файла через значение `llms: -`.
  - Встроенный каталог промптов (`Prompts`): системный раздел с библиотекой готовых шаблонов запросов для ИИ (создание контент-планов, генерация идей постов, сценарии видео, SEO-тексты, описания для картинок) с функцией копирования в один клик прямо из панели управления.
  - Совместимость с AI-ассистентами при разработке: благодаря прозрачной файловой архитектуре, отсутствию перегруженных абстракций и семантичным классам Berry CSS, код Albireo CMS легко генерируется и дорабатывается современными моделями (ChatGPT, Claude, Cursor) без риска галлюцинаций.
  (Инструкции по настройке генератора llms.txt, параметры полей и список категорий промптов см. на странице)

- [Возможности Albireo CMS](https://maxsite.org/albireo/features)
  **Архитектурные принципы, возможности и устройство Albireo CMS:**
  - Формат данных (Flat-File): страницы и конфигурация хранятся в обычных файлах, а не в MySQL. Конфигурационные поля задаются в начале файла (аналог Front Matter в PHP-комментарии).
  - Свобода PHP и парсеры: страницы представляют собой исполняемые PHP-файлы. Поддерживается встроенный быстрый парсер TextSimple (расширенный аналог Markdown с поддержкой CSS-классов), стандартный Markdown, произвольный HTML/CSS/JS и динамический PHP-код.
  - Масштабируемость без статического кэша: авторский алгоритм работы с файлами держит до 10 000–20 000+ страниц без проседания памяти и процессора. Статический HTML-кэш не используется — все страницы всегда на 100% динамические.
  - Роль SQLite: встраиваемая база используется исключительно «под капотом» для внутренних задач и динамики (комментарии, логирование, внутренняя статистика, голосования), но не для хранения самих страниц.
  - Отказ от концепции плагинов: плагины исключены ради безопасности и производительности. Необходимый код, сторонние классы (PSR-4, Composer) и пользовательские функции подключаются напрямую по месту назначения.
  - Нулевая инсталляция и бэкапы: нет мастера установки и первичной настройки базы данных. Система готова к работе сразу после копирования файлов на сервер; бэкап сводится к архивации каталогов.
  - Изоляция страниц: каждая страница автономна — через поля записи ей можно назначить собственный шаблон, цветовую тему, модульную сетку (10+ вариантов) или отключить общее оформление (превратить в отдельный лендинг).
  - Стек оформления: базовый утилитарный фреймворк Berry CSS (22+ цветовые темы, автопереключение Dark Mode) и реактивная JS-библиотека AlpineJS.
  - Автономия контента: контент можно создавать в любых внешних редакторах (например, в Obsidian) и загружать через админ-панель или синхронизировать по sFTP/WinSCP без участия админки.
  - Комплектация «из коробки»: встроенная SEO-разметка, Open Graph, генераторы sitemap.xml и llms.txt, RSS записей и комментариев, мультиязычность, мультисайтинг, контактные формы, корзина покупателя и GDPR-совместимая статистика без сбора персональных данных.
  - Комплексная безопасность: запрет прямого исполнения системных файлов, токены CSRF с контролем источников и таймстемпов, защита от brute force и частых отправок, ловушки для ботов, фильтрация XSS и стоп-слова.
  (Подробное описание параметров полей и функций — см. на соответствующих страницах документации)

- [Получить Albireo CMS](https://maxsite.org/albireo/get)
  **Варианты поставки системы, различия между Lite и полной версией, а также условия лицензирования:**
  - Форматы поставки: бесплатная Lite-версия и платная полная версия (лицензия на 1 год для одного домена с возможностью продления).
  - Что входит только в полную версию: встроенная админ-панель (в Lite-версии её нет), встроенная система комментариев, дополнительные модули лендингов (33 шт./97 страниц), расширенные tpl-модули вывода записей, дополнительные виджеты, готовый скрипт FTP-синхронизации через WinSCP, Telegram-бот для сайта, расширенная техподдержка и приоритетные обновления.
  - Возможности, общие для Lite и полной версий: базовый движок, рубрики, метки, система пользователей, мультиязычность, Berry CSS, Alpine.js, 10+ модульных сеток, генерация Sitemap/RSS/llms.txt, WebP, контактные формы, голосования, zip-бэкапы, заметки (shorts, notes), промпты для AI и базовые виджеты.
  - Привязка лицензии: полная версия жестко привязывается к указанному домену (по значению HTTP_HOST) с поддержкой всех его поддоменов и подкаталогов; смена домена после покупки не предусмотрена. Для локальной разработки бесплатно выдаются ключи для albireo.loc и localhost:8000.
  - Контроль легальности: наличие публичного механизма валидации законности копии (знак «Legal copy of Albireo CMS»).
  (Точные тарифы, реквизиты и процедуру заказа см. на странице)

- [Перенос данных с MaxSite CMS](https://maxsite.org/albireo/maxsite)
  **Методология и автоматизация миграции контента из базы MySQL (MaxSite CMS) в файлы Albireo CMS:**
  - Автоматизированный экспорт (`albireo-ex`): специальный скрипт для MaxSite CMS автоматически выгружает записи в плоские текстовые PHP-файлы с разбивкой по годам, выносит статичные страницы в папку `static`, помечает черновики префиксом `draft-` и заменяет адреса ссылок на системные переменные.
  - Конвертация медиа и комментариев: скрипт миграции на лету преобразует графику в формат WebP и конвертирует комментарии прямо в единый файл SQLite (`comments.sqlite`) формата Albireo CMS.
  - Размещение данных: выгруженные страницы копируются в `website/pages`, изображения — в `website/uploads`, а база комментариев — в `website/service/storage`.
  - Оптимизация больших объемов (5000+ страниц): для снижения нагрузки на диск при первом построении кэша папки со старыми записями помечаются режимом `frozen` либо выносятся в отдельный архивный подсайт средствами встроенного мультисайтинга.
  - Адаптация верстки и шаблонов: при использовании Berry CSS и AlpineJS классы оформления совпадают; базовые блоки и модульные сетки Albireo CMS основаны на компонентах шаблона MF; модификация оформления выполняется точечно через каталоги переопределений `my/` без правки исходников.
  - Упрощение логики главной страницы: вывод блоков и записей на главной настраивается прямо в `home.php` или `modules/home` через параметры выборок, без разрозненных файлов юнитов и плагинов.
  (Инструкцию по настройке скрипта albireo-ex и переносу дизайна см. на странице)

- [Установка Albireo CMS](https://maxsite.org/albireo/install)
  **Системные требования, процесс «нулевой» установки, запуск на локальном сервере и базовая настройка:**
  - Системные требования: веб-сервер с PHP 8.3–8.5, SQLite 3.38+ (рекомендуется 3.48+), поддержка Phar, pdo_sqlite, mbstring, openssl, gd. Предусмотрен встроенный скрипт проверки совместимости сервера перед установкой.
  - Принцип «нулевой» установки: инсталлятор и мастер настройки базы отсутствуют. Достаточно распаковать архивы на хостинг и открыть в браузере адрес с явным указанием корневого файла запуска.
  - Базовая структура: каталог системного неизменяемого ядра `system` (с файлом лицензии в полной версии), каталог `templates` (шаблоны и ресурсы), рабочий каталог контента `website` и входной файл `index.php`.
  - Автоматическая инициализация: при первом запуске система автоматически генерирует файлы `.htaccess` (для ЧПУ на Apache) и `robots.txt`, если они отсутствуют на сервере.
  - Встроенный PHP-сервер: поддерживается локальный запуск стандартной командой CLI; для корректной отдачи системных XML-файлов (Sitemap, RSS) используется вспомогательный файл роутинга.
  - Мультисайтинг («подсайты»): создание изолированных разделов или отдельных сайтов в подпапках выполняется простым копированием рабочего каталога `website` (с общим ядром и шаблонами).
  - Тонкости настройки: возможность переименования рабочего каталога `website` через константу в точке входа; рекомендации по строгому 301-редиректу на HTTPS во избежание разделения URL-адресов динамических данных; возможность уменьшения дистрибутива до 1–5 Мб удалением демо-данных.
  (Тестовый скрипт проверки сервера, параметры .htaccess и команды запуска см. на странице)

- [Размещение видео с YouTube](https://maxsite.org/albireo/build-website/video-youtube)
  **Методы адаптивного встраивания видеороликов YouTube, сохранение пропорций 16:9 и оптимизация скорости загрузки:**
  - Проблема стандартного фрейма: прямой код вставки YouTube (`iframe`) имеет фиксированные размеры в пикселях и ломает верстку на мобильных экранах.
  - Пропорциональные контейнеры Berry CSS: фрейм оборачивается в адаптивный контейнер с утилитарным классом соотношения сторон (16:9), который автоматически растягивает видео на 100% ширины родительского блока с сохранением корректной высоты.
  - Интеграция с TextSimple: создание адаптивной обертки для плеера доступно прямо в тексте статьи через короткий блочный синтаксис парсера.
  - Отложенная загрузка (фасад): поддержка механизма подмены тяжелого плеера легковесной статической обложкой с кнопкой воспроизведения, что исключает загрузку скриптов Google до явного клика пользователя и ускоряет рендеринг страницы.
  - Просмотр во всплывающем окне: возможность выноса видео в модальный плеер через встроенный лайтбокс FSLightbox с помощью кликабельной ссылки на ролик.
  (Утилитарные классы соотношения сторон, синтаксис оберток в TextSimple и примеры атрибутов плеера см. на странице)

- [Создание лендингов](https://maxsite.org/albireo/build-website/landing)
  **Методология превращения любой страницы в изолированный лендинг, конфигурация полей и готовые посадочные шаблоны:**
  - Принцип изолированности: любая страница сайта может стать автономным посадочным лендингом без привязки к глобальному шаблону блога за счет управления служебными метаданными.
  - Настройка через поля записи:
    - подключение специализированных сеток `layout: landing.php`, `clean.php` или `empty.php`;
    - полное отключение стандартных сквозных элементов сайта: `header: -`, `footer: -`, `sidebar: -` и `comments: -`;
    - исключение лендинга из общих лент записей, архивов и RSS через статус `type: system`.
  - Изолированные стили и скрипты: возможность подключения индивидуальных библиотек (слайдеров, анимаций AOS), специфических шрифтов и таблиц стилей строго для одного лендинга через массивы полей `css.head.url[]` и `js.lazy.url[]` без утяжеления остальных разделов ресурса.
  - Пакет готовых решений: полная версия Albireo CMS включает коллекцию из 33 готовых адаптивных лендингов (суммарно 97 страниц), сверстанных на классах Berry CSS и реактивных компонентах Alpine.js.
  - Сборка секций и лидогенерация: лендинг может строиться из модульных блоков (первый экран, преимущества, тарифные сетки, FAQ-спойлеры, отзывы) с бесшовной интеграцией асинхронных AJAX-форм обратной связи и корзины товаров.
  (Перечень готовых шаблонов лендингов, конфигурацию полей изоляции и примеры верстки секций см. на странице)

- [Создание своего сайта](https://maxsite.org/albireo/build-website/build-website)
  **Методология разработки сайта, сценарии применения, философия блогинга, требования к навыкам и роль Berry CSS:**
  - Базовые сценарии: система закрывает задачи одиночных посадочных страниц (лендингов), персональных блогов с навигацией и автономных баз знаний/документации (для сложной коммерции с автооплатой автор рекомендует специализированные сервисы).
  - Управление контентом: работа строится на уровне обычных файлов — редактировать страницы можно как через веб-админку, так и напрямую в локальных редакторах с последующей отправкой по FTP.
  - Философия удобного блогинга:
    - разметка TextSimple с поддержкой HTML;
    - нулевые искусственные ограничения — возможность писать произвольный PHP, HTML и JS прямо в контенте;
    - независимость структуры файлов от адресации (URL регулируется полем `slug`);
    - персональный закрытый блок заметок и TODO-списков автора (`Shorts`);
    - автоконвертация входящей графики в формат WebP;
    - декларативное подключение галерей, иконок и лайтбоксов через поля страниц («вкл/выкл»).
  - Требования к квалификации: CMS ориентирована на пользователей, понимающих базовую работу с файловой системой и кодом (движок не подходит тем, кто не отличает регистр файлов или не готов разбираться в разметке по примерам).
  - Стек верстки Berry CSS: ключевой атомарный CSS-фреймворк на CSS-переменных (эволюция с 2014 года); существенно легче Tailwind CSS, позволяет оформлять тексты и сетки готовыми утилитарными классами без ручного написания CSS-кода.
  - Свобода для программистов: открытая архитектура для подключения Composer, PSR-4 библиотек и пользовательских PHP-функций без ограничений, присущих классическим CMS.
  (Советы по выбору модульных сеток, классификацию пользователей и контакты поддержки см. на странице)

- [Создание API на Albireo CMS](https://maxsite.org/albireo/build-website/create-api)
  **Реализация серверных API-эндпоинтов, отдача данных в формате JSON, безопасность и Headless-сценарии:**
  - Концепция эндпоинта: любой файл страницы Albireo CMS может выступать в роли API-точки входа за счет отключения визуальных компонентов оформления и парсеров.
  - Служебные поля API-страницы:
    - `layout: empty.php` — отключает модульную сетку, гарантируя отсутствие внешнего HTML-каркаса;
    - `parser: -` — выключает парсеры контента для предотвращения оборачивания данных в теги параграфов;
    - `compress: -` — отключает минификацию и сжатие вывода;
    - `type: system` и `sitemap: -` — полностью исключают эндпоинт из списков записей, лент и поисковых карт.
  - Формирование ответа: отправка заголовков `Content-Type: application/json`, обработка входящих параметров (`GET`, `POST` или сырого потока JSON) и сериализация данных через стандартные функции с сохранением Юникода.
  - Модель безопасности API: авторизация запросов по секретным токенам или API-ключам (в заголовках запроса или параметрах), проверка разрешенных IP-адресов, настройка заголовков CORS для взаимодействия с внешними доменами.
  - Сценарии применения: использование Albireo CMS в Headless-режиме, интеграция с мобильными приложениями, внешними вебхуками, дашбордами и Telegram-ботами.
  (Примеры конфигурации полей, шаблоны отдачи JSON и способы проверки токенов см. на странице)

- [Grid Gallery](https://maxsite.org/albireo/build-website/grid-gallery)
  **Модуль адаптивной фотогалереи на чистом CSS Grid, интеграция с лайтбоксами и управление через парсер:**
  - Архитектура и стек: легковесная галерея построена на чистом CSS Grid без использования сторонних скриптов для раскладки; автоматически подстраивает количество колонок под ширину экрана устройства.
  - Декларативное подключение: активируется точечно для текущей записи через служебное поле `use.grid-gallery: +`.
  - Связка с лайтбоксами: без швов интегрируется со встроенными библиотеками GLightbox или Fullscreen Lightbox, превращая миниатюры в интерактивные всплывающие галереи при клике.
  - Оформление в тексте: галерея формируется оборачиванием картинок в контейнер с классом `grid-gallery` (в HTML или через синтаксис блоков парсера TextSimple).
  - Гибкость стилизации: пропорции миниатюр, отступы между ячейками и микроэффекты увеличения при наведении (hover) регулируются стандартными утилитарными классами Berry CSS.
  (Синтаксис блоков в TextSimple, классы сетки и примеры связки с лайтбоксами см. на странице)

- [Google-поиск](https://maxsite.org/albireo/build-website/google-search)
  **Интеграция стороннего поиска по сайту через Программируемую поисковую систему Google (CSE):**
  - Причина использования: встроенный полнотекстовый поиск в движке отсутствует, поэтому организация поиска по контенту делегируется сервису Google Programmable Search Engine без нагрузки на хостинг.
  - Создание служебной страницы: поиск размещается в отдельном файле (например, `search.php`), которому назначается служебный тип `type: system` и метатег `head-meta[robots]: noindex` для исключения самой поисковой страницы из индексации поисковиками.
  - Настройка в сервисе Google: в панели управления создается поисковая система с ограничением области поиска адресом своего домена, где в настройках отображения рекомендуется выбирать макет «Широкий» для бесшовной адаптации под сетку сайта.
  - Подключение виджета: на странице поиска размещается асинхронный скрипт с индивидуальным идентификатором (`cx`) и стандартный контейнер отображения результатов Google.
  (Шаблон служебного файла страницы поиска и параметры интеграции скрипта см. на странице)

- [Табы](https://maxsite.org/albireo/build-website/tabs)
  **Интерактивные переключаемые вкладки на базе Alpine.js, стилизация классами Berry CSS и адаптивность:**
  - Архитектура и стек: компонент табов функционирует на базе реактивных директив встроенного Alpine.js; не требует подключения внешних плагинов или тяжелых UI-фреймворков.
  - Принцип работы: переключение панелей контента строится на отслеживании состояния активной вкладки, динамическом назначении активных стилевых классов кнопкам и показе соответствующего содержимого с поддержкой плавных переходов.
  - Верстка и оформление: внешний вид переключателей (линейные табы, плашки-пиллы, рамки, отступы и цвета активного элемента) стилизуется утилитарными классами Berry CSS с автоматической адаптацией под мобильные экраны.
  - Интеграция с парсером: структуру табов можно оформлять как на чистом HTML, так и через компактные блочные обертки авторского парсера TextSimple.
  - Произвольный контент: внутри каждой вкладки разрешено размещать любые элементы — текст, формы, медиагалереи, кнопки покупки или вызовы других сниппетов.
  (Примеры реактивной разметки на Alpine.js и классы оформления табов см. на странице)

- [Слайдер контента](https://maxsite.org/albireo/build-website/content-slider)
  **Пошаговый показ произвольных блоков контента на Alpine.js, управление через сниппет и анимация переходов:**
  - Назначение и стек: инструмент предназначен для поочередного вывода блоков контента (текста, графики, верстки); написан на базе встроенного Alpine.js и не требует подключения внешних библиотек или дополнительных JS-файлов.
  - Навигация: поддерживает переключение слайдов кнопками интерфейса и стандартными стрелками клавиатуры (`←` и `→`).
  - Механизм подключения через сниппет: слайдер оформляется как обертка из двух вызовов системного сниппета `slides` с ключевыми словами `start` (открывающий блок) и `end` (закрывающий блок навигации).
  - Разметка слайдов: каждый отдельный слайд представляет собой обычный блок `<div>` с произвольным содержимым, помещенный между частями сниппета; для плавности смены слайдов блокам назначаются утилитарные классы анимаций (например, `animation-fade`).
  - Стилизация и аргументы: при вызове стартовой и финальной частей сниппета можно передавать дополнительные CSS-классы оформления (отступы, фон, рамки, скругления).
  - Кастомизация логики: логика слайдера полностью открыта — для изменения поведения файл сниппета `slides.php` копируется в пользовательский каталог `website/service/snippets/` для безопасной модификации.
  (Синтаксис вызова сниппета slides, параметры CSS-классов и структуру разметки см. на странице)

- [Слайдер Tiny Slider](https://maxsite.org/albireo/build-website/tini-slider)
  **Интеграция легковесного слайдера Tiny-Slider, автономная поставка ресурсов и конфигурация каруселей:**
  - Назначение и стек: Tiny-Slider — альтернативный сверхкомпактный слайдер на чистом JavaScript без зависимостей, оптимизированный для создания быстрых адаптивных каруселей, отзывов и фотолент.
  - Включение в комплект: библиотеки стилей и скриптов уже предустановлены в системном каталоге ресурсов движка.
  - Декларативное подключение: активируется точечно для текущей записи через служебное поле страницы `use.tiny-slider: +`, подключая необходимые ассеты только там, где размещен слайдер.
  - Разметка и адаптивность: блоки слайдов верстаются обычными контейнерами в HTML или через блочные обертки TextSimple; поддерживается настройка адаптивных брейкпоинтов для разного количества отображаемых элементов на мобильных и десктопных экранах.
  - Настройка поведения: параметры автовоспроизведения, навигационных стрелок, точек пагинации, зацикливания и скорости перелистывания передаются стандартной функцией инициализации в секции отложенных скриптов.
  (Параметры служебного поля, синтаксис инициализации tns и примеры верстки слайдов см. на странице)

- [Анимация элементов](https://maxsite.org/albireo/build-website/animations)
  **Способы анимации контента: классы Berry CSS, запуск по событиям, библиотеки Animate.css и Wow.js, а также переходы в Alpine.js:**
  - Встроенные CSS-классы фреймворка Berry CSS: простая анимация элементов добавлением утилитарных классов появления, затухания, сдвигов по сторонам, зума, вращения и пульсации (`animation-fade`, `animation-zoom`, `animation-left`, `animation-bounce`, `animation-spin` и др.) напрямую через разметку или TextSimple.
  - Анимация по JS-событиям: запуск CSS-эффектов по клику или иным событиям на элементе через встроенный метод `this.animate(...)`.
  - Интеграция Animate.css: быстрое подключение библиотеки через служебное поле страницы `use.animate: +`, открывающее доступ ко всем стандартным классам анимаций, задержек и повторов библиотеки (`animate__animated`).
  - Анимация по скроллу через Wow.js: подключение библиотеки для отслеживания появления элементов при прокрутке экрана (часто на лендингах) через поле страницы `use.wow: +` и назначение класса `wow` в связке с классами анимации; для устранения эффекта мигания до инициализации используется скрытие через поле инлайн-стилей `css.style[]: .wow {visibility: hidden;}`.
  - Реактивные переходы на Alpine.js: управление плавным появлением и скрытием интерактивных блоков (закрытие плашек, иконки) с помощью директивы `x-transition` и параметров длительности.
  (Перечень классов Berry CSS, параметры подключения use.animate/use.wow и примеры разметки см. на странице)

- [Пример лендинга](https://maxsite.org/albireo/build-website/landing-sample)
  Описание лендинга

- [Иконки IM](https://maxsite.org/albireo/build-website/font-im)
  **Легковесный встроенный иконочный шрифт mfont, быстрое подключение и набор глифов:**
  - Назначение и происхождение: специализированный оптимизированный шрифт `mfont` (222 иконки), созданный на базе символов FontAwesome 5; отличается минимальным размером файла и практически мгновенной загрузкой.
  - Декларативное подключение: активируется для текущей страницы указанием служебного поля `use.imfont: +`.
  - Синтаксис использования: иконки выводятся через CSS-классы с префиксом `im-` (навигация, социальные сети, элементы интерфейса, стрелки, действия) в разметке HTML или через парсер TextSimple.
  (Полный визуальный каталог из 222 иконок и имена соответствующих CSS-классов см. на странице)

- [Эффекты CSSgram](https://maxsite.org/albireo/build-website/css-gram)
  **Подключение библиотеки фильтров CSSgram, стилизация изображений и управление эффектами при наведении:**
  - Назначение библиотеки: интеграция готовых CSS-фильтров (аналогов эффектов Instagram) для визуальной обработки фотографий без редактирования исходных графических файлов.
  - Декларативное подключение: библиотека активируется точечно для текущей записи через служебное поле `use.cssgram: +`.
  - Применение эффектов: стилевые классы библиотеки (например, `moon` и др.) назначаются непосредственно целевым изображениям через HTML-атрибуты или разметку парсера TextSimple.
  - Интерактивное поведение: поддержка вспомогательного класса `hover-no-filter`, который автоматически отменяет наложенный фильтр при наведении курсора мыши на картинку.
  (Перечень доступных классов фильтров CSSgram и примеры разметки картинок см. на странице)

- [Слайдер Swiper](https://maxsite.org/albireo/build-website/swiper-slider)
  **Интеграция сенсорного слайдера Swiper, пакетная поставка скриптов и управление параметрами:**
  - Наличие в комплекте: полнофункциональный слайдер Swiper уже включен в дистрибутив Albireo CMS.
  - Декларативное подключение: активируется для текущей страницы указанием служебного поля `use.swiper: +`, которое автоматически подгружает все необходимые стили и скрипты библиотеки.
  - Структура разметки: слайды формируются стандартными контейнерами библиотеки (обертка, трек и элементы слайдов), которые можно верстать как на чистом HTML, так и через блочные обертки парсера TextSimple.
  - Элементы управления: поддерживается добавление стрелок перелистывания «вперед/назад», пагинационных точек (буллетов) и полосы прокрутки.
  - Инициализация и настройка: поведение слайдера (автопрокрутка, зацикливание, адаптивное количество слайдов на экран, отступы и скорость) конфигурируется стандартными параметрами инициализации объекта Swiper в отложенной секции скриптов.
  (Синтаксис HTML/TextSimple-разметки слайдов и параметры конфигурации скрипта инициализации см. на странице)

- [Лайтбоксы](https://maxsite.org/albireo/build-website/fslightbox)
  **Два встроенных решения для всплывающего просмотра медиа: GLightbox и Fullscreen Lightbox:**
  - Набор инструментов: в комплект поставки входят две независимые библиотеки для модального открытия изображений и видеоконтента без сторонних надстроек.
  - GLightbox (решение по умолчанию): подключается через служебное поле страницы `use.glightbox: +`; интегрируется с парсером TextSimple через спецсимволы разметки картинок (`!!`) или назначение CSS-класса `glightbox`.
  - Fullscreen Lightbox (fslightbox): подключается через поле `use.fslightbox: +`; активируется добавлением атрибута `data-fslightbox` к ссылкам или разметке TextSimple.
  - Поддержка мультимедиа и галерей: fslightbox умеет воспроизводить не только статичные изображения, но и ролики с YouTube и прямое HTML5-видео, а также объединять элементы в листаемые серии через имя галереи в атрибуте.
  (Синтаксис вызова в TextSimple, параметры атрибутов галерей и HTML-разметку ссылок см. на странице)

- [Примеры шрифтов](https://maxsite.org/albireo/build-website/fonts)
  **Набор из 22 предустановленных шрифтов в комплекте поставки, их активация и подключение сторонней типографики:**
  - Встроенный шрифт-пакет: система поставляется с готовой коллекцией из 22 качественных веб-шрифтов с поддержкой кириллицы (Alegreya, Alegreya Sans, Arimo, Bad Script, Caveat, Exo 2, Fira Sans, Gabriela, IBM Plex Sans, Lora, Marck Script, Montserrat, Neucha, Noto Sans, Open Sans, Oswald, Pacifico, PT Sans, Roboto, Roboto Slab, Source Sans Pro, Ubuntu).
  - Подключение из комплекта: любой встроенный шрифт активируется точечно для текущей записи через служебное поле `use.font[имя]: +`, а для назначения шрифта всему документу или отдельным блокам используются CSS-переменная `css.root` и стилевые классы (например, `t-шрифт`).
  - Подключение сторонних шрифтов: при необходимости использовать любые другие шрифты (Google Fonts или собственные файлы woff2) их можно подключить стандартными полями записи `css.head.url[]` или прямыми директивами `@font-face` в `css.head[]`.
  (Спецификацию имен шрифтов для полей use.font и стилевые классы семейств см. на странице)

- [Создание телеграм-бота](https://maxsite.org/albireo/build-website/telegram-bot)
  **Интеграция с Telegram Bot API, мгновенные уведомления о событиях сайта и двустороннее взаимодействие:**
  - Доступность: компонент входит в комплект полной версии Albireo CMS и работает без сторонних тяжелых библиотек через прямые системные запросы к Telegram Bot API.
  - Настройка и параметры: для работы требуется получение токена бота у @BotFather и идентификатора чата администратора; параметры задаются в конфигурации сайта.
  - Автоматические триггеры уведомлений:
    - новые комментарии (сообщение содержит имя автора, текст комментария, ссылку на публикацию и статус);
    - входящие сообщения из контактных форм сайта;
    - новые заказы из корзины интернет-магазина (список выбранных товаров, сумма, имя и контакты клиента);
    - критические системные события и уведомления безопасности.
  - Программная отправка сообщений: движок предоставляет готовую функцию отправки произвольных сообщений с поддержкой HTML-разметки текста прямо из любых PHP-файлов, сниппетов или обработчиков страниц.
  - Обработка входящих команд (вебхуки): возможность организации страницы-вебхука для приема команд от пользователей в Telegram и отправки ответных данных с сайта.
  (Инструкции по настройке вебхука, сигнатуру функции отправки сообщений и формат конфигурации см. на странице)

- [Шаблоны в Albireo CMS](https://maxsite.org/albireo/templates/template)
  **Концепция шаблонизации, архитектура готового шаблона Default, файловая структура и механизм безопасных переопределений:**
  - Философия и управление на уровне страницы: шаблон не навязывает жестких ограничений — страница сама решает, как ей выводиться, выбирая собственный шаблон, модульную сетку (`layout`), блоки шапки, подвала, виджеты и стили. Каждая страница сайта может иметь уникальный дизайн.
  - Базовый стек: по умолчанию используется готовый шаблон `Default`, утилитарный фреймворк Berry CSS (сборка верстки через семантичные CSS-классы) и реактивный Alpine.js. Сторонние библиотеки (шрифты, JS/CSS) размещаются в общем каталоге `templates/_resources/` и подключаются через простые PHP-коннекторы.
  - Анатомия каталога шаблона:
    - `layout/` — обязательные модульные сетки, внутрь которых подключается страница;
    - `modules/` — независимые компоненты шапок (`headers`), подвалов (`footers`) и главной страницы (`home`), переключаемые полями записи;
    - `parts/` — точки внедрения кода в модульную сетку (`parts/head` в секцию HEAD, `parts/content-start` до контента, `parts/content` после контента, `parts/lazy` перед закрывающим тегом BODY);
    - `extras/` — вспомогательные блоки и плашки, вызываемые функцией `extras()` через встроенный TPL-шаблонизатор;
    - `tpl/` — шаблоны вывода списков записей, пагинации и комментариев;
    - `snippets/` — оформленные сниппеты (например, навигация по заголовкам);
    - `assets/` — локальные CSS, SASS, JS и графика.
  - Высокая модульность: компоненты шаблона изолированы друг от друга — изменение или расширение функционала затрагивает только один конкретный файл.
  - Безопасное переопределение (`website/service/my`): механизм «зеркальной» папки позволяет изменять любые файлы базового шаблона (шапки, подвалы, части разметки) без их прямой правки. Если файл скопирован в `service/my/`, движок автоматически отдает приоритет пользовательской версии, гарантируя чистоту обновлений.
  (Подробное описание директорий шаблона и параметров полей подключения стилей/скриптов см. на странице)

- [Сайдбары и виджеты в Albireo CMS](https://maxsite.org/albireo/templates/sidebar)
  **Архитектура боковой панели, устройство и подключение виджетов, переопределение на уровне страниц:**
  - Концепция сайдбара: сайдбар не является замкнутой подсистемой CMS, а подключается как модульный компонент внутри соответствующих сеток верстки (`sidebar.php`, `sidebar-left.php`, `sidebar-float.php` и др.).
  - Расположение и переопределение: стандартный файл боковой колонки находится в `layout/parts/_sidebar.php`; для безопасной модификации он копируется в зеркальный каталог переопределений `website/service/my/layout/parts/_sidebar.php`.
  - Управление через поля страницы: поле `sidebar` позволяет подключить альтернативный файл сайдбара для конкретной записи либо полностью отключить боковую колонку значениями `0`, `-` или `false`.
  - Архитектура виджетов: виджеты представляют собой компактные, изолированные PHP/HTML-файлы в каталоге `modules/widgets/` (или `service/my/modules/widgets/`), не требующие регистрации через сложные классы или интерфейсы.
  - Библиотека встроенных виджетов: готовые модули облака меток, списка рубрик, последних публикаций, свежих комментариев, формы поиска, карточки автора и блоков подписки.
  - Условный вывод и гибкость: порядок вывода виджетов, их видимость и параметры настраиваются напрямую в коде сайдбара через простые PHP-условия или с опорой на служебные метаданные текущей записи.
  (Перечень стандартных сеток с сайдбаром, доступные виджеты и примеры сборки боковой панели см. на странице)

- [Создание шаблона Albireo CMS](https://maxsite.org/albireo/templates/custom-template)
  **Подходы к разработке и кастомизации оформления, расширение шаблона Default и переключение пользовательских каталогов:**
  - Два подхода к оформлению: создание независимой копии шаблона Default под новым именем либо расширение возможностей стандартного Default (рекомендуемый путь, так как базовый шаблон уже решает большинство задач).
  - Обязательные требования: модуль сетки (`layout`) является критически необходимым для функционирования движка; при смене стилей необходимо учитывать, что стандартные компоненты спроектированы под Berry CSS и Alpine.js.
  - Способы расширения шаблона Default:
    - *Новые файлы внутри шаблона*: добавление файлов с уникальными префиксами (например, `my-header.php`), чтобы избежать конфликтов и перезаписи при системных обновлениях движка;
    - *Стандартный каталог переопределений (`website/service/my`)*: зеркальное повторение структуры шаблона, позволяющее «бесшовно» подменять стандартные компоненты (шапки, подвалы, сетки) без необходимости менять имена файлов в полях страниц;
    - *Именованные my-каталоги*: переключение наборов модификаций через конфигурационную опцию `serviceMyDir` в `config.php` (например, для быстрой смены кастомных тем оформления на базе одного шаблона).
  - Гибкость путей и констант: подключение файлов шаблонизатора (TPL) не привязано жестко к одной папке и может производиться из любых каталогов; системные константы путей к компонентам можно переопределять до загрузки ядра.
  - Модель распространения тем: пользовательские модификации можно распространять в виде независимых архивов `my`-папок, дополняя их файлом настроек `page-data` для удобного назначения полей пользователями.
  (Инструкцию по конфигурации serviceMyDir и правила переопределения системных констант см. на странице)

- [Extras-файлы в Albireo CMS](https://maxsite.org/albireo/templates/extras)
  **Механизм вывода контекстных TPL-блоков для текущей страницы, декларативное подключение и автоматическая передача метаданных:**
  - Назначение и концепция: extras-файлы представляют собой TPL-шаблоны, ориентированные на работу исключительно в контексте текущей записи, что позволяет упростить верстку блоков со сложными условиями отображения (заголовки, мета-информация статьи, навигационные плашки).
  - Расположение и переопределения: стандартные файлы размещаются в каталоге шаблона `extras/`, а пользовательские версии — в каталоге приоритетных переопределений `website/service/my/extras/`.
  - Автоматическая передача данных: внутри extras-файла автоматически доступны абсолютно все поля текущей страницы в виде стандартных переменных шаблонизатора (с поддержкой условий `{@isset}`, `{@empty}`, языковых меток и вывода значений через `{{ $переменная }}`).
  - Способы вызова:
    - программный вызов через системную функцию `extras('имя_файла.php')` в коде шаблона или разметки;
    - декларативное подключение через поля страницы — массив `extras.start[файл]: +` для автоматического вывода блока перед текстом статьи и `extras.end[файл]: +` для вывода сразу после основного контента.
  (Синтаксис условий шаблонизатора, готовые примеры info-файлов и параметры подключения см. на странице)

- [Шапка и подвал в Albireo CMS](https://maxsite.org/albireo/templates/headers-and-footers)
  **Модульная архитектура шапок и подвалов, переключение компонентов через поля страницы и кастомизация без правки исходников:**
  - Изоляция компонентов: шапки (`headers`) и подвалы (`footers`) вынесены в самостоятельные модули внутри каталога шаблона `modules/`, что отделяет их верстку от каркаса модульных сеток (`layout`).
  - Управление на уровне страницы: выбор конкретного варианта шапки или подвала задается в служебных полях записи `header` и `footer` (например, `header: header1.php`). Значения `0`, `-` или `false` полностью отключают вывод блока (удобно для автономных посадочных страниц и промо-материалов).
  - Готовый набор решений: в комплект системы входит 15+ вариантов шапок (с верхними панелями, поиском, соцсетями, липким позиционированием, центрированным меню и мобильной адаптацией) и 7+ вариантов подвалов (от минималистичного копирайта до многоколоночных компоновок).
  - Передача параметров через поля: модули шапок и подвалов могут считывать специфические данные прямо из метаданных текущей страницы (например, кастомный заголовок, показ дополнительных кнопок или переопределение меню).
  - Приоритет пользовательских переопределений: для изменения стандартной шапки/подвала файл копируется в каталог `website/service/my/modules/`, где он автоматически замещает базовый файл шаблона, сохраняя пользовательские правки при системных обновлениях.
  (Каталог готовых вариантов оформления и правила передачи параметров в модули см. на странице)

- [Модульная сетка в шаблоне Albireo CMS](https://maxsite.org/albireo/templates/layout)
  **Архитектура модульных сеток (layout), механизм передачи управления от ядра к странице и правила верстки:**
  - Принцип работы и отличие от других CMS: система заранее не компилирует данные страницы; ядро лишь считывает служебные поля, определяет целевой файл и передает управление в layout-файл, который сам подключает контент через обычный `require`.
  - Выбор и приоритет сеток: активная сетка задается в поле записи `layout` (по умолчанию `default.php`). Движок сначала ищет сетку в переопределениях `service/my/layout` и только затем в каталоге шаблона `templates/default/layout`.
  - Встроенный набор сеток: стандартная без сайдбаров (`default.php`), с правым/левым/фиксированным сайдбаром, во всю ширину экрана (`full-width.php`), для лендингов без шапки и подвала (`landing.php`), минималистичные (`clean.php`), сетки документации (`doc1.php`, `doc2.php`) и пустая (`empty.php`), состоящая только из подключения файла страницы.
  - Структурное деление сетки: для исключения дублирования типовой layout разбит на служебные секции — `_start.php` (HEAD, открытие BODY), `_content.php` (контейнер со страницей) и `_end.php` (подвал, скрипты, закрытие тегов). Пользовательские сетки могут повторно использовать эти секции через системную константу пути.
  - Идеология верстки каркаса: блоки шапки, контента и подвала обязательно верстаются каждый в своем независимом контейнере, а не оборачиваются в один общий глобальный `<div>`.
  - Управление тегами документа через поля: прямое внедрение кода и метатегов в секцию HEAD через массивы `head[]`, `head-meta[]`, `head-lang[]`, добавление классов и атрибутов к тегу BODY через поле `body`, а также вывод отложенных ресурсов перед закрытием BODY через `lazy[]`.
  (Список стандартных сеток, структура файлов layout и правила переопределения через my-каталог см. на странице)

- [TPL-шаблонизатор в Albireo CMS](https://maxsite.org/albireo/templates/tpl-template)
  **Архитектура легковесного шаблонизатора TPL, разделение логики и представления, вывод коллекций данных:**
  - Назначение и концепция: TPL — это компактный встроенный механизм шаблонизации на чистом PHP, предназначенный для единообразного рендеринга списков записей, архивных лент, комментариев, пагинации и служебных блоков (`extras`).
  - Разделение обязанностей: механизм полностью отделяет логику выборки данных (например, системную функцию `getPages`) от их визуального представления. Для смены внешнего вида вывода на странице или в модуле достаточно указать другой TPL-файл без изменения кода логики.
  - Размещение и переопределение: стандартные файлы разметки хранятся в каталоге шаблона `tpl/`, а пользовательские варианты и безопасные переопределения — в папке `website/service/my/tpl/`.
  - Принцип обработки данных: функция `tpl` принимает массив структурированных данных и применяет к нему шаблон, поддерживая оформление открывающих/закрывающих блоков списка (`start`, `end`) и итеративную разметку отдельных элементов.
  - Производительность: работает на нативном PHP без промежуточных компиляторов и сложного синтаксического оверхенда (в отличие от Twig или Blade), обеспечивая максимальную скорость генерации и минимальный расход памяти.
  (Сигнатуру функции tpl, поддерживаемые плейсхолдеры и структуру TPL-файлов см. на странице)

- [Сниппеты в Albireo CMS](https://maxsite.org/albireo/templates/snippets)
  **Назначение переиспользуемых сниппетов, механизм передачи параметров и готовая библиотека интерфейсных компонентов:**
  - Концепция и роль: сниппеты представляют собой изолированные фрагменты кода и разметки для повторяющихся визуальных блоков интерфейса, позволяя сохранять тело статей чистым и избегать дублирования разметки.
  - Каталоги размещения и приоритет: стандартные сниппеты располагаются в `templates/<имя_шаблона>/snippets/`; для создания собственных или безопасного изменения базовых используется каталог переопределений `website/service/my/snippets/` (имеет высший приоритет поиска).
  - Вызов и параметризация: сниппет подключается в тексте или шаблоне с помощью системной функции вызова с возможностью передачи произвольного массива аргументов для кастомизации вывода (тексты, классы, параметры отображения).
  - Встроенные готовые сниппеты:
    - оглавление статьи (`article-navigation`) — автоматически сканирует заголовки публикации и строит интерактивное меню навигации;
    - хлебные крошки (`breadcrumbs`) — строит цепочку навигации по структуре разделов и метаданным;
    - кнопки шеринга — легковесные социальные кнопки без использования тяжелых внешних трекинг-скриптов;
    - карточки авторов, блоки цитат и навигационные плашки.
  - Чистота исходного контента: сниппеты отделяют верстку и стилизацию типовых элементов от содержательной части текста, гарантируя единообразие оформления на всем сайте.
  (Сигнатуру функции snippet, перечень стандартных компонентов и параметры вызовов см. на странице)

- [Работа с JavaScript в Albireo CMS](https://maxsite.org/albireo/templates/javascript)
  **Способы подключения скриптов, управление JavaScript через поля страниц, отложенная загрузка и архитектурный стек:**
  - Концепция изоляции: скрипты могут подключаться как глобально в шаблоне, так и точечно на уровне конкретных страниц, предотвращая загрузку неиспользуемого JavaScript на остальных разделах сайта.
  - Динамическое подключение через поля страницы:
    - `js.head.url[]` — подключение внешних или локальных скриптов в секции `<head>`;
    - `js.lazy.url[]` — отложенное подключение скриптов перед закрывающим тегом `</body>`;
    - `js.head[]` — вставка инлайн-кода JavaScript в `<head>`;
    - `js.lazy[]` — вставка инлайн-кода в нижнюю часть документа перед `</body>`.
  - Системные макросы: поддержка плейсхолдеров (`[ TEMPLATE_URL ]`, `[ SERVICE_URL ]`, `[ SITE_URL ]`) и префиксов для формирования корректных путей к скриптам шаблона или пользовательским файлам.
  - Базовый стек: основной инструмент реактивности — легковесная библиотека Alpine.js, работающая без сборщиков (Webpack/Vite) и тяжелого окружения Node.js; сторонние библиотеки (слайдеры, галереи) хранятся в общем каталоге ресурсов `templates/_resources/` и подключаются по требованию.
  - Пользовательские скрипты: кастомные JS-файлы выносятся в каталог переопределений `website/service/my/`, что защищает код от затирания при обновлениях системы.
  (Синтаксис массивов подключения скриптов и параметры атрибутов defer/async см. на странице)

- [Работа с CSS в Albireo CMS](https://maxsite.org/albireo/templates/css)
  **Способы подключения таблиц стилей, управление ресурсами через поля страниц, отложенная загрузка и инлайн-стили:**
  - Концепция подключения: стили могут подключаться как глобально через секции шаблона (`parts/head`), так и точечно на уровне конкретных страниц через служебные метаданные, что предотвращает загрузку лишнего CSS на страницах, где он не используется.
  - Динамическое подключение через поля страницы:
    - `css.head.url[]` — загрузка внешних или локальных CSS-файлов в секции `<head>`;
    - `css.lazy.url[]` — отложенная загрузка тяжелых таблиц стилей перед закрывающим тегом `</body>`;
    - `css.head[]` — вставка критического инлайн-кода стилей в блок `<style>` внутри `<head>`;
    - `css.lazy[]` — вставка инлайн-стилей в нижнюю часть документа (`parts/lazy`).
  - Системные макросы путей: поддержка системных плейсхолдеров (`[ TEMPLATE_URL ]`, `[ SERVICE_URL ]`, `[ SITE_URL ]`) для быстрого указания адресов к файлам стилей шаблона или пользовательского каталога.
  - Стек стилей и темы: по умолчанию используется утилитарный фреймворк Berry CSS с набором готовых цветовых тем (Material Design и палитра RAL) и нативной поддержкой темного режима оформления.
  - Безопасная кастомизация: пользовательские файлы стилей рекомендуется размещать в каталоге переопределений `website/service/my/` и подключать через соответствующие поля, что исключает их перезапись при обновлении базового шаблона.
  (Синтаксис массивов подключения стилей и список готовых цветовых схем см. на странице)

- [Поля страниц в Albireo CMS](https://maxsite.org/albireo/introduction/page-fields)
  **Правила синтаксиса служебных полей, логика булевых значений, маршрутизация и базовые системные параметры:**
  - Синтаксис и форматирование: поля оформляются построчно в виде `ключ: значение`. Обязательно наличие двоеточия с пробелом (`: `) после имени — это позволяет использовать символ `:` внутри названий ключей (например, `meta[og:title]: ...`).
  - Спецсимволы и замены: строка, начинающаяся с `#`, считается комментарием и игнорируется движком; разделитель `///` выполняет перенос строки (`\n`) внутри значения некоторых полей; пробелы по краям автоматически обрезаются, а для их сохранения используется маркер `[ NBSP ]`.
  - Унифицированная булева логика: во всех логических полях значения `0`, `-`, `false` означают отключение, а `1`, `+`, `true`, `вкл` или любой произвольный текст — включение опции.
  - Формирование URL и адресация:
    - если поле `slug` не задано, адрес генерируется автоматически из пути к файлу и его имени (переводится в нижний регистр, пробелы заменяются на дефисы);
    - поле `slug` задает произвольный адрес любой структуры без привязки к расположению файла на диске (поддерживаются эмодзи и точки);
    - поле `slug-pattern` позволяет задавать регулярные выражения и альтернативные адреса для одной страницы (например, языковые префиксы);
    - для защиты от XSS адреса с символами `< > " ' ( {` автоматически вызывают 404-ошибку (настраивается в конфигурации).
  - Сортировка и заморозка файлов:
    - числовые префиксы у файлов и папок (`01.name.php`) задают порядок сортировки, но автоматически вырезаются из итогового slug;
    - префикс `!` в имени файла (`!name.php`) включает режим «frozen» — страница исключается из перестроения внутреннего кэша при сохранении, что оптимизирует производительность на больших сайтах (500+ страниц).
  - Ключевые системные поля:
    - `type` — разграничение записей (`blog` попадает в ленты и архивы, `system` исключается из списков, RSS, sitemap и отключает комментарии);
    - `date`, `date-edit`, `date-pub` — поддержка любых форматов `strtotime()`; поле `date-pub` с будущей датой автоматически удерживает страницу в статусе черновика до наступления срока;
    - `draft` — логический перевод страницы в режим черновика;
    - `comments` и `comments-pub` — раздельное управление разрешением на комментирование и показом уже оставленных отзывов;
    - `stat.page` и `stat-start` — бессерверный GDPR-совместимый учет просмотров в базе SQLite без сбора персональных данных;
    - `compress` и `protect-pre` — сжатие итогового HTML и автоматическое экранирование кода в тегах PRE/CODE;
    - `sitemap` и `rss` — динамическое включение/исключение страниц из поисковой карты и RSS-ленты;
    - `llms` — управление текстом для файла `llms.txt` (с автоматическим фоллбэком: `announce` → `description` → `title` или исключением через `-`).
  (Синтаксис slug-pattern, конфигурационные параметры замены слэшей и примеры см. на странице)

- [Другие страницы в комплекте Albireo CMS](https://maxsite.org/albireo/introduction/other-pages)
  **Обзор встроенных служебных страниц, системных разделов и инструментов продуктивности автора:**
  - Обратная связь и комментарии: готовая страница контактной формы `/contact` с отдельным обработчиком, страница последних комментариев сайта `/last-comments` и RSS-лента комментариев `/rss-comments.xml`.
  - Карты сайта: раздельные механизмы для HTML-карты навигации для посетителей (`/sitemap`) и поисковой XML-карты для индексации (`/sitemap.xml`).
  - Авторизация и администрирование: готовые формы входа в каталоге `specific/auth`, а также возможность добавления собственных разделов панели управления в каталог `specific/admin` без модификации системного ядра.
  - Демонстрация стилей и верстки: витрина стилей CSS-фреймворка на странице `/berry-design` и примеры различных компоновок записей блога на странице `/group-samples`.
  - Личные инструменты автора (доступны только администратору):
    - `Shorts` (`/shorts`) — компактные заметки, TODO-списки и подборки ссылок, которые выводятся единым списком без разбивки на страницы;
    - `Notes` (`/notes`) — приватный блок для ведения произвольных авторских заметок;
    - `Prompts` — встроенная библиотека готовых промптов для нейросетей (контент-планы, идеи постов, сценарии видео, генерация картинок) с быстрым копированием прямо из админки.
  - Мастер-заготовки (`_master`): система каркасов для быстрого создания типовых страниц с предзаполненными полями через выпадающий список в админ-панели.
  - Демо-контент: каталог `demo` содержит ознакомительные материалы и безопасно удаляется при запуске боевого проекта.
  (Файловую структуру служебных обработчиков и перечень промптов см. на странице)

- [Главная страница сайта в Albireo CMS](https://maxsite.org/albireo/introduction/home-page)
  **Назначение главной страницы, сценарии использования (лендинг или блог), модули вывода и шаблонизация записей:**
  - Определение главной страницы: главной считается любая страница, у которой в служебном блоке задан адрес `slug: /` (по умолчанию это файл `home.php`).
  - Сценарии работы: страница может выступать самостоятельным статичным лендингом (выводя собственное текстовое содержимое) либо работать как архивная страница блога, динамически выводящая список других записей.
  - Готовые модули вывода: для блога переключение вариантов оформления главной выполняется в конфигурации через опцию `homeOutputModule` (файлы модулей размещаются в каталоге шаблона `modules/home`), а лимиты записей для пагинации регулируются ключами `homeLimitPagination1` и `homeLimitPagination2`.
  - Программная выборка и рендеринг: при кастомизации архива записи получаются системной функцией выборки данных `getPages`, после чего передаются в функцию шаблонизатора `tpl` с указанием конкретного TPL-файла разметки (из каталога `tpl/`) и файла пагинации.
  - Демонстрация вариантов группировок: в комплект системы входит наглядная страница `/group-samples` (исходный код в `examples/group-samples.php`), демонстрирующая готовые примеры верстки и компоновки записей на главной.
  (Примеры вызова функций getPages, tpl и опции конфигурации см. на странице)

- [Поля страниц (основы) Albireo CMS](https://maxsite.org/albireo/introduction/fields-base)
  **Базовые принципы работы с полями страниц, синтаксические конструкции, шаблонизация и расширенная обработка данных:**
  - Общие правила синтаксиса: формат `ключ: значение` с обязательным пробелом после двоеточия; булевы флаги (выключение: `0`, `-`, `false`; включение: `1`, `+`, `true` или любой текст); комментирование строк символом `#` в начале; замена переноса строки через `///`; сохранение краевых пробелов через `[ NBSP ]`; прямая поддержка HTML-разметки.
  - Многострочные поля (YAML-подобный формат):
    - списки для автогенерации PHP-массивов (элементы отбиваются пробелом и дефисом ` - элемент`);
    - многострочный сплошной текст (имя поля завершается символом `|`, а строки ниже отбиваются двумя пробелами).
  - Строки и массивы (метки и рубрики): поля `tags` и `category` движок автоматически принимает как строкой через запятую, так и списком; для пользовательских полей аналогичное преобразование строки в массив выполняет функция `strExplode()`.
  - Системные макросы-заменители: готовые подстановки путей и констант внутри значений полей — `[ SITE_URL ]`, `[ UPLOADS_URL ]`, `[ SERVICE_DIR ]`, `[ CONFIG_DIR ]`, `[ NBSP ]` и `[ EOL ]`.
  - Взаимные подстановки и условия:
    - наследование значений других полей через квадратные скобки (например, `slug: blog/Поля страниц (основы) Albireo CMS`);
    - условные конструкции переопределения полей через синтаксис `` или со значением по умолчанию.
  - Сброс и удаление полей (`[ UNSET ]`): удаление глобально предопределенных полей (из `page-data.php`) на уровне конкретной страницы с помощью значения `[ UNSET ]` (для множественных полей сброс выполняется по конкретному индексу).
  - Автоматически генерируемые поля: ядро самостоятельно рассчитывает и добавляет служебные данные страницы — полные адреса (`page-url`, `page-url-full`), пути к папкам (`current-path`, `subdirs`, `subdirs-basename`), имя файла (`this-file`, `this-file-stem`), уникальный хеш (`uniqid`), Unix-метки дат (`date.unix`, `date-pub.unix`), язык браузера (`user-lang`) и ссылку на редактирование в админке (`link-for-edit`).
  - Программный доступ: получение единичного поля или всего массива данных текущей страницы выполняется функцией `getPageData()`.
  - PHP и сложные структуры в полях: допустимо исполнение PHP-вставок (`< ?= ... ? >`); для передачи сложных массивов или многострочного вывода без случайных разрывов строк применяется упаковка в JSON (`json_encode` с последующим `json_decode`).
  - Множественные и именованные поля:
    - синтаксис `поле[]: значение` автоматически собирает массив однотипных элементов с уникальными ключами (например, стили CSS);
    - синтаксис `поле[ключ]: значение` формирует ассоциативные массивы (например, метатеги Open Graph), обрабатываемые функцией `getKeysPageData()`;
    - значение именованного ключа может быть списком ссылок или массивом.
  - Подключение внешних конфигураций (`file-page-data`): загрузка готового PHP-массива настроек страницы из каталога `config/page-data/`.
  - Рекомендации по именованию: полная свобода в выборе имен и разделителей (`.`, `-`, `_`, `:`, `#`), использование префиксов для связи полей с конкретными сниппетами, модулями или блоками шапки/подвала.
  (Синтаксические конструкции, примеры вызовов getPageData и шаблоны getKeysPageData см. на странице)

- [Создание документации с помощью Albireo CMS](https://maxsite.org/albireo/introduction/create-doc)
  **Инструменты и подходы к построению документации — в виде отдельного сайта или изолированного раздела:**
  - Два готовых сценария (`layout`): автономная база знаний без шапки и подвала (`doc1.php`, пример — сайт Berry CSS) либо документация как встроенный раздел основного сайта с сохранением общей структуры (`doc2.php`).
  - Служебные поля документации: явное указание типа `type: doc`, выбор конфигуратора `doc.config`, а также настройка бокового меню через `doc.menu.title` (название ссылки), `doc.menu.path` (секция и порядок вида `01_Название.01`) и классы иконок `doc.menu.icon`.
  - Упрощение поддержки (`page-data`): повторяющиеся системные настройки страниц выносятся в единый файл `config/page-data/doc-data.php`, оставляя в записях только индивидуальные метаданные.
  - Автоматическая сортировка: нумерация имен файлов и папок (`01.name.php`) автоматически задает строгий порядок в навигации, но вырезается движком из итоговых URL-адресов.
  - Навигационные элементы: поддержка постраничной навигации «вперед/назад» через extras-файлы (`doc-nav.php`), а также автоматическая генерация оглавления статьи по заголовкам H2 через встроенные сниппеты или плавающую колонку TOC (`doc-toc.php`).
  (Синтаксис путей меню, параметры конфигурационных файлов doc1/doc2 и примеры разметки см. на странице)

- [Структура страницы в Albireo CMS](https://maxsite.org/albireo/introduction/page-structure)
  **Устройство PHP-файла страницы, синтаксис служебного блока полей, создание через админ-панель и автоматическая конвертация Markdown/Obsidian:**
  - Базовая анатомия и безопасность: файл начинается с обязательной защиты от прямого вызова (`defined('BASE_DIR') or exit;`), за которой следует служебная секция полей страницы в формате `поле: значение` и тело контента (где разрешен произвольный PHP, HTML и текст).
  - Специфика синтаксиса комментариев: служебный блок оформляется строго в формате php-комментария (обязательно с двумя звездочками, чтобы система отличала его от обычных комментариев).
  - Гибкость размещения секции: движок находит блок полей в любом месте файла (например, спрятанным внутри HTML-комментария), но расположение в начале предпочтительно для скорости. Если служебной части нет или она пуста — движок игнорирует файл, он не считается страницей.
  - Создание страниц в админ-панели: форма «New page» автоматически создает вложенные папки, отсекает расширение `.php`, предлагает шаблоны генерации имен (Date, DateTime, Shorts, Prompts) и позволяет использовать мастер-шаблоны из каталога `_master`.
  - Загрузка готовых PHP-файлов: drag-and-drop загрузка с автоматической транслитерацией кириллицы и очисткой недопустимых символов в именах файлов.
  - Нативная интеграция с Markdown и Obsidian:
    - поддерживается прямая загрузка `.md`-файлов: система сама переименовывает их в `.php` и конвертирует блок кода ` ```albireo ` в блок полей;
    - встроенная поддержка макросов подстановки: `%%DATE-NOW%%` (текущие дата и время) и `%%SLUG%%` (имя файла);
    - поле `page-on-website` позволяет переопределить итоговое имя файла на сервере;
    - YAML-блок (`---`), используемый в Obsidian, автоматически удаляется при импорте.
  - Обработка изображений из Obsidian: путь к папке вложений `attachement/` на лету заменяется на значение поля `images-dir` (а префикс `//` работает как алиас системного `https://maxsite.org/albireo/uploads/`).
  - Поддержка автономных MD-файлов с Base64: система умеет принимать единый Markdown-файл с картинками в формате data-атрибутов (`data:image/webp;base64`), автоматически извлекая и сохраняя графику в отдельные файлы на сервере.
  (Инструкции по Obsidian-плагинам и синтаксис макросов см. на странице)

- [Страницы в Albireo CMS](https://maxsite.org/albireo/introduction/pages)
  **Устройство текстовых страниц, формат метаданных, маршрутизация и исполнение кода внутри контента:**
  - Формат хранения: страницы представляют собой стандартные PHP-файлы, расположенные внутри каталога `website/pages/`. Физическая вложенность файлов в подпапки служит для удобства автора и может иметь любой итоговый веб-адрес.
  - Блок метаданных (Front Matter): в начале каждого файла размещается специальный PHP-комментарий с полями конфигурации записи (заголовок, веб-адрес, дата публикации, рубрики, метки, SEO-описание, выбор шаблона, модульной сетки, парсера и т.д.).
  - Маршрутизация (slug): адрес страницы в браузере определяется значением конфигурационного поля slug или именем файла на диске, что дает полную свободу в организации файловой структуры.
  - Исполнение PHP и контент: под блоком метаданных располагается тело записи, где разрешено свободно комбинировать разметку парсеров (TextSimple, Markdown), чистый HTML, CSS, JS и исполняемый PHP-код в тегах `<?php ... ?>`.
  - Управление публикацией: предусмотрены механизмы перевода записей в черновики через поля метаданных или префиксы имен файлов, отложенная публикация по дате и скрытие из общих списков.
  - Автономность страницы: любая запись может быть как стандартной статьей блога, так и изолированным лендингом или системным обработчиком за счет отключения или переопределения общего шаблона.
  (Полный перечень полей метаданных и правила оформления заголовка см. на странице)

- [Создание Корзины товаров](https://maxsite.org/albireo/introduction/cart)
  **Архитектура интернет-магазина без базы данных, хранение корзины на клиенте, поля товаров и обработка заказов:**
  - Концепция каталога: карточки товаров формируются как обычные страницы Albireo CMS с указанием специализированных полей в служебном блоке (цена, старая цена, артикул, валюта, наличие). Для простых витрин и лендингов товарные свойства можно задавать прямо в разметке кнопок покупки.
  - Клиентское хранилище: корзина работает на базе реактивного Alpine.js и сохраняет данные в `localStorage` браузера пользователя, что исключает серверную нагрузку, создание лишних сессий и зависимость от внешних баз данных.
  - Компоненты интерфейса: готовые модули кнопок «В корзину», компактный виджет счетчика товаров и суммы в шапке/сайдбаре, а также модальное окно или отдельная страница оформления заказа с управлением количеством позиций и пересчетом итогов.
  - Оформление и отправка заказа: форма чекаута собирает контактные данные покупателя и передает заказ серверному обработчику через безопасный AJAX-запрос с защитой от спама и CSRF.
  - Каналы уведомлений: поддержка мгновенной отправки информации о новом заказе на электронную почту администратора, в Telegram-бот сайта (в полной версии) или фиксация в локальном хранилище.
  (Спецификацию полей карточки товара, разметку кнопок и параметры почтовых уведомлений см. на странице)

- [Регистрация пользователей в Albireo CMS](https://maxsite.org/albireo/introduction/users)
  **Архитектура системы пользователей, произвольные уровни доступа (user-level), защита страниц и разграничение контента:**
  - Модель хранения: пользователи описываются в конфигурационном массиве `website/config/users.php` (логин, имя/ник, хэш пароля и список доступов). При включении публичной регистрации движок автоматически объединяет статический файл с базой зарегистрированных пользователей.
  - Единственная системная роль — `admin`: на уровне ядра жестко зашит только статус `admin` с абсолютными правами. Любые другие уровни доступа (`reader`, `subscriber`, `editor` и т.д.) являются произвольными строками, не требуют регистрации в движке и свободно придумываются владельцем сайта.
  - Ограничение доступа через поле `user-level`: доступ к странице задается прямо в её служебном заголовке (например, `user-level: admin` или несколько уровней через запятую). Движок на лету сверяет права вошедшего пользователя и формирует метку доступа (`userAccess`).
  - Разграничение видимости контента: функция `noUserAccess(...)` позволяет как полностью блокировать страницу с выводом сообщения об отказе, так и скрывать отдельные части текста внутри одной записи (для платных подписок, пейволлов или приватных блоков).
  - Безопасность и обработчики: защита панели управления, страниц и AJAX/POST-обработчиков базируется на едином механизме проверки `user-level`. Пароли обязательно сохраняются в виде криптографических хэшей (`password_hash`).
  (Синтаксис объявления массива пользователей и примеры вызова функций проверки см. на странице)

- [Метки и рубрики в Albireo CMS](https://maxsite.org/albireo/introduction/tags-and-category)
  **Принципы группировки записей, настройка меток и рубрик, конфигурация архивов и автоопределение по папкам:**
  - Философия группировки: в системе нет жестко навязанной таксономии — метки (`tags`) и рубрики (`category`) поставляются «из коробки» как привычный стандарт, но разработчик может реализовать любую собственную логику группировки.
  - Работа с метками (`tags`): задаются в полях страницы через запятую или списком. Автоматически формируют облако всех найденных меток по адресу `/tags` и страницы выборок `/tags/имя` (через системный файл `specific/tags.php`).
  - Работа с рубриками (`category`): выводятся по адресам `/category` и `/category/slug` (через `specific/category.php`). Если рубрика не описана в конфигурации, она работает по принципу метки (название формируется из её адреса).
  - Предварительная конфигурация рубрик (`website/config/category.php`): позволяет заранее задать для каждой рубрики мета-заголовок (`title`), выводимое название (`caption`), `description`, вступительный и завершающий тексты (`text-start`, `text-end` с поддержкой переноса `///`), порядок вывода рубрики (`order`), сортировку записей внутри неё (`order-pages`: `date-asc` или `date-desc`), пагинацию (`limit`), уровень вложенности (`path`) и кастомный URL (`my-url` для вывода вне префикса `/category/`).
  - Иерархия и спецсимволы: как в метках, так и в рубриках поддерживаются любые валидные символы URL, эмодзи и многоуровневая вложенность через слэш (например, `astronomy/deepspace/galaxies`). Для попадания записи сразу в несколько родительских сегментов они перечисляются явно через запятую.
  - Автоматическая привязка к структуре папок: подстановка макроса `[ subdirs-basename ]` в поле `category` или `tags` автоматически назначает рубрику/метку по имени текущей подпапки внутри `pages/`, а макрос `[ subdirs ]` формирует вложенную рубрику/метку из полного относительного пути к каталогу файла.
  (Структуру массива конфигурации category.php и примеры задания полей см. на странице)

- [Синхронизация файлов через WinSCP](https://maxsite.org/albireo/introduction/sync-script-for-winscp)
  **Автоматизация публикации сайта по FTP/SFTP через WinSCP, локальный рабочий процесс и маски исключений:**
  - Назначение и концепция: инструмент для локальной разработки и публикации («local-first»), позволяющий писать статьи и редактировать код на локальном компьютере (в Obsidian, VS Code или любом редакторе), а затем синхронизировать изменения с боевым сервером в один клик без использования админ-панели.
  - Принцип работы: пакетный сценарий (`.bat`/`.cmd`) автоматизирует консольный клиент WinSCP, подключается по FTP/SFTP и передает на хостинг только измененные или вновь созданные файлы.
  - Настройки подключения: скрипт конфигурируется параметрами хоста, порта, учетных данных (логин/пароль или SSH-ключи), а также локального и удаленного путей к рабочим каталогам сайта.
  - Маски исключений и защита данных:
    - встроенная фильтрация предотвращает отправку локального служебного мусора (файлов Git, служебных папок IDE, временных файлов ОС);
    - защита серверных данных исключает перезапись или затирание динамических серверных файлов (баз данных комментариев, статистики и сессий в каталоге `service/`).
  - Управление режимами: поддержка односторонней отправки изменений на сервер (`local to remote`), обратного скачивания или предварительного просмотра списка обновляемых файлов без их перезаписи.
  (Готовый код bat-файла, команды WinSCP и синтаксис масок исключений см. на странице)

- [Конфигурация сайта на Albireo CMS](https://maxsite.org/albireo/introduction/configuration)
  **Принципы конфигурирования системы, структура настроек сайта и механизм переопределения параметров:**
  - Формат хранения: настройки хранятся в обычных PHP-файлах в каталоге `website/config/` (основной файл — `config.php`, возвращающий ассоциативный массив параметров). Отсутствие базы данных позволяет легко контролировать версии настроек через Git.
  - Архитектура переопределений: предусмотрены механизмы кастомных конфигураций (файлы вида `config-custom.php` и каталоги `my/`), что позволяет безопасно менять системные настройки без риска их затирания при обновлениях дистрибутива.
  - Сетевые и базовые параметры: определение базового адреса сайта (`siteUrl`, поддерживающий автоопределение протокола и домена), глобальное название и описание ресурса (используются как фоллбэк для Open Graph, RSS и мета-тегов), а также настройка системного часового пояса (`timezone`).
  - Управление оформлением и структурой: назначение глобального шаблона по умолчанию (`defaultTemplate`), базовой модульной сетки (`defaultLayout`) и основного парсера контента.
  - Маршрутизация и безопасность URL: параметры нормализации автогенерируемых адресов (`slugReplaceSlashes` — замена слэшей из вложенных папок на дефисы или сохранение структуры каталогов) и фильтрация недопустимых XSS-символов в строке запроса.
  - Производительность и среда: управление сжатием вывода, оптимизацией кэширования и независимость настроек для каждого изолированного подсайта в мультисайтовой конфигурации.
  (Полный список конфигурационных ключей и их значения по умолчанию см. на странице)

- [Работа с AJAX](https://maxsite.org/albireo/introduction/ajax)
  **Архитектура асинхронных запросов, организация серверных обработчиков, модель безопасности и клиентская интеграция:**
  - Концепция обработчиков: в роли серверных эндпоинтов для AJAX выступают отдельные PHP-файлы (в служебных разделах `specific/` или изолированных страницах `pages/`) с отключенным общим оформлением шаблона, отдающие чистый JSON или фрагменты HTML-разметки.
  - Клиентский стек: архитектура ориентирована на современный нативный JavaScript (`fetch`) и реактивные директивы библиотеки Alpine.js, что исключает зависимость от тяжелых сторонних фреймворков.
  - Комплексная безопасность эндпоинтов:
    - обязательная верификация CSRF-токенов с проверкой временных меток и валидацией источника запроса (Origin/Referer);
    - разграничение прав через системный механизм проверки уровней доступа пользователей (`user-level`) для защиты закрытых функций;
    - встроенная защита от частого спама, бот-атак и злоупотреблений запросами (rate limiting).
  - Типовые сценарии использования: динамическая отправка контактных форм без перезагрузки страницы, добавление и подгрузка комментариев, интерактивные голосования, живой поиск и асинхронные операции в панели управления.
  (Архитектурные паттерны, сигнатуры функций верификации токенов и JS-примеры см. на странице)

- [Админ-панель в Albireo CMS](https://maxsite.org/albireo/introduction/admin-panel)
  Админ-панель доступна по адресу ваш-сайт/admin. На странице приведены скриншоты панели.

- [Разметка с помощью TextSimple. Albireo CMS](https://maxsite.org/albireo/introduction/textsimple)
  **Назначение, архитектурные преимущества и функциональные возможности авторского парсера TextSimple:**
  - Суть парсера: основной встроенный инструмент форматирования контента в Albireo CMS, представляющий собой расширенную, оптимизированную и обогащенную версию Markdown, развивающуюся с 2014 года.
  - Полная поддержка базы Markdown: включает стандартное оформление заголовков, списков (в том числе чекбоксов и списков определений), цитат, таблиц, ссылок, изображений и блоков кода.
  - Прямое управление CSS и атрибутами: в отличие от стандартного Markdown, позволяет нативно назначать CSS-классы, идентификаторы, инлайн-стили и произвольные HTML-атрибуты практически любым элементам — абзацам, заголовкам, ссылкам, картинкам, ячейкам таблиц и спискам.
  - Бесшовная интеграция с кодом: спроектирован для корректной работы со вставками чистого HTML-кода и динамического PHP; не ломает верстку параграфами вокруг тегов скриптов и разметки.
  - Контейнеры и компоненты: синтаксис позволяет прямо в тексте быстро формировать блочные обертки (div, section), карточки, информационные уведомления (алерты), спойлеры (details/summary), кнопки и модульные колонки.
  - Расширенная типографика и медиа: встроенная поддержка сносок, подсветки текста, надстрочных/подстрочных знаков, клавиш клавиатуры (kbd), типографических замен, а также разметки для подключения лайтбоксов к изображениям.
  - Высокая производительность: работает существенно быстрее сторонних библиотек парсинга и не имеет внешних зависимостей.
  (Полный синтаксис разметки, правила назначения CSS-классов и примеры оформления см. на странице)

- [Мультиязычность в Albireo CMS.](https://maxsite.org/albireo/introduction/multi-language)
  **Архитектура локализации, определение языка посетителя и все варианты реализации мультиязычного контента:**
  - Базовые механизмы и язык пользователя: системная функция `detectUserLang()` определяет двухсимвольный код языка по заголовку браузера с учетом приоритетов и разрешенного списка; глобальные параметры `defaultLang` и `langAllowed` задаются в `config.php`, транслируются в атрибут `<html lang="...">` и могут быть переопределены на уровне каждой страницы через поля `html[ lang ]` и `lang`.
  - Варианты организации многоязычного контента:
    1. *Контекстные файлы перевода (`@lang-КОД`)*: основной файл записи содержит метаданные и системную диспетчеризацию функцией `langFile()`, а текст для каждого языка выносится в отдельные файлы с суффиксом (например, `about@lang-en.php`, `about@lang-uk.php`).
    2. *Единый файл с PHP-условиями*: для небольших страниц весь контент хранится в одном файле и отдается через ветвление по значению текущего языка пользователя `getPageData('user-lang')`.
    3. *Перевод по месту через `langText()`*: inline-перевод фраз и блоков прямо в верстке страницы вызовом функции со списком переводов (или массивом), порядок которых строго привязан к списку языков в поле `lang`.
    4. *Самостоятельные изолированные страницы с раздельными URL*: создание независимых файлов в подпапках языков (например, `/en/page`, `/uk/page`) со связыванием через мета-теги `head-lang[ КОД ]` (генерируют SEO-теги `rel="alternate" hreflang`) и опциональным авторедиректом.
    5. *Раздельные сайты через встроенный мультисайтинг*: создание независимых копий рабочего каталога `website` под каждый язык с общим системным ядром для полной изоляции медиафайлов, баз данных и настроек.
  - Локализация интерфейса и метаданных:
    - функция `lang()` переводит элементы шаблона (шапка, меню, виджеты), подтягивая словари из каталога `website/config/langs/ЯЗЫК/`;
    - синтаксис полей `lang.КОД[ ПОЛЕ ]` на лету динамически подменяет метаданные (заголовки, описания, произвольные поля) под язык посетителя без использования внешних словарей;
    - встроенная панель отладки перевода на локальном сервере автоматически подсвечивает отсутствующие фразы в словарях.
  (Синтаксис функций langText, detectUserLang, структуру словарей и примеры шаблонов перевода см. на странице)

- [Структура каталогов Albireo CMS](https://maxsite.org/albireo/introduction/directories)
  **Назначение и архитектурное разделение системных, пользовательских и шаблонных директорий движка:**
  - Корневые файлы: входная точка `index.php` (инициализирует окружение и позволяет переопределить рабочий каталог через константу), файл локальной маршрутизации, служебные `.htaccess`, `robots.txt` и лицензионные файлы.
  - Каталог системного ядра (`system`): закрытый и защищенный код движка, а также персональный файл лицензии для полной версии. Ручное изменение файлов ядра запрещено.
  - Каталог оформления (`templates`): общие шаблоны вывода, модульные сетки, компоненты (шапки, подвалы), CSS-фреймворк Berry CSS, скрипты Alpine.js, шрифты и статические ассеты.
  - Рабочий каталог сайта (`website`): изолированное пространство контента и логики конкретного проекта, которое можно свободно дублировать для создания мультисайтов/подсайтов.
  - Подкаталоги рабочего пространства:
    - `pages/` — хранилище текстовых страниц контента (записи блога, статичные страницы, лендинги, заметки);
    - `config/` — конфигурационные файлы сайта, настроек вывода и параметров локализации;
    - `service/` — системные кэши, сессии и базы данных SQLite (комментарии, статистика, логи);
    - `uploads/` — загруженные медиафайлы и изображения (включая WebP);
    - пользовательские каталоги функций и переопределений шаблонов (механизм папок `my/`).
  (Схему полного дерева каталогов и рекомендации по изоляции данных см. на странице)

- [Изображения в Albireo CMS](https://maxsite.org/albireo/introduction/images)
  **Хранение медиафайлов, автоматическая конвертация в WebP, генерация миниатюр и интеграция с лайтбоксами:**
  - Базовое хранилище и адресация: все медиафайлы размещаются в каталоге `uploads/`. Поддерживаются короткие префиксы адресов: `//` (ссылка на папку uploads), `##` (относительно корня сайта) и системный макрос `[ UPLOADS_URL ]`.
  - Загрузка и быстрая вставка:
    - перетаскивание (drag-and-drop) файлов или вставка из буфера обмена (`Ctrl+V`) прямо в поле текстового редактора;
    - диалог настройки ширины (по умолчанию 1200px или исходный) и качества сжатия;
    - автоматическая транслитерация кириллических имен в латиницу и конвертация входящих JPG/PNG в формат WebP;
    - загрузка через специальный раздел админки «Images» или по FTP (файлы сразу становятся доступны без импорта в БД).
  - Управление каталогом записи (`images-dir`): поле в заголовке страницы задает персональную папку для вложений записи и открывает быстрый доступ к ее галерее прямо из окна редактирования.
  - Главное изображение записи (`image-large`): служит источником для Open Graph, карточек соцсетей и автоматических миниатюр в списках архивов (рекомендуется от 1200×628px до 800×600px).
  - Динамическая генерация миниатюр (`hThumb`): функция создает уменьшенные WebP-копии заданных размеров с сохранением пропорций или центрированием, кэширует результат на диске (суффикс `@размер-thumb.webp`) и формирует корректный HTML-код или чистый URL.
  - Хелпер разметки (`hIMG`): быстро генерирует тег `<img>` с нужными атрибутами из локальных путей, коротких ссылок `//` или значений полей записи (например, `[ image-large ]`).
  - Поддержка лайтбоксов: встроенная интеграция с библиотеками `glightbox` и `fslightbox` через поля страницы (`use.glightbox: +`), генерирующая кликабельные всплывающие окна как через функции, так и через спецсимволы разметки TextSimple (`!![...]`).
  - Сервисные возможности: пакетное перекодирование загруженных каталогов в WebP (`convertToWebp`), программная генерация обложек с наложением TTF-текста и теней на фон (`createImageText`), а также вывод фотогалерей в связке с модулем Grid Gallery.
  (Сигнатуры функций hThumb, hIMG, параметры createImageText и синтаксис лайтбоксов см. на странице)

- [Поля страниц (справочник) Albireo CMS](https://maxsite.org/albireo/introduction/fields)
  **Полный справочник по всем служебным полям страниц, сгруппированный по назначению и с примерами синтаксиса:**
  - Основные поля записи: `title`, `description`, `header`, `announce`, `category`, `tags`, `draft`, `author`, `llms` (описание для нейросетей; фоллбэк: `llms` → `announce` → `description` → `title`).
  - Даты: `date`, `date-edit`, `date-pub` (отложенная публикация).
  - Тип страницы: `type: blog` (попадает в ленты и архивы) или `type: system` (исключается из sitemap, RSS, комментариев, блоков других записей).
  - Адреса: `slug`, `slug-pattern` (регулярное выражение), `method` (HTTP-метод для роутинга), `page-on-website` (для загрузки md-файлов).
  - Изображения: `image-large`, `image-large-size`, `image-noview`, `images-dir`.
  - Комментарии: `comments`, `comments-pub`, `comments.page` (вывод комментариев другой страницы).
  - Sitemap: `sitemap`, `sitemap-changefreq`, `sitemap-priority`.
  - Статистика: `stat` (модуль Stat), `stat.page` (модуль PageViews), `stat-start`.
  - Обработка текста: `parser`, `compress`, `protect-pre`, `content-separate`, `text-function`.
  - Доступ: `user-level`, `no-user-access`.
  - PHP-функции: `require[]`, `triggers[]`.
  - Автоматически создаваемые поля: `page-url`, `page-url-full`, `current-path`, `subdirs`, `subdirs-basename`, `this-file`, `this-file-stem`, `this-dir`, `uniqid`, `date.unix`, `date-edit.unix`, `date-pub.unix`, `link-for-edit`, `user-lang`.
  - Шаблон и сетки: `template`, `layout` (доступные варианты: `default.php`, `sidebar.php`, `sidebar-left.php`, `sidebar-float.php`, `full-width.php`, `clean.php`, `landing.php`, `empty.php`, `doc1.php`, `doc2.php`), а также поля для вставки блоков: `layout-start`, `layout-content-start`, `layout-content-end`, `layout-end`.
  - Шапка и подвал: `headers`, `footers`, а также `headers.title`, `headers.subtitle`, `headers.logo`, `headers.namesite`, `headers.pursuing` (липкое меню) и др.
  - Меню: `menu` (файл элементов), `menu.design` (файл дизайна).
  - HTML и HEAD: `html[атрибут]`, `head[]`, `head-meta[]`, `head-lang[]`, `http-equiv[]`, `head-rel-href[]`, `rss`, `rss.comments`.
  - BODY: `lazy[]`, `body`.
  - CSS: `css.layout`, `css.theme[]`, `css.style[]`, `css.root[]`, `css.head[]`, `css.lazy[]`, `css.fonts`, `css.head.url[]`, `css.lazy.url[]`, `use.font[]`.
  - JS: `js.head[]`, `js.lazy[]`, `js.head.url[]`, `js.lazy.url[]`, `js.fscript[]`.
  - Подключение библиотек через `use.*`: `use.alpine`, `use.imfont`, `use.tiny-slider`, `use.animate`, `use.glightbox`, `use.fslightbox`, `use.grid-gallery`, `use.highlight`, `use.berry` (и dark-режим), `use.scrolltotop` и многие другие.
  - Open Graph: `ogp[og:site_name]`, `ogp[og:type]`, `ogp[og:url]`, `ogp[og:title]`, `ogp[og:description]`, `ogp[og:image]`.
  - Навигация: `nav`, `nav-top`, `nav-category`, `next-prev`, `nav-folder`, `nav-top-folder-date`, а также иерархия через `hierarchy`.
  - Связанные ссылки: `links` (с настройкой заголовка `links.title`).
  - Сниппеты в HEAD: `snippet.head[]`.
  - Extras-файлы: `extras.start0[]`, `extras.start[]`, `extras.end[]`.
  - Блок «Похожие записи»: `other-pages` (с последовательным фоллбэком по category → tags → type).
  - Мультиязычность: `lang`, `lang.ЯЗЫК[ПОЛЕ]`, `html[lang]`, а также функция `lang()` в полях.
  (Страница является полным справочником: для получения точной сигнатуры конкретного поля или его поведения в особых случаях следует обращаться к оригинальной странице)

- [Отладка кода в Albireo CMS](https://maxsite.org/albireo/core/debugging)
  **Встроенные инструменты отладки: безопасный вывод данных, логирование, замеры производительности, трассировка и отладочная панель:**
  - Быстрый вывод данных в браузер:
    - `pr()` — безопасный вывод любых переменных и массивов в браузер;
    - `prMakeStr()` — аналогичное форматирование данных без прямого вывода (возвращает готовую строку для вставки в разметку).
  - Запись в лог-файл (`saveLogFile`):
    - позволяет сбрасывать произвольный набор переменных в файл по абсолютному пути;
    - механизм безопасности: функция срабатывает только при предварительном объявлении константы `ALLOW_SAVE_LOGFILE` (рекомендуется включать строго по условию `LOCALHOST` во избежание записи логов на боевом сервере).
  - Профилирование и замеры производительности (`debugBenchmark`):
    - связка функций `debugBenchmarkStart('метка')`, `debugBenchmarkEnd('метка')` и вывод итогов через `debugBenchmarkOut()` (в браузер или с передачей пути к лог-файлу);
    - замеры времени выполняются через высокоточную функцию `hrtime()`, а память — через `memory_get_usage()`;
    - флаг активации: замеры выполняются только при объявленной константе `DEBUG_BENCHMARK` (без неё функции ничего не делают, что позволяет безопасно оставлять тестовые метки в коде).
  - Трассировка вызовов (`debugTrace`):
    - обертка над `debug_backtrace()`, выводящая стек файлов, строк и функций, приведших к текущей точке;
    - поддерживает аргумент ограничения глубины цепочки (например, только 3 последних вызова).
  - Сбор контекстных отладочных данных:
    - `debug()` — выводит произвольные значения с автоматической фиксацией имени вызвавшей функции, пути к файлу и номера строки;
    - `debugAdd()` — предварительно накапливает значения в отладочный стек перед финальным вызовом `debug()`.
  - Встроенная отладочная панель (`debugPanel`):
    - вывод уведомлений и сервисных массивов в специальную панель шаблона;
    - используется движком для подсветки проблем (например, непереведенных языковых фраз);
    - активность панели контролируется конфигурационным ключом `debug` (рекомендуется связывать с `LOCALHOST`).
  (Примеры вызовов функций, форматы вывода бенчмарка и параметры конфигурации debug см. на странице)

- [Работа с SQLite в Albireo CMS](https://maxsite.org/albireo/core/sqlite)
  **Архитектура работы с базами данных SQLite, класс подключения PdoConnect, хелпер getDB, CRUD-методы PdoQuery и синтаксис кавычек:**
  - Роль и расположение: SQLite служит основной СУБД для динамических данных (логи, комментарии, сессии, регистрации); базы представляют собой одиночные файлы и хранятся в едином каталоге `STORAGE_DIR` (`website/service/storage/`).
  - Класс `\Pdo\PdoConnect`: синглтон-обертка над стандартным PHP PDO, предотвращающая повторные подключения к одному файлу базы; принимает DSN-массив параметров и при необходимости может подключать любые другие СУБД (например, MySQL).
  - Хелпер быстрого подключения `getDB()`: получает PDO-объект базы по короткому псевдониму (алиасу) из конфигурационного файла `dbase.php` (или пользовательского файла в `CONFIG_DIR`) без ручной сборки DSN.
  - Статический класс `\Pdo\PdoQuery`: надстройка над PDO, ориентированная на SQLite и принимающая первым аргументом объект подключения:
    - *Выполнение запросов*: `fetchAll` (получение массива строк с bind-параметрами), `execute` (подготовленный запрос), `query` («сырой» SQL), `exec` (запросы без возврата данных: создание таблиц, индексов);
    - *CRUD-операции*: `insert` (одиночная или пакетная вставка), `insertSql`, `update`, `delete`, получение `lastInsertRowId`;
    - *Управление структурой и БД*: `tableExists`, `dropTable`, `tableInfo` (интроспекция колонок), сжатие базы `vacuum`, подсчет `countRecord`;
    - *Транзакции и тюнинг производительности*: управление блоками `begin`/`commit`, настройка режима синхронизации `pragma('synchronous', ...)` и типа журнала `journalMode` (`MEMORY`, `WAL`, `DELETE`, `TRUNCATE`, `PERSIST`);
    - *Генерация плейсхолдеров для IN()*: `buildPlaceholders` (позиционные знаки `?`) и `buildNamedPlaceholders` (именованные `:p0, :p1` для бесконфликтного объединения с другими переменными);
    - *Пагинация и отладка*: расчет смещений `getPagination`, а также функции быстрой визуализации массивов данных в виде HTML-таблиц `outTableRows` и списков `outListRows` (метод `upsert1` помечен автором как нестабильный).
  - Строгое правило кавычек в SQLite: в текстовых литералах SQL-запросов разрешено использовать строго одинарные кавычки (`'значение'`), так как двойные кавычки трактуются парсером SQLite как имена колонок и приводят к фатальной ошибке; лучшей практикой является использование PDO-плейсхолдеров (`:param`).
  (Сигнатуры методов PdoQuery, параметры PRAGMA и примеры конфигурации dbase.php см. на странице)

- [Функции меток в Albireo CMS](https://maxsite.org/albireo/core/tag)
  **Назначение и краткий справочник функций группы tag (таксономия меток, облако тегов и архивная выборка):**
  - `tagGetAll()` — сканирует кэш базы данных и возвращает массив всех существующих меток сайта с автоматическим подсчетом количества страниц по каждому тегу (основа для облака меток).
  - `tagGetPages()` — выполняет оптимизированную SQL-выборку страниц, привязанных к конкретной метке, с поддержкой пагинации и сортировки (поиск по JSON-массиву тегов в SQLite).
  - `tagLinks()` — формирует готовую HTML-строку кликабельных ссылок на страницы архивов меток (`/tags/...`) из переданного списка тегов текущей записи с возможностью назначения CSS-классов.
  (Сигнатуры аргументов, возвращаемые типы и примеры вызовов функций см. на странице)

- [Функции строк в Albireo CMS](https://maxsite.org/albireo/core/string)
  **Назначение и краткий справочник функций группы string (строковые манипуляции, форматирование дат, валидация и генерация slug):**
  - `checkStr()` — классифицирует значение по трем состояниям: не задано (`null`), отключено (`false`) или активно (`true`), что необходимо для разбора опций и булевых полей записей.
  - `convertDate()` — преобразует дату из любого формата `strtotime()` в заданный формат вывода (по умолчанию `d-m-Y`) с возвратом пустой строки при ошибке.
  - `hex2RGB()` — конвертирует HEX-код цвета (3 или 6 символов, с `#` или без) в ассоциативный массив компонентов RGB или строку для CSS.
  - `humanFilesize()` — форматирует размер файла в байтах в человекочитаемый вид с суффиксами (B, K, M, G, T) на основе степеней 1024.
  - `implodeWrap()` — оборачивает каждый непустой элемент массива префиксом и суффиксом и объединяет результат в строку (удобно для сборки HTML-тегов).
  - `isValidEmoji()` — проверяет, содержит ли строка ровно один разрешенный символ-эмодзи (для статусов и иконок), отсекая обычный текст, флаги и запрещенные символы.
  - `isValidUrl()` — выполняет многоступенчатую валидацию корректности и безопасности веб-адреса, отсекая XSS-вставки, опасные схемы и двойные слэши, но допуская кириллические домены.
  - `mb_ucfirst()` — многобайтовый полифил для перевода первого символа строки в верхний регистр с корректной поддержкой UTF-8 и кириллицы.
  - `plur()` — выполняет склонение существительных по числу (три числовые формы) с автоматической передачей выбранного слова в функцию перевода `lang()`.
  - `strCropWord()` — обрезает текст до заданного числа значимых слов с возможностью игнорирования коротких предлогов/союзов и предварительным удалением HTML-тегов.
  - `strExplode()` — расширенный разбор строки с разделителями в массив: удаляет дубликаты и пустые элементы, фильтрует положительные числа, поддерживает диапазоны (`1..7`) и безопасно принимает готовые массивы.
  - `strFirstDotClean()` — очищает сегменты файловых путей и URL от служебных префиксов сортировки вида «число-точка» (`01.`, `02.`).
  - `strFormat()` — форматирует строку-шаблон, подставляя значения массива вместо именованных или позиционных плейсхолдеров.
  - `strRemoveLF()` — удаляет любые символы переноса строк (`\r\n`, `\n`, `\r`), собирая многострочный текст в одну строку.
  - `strToSlug()` — генерирует чистый веб-адрес (slug) из произвольной строки с транслитерацией кириллицы, нижним регистром и заменой спецсимволов на дефисы.
  - `strUcFirst()` — преобразует первую букву строки в верхний регистр с поддержкой многобайтовых символов UTF-8.
  - `strEval()`— выполняет PHP-код, внедрённый в текстовую строку в виде открывающих и закрывающих тегов PHP, перехватывает вывод и возвращает полученный результат.
  (Сигнатуры аргументов, возвращаемые типы и примеры вызовов функций см. на странице)

- [Функции прочие в Albireo CMS](https://maxsite.org/albireo/core/ext)
  **Назначение и краткий справочник функций группы ext (интерфейсные блоки, сниппеты, безопасность, почта и обработчики):**
- `addClassmap()` — регистрирует пути к пользовательским PHP-классам во встроенном автозагрузчике системы.
- `ajaxURL()` — формирует защищенный веб-адрес для вызова AJAX-обработчиков с передачей зашифрованных параметров пути.
- `comments()` — выводит системный блок комментариев к текущей записи с формой отправки и списком отзывов.
- `extractDomain()` — извлекает чистый домен из переданного URL-адреса (с отсечением протокола, портов, путей и префикса `www`).
- `extras()` — подключает и рендерит файл из каталога `extras/` через TPL-шаблонизатор в контексте метаданных текущей страницы.
- `fieldsParse()` — выполняет парсинг текстового служебного блока метаданных (`/ ** ... ** /`) в ассоциативный массив полей страницы.
- `formHandler()` — универсальный серверный обработчик входящих форм с валидацией CSRF-токенов, временных меток и защитой от ботов.
- `gdprDialog()` — генерирует интерфейсное модальное окно или плашку уведомления о согласии на использование cookies (GDPR).
- `isAjax()` — проверяет, был ли текущий HTTP-запрос отправлен асинхронно через AJAX.
- `mail64()` — отправляет электронные письма через стандартный `mail()` с корректным кодированием UTF-8 заголовков и вложений.
- `module()` — подключает независимый компонент интерфейса (шапку, подвал) с приоритетным поиском в каталоге `service/my/`.
- `nextPrev()` — генерирует ссылки навигации на предыдущую и следующую публикации блога по хронологии.
- `nextPrevCategory()` — строит навигацию «предыдущая/следующая запись» с фильтрацией строго внутри текущей рубрики.
- `normalizeFilesArray()` — преобразует нестандартную структуру системного массива `$_FILES` в удобный плоский список файлов.
- `promptsInfo()` — возвращает структурированную информацию и списки заготовок из встроенного банка AI-промптов.
- `snippet()` — вызывает и рендерит сниппет интерфейса с передачей параметров и поиском пользовательских переопределений.
- `statCountPage()` — фиксирует просмотр текущей страницы в легковесной базе SQLite без сбора персональных данных (GDPR-safe).
- `stopWords()` — проверяет переданный текст на наличие спам-выражений и стоп-слов из настроенного черного списка.
- `templateModules()` — возвращает список всех доступных вариантов оформления модулей (списки шапок, подвалов шаблона).
- `textsimple()` — программно запускает рендеринг переданного текста через встроенный авторский парсер TextSimple.
- `widgetRun()` — инициализирует и отображает отдельный файл виджета с передачей контекста.
- `widgets()` — выполняет последовательный вывод группы виджетов для сайдбара или контентной зоны.
(Сигнатуры аргументов, возвращаемые типы и примеры вызовов функций см. на странице)

- [Функции массивов в Albireo CMS](https://maxsite.org/albireo/core/array)
  **Назначение и краткий справочник функций группы array:**
  - `arrayCondition()` — формирует строку из элементов массива по булевым условиям (удобно для условной генерации CSS-классов и inline-стилей).
  - `arrayFindPrevNext()` — находит предыдущий и следующий элементы в массиве относительно заданного значения или ключа.
  - `arrayFormat()` — форматирует значения массива по шаблону строки с подстановкой плейсхолдеров.
  - `arrayNatSort()` — выполняет «естественную» (natural) сортировку массива без учета регистра символов.
  - `arrayPagination()` — рассчитывает параметры пагинации (смещение, лимиты, текущую страницу) для произвольного массива.
  - `arrayReplaceKeys()` — заменяет ключи массива в соответствии с картой соответствия.
  - `arraySearchKeys()` — ищет элементы массива по совпадению или регулярному выражению в именах ключей.
  - `arraySortKeys()` — сортирует массив по заданному списку/порядку приоритетных ключей.
  - `arrayToStrHTML()` — преобразует массив параметров в строку валидных HTML-атрибутов (`ключ="значение"`).
  - `arrayValidate()` — валидирует структуру и типы значений массива по заданной схеме правил.
  - `checkArrVal()` — безопасно проверяет наличие ключа и непустое значение в массиве (защита от Notice/Warning).
  - `choiceKey()` — возвращает значение первого найденного ключа из переданного списка приоритетов.
  - `choiceKeyStr()` — ищет первое непустое строковое значение среди списка ключей.
  - `isFlatArray()` — проверяет, является ли массив плоским (одномерным) без вложенных структур.
  - `searchInArray()` — выполняет поиск значения или подстроки внутри одномерных и многомерных массивов.
  - `sortArray()` — универсальная многоуровневая сортировка массива по нескольким полям и направлениям.
  (Сигнатуры аргументов, возвращаемые типы и примеры вызовов функций см. на странице)

- [Функции отладки в Albireo CMS](https://maxsite.org/albireo/core/debug)
  **Назначение и краткий справочник функций группы debug:**
  - `ajaxTest_handler()` — тестовый серверный обработчик для быстрой проверки корректности отправки и приема AJAX-запросов.
  - `alert()` — формирует визуальное HTML-уведомление (плашку алерта) для вывода информационных сообщений, предупреждений или ошибок.
  - `debug()` — выводит отладочные данные с автоматической фиксацией контекста вызова (имя функции, файл и номер строки).
  - `debugAdd()` — накапливает промежуточные переменные в отладочный стек перед итоговым выводом через `debug()`.
  - `debugBenchmarkStart()` — запускает таймер бенчмарка под указанной меткой (активен только при константе `DEBUG_BENCHMARK`).
  - `debugBenchmarkEnd()` — останавливает замер для метки, фиксируя затраченное время (`hrtime`) и объем памяти (`memory_get_usage`).
  - `debugBenchmarkOut()` — выводит собранную таблицу замеров производительности в браузер или записывает её в указанный файл.
  - `debugPanel()` — отправляет сервисные сообщения или массивы во встроенную отладочную панель шаблона (при ключе `'debug' => true`).
  - `debugTrace()` — выводит структурированную трассировку стека вызовов (файл, строка, функция) с поддержкой ограничения глубины.
  - `pr()` — безопасный форматированный вывод структуры любых переменных, массивов и объектов в браузер.
  - `prMakeStr()` — преобразует данные переменной в форматированную строку без прямого вывода в браузер (для передачи в шаблоны).
  - `saveLogFile()` — выполняет защищенную запись произвольных данных в лог-файл по абсолютному пути (требует флаг `ALLOW_SAVE_LOGFILE`).
  (Сигнатуры аргументов, возвращаемые типы и примеры вызовов функций см. на странице)

- [Функции шаблонизатора в Albireo CMS](https://maxsite.org/albireo/core/tpl)
  **Назначение и краткий справочник функций группы tpl (рендеринг списков данных и строковых шаблонов):**
  - `tpl()` — основная функция встроенного шаблонизатора: принимает массив данных (например, выборку `getPages()`) и применяет к нему указанный TPL-файл разметки (с приоритетным поиском в `service/my/tpl/` и каталоге шаблона).
  - `tplContent()` — выполняет рендеринг шаблона напрямую из переданной текстовой строки без обращения к файловой системе, подставляя переменные и вычисляя конструкции TPL «на лету».
  (Сигнатуры аргументов, возвращаемые типы и примеры вызовов функций см. на странице)

- [Функции файлов в Albireo CMS](https://maxsite.org/albireo/core/file)
  **Назначение и краткий справочник функций группы file (файловая система, поиск переопределений, чтение страниц и безопасность):**
  - `checkRealFile()` — проверяет физическое существование файла на диске и подтверждает, что это именно файл, а не каталог.
  - `checkUrlAsRealFile()` — определяет, указывает ли входящий URL-адрес на существующий статический файл (для отдачи ассетов и медиа в обход роутинга страниц).
  - `contentFile()` — считывает сырое исходное содержимое файла целиком с диска.
  - `copyDir()` — выполняет рекурсивное копирование директории со всей вложенной структурой папок и файлов.
  - `copyFile()` — безопасно копирует одиночный файл с автоматическим созданием целевого каталога при его отсутствии.
  - `deleteDir()` — выполняет полное рекурсивное удаление директории со всем содержимым.
  - `dirToArray()` — рекурсивно сканирует директорию и возвращает иерархический многомерный массив структуры папок и файлов.
  - `dirToArrayFlat()` — сканирует директорию и возвращает плоский одномерный список абсолютных путей ко всем файлам.
  - `dirToArrayFlat2()` — плоское сканирование файлов с формированием массива относительных путей для удобного сопоставления и индексации.
  - `findFile()` — ищет файл по цепочке переданных каталогов и возвращает первое совпадение (базовый механизм движка для приоритета переопределений `service/my/` над `templates/`).
  - `findFilesFromDirs()` — агрегирует файлы сразу из нескольких директорий с учетом каскада приоритетов переопределения.
  - `getContentFile()` — считывает контентную часть страницы Albireo CMS, автоматически отсекая служебный блок метаданных (`/ ** ... ** /`).
  - `getExtension()` — извлекает расширение файла в нижнем регистре без точки.
  - `getSafePath()` — нормализует путь к файлу и блокирует попытки выхода за пределы разрешенного базового каталога (защита от Path Traversal).
  - `getSubDirs()` — возвращает плоский список названий непосредственных подкаталогов первого уровня в указанной папке.
  - `isPathTraversal()` — валидирует строку пути на наличие попыток несанкционированного обхода каталогов (`../`, нулевые байты).
  - `moveFile()` — перемещает или переименовывает файл с созданием необходимой структуры целевой папки.
  - `requireSafe()` — безопасно подключает PHP-файл (компоненты шаблона, модули, сниппеты) только при его физическом наличии, предотвращая фатальный сбой скрипта при отсутствии файла.
  (Сигнатуры аргументов, возвращаемые типы и примеры вызовов функций см. на странице)

- [Функции пользователей в Albireo CMS](https://maxsite.org/albireo/core/user)
  **Назначение и краткий справочник функций группы user (аутентификация, проверка уровней доступа и разграничение контента):**
  - `checkUserAccess()` — проверяет наличие у пользователя хотя бы одного из требуемых уровней доступа (роль `admin` всегда обладает полными правами).
  - `findUser()` — выполняет поиск учетной записи пользователя по логину или email среди статических пользователей (`users.php`) и в базе зарегистрированных аккаунтов.
  - `getUser()` — возвращает полный профиль текущего авторизованного пользователя либо значение конкретного поля (логин, ник, массив уровней доступа).
  - `loginUser()` — аутентифицирует пользователя по паролю (сверка с хэшем через `password_verify`), инициализирует сессию и устанавливает защищенные cookies авторизации.
  - `logoutUser()` — безопасно завершает сеанс пользователя, очищает сессионные токены и удаляет cookies входа.
  - `noUserAccess()` — проверяет права текущего посетителя и выводит уведомление об ограничении прав (идеально для скрытия фрагментов текста, платных блоков или пейволлов).
  - `noUserAccessFull()` — выполняет полную жесткую блокировку всей страницы с отправкой HTTP-статуса 403 и прекращением дальнейшего рендеринга при отсутствии необходимых прав.
  (Сигнатуры аргументов, возвращаемые типы и примеры вызовов функций см. на странице)

- [Основы Albireo CMS](https://maxsite.org/albireo/core/base)
  **Архитектура системного ядра, упаковка в PHAR, внутреннее разделение функций и классов, а также модель Flat-File с базой SQLite:**
  - Полная изоляция ядра: системное ядро (`system`) физически и логически отделено от пользовательского пространства (`website`) и не требует никаких правок со стороны разработчика.
  - Поставка в формате PHAR: ядро упаковано в компактный системный phar-архив вместо сотен отдельных PHP-файлов, что снижает дисковый объем ядра всего до 100–200 Кб и ускоряет файловый ввод-вывод.
  - Внутренняя структура ядра:
    - `function` — процедурная часть, содержащая все вспомогательные функции движка;
    - `psr4` — объектно-ориентированная часть с поддержкой стандарта автозагрузки классов PSR-4;
    - системные конфигурации `config`, языковые пакеты `langs`, базовые `widgets`, служебные скрипты установки `install` и входной системный загрузчик `loader.php`.
  - Преимущества изоляции: процедура обновления сводится к простой замене каталога `system`, а одно неизменяемое ядро может параллельно обслуживать неограниченное число независимых сайтов в рамках мультисайтинга.
  - Идеология Flat-File: все статические данные и страницы хранятся в обычных нативных PHP-файлах без использования специфических или проприетарных форматов данных.
  - Хранение динамики в SQLite: для любых изменяемых динамических данных (комментарии, сессии, логи, счетчики) применяется встроенная файловая СУБД SQLite; все базы данных системы централизованно располагаются строго по единому пути `website/service/storage`.
  (Схему модулей ядра, устройство загрузчика loader.php и правила автозагрузки PSR-4 см. на странице)

- [Функции cookies в Albireo CMS](https://maxsite.org/albireo/core/cookies)
  **Назначение и краткий справочник функций группы cookies (управление куками, безопасность, шифрование и защита от частых отправок):**
  - `cookieFlash()` — универсальный хелпер (геттер/сеттер) для работы с одноразовыми флеш-куками: устанавливает значение или считывает его с немедленным удалением.
  - `cookieFlashGet()` — получает значение флеш-куки с гарантированным последующим удалением из браузера.
  - `cookieFlashSet()` — сохраняет кратковременное flash-сообщение в cookie до следующего запроса.
  - `cookieName()` — генерирует системное имя cookie с добавлением уникального хэш-префикса сайта для изоляции от других проектов на том же домене.
  - `cookieOld()` — возвращает сохраненное предыдущее значение поля (например, для восстановления введенных данных в формах).
  - `myDeleteCookie()` — безопасно удаляет указанную cookie из браузера и очищает её значение в массиве `$_COOKIE`.
  - `myExtendCookie()` — продлевает срок действия существующей cookie на заданное количество секунд без перезаписи её содержимого.
  - `myGetCookie()` — безопасно считывает cookie по системному псевдониму с автоматической подстановкой префикса имени и опциональной расшифровкой.
  - `mySetCookie()` — устанавливает cookie с безопасными параметрами по умолчанию (флаги `httponly`, `samesite=Lax`, автоопределение `secure` для HTTPS) и поддержкой шифрования данных.
  - `sentLastCookie()` — проверяет интервал времени между действиями пользователя (rate limiting) для защиты форм и AJAX-обработчиков от спама и повторных отправок.
  (Сигнатуры аргументов, возвращаемые типы и примеры вызовов функций см. на странице)

- [Функции изображений в Albireo CMS](https://maxsite.org/albireo/core/img)
  **Назначение и краткий справочник функций группы img (обработка изображений, генерация WebP, миниатюры и плейсхолдеры):**
  - `convertToWebp()` — выполняет пакетную конвертацию изображений указанного каталога в формат WebP с кэшированием, сохранением исходных имен файлов и возвратом массива URL.
  - `createImageText()` — динамически генерирует WebP-изображения (обложки, баннеры, Open Graph карточки) наложением многострочного текста и тени через TTF-шрифт на фоновый шаблон.
  - `hIMG()` — формирует HTML-тег `<img>` с безопасным XSS-экранированием, поддержкой сокращений атрибутов (`w`, `h`, `alt/title`, `auto`), разрешением плейсхолдеров и опциональной оберткой в ссылку `<a>`.
  - `hIMG_src()` — преобразует сокращенные префиксы (`//`), системные константы (`@UPLOADS_URL@`) и метаданные страницы (`[images-dir]`) в полный валидный URL-адрес изображения.
  - `hThumb()` — комплексное создание и дисковое кэширование миниатюр «на лету» (пропорционально или с обрезкой по центру), поддержка форматов (по умолчанию WebP), вывод тега или чистого URL (`urlOnly`), интеграция с лайтбоксами.
  - `imgHolder()` — генерирует легковесные векторные placeholder-заглушки в формате Base64 SVG прямо в коде (с поддержкой размеров, цвета и автоматическим подбором контрастности текста).
  - `parseImageSize()` — парсит произвольные строки размеров (`800x600`, `1024 x 768`, `1920-1080`) в стандартизированный числовой массив ширины и высоты.
  (Сигнатуры аргументов, возвращаемые типы и примеры вызовов функций см. на странице)

- [Получение записей в Albireo CMS](https://maxsite.org/albireo/core/getpages)
  **Выборка страниц через нативный SQL к SQLite-таблице file_info, параметры getPages(), JSON-поля и расширение схемы:**
  - Архитектурная суть: несмотря на статус Flat-File CMS, система не сканирует файлы при запросах, а кэширует метаданные всех страниц в SQLite-таблицу `file_info` (`service/storage/filesinfo.sqlite`). Это позволяет выполнять выборки записей полноценными SQL-запросами с минимальной нагрузкой на сервер.
  - Возвращаемая структура `getPages()`: функция возвращает ассоциативный массив строго из двух ключей — `files` (массив данных полученных записей для TPL-шаблонизатора) и `pagination` (данные для шаблона пагинации).
  - SQL-параметры функции `getPages()`:
    - `limit` — число записей (0 для получения всех);
    - `where` — фрагмент SQL-условия WHERE с плейсхолдерами;
    - `order` — SQL-выражение сортировки (например, `subdirs ASC, file ASC, date_unix DESC`);
    - `bindValue` — массив именованных плейсхолдеров PDO для безопасной подстановки параметров;
    - `sqlResult` — булев флаг (при `true` возвращает сырые данные выборки без построения полного контекста);
    - `selectFields` — переопределение выбираемых полей (по умолчанию выбираются только обязательные `file, info`, но можно дописать, например, `file_mtime`).
  - Устройство таблицы `file_info` и разрешение конфликтов:
    - таблица хранит только индексируемые поля: `file`, `slug`, `slug_pattern`, `date_unix`, `date_pub_unix`, `date`, `type`, `draft`, `rss`, `sitemap`, `favorite`, `title`, `header`, `subdirs`, `image_large`, `page_url`, `doc_menu_path`, `file_mtime`, `frozen`, `info`;
    - поля-флаги хранятся как числа `1` или `0`;
    - из-за зарезервированных слов SQL имена некоторых полей изменены: поле `order` хранится как `_order`, а `group` как `_group`.
  - JSON-хранение меток и рубрик: поля `tags` и `category` упакованы в JSON-формате; для SQL-выборки по ним используются функции SQLite `json_valid()` и `json_each()` с генерацией плейсхолдеров через `PdoQuery::buildNamedPlaceholders` (для типовых задач предусмотрены готовые обертки `tagGetPages()` и `categoryGetPages()`).
  - Доступ к полям и массив `_rows_result`:
    - в стандартном режиме `getPages()` подгружает все поля страницы, делая их доступными через функцию `getPageData()`;
    - сырые SQL-поля из `selectFields` складываются в специальный подмассив `$data['_rows_result']` (но недоступны через `getPageData()`).
  - Добавление своих полей в `file_info`: выполняется через конфиг `file-info-fields.php` (задаются имя поля, ключ в базе `my_*`, тип SQL, значение по умолчанию и callback-обработчик) с последующим перестроением кэша. Добавлять поля в базу имеет смысл исключительно тогда, когда по ним требуется прямая SQL-выборка.
  (Примеры формирования SQL-запросов, конфигурацию file-info-fields.php и синтаксис json_each см. на странице)

- [Функции Albireo CMS](https://maxsite.org/albireo/core/functions)
  **Справочник системных процедурных функций ядра Albireo CMS, сгруппированный по функциональным модулям:**
  - `array` (массивы): `arrayCondition`, `arrayFindPrevNext`, `arrayFormat`, `arrayNatSort`, `arrayPagination`, `arrayReplaceKeys`, `arraySearchKeys`, `arraySortKeys`, `arrayToStrHTML`, `arrayValidate`, `checkArrVal`, `choiceKey`, `choiceKeyStr`, `isFlatArray`, `searchInArray`, `sortArray`.
  - `category` (рубрики): `categoryGetAll`, `categoryGetPages`, `categoryLinks`, `categoryList`, `categoryPagesPrompts_handler`, `categoryTitleTriggers`.
  - `cookies` (куки): `cookieFlash`, `cookieFlashGet`, `cookieFlashSet`, `cookieName`, `cookieOld`, `myDeleteCookie`, `myExtendCookie`, `myGetCookie`, `mySetCookie`, `sentLastCookie`.
  - `debug` (отладка): `ajaxTest_handler`, `alert`, `debug`, `debugAdd`, `debugBenchmarkEnd`, `debugBenchmarkOut`, `debugBenchmarkStart`, `debugPanel`, `debugTrace`, `pr`, `prMakeStr`, `saveLogFile`.
  - `encode` (шифрование и кодирование): `decodeURL64`, `encodeURL64`, `encryptDecrypt`.
  - `ext` (расширения и интерфейсы): `addClassmap`, `ajaxURL`, `comments`, `extractDomain`, `extras`, `fieldsParse`, `formHandler`, `gdprDialog`, `isAjax`, `mail64`, `module`, `nextPrev`, `nextPrevCategory`, `normalizeFilesArray`, `promptsInfo`, `snippet`, `statCountPage`, `stopWords`, `templateModules`, `textsimple`, `widgetRun`, `widgets`.
  - `file` (файловая система): `checkRealFile`, `checkUrlAsRealFile`, `contentFile`, `copyDir`, `copyFile`, `deleteDir`, `dirToArray`, `dirToArrayFlat`, `dirToArrayFlat2`, `findFile`, `findFilesFromDirs`, `getContentFile`, `getExtension`, `getSafePath`, `getSubDirs`, `isPathTraversal`, `moveFile`, `requireSafe`.
  - `get` (получение данных и конфигурации): `getConfig`, `getConfigFile`, `getDB`, `getKeysPageData`, `getPageData`, `getPageDataChoice`, `getPages`, `getPagination`.
  - `img` (изображения): `convertToWebp`, `createImageText`, `hIMG`, `hIMG_src`, `hThumb`, `imgHolder`, `parseImageSize`.
  - `lang` (локализация и переводы): `detectUserLang`, `lang`, `langFile`, `langText`.
  - `menu` (навигационные меню): `menu1`, `menuDoc`.
  - `session` (сессии): `sentLast`, `session`, `sessionFlashGet`, `sessionFlashSet`, `sessionOld`.
  - `storage` (внутреннее хранилище): `delVal`, `getVal`, `setVal`, `storage`.
  - `string` (строковые операции): `checkStr`, `convertDate`, `hex2RGB`, `humanFilesize`, `implodeWrap`, `isValidEmoji`, `isValidUrl`, `mb_ucfirst`, `plur`, `strCropWord`, `strExplode`, `strFirstDotClean`, `strFormat`, `strRemoveLF`, `strToSlug`, `strUcFirst`.
  - `tag` (метки): `tagGetAll`, `tagGetPages`, `tagLinks`.
  - `tpl` (шаблонизатор): `tpl`, `tplContent`.
  - `user` (пользователи и права доступа): `checkUserAccess`, `findUser`, `getUser`, `loginUser`, `logoutUser`, `noUserAccess`, `noUserAccessFull`.
  (Подробные сигнатуры, параметры и примеры использования см. на соответствующих страницах разделов)

- [Функции меню в Albireo CMS](https://maxsite.org/albireo/core/menu)
  **Назначение и краткий справочник функций группы menu (построение навигационных меню и оглавлений документации):**
  - `menu1()` — генерирует HTML-разметку адаптивного навигационного меню сайта (из конфига `menus.php` или массива) с поддержкой вложенных выпадающих списков и автоопределением активного пункта по текущему URL.
  - `menuDoc()` — строит многоуровневое боковое меню документации на основе служебных полей страниц (`doc.menu.path`, `doc.menu.title`), автоматически группируя разделы по иерархии и подсвечивая текущую статью базы знаний.
  (Сигнатуры аргументов, возвращаемые типы и примеры вызовов функций см. на странице)

- [Функции перевода в Albireo CMS](https://maxsite.org/albireo/core/lang)
  **Назначение и краткий справочник функций группы lang (локализация, определение языка, словари и мультиязычный контент):**
  - `detectUserLang()` — определяет двухсимвольный код языка посетителя по HTTP-заголовкам браузера с учетом весовых коэффициентов приоритета (q-фактор), списка разрешенных языков и резервного языка по умолчанию.
  - `lang()` — переводит интерфейсные фразы по строковому ключу из словарей (каталог `config/langs/`), поддерживает замену плейсхолдеров значениями и логирует отсутствующие переводы в отладочную панель.
  - `langFile()` — находит и возвращает путь к контекстному файлу страницы под текущий язык по схеме именования `файл@lang-КОД.php` с автоматическим возвратом к базовому файлу при отсутствии перевода.
  - `langText()` — выполняет быстрый inline-перевод текста без внешних файлов словарей, выбирая вариант фразы по порядку языков, заданному в служебном поле страницы `lang`.
  (Сигнатуры аргументов, возвращаемые типы и примеры вызовов функций см. на странице)

- [Функции данных в Albireo CMS](https://maxsite.org/albireo/core/get)
  **Назначение и краткий справочник функций группы get (получение конфигураций, метаданных страниц, баз данных и пагинации):**
  - `getConfig()` — считывает значение параметра из глобальной конфигурации сайта (`config.php`) либо возвращает весь конфигурационный массив.
  - `getConfigFile()` — безопасно загружает и возвращает массив настроек из отдельного конфигурационного файла каталога `CONFIG_DIR`.
  - `getDB()` — возвращает экземпляр подключения PDO к базе данных (SQLite) по псевдониму (алиасу) из файла конфигурации баз.
  - `getKeysPageData()` — извлекает ассоциативный массив полей текущей записи по префиксу (например, все мета-теги Open Graph или ключи вида `поле[ключ]`).
  - `getPageData()` — возвращает значение конкретного служебного поля текущей страницы либо полный массив всех распарсенных метаданных.
  - `getPageDataChoice()` — последовательно проверяет список переданных полей страницы и возвращает значение первого найденного непустого ключа.
  - `getPages()` — выполняет оптимизированную SQL-выборку записей из SQLite-таблицы кэша метаданных `file_info` с фильтрацией, сортировкой и структурой пагинации.
  - `getPagination()` — рассчитывает параметры постраничной навигации (смещения, общее число страниц, лимиты и текущую позицию) для передачи в TPL-шаблон пагинации.
  (Сигнатуры аргументов, возвращаемые типы и примеры вызовов функций см. на странице)

- [Функции хранилища в Albireo CMS](https://maxsite.org/albireo/core/storage)
  **Назначение и краткий справочник функций группы storage (оперативное key-value хранилище данных в памяти):**
  - `delVal()` — удаляет указанный ключ и его значение из оперативного хранилища текущего запроса.
  - `getVal()` — безопасно считывает сохраненное значение по ключу с возможностью возврата значения по умолчанию при отсутствии ключа.
  - `setVal()` — сохраняет значение под указанным ключом в оперативной памяти для передачи между страницами, шаблонами, сетками и модулями.
  - `storage()` — базовая универсальная функция управления хранилищем: возвращает весь массив данных при вызове без аргументов либо работает как прямой геттер/сеттер.
  (Сигнатуры аргументов, возвращаемые типы и примеры вызовов функций см. на странице)

- [Функции шифрования в Albireo CMS](https://maxsite.org/albireo/core/encode)
  **Назначение и краткий справочник функций группы encode:**
  - `decodeURL64()` — декодирует URL-безопасную строку Base64 обратно в исходные данные.
  - `encodeURL64()` — кодирует строку в модифицированный вариант Base64, адаптированный для безопасной передачи в веб-адресах (URL) и GET-параметрах без экранирования.
  - `encryptDecrypt()` — выполняет двустороннее симметричное шифрование или дешифрование данных алгоритмом OpenSSL (AES-256-GCM) с использованием системного или пользовательского ключа.
  (Сигнатуры аргументов, возвращаемые типы и примеры вызовов функций см. на странице)

- [Алгоритмы работы Albireo CMS](https://maxsite.org/albireo/core/algorithm)
  **Жизненный цикл HTTP-запроса, внутренняя индексация полей, механизм маршрутизации и пайплайн рендеринга:**
  - Проблема классических Flat-File CMS: традиционные движки при каждом запросе сканируют каталоги и парсят заголовки файлов заново, из-за чего начинают резко терять производительность уже при 500–1000 страницах.
  - Архитектурное решение Albireo CMS: система использует высокопроизводительный внутренний кэш, хранящий разобранные служебные поля и пути к файлам. Кэш не перестраивается на каждый просмотр, а обновляется только при модификации/добавлении контента или явном сбросе.
  - Оптимизация больших объемов («заморозка»): механизм замороженных файлов и каталогов (префикс `!` или статус frozen) полностью исключает старые массивы записей из повторной индексации при обновлении сайта, что позволяет системе легко обслуживать 10 000–20 000+ страниц.
  - Этапы обработки запроса:
    1. *Инициализация (`index.php`)* — определение базовых путей, имени фронт-каталога и подключение загрузчика ядра (`loader.php` из PHAR);
    2. *Инициализация окружения* — регистрация автозагрузчика функций и PSR-4 классов, считывание файлов конфигурации;
    3. *Маршрутизация (Routing)* — мгновенное сопоставление входящего URL со списком адресов (`slug`) и регулярных выражений (`slug-pattern`) по готовому индексу в оперативной памяти без опроса файловой системы;
    4. *Контекст и контроль доступа* — загрузка служебных полей найденной записи в состояние страницы (`getPageData`), проверка прав доступа по уровню пользователя (`user-level`);
    5. *Передача управления в Layout* — ядро передает исполнение модульной сетке, которая через нативный `require` подключает целевой PHP-файл страницы;
    6. *Парсинг и отдача* — обработка контента выбранным парсером (TextSimple) с динамическим выполнением PHP-вставок, опциональная минификация HTML и финальный вывод клиенту (за 0.02–0.08 с при потреблении 0.5–0.8 Мб памяти).
  (Схему вызовов ядра, структуру индексного кэша и этапы загрузки компонентов см. на странице)

- [Функции рубрик в Albireo CMS](https://maxsite.org/albireo/core/category)
  **Назначение и краткий справочник функций группы category (таксономия, SQL-выборка по категориям и вывод ссылок):**
  - `categoryGetAll()` — возвращает полный список всех используемых на сайте рубрик с агрегацией и подсчетом количества записей в каждой из них.
  - `categoryGetPages()` — выполняет оптимизированную SQL-выборку страниц для указанной рубрики (поиск внутри JSON-поля базы данных SQLite с пагинацией и сортировкой).
  - `categoryLinks()` — генерирует готовую HTML-строку кликабельных ссылок на архивы рубрик из переданной строки или массива категорий текущей записи.
  - `categoryList()` — формирует иерархический список или меню рубрик (для виджетов и навигационных блоков) с учетом настроек порядка и счетчиков публикаций.
  - `categoryPagesPrompts_handler()` — специализированный сервисный обработчик для выборки и фильтрации записей в разделе библиотеки AI-промптов.
  - `categoryTitleTriggers()` — обрабатывает и возвращает динамические заголовки, вступительные тексты и триггеры для рубрики из файла конфигурации `category.php`.
  (Сигнатуры аргументов, возвращаемые типы и примеры вызовов функций см. на странице)

- [Константы Albireo CMS](https://maxsite.org/albireo/core/constants)
  **Порядок инициализации и переопределения системных констант, группы путей и встроенные токены безопасности:**
  - Точки и порядок переопределения (в каталоге `website/`):
    - `constants.php` — самое раннее определение констант до старта ядра;
    - `base-constants.php` — определение констант перед основными системными (рекомендуемый способ для пользовательских флагов вроде отладки);
    - `myconstants.php` — самое позднее определение, где уже вычислены и доступны все остальные константы системы.
  - Стандарт форматирования путей: во всех файловых путях и константах на любых ОС (включая Windows) строго используется закрывающий Linux-слэш `/`.
  - Принцип использования: функции движка требуют абсолютных путей, поэтому хардкод путей запрещен — адреса компонентов всегда конкатенируются из констант (например, `TEMPLATE_PARTS_DIR . 'head/rss.php'`, `TPL_DIR . 'shorts.php'`).
  - Базовые и сетевые константы:
    - физический корень `BASE_DIR`, системное ядро `SYS_DIR`, имя рабочего каталога `FRONT_NAME` (из `index.php`), флаг корня `RUN_IS_ROOT`, таймстемп старта `TIME_START`;
    - сетевые адреса и хосты: `SITE_URL`, `SITE_HOST`, `SERVER_HOST`, `FRONT_URL`, `FRONT_URL_NAME`, а также пути и адреса уровнем выше `LEVEL_UP_DIR` и `LEVEL_UP_URL`.
  - Пути к ресурсам и контенту (парные DIR/URL): страницы (`PAGES_DIR`/`PAGES_URL`), шаблоны (`TEMPLATES_DIR`/`TEMPLATES_URL`), сервис (`SERVICE_DIR`/`SERVICE_URL`), общие ресурсы (`RESOURCES_DIR`/`RESOURCES_URL`), загрузки (`UPLOADS_DIR`/`UPLOADS_URL`).
  - Внутренние каталоги активного шаблона: директория шаблона (`TEMPLATE_DIR`/`TEMPLATE_URL`), ассеты (`ASSETS_DIR`/`ASSETS_URL`), модули `TEMPLATE_MODULES_DIR`, сетки `TEMPLATE_LAYOUT_DIR`, секции разметки `TEMPLATE_PARTS_DIR`, шаблонизатор `TPL_DIR`, сниппеты `TEMPLATE_SNIPPETS_DIR`, блоки `EXTRAS_DIR`.
  - Пользовательские переопределения и сервисы: каталог `SERVICE_MY_DIR`/`SERVICE_MY_URL` (меняется через опцию `serviceMyDir`), папки `CACHE_DIR`, `BACKUP_DIR`, `STORAGE_DIR` (базы SQLite), `CONFIG_DIR`, `SNIPPETS_DIR`, `WIDGETS_DIR`, `WIDGETS_DIR_SITE`, вендоры `COMPOSER_DIR` (`vendor`).
  - Админ-панель и окружение: константы админки (`ALBIREO_ADMIN_NAME`, `ALBIREO_ADMIN_URL`, `ALBIREO_ADMIN_DIR`, ссылка редактирования `ALBIREO_ADMIN_LINK_EDIT_FILE`), маркер легальности копии `LIC_LEGAL_COPY`, переменные AJAX (`REQUEST_AJAX`, `METHOD_AJAX`), флаг локального сервера `LOCALHOST`, спецсимволы `LF` (`\n`), `APOS` (`'`), `BSOL` (`\`).
  - Защищенные токены безопасности (OpenSSL):
    - `CSRF` — готовый HTML-тег `<input>` со всеми необходимыми скрытыми токенами для вставки в формы;
    - `SESSION_TOKEN` — зашифрованный токен сессии;
    - `SESSION_TOKEN_SOURCE` — шифрует исходную страницу отправки (в обработчике раскрывается в константу `TOKEN_SOURCE` с URL);
    - `SESSION_TOKEN_TIME` — шифрует метку времени (в обработчике раскрывается в число `TOKEN_TIME` с количеством прошедших секунд для защиты от ботов и повторов);
    - `SESSION_TOKEN_CRYPT` — случайный сессионный ключ для функции `encryptDecrypt()`.
  (Полную таблицу дефолтных значений констант и примеры условий см. на странице)

- [Функции сессий в Albireo CMS](https://maxsite.org/albireo/core/session)
  **Назначение и краткий справочник функций группы session (серверные сессии, флеш-сообщения и защита от спама):**
  - `sentLast()` — отслеживает интервал между действиями пользователя через данные сессии (rate limiting), предотвращая частые повторные отправки форм и спам-запросы в обработчиках.
  - `session()` — универсальный хелпер управления серверной сессией: считывает всю сессию, получает значение по ключу, сохраняет новые данные или удаляет указанную переменную.
  - `sessionFlashGet()` — извлекает одноразовое flash-сообщение из сессии с его автоматическим удалением сразу после чтения (для уведомлений после редиректов).
  - `sessionFlashSet()` — сохраняет временное flash-уведомление в сессию для его однократного показа на следующей загруженной странице.
  - `sessionOld()` — возвращает ранее введенные пользователем данные формы из сессии для восстановления значений в полях ввода при ошибках валидации.
  (Сигнатуры аргументов, возвращаемые типы и примеры вызовов функций см. на странице)