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

Вся конфигурация выполняется через 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', // адрес, на который можно отправлять письма при комментировании
    'emailFrom' => '{{Website on Albireo CMS}} <no-reply@site.com>', // адрес From с которого якобы идёт отправка, должен указывать на домен сайта
    
    'emailCommentSubjectPattern' => '[Website on Albireo CMS] New comment on «@pagetitle»', // шаблон заголовка письма о новом комментарии @pagetitle заменится на название записи
    
    // временная поправка для тех случаев, когда используется GMT https://www.php.net/manual/ru/function.strtotime.php
    'timezone' => '+3 hours', 
    
    'defaultPageData' => [
        // язык страницы по умолчанию 
        'html[lang]' => 'ru', 
        
        //  для шапки
        'headers.title' => 'Website on Albireo CMS', 
        'headers.subtitle' => 'The best site', 
        'headers.logo' => UPLOADS_URL . 'images/logo.png', 
        'headers.namesite' => 'Albireo CMS', 
        
        // Разметка Open Graph protocol https://ogp.me/
        'ogp[og:site_name]' => 'Website on Albireo CMS', // название сайта
    ],
];

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

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

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

   'stat' => 0, // включить сбор статистики посещений страницы

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

stat: 0

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

   'headers' => 'headers/header2.php', // файлы шапки
   'footers' => 'footers/footer2.php', // файлы подвала

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

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

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

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

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

Файл admin.php

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

Файл 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

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