Albireo CMS 2025.05.03

Главная страница сайта в Albireo CMS

Главная страница сайта это страница, где указано:

slug: /

Обычно это файл home.php.

Главная страница может иметь разное назначение. Она может быть лендингом и таким образом будет выводиться её текст. В случае же типового блога, главная — это архивная страница, которая выводит другие страницы.

Другие архивные страницы: метки, рубрики, карта сайта и т.п.

Для того, чтобы выводить другие записи, следует использовать php-код.

«Типовой» вариант для блога — это вывод всех записей в обратном хронологическом порядке. Для этого можно самостоятельно написать php-код получения и вывода записей, а можно воспользоваться уже готовым файлом вывода.

Для этого в файле конфигурации используйте опции:

    // файл/модуль вывода главной / каталог шаблон/modules/*
    'homeOutputModule' => 'home/home1.php', // home/home2.php

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

Файлы вывода размещаются в каталоге шаблона modules/home. Есть два готовых варианта вывода и один демо-пример для сложного вывода по рубрикам. Модульный файлы просто хранят уже готовый php-код.

Ели же нужно изменить вывод главной (да и вообще любой другой архивной страницы), то реализуется это так:

// получение записей
// сразу указывается кол-во страниц для пагинации из конфигурации
$result = getPages(limit: getConfig('homeLimitPagination1', 10));

// вывод записей происходит через tpl-файл
echo tpl(data: $result['files'], tpl: TPL_DIR . 'one-column-3.php');

// вывод пагинации
echo tpl(data: $result['pagination'], tpl: TPL_DIR . getConfig('pagination', 'pagination1.php'));

В параметре функции tpl указывается полный путь к файлу, который непосредственно выполняет вывод данных. Обычно это каталог шаблона website/templates/default/tpl. Для работы с шаблонизатором нужны начальные знания HTML и PHP.

Примеры для главной вы можете посмотреть в templates/default/modules/home.

Примеры группировок записей

За непосредственный вывод записей отвечает tpl-файл, который указывается в одноименной функции. В Albireo CMS весть файл-подсказка, который демонстрирует примеры вариантов для главной страницы (или любой другой).

Для этого наберите адрес ваш-сайт/group-samples, где последовательно выводятся блоки группировок.

Посмотреть код вставки можно в файле specific/group-samples.php.