Вывод результата работы кастомного макроса для TPL - История изменений

Velross в 18:19, 29 июня 2013

2013-06-29T18:19:33Z

Velross в 18:16, 29 июня 2013

2013-06-29T18:16:17Z

Velross в 18:12, 29 июня 2013

2013-06-29T18:12:24Z

Velross в 18:04, 29 июня 2013

2013-06-29T18:04:25Z

Velross в 17:48, 29 июня 2013

2013-06-29T17:48:14Z

Velross в 17:32, 29 июня 2013

2013-06-29T17:32:27Z

Velross в 17:28, 29 июня 2013

2013-06-29T17:28:16Z

Velross: Новая страница: «'''Актуально для 2.9''' ---- '''Задача:''' Вывести результат работы кастомного макроса в TPL-шаблон…»

2013-06-29T17:23:38Z

Новая страница: «'''Актуально для 2.9''' ---- '''Задача:''' Вывести результат работы кастомного макроса в 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/>

@@ Строка 49: / Строка 49: @@
 [[Файл:Macros2.png]]
 <br/>
-Заполнение массива $items обычно производиться в теле циклов for или foreach:
+Заполнение массива $items обычно производится в теле циклов for или foreach:
 <source lang="php">
 $items = array();
@@ Строка 61: / Строка 61: @@
 </source>
-. Создаем массив под общий блок items и при помощи служебного ключа в массиве '''subnodes:''' указываем название ноды, в которой будут помещены собранные нами элементы с данными. Также, мы здесь можем создать отдельный блок с нужной нам информацией:
+. Создаем массив под общий блок items и при помощи служебного ключа в массиве '''subnodes:''' указываем название ноды, в которую будут помещены собранные нами элементы с данными. Также, здесь мы можем создать отдельный блок с нужной нам информацией:
 <source lang="php">
 $blockItems = array();

← Предыдущая		Версия 18:12, 29 июня 2013
Строка 95:		Строка 95:
	Чтобы увидеть результат в TPL шаблоне, создадим страницу контента и в поле "Контент" вставим макрос: %custom test()%, а в самом шаблоне, в каждом блоке добавим макросы %scope%:<br>		Чтобы увидеть результат в TPL шаблоне, создадим страницу контента и в поле "Контент" вставим макрос: %custom test()%, а в самом шаблоне, в каждом блоке добавим макросы %scope%:<br>
	[[Файл:Tplparsing.png]]<br>		[[Файл:Tplparsing.png]]<br>
		+	Если мы делаем универсальный макрос и желаем, чтобы в XML виде результат был более аккуратным, то мы можем при помощи префикса '''@''' или служебного слова '''attribute:''' сделать параметры id и link атрибутами, а чтобы передать содержимое элемента, мы можем использовать слово '''node:'''
		+	<source lang="php">
		+	$item['@id'] = $i;
		+	$item['attribute:link'] = 'http://ya.ru';
		+	$item['node:value'] = 'http://ya.ru';
		+	</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.003412">
		+	<items>
		+	<item id="0" link="http://ya.ru">http://ya.ru</item>
		+	<item id="1" link="http://ya.ru">http://ya.ru</item>
		+	<item id="2" link="http://ya.ru">http://ya.ru</item>
		+	</items>
		+	<total>3</total>
		+	</udata>
		+	<!-- This page generated in 1.12127 secs by XSLT, HTTP SCHEME MODE -->
		+	</source>
		+	[[Категория:Вопросы и уроки разработки сайтов на UMI.CMS]][[Категория:Написание кастомных макросов]]

← Предыдущая		Версия 18:04, 29 июня 2013
Строка 49:		Строка 49:
	[[Файл:Macros2.png]]		[[Файл:Macros2.png]]
	<br/>		<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>

@@ Строка 9: / Строка 9: @@
 Чтобы вывести результат работы макроса в TPL шаблоне, необходимо выполнить ряд условий:
-# В объявлении кастомного метода необходимо указать параметр с шаблоном по умолчанию:
+. В объявлении кастомного метода необходимо указать параметр с шаблоном по умолчанию:
 <source lang="php">
 public function test($template = 'default') {
 </source>
-# Необходимо запустить парсер шаблона, передав ему в параметрах путь до шаблона и названия блоков, которые необходимо парсить:
+. Необходимо запустить парсер шаблона, передав ему в параметрах путь до шаблона и названия блоков, которые необходимо парсить:
 <source lang="php">
 list($itemsTemplate, $itemTemplate) = def_module::loadTemplates("content/" . $template, "items", "item");
@@ Строка 20: / Строка 20: @@
 [[Файл:Macros.png]]<br/>
-# Создаем шаблон в директории /templates/{название_папки}/tpls/content/default.tpl:
+. Создаем шаблон в директории /templates/{название_папки}/tpls/content/default.tpl:
 <source lang="php">
 <?php
@@ Строка 36: / Строка 36: @@
 Если шаблон уже сущестует, то просто добавляем в него наши блоки.
-# Создаем массив с данными
+. Создаем массив с данными
 <source lang="php">
 $item = array();
@@ Строка 42: / Строка 42: @@
 $item['link'] = 'http://ya.ru';
 </source>

← Предыдущая		Версия 17:32, 29 июня 2013
Строка 35:		Строка 35:
	</source>		</source>
	Если шаблон уже сущестует, то просто добавляем в него наши блоки.		Если шаблон уже сущестует, то просто добавляем в него наши блоки.
		+
		+	# Создаем массив с данными
		+	<source lang="php">
		+	$item = array();
		+	$item['id'] = 1;
		+	$item['link'] = 'http://ya.ru';
		+	</source>