Конфигурация сайта
Вся конфигурация выполняется через 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
Здесь указываются ссылки для подвала, но их отображение зависит только от самого подвала.