Конфигурация сайта
Вся конфигурация выполняется через 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 через админ-панель, то скопируйте этот файл в каталог сайта и укажите в нём логин и хэш-пароль. После этого вы сможете войти в админ-панель.
Файлы menu.php и menu-designX.php
Эти файлы используется в некоторых компонентах шапки для вывода главного меню.
Файл widgets.php
Виджеты это блоки в боковой колонке сайта (сайдбары, sidebar). Использование виджетов напрямую зависит от используемого layout-файла. Если шаблон без сайдбара, то виджеты не выводятся. Каждый виджет имеет свои особенные настройки.
Файл category.php
Этот файл хранит описание рубрик сайта. В Albireo CMS рубрики можно задавать как в свободном виде, так и заранее их предопределить. Можно указать названия, описания, а также html-блоки для оформления страниц рубрики.
Файлы links-footer.php, links-project.php и links-social.php
Здесь указываются ссылки для подвала, но их отображение зависит только от самого подвала.