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