Albireo CMS 2025.01.17

Сниппеты в Albireo CMS

Сниппеты — это короткие фрагменты кода, которые, как правило, выводятся как есть. Например код счётчика Google лучше оформить как сниппет.

Сниппеты могут иметь два расположения.

Если сниппет не привязан к css-классам шаблона, то его лучше разместить в каталоге website/snippets. Если же сниппет имеет какую-то привязку к шаблону, то его нужно разместить в каталоге шаблона snippets.

По умолчанию в Albireo CMS есть два сниппета в каталоге сайта:

  • counter.php — здесь размещается счетчик Google и этот сниппет автоматически подключается в HEAD.
  • favicon.php— здесь код фавиконки сайта, который можно сгенерировать на сайте realfavicongenerator.net, он тоже подключается автоматически в HEAD.

Сниппеты в каталоге шаблона имеют привязку к css-классам. Есть два готовых сниппета, которые используются для создания навигации по статье по тэгам H2 (или другим).

  • article-navigation.php
  • article-navigation-flat.php

Чтобы использовать эти сниппеты нужно прописать в теле страницы вызов функции snippet():

<div class="article_navigation"></div>
<?= snippet('article-navigation') ?>

В сниппеты можно передавать данные, которые указываются как дополнительные аргументы функции (до 4-х). Они будут доступны в файле сниппета, как переменные $DATA, $DATA1, $DATA2, $DATA3.

Создайте сниппет test.php:

pr($DATA, $DATA1, $DATA2, $DATA3);

После этого в теле страницы пропишите разные вызовы этого сниппета:

<?= snippet('test', 'arg', 'arg1', 'arg2', 'arg3') ?>

Вы увидите отладочную информацию, которая была передана через аргументы функции.

Используйте сниппеты там, где нужно создать вывод блока в теле страницы.