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