Оглавление

Сниппеты — это вариант применения встроенного PHP-кода в MODx. В основном сниппеты предоставляют настраиваемый динамический контент, такой как меню, список новостей, поиск и другие функции.

Вызов сниппета

После того, как вы установили или написали нужный сниппет, вы можете вызвать его, просто поместив тег вызова в шаблон, чанк, TV или содержимое документа:

[[MySnippet]]

Если ваш сниппет будет генерировать динамические данные для разных пользователей, то сниппет нужно вызывать без кэширования:

[[!MySnippet]]

Параметры сниппета

Сниппет может быть вызван с параметрами, например:

[[pdoMenu? &parents=`0` &level=`1`]]

Вы также можете объединить эти параметры в набор свойств, которые могут быть присоединены к любому сниппету. Это позволит вам использовать общие наборы свойств в вызовах сниппета.

Скажем, у вас есть набор свойств с именем Menu, для него значение `parents` установлено — 0, а значение `level` — 1. Давайте вызовем сниппет в набором свойств Menu:

[[!pdoMenu@Menu]]

Такой вызов автоматически загрузит эти свойства в сниппет. Если вы захотите, эти свойства могут быть переопределены:

[[!pdoMenu@Menu? &level=`2`]]

В вызове выше, мы переопределяем значение параметра `level`, которое по умолчанию имеет значение 1, мы устанавливая ему значение 2. Таким образом, вы можете создавать сниппеты, с уже установленными параметрами, без необходимости прописывать их каждый раз снова и снова.

Это здорово экономит время, если вы вызываете какие-либо сниппеты с одинаковыми параметрами несколько раз. Например, таким образом можно сделать оформление шаблонов сниппетов компонента pdoTools.

Подробнее про создание собственных наборов свойств, мы поговорим в следующем разделе документации.

Установка сниппетов

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

Про написание собственных сниппетов, как и про наборы свойств, мы поговорим в следующем разделе документации.