Структура каталогов Albireo CMS

Система состоит из двух базовых каталогов и одного корневого index.php.

system/
website/
index.php

Каталог system

Каталог system содержит «ядро» системы. Файлы в этом каталоге не следует менять.

system/
    admin/
    config/
    core/
    install/
    langs/
    widgets/

    loader.php
    index.php

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

Файл loader.php загрузчик всех функций системы. Файл index.php пустая «заглушка».

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

Каталог system/install используется при первом запуске системы. В ней находятся htaccess.txt и robots.txt, которые вы можете использовать как заготовку для своих сайтов. Там же располагается подкаталог transfer с файлами для создания миграций с MaxSite CMS.

Каталог langs хранит общие для системы языковые файлы. Сейчас это английский, украинский и русские языки.

Каталог widgets содержит виджеты, которые можно использовать в шаблоне сайта: category, favorites, login, pages, tags и text_block.

Файлы .htaccess содержат директиву от прямого доступа к каталогу. Не удаляйте их, поскольку это безопасность вашего сайта.

Каталог system не следует менять.

Каталог website

Каталог website — основной рабочий каталог вашего сайта.

website/
    config/
    pages/
    service/
    templates/
    uploads/
    
    index.php

Каталог website/config используется для хранения файлов конфигураций.

В каталоге website/pages размещаются все страницы сайта.

Каталог website/service служебный каталог вашего сайта. В нём хранятся бэкапы, sqlite-базы данных, собственные php-библиотеки, файлы кэша, собственные виджеты.

Каталог website/templates содержит файлы шаблонов и их ресурсов.

Каталог website/uploads используется для загружаемых файлов, например изображений сайта.

Файл index.php — это «точка запуска» вашего сайта. Его не нужно менять, поскольку в нём выполняется основной алгоритм работы сайта.

Каталог website/service

Это служебный каталог вашего сайта.

website/
    service/
        backup/
        cache/
        events/
        functions/
        psr4/
        seeder/
        snippets/
        storage/
        widgets/
        my/

Каталог backup хранит старые удалённые файлы ваших записей.

Каталог cache — это хранилище файлового кэша.

Каталог events — это файлы с функциями для обработки сообщений системы. Сейчас в них обработчики событий статистики.

Каталог functions может содержать ваши собственные php-функции. Лучше если каждая функция будет размещаться в собственном файле, но здесь нет никаких ограничений. Все php-файлы этого каталога автоматически подключаются при старте системы. Если файл начинается с символа _, то он игнорируется.

Каталог psr4 это ваши php-классы, которые поддерживают автозагрузку PSR4.

Каталог seeder используется для миграций/seeder баз данных и/или версионных изменений системы.

В каталоге snippets можно разместить небольшие сниппеты. Например счетчик Google или код фавиконки сайта.

Каталог storage хранит файлы баз SQLite. Если файл удалить, то он будет автоматически создан заново. При удалении вы потеряете всю его информацию. Файл filesinfo.sqlite — это файл кэша Albireo CMS. При обновлении сайта можно просто его удалить, он будет построен заново.

Каталог widgets используется для собственных виджетов.

Каталог my расширяет действие текущего шаблона.

Каталог website/service/my

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

website/service/my/
    assets/
        css/
            fonts/
            themes/
        js/
    extras/
    layout/
    modules/
        footers/
        headers/
        home/
    parts/
        content/
        content-start/
        head/
        lazy/
    tpl/

Все эти каталоги повторяют структуру шаблона Default. При необходимости, можно поменять расположение my-каталога с помощью конфигурации serviceMyDir файла config.php. Это может пригодится, когда нужно сделать несколько раздельных вариантов сайта.

// каталог относительно «website»
'serviceMyDir' => 'service/templates/taurus',

Такой «my-каталог» должен повторять структуру основного website/service/my.