Albireo CMS 2025.01.17

Модификация шаблона Albireo CMS

Есть два подхода к изменению Default-шаблона Albireo CMS.

  • Первый — это создать копию Default и все изменения производить в новом шаблоне.
  • Второй подход — это использовать стандартный Default, но добавить в него свои файлы.

Создание нового шаблона

Лучше всего — это сделать копию Default и потом вносить свои изменения. Такой подход хорош тем, что можно создавать совершенно самостоятельный шаблон под свои задачи. Обратите внимание, что в Albireo CMS нет файлов, отвечающих за вывод разных типов файлов, как это происходит в других системах. Вместо этого в Albireo CMS просто указывается layout-файл, в котором и происходит вывод страницы.

Поскольку количество layout-файлов произвольно, то можно создавать их под любые страницы с любой html-разметкой под любой css-фреймворк. То есть шаблон Default — это не какая-то строгая структура каталогов, а рабочий пример универсального сайта или блога.

Расширение Default

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

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

Например, если вы хотите подключить другой css-фреймворк, то не нужно ничего менять, а достаточно разместить его css-файл в assets/css/themes. Таким образом пользователю шаблона будет доступен и Berry CSS и новый фреймворк.

Если стоит задача использовать именно Berry CSS, но поменять оформление сайта, например основную палитру цветов, то достаточно создать свой css-файл, по аналогии с assets/css/color-green.css и переопределить css-переменные Berry CSS. Либо прописать свои css-правила для нужных блоков и классов.

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

То же самое касается подключения сторонних css/js-библиотек. Создаются parts-файлы, и если нужно, то исходные файлы размещаются в каталоге ресурсов.

Для того, чтобы создать особый вывод записей, используются tpl/extras-файлы. Создавайте свои варианты вывода, не меняя стандартные файлы.

Модули — шапки и подвала делаются по тому же принципу — создание своих вариантов без изменения существующих.

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