MVC-2. Создание сниппета

В PHP-платформе Wad-er сниппет является объектом, отображаемым в Каталоге объектов. Для доступа к дереву сниппетов используется меню панели управления Элементы сайта – Сниппеты.

При выборе записи конкретного сниппета в правом фрейме отображается карточка сниппета, имеющая ряд вкладок – Общие, PHP-скрипт, Описание, Прочие и Лог.

В полях вкладки Общие задается;

• Код (id)* – задается пользователем или генерится автоматически;
• Название* – название сниппета (отображается в Каталоге объектов);
• Родитель – объект в дереве сниппетов, которому подчиняется данный сниппет;
• Псевдоним – может использоваться для вызова сниппета вместо Код (id)*;
• Примечание – текстовое поле;
• Вместо сниппета – выбор сниппета, вместо которого будет использоваться данный сниппет.

На вкладке php-скрипт  размещается исходный код сниппета.

На вкладке Описание приводится назначение краткое описание параметров сниппета и пример его использования.

В полях вкладки Прочие задаются:

• Аватар – указывается путь к файлу аватара сниппета;
• Модуль – привязка сниппета к модулю.

При вызове сниппета можно указать параметры, которые определят его поведение. Такие параметры всегда идут после символа "&" и передаются в виде пары "ключ='значение'". Пример вызова сниппета с параметрами приведен ниже (вызов контактной формы).

Для создания сниппета используется меню панели управления Элементы сайта – Сниппеты. В дереве сниппетов необходимо выбрать нужную ветку типа сниппета и воспользоваться опцией Добавить из контекстного меню. В появившемся окне Добавление записи необходимо заполнить ключевые поля Код (id)* и Название*.

На вкладке php-скрипт необходимо ввести код сниппета, например:

рrint "Hello World"

После нажатия кнопки Добавить, запись о новом сниппете появится в Каталоге объектов.

Теперь сниппет можно вызывать на страницах или в шаблоне следующим образом:

{ ! name_snippet ! }

Здесь name_snippet - Код (id) сниппета. Приведенная выше конструкция вставляется на вкладке Содержание карточки страницы или на вкладке Шаблон карточки шаблона.

Добавление к сниппету css-стилей и javascript-кода. В код сниппета можно добавить CSS-стили, прописав в его коде следующую строку:

$parser->addCSS("path/to/snippet/test_style.css"); 

К каждому сниппету можно добавить js-скрипты:

$parser->addJS("path/to/snippet/test.js");

Здесь $parser – объект парсера (класс PageParser), path/to/template / - путь к каталогу, где будут сохраняться файлы, связанные с сниппетом.