Просмотр исходного текста страницы Вывод результата работы кастомного макроса для TPL

'''Актуально для 2.9'''

----

'''Задача:''' Вывести результат работы кастомного макроса в TPL-шаблоне.<br/>
'''Решение:'''

Для начала, стоит заметить, что делая вывод результатов для TPL шаблона, мы автоматически сделаем вывод и для XSLT шаблонов. <br />

Чтобы вывести результат работы макроса в TPL шаблоне, необходимо выполнить ряд условий:
1. В объявлении кастомного метода необходимо указать параметр с шаблоном по умолчанию:
<source lang="php">
public function test($template = 'default') {
</source>

2. Необходимо запустить парсер шаблона, передав ему в параметрах путь до шаблона и названия блоков, которые необходимо парсить:
<source lang="php">
list($itemsTemplate, $itemTemplate) = def_module::loadTemplates("content/" . $template, "items", "item");
</source>
[[Файл:Macros.png]]<br/>

3. Создаем шаблон в директории /templates/{название_папки}/tpls/content/default.tpl:
<source lang="php">
<?php
$FORMS = Array();

$FORMS['items'] = <<<END
%items%
END;

$FORMS['item'] = <<<END

END;
?>
</source>
Если шаблон уже сущестует, то просто добавляем в него наши блоки.

4. Создаем массив с данными
<source lang="php">
$item = array();
$item['id'] = 1;
$item['link'] = 'http://ya.ru';
</source>

5. Парсим собранные данные в нужный нам блок шаблона и записываем их в качестве элемента нового массива, так как предполагается, что данные не будут ограничиваться одной строкой:
<source lang="php">
$items[] = self::parseTemplate($itemTemplate, $item);
</source>
[[Файл:Macros2.png]]
<br/>
Заполнение массива $items обычно производиться в теле циклов for или foreach:
<source lang="php">
$items = array();
for ($i=0; $i < 3; $i++) {
	$item = array();
	$item['id'] = $i;
	$item['link'] = 'http://ya.ru';

	$items[] = self::parseTemplate($itemTemplate, $item);
}
</source>

6. Создаем массив под общий блок items и при помощи служебного ключа в массиве '''subnodes:''' указываем название ноды, в которой будут помещены собранные нами элементы с данными. Также, мы здесь можем создать отдельный блок с нужной нам информацией:
<source lang="php">
$blockItems = array();
$blockItems['subnodes:items'] = $items;
$blockItems['total'] = 3;
</source>

7. Парсим собранный массив в общий блок шаблона и возвращаем результат:
<source lang="php">
return def_module::parseTemplate($itemsTemplate, $blockItems);
</source>
Результат, который мы увидим в XML-виде:
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="custom" method="test" generation-time="0.003399">
  <items>
    <item>
      <id>0</id>
      <link>http://ya.ru</link>
    </item>
    <item>
      <id>1</id>
      <link>http://ya.ru</link>
    </item>
    <item>
      <id>2</id>
      <link>http://ya.ru</link>
    </item>
  </items>
  <total>3</total>
</udata>
</source>
Чтобы увидеть результат в TPL шаблоне, создадим страницу контента и в поле "Контент" вставим макрос: %custom test()%, а в самом шаблоне, в каждом блоке добавим макросы %scope%:<br>
[[Файл:Tplparsing.png]]<br>