Albireo CMS 2025.06.08

Конфигурация сайта

Вся конфигурация выполняется через php-файлы, которые содержат массив данных. По умолчанию каталог website/config не содержит основных файлов конфигурации, поскольку используются дефолтные значения в system/config.

Albireo CMS когда получает данные из конфигурации, проверит существование этого файла в website/config и если его там нет, то использует файл из system/config. Всё это происходит автоматически.

Для того, чтобы изменить конфигурацию, следует скопировать файл из system/config в website/config и менять файл уже в каталоге сайта.

Никогда не меняйте файлы в system/config!

Файл config.php

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

Например, для изменения названия сайта используется ключ массива siteTitle. Поэтому в файле website/config/config.php достаточно указать только этот ключ:

return [
    // может использоваться в RSS и разных модулях
    'siteTitle' => 'Мой первый сайт на Albireo CMS', // заголовок/название сайта
};

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

return [
    // может использоваться в RSS и разных модулях
    'siteTitle' => 'Website on Albireo CMS', // заголовок/название сайта
    'siteDescription' => 'The best site', // описание сайта
    
    'siteYearCreation' => '2020', // год создания сайта - используется в подвалах и т.п.
    
    // секретна фраза - «соль» для шифрования данных
    // лучше задать явно '1234567890abcd!@#$%^&*()_+-=[],.?<>'
    'secretKey' => (LOCALHOST ? '' : md5(SITE_URL)), 
    
    // email
    // адрес админа, на который можно отправлять письма из форм
    'emailAdmin' => 'my@gmail.com', 
    
    // адрес, на который можно отправлять письма при комментировании
    'emailComments' => 'my@gmail.com', 
    
    // адрес From с которого якобы идёт отправка, должен указывать на домен сайта
    'emailFrom' => '{{Website on Albireo CMS}} <no-reply@site.com>', 
    
    // шаблон заголовка письма о новом комментарии @pagetitle заменится на название записи
    'emailCommentSubjectPattern' => '[Website on Albireo CMS] New comment on «@pagetitle»', 
    
    // временная поправка относительно времени сервера в секундах
    'timeshift' => 0, 
    
    // файл/модуль вывода главной / каталог шаблон/modules/*
    'homeOutputModule' => 'home/home1.php',

    // количество записей на одной странице пагинации — может использоваться в модуле вывода
    // короткий вывод
    'homeLimitPagination1' => 7, 
    
    // длинный вывод
    'homeLimitPagination2' => 10, 
];

Файл page-data.php

Файл содержит поля по умолчанию для каждой записи. То есть система возьмет вначале эти дефолтные поля, а потом добавит те, которые указаны непосредственно в файле записи. Отличие полей в здесь в том, что это php-код, поэтому нужно писать по правилам PHP. В большинстве случаев это обычные строки.

Посмотрите файл system/config/page-data.php чтобы понять какие поля используются для записей по умолчанию. Если их нужно переопределить, то сделайте это в website/config/page-data.php.

Например если нужно отключить сбор статистики, то это можно сделать так:

'stat' => 0,
'stat.page' => 0,

Это будет эквивалентно полям страницы:

stat: -
stat.page: -

Поля в page-data.php задают поведение и вид сайта по умолчанию и их действие распространяется на все страницы сайта. Это позволяет задавать параметры сайта только в конфигурационном файле, не описывая каждое поле в теле страницы. Например, если нужно сменить шапку и подвал для всего сайта, то это делается в конфигурации page-data.php:

// файлы шапки
'headers' => 'headers/header2.php', 

// файлы подвала
'footers' => 'footers/footer2.php', 

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

headers: headers/header1.php
footers: footers/footer1.php

Файл admin.php

Этот файл используется для настройки админ-панели. Скорее всего у вас не будет особой потребности менять этот файл, поскольку он уже настроен под большинство задач.

Другие файлы конфигураций

Остальные файлы конфигурации, если их нужно изменить, следует копировать в каталог сайта целиком. То есть в отличие от config.php, page-data.php и admin.php эти файлы читаются как есть и не объединяются с файлами из system.

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

Файл dbase.php

Файл хранит конфигурацию баз данных SQLite. Скорее всего вам никогда не нужно будет его менять.

Файлы doc1.php и doc2.php

Эти файлы используются для конфигурации шаблонов документации. Эти шаблоны — их layout-файлы могут гибко настраиваться под разные задачи. В системе есть два layout-файла и doc1.php и doc2.php — это их настройки. Файлы не обязательно использовать именно эти, поскольку их имена произвольны и вы сможете придумать своё название и свои настройки.

Файл users.php

Здесь хранятся пользователи сайта. Их логины, ники, хэш пароля, уровни доступа и время действия учетной записи. Если вы хотите работать c Albireo CMS через админ-панель, то скопируйте этот файл в каталог сайта и укажите в нём логин и хэш-пароль. После этого вы сможете войти в админ-панель.

Файл menu1.php

Этот файл используется в некоторых компонентах шапки.

Файл widgets.php

Виджеты это блоки в боковой колонке сайта (сайдбары, sidebar). Использование виджетов напрямую зависит от используемого layout-файла. Если шаблон без сайдбара, то виджеты не выводятся. Каждый виджет имеет свои особенные настройки.

Файл category.php

Этот файл хранит описание рубрик сайта. В Albireo CMS рубрики можно задавать как в свободном виде, так и заранее их предопределить. Можно указать названия, описания, а также html-блоки для оформления страниц рубрики.

Файлы links-footer.php, links-project.php и links-social.php

Здесь указываются ссылки для подвала, но их отображение зависит только от самого подвала.