From In-Portal Developers Guide

Revision as of 14:54, 25 December 2008

Библиотека тэгов
Статьи в этой категории
Реорганизация тэгов

На данным момент интерпретатор шаблонов (template parser) поддерживает 2 набора тэгов:

• совместимые с XML правилами
• не совместимые с XML правилами

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

<inp2:m_block name="some_elem"/>
	element content
<inp2:m_blockend/>

<inp2:m_DefineElement name="some_elem">
	element content
</inp2:m_DefineElement>

<inp2:m_if prefix="prefix" function="Tag" param1="1" param2="2"/>
	true case
<inp2:m_else/>
	false case
<inp2:m_endif/>

<inp2:m_if check="prefix_Tag" param1="1" param2="2">
	true case
<inp2:m_else/>
	false case
</inp2:m_if>

<inp2:m_ParseBlock name="..."/>

<inp2:m_RenderElement name="..."/>

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

find ./ -type f -name "*.tpl" | xargs \
sed -i -e "s/<inp2:m_blockend[^\/>]*[\/]*>/<\/inp2:m_DefineElement>/g" \
    -e "s/<inp2:m_block \(.*\)\/>/<inp2:m_DefineElement \1>/g" \
    -e "s/<inp2:m_if\(.*\)prefix=\"\(.*\)\"\(.*\)function=\"\(.*\)\"\([^\/>]*\)[\/]*>/<inp2:m_if\1check=\"\2_\4\"\3\5>/g" \
    -e "s/<inp2:m_endif[ ]*\/>/<\/inp2:m_if>/g" \
    -e "s/<inp2:m_ParseBlock\([^>]*\)>/<inp2:m_RenderElement\1>/g" \
    -e "s/\(<inp2:[^>]*\)\$PrefixSpecial_\([^\"]*\)/\1{\$PrefixSpecial}_\2/g" \
    -e "s/\(<inp2:[^>]*\)\$prefix_\([^\"]*\)/\1{\$prefix}_\2/g"

После это может потребоваться руками заменить тэги вида:

• <inp2:m_if ... /> на <inp2:m_if>
• <inp2:m_DefineElement /> на <inp2:m_DefineElement>

Для атрибутов тэгов требуется выполнять следующие преобразования:

XML совместимые тэги так-же улучшают читабельность шаблона, например:

<inp2:p_ListProducts render_as="product_elem" row_start_render_as="row_start_elem" />

Эта конструкция проста и понятна, т.к. сразу ястно что здесь происходит. А из названия тэга DefineElement понятно, что это только декларация и результат не будет виден здесь, а будет использоваться в другом месте.

As for IF we should use:

Пожалуйста начинайте пересматривать код в ваших шаблонах. Лучше не заменять название атрибутов совсем, а пользоваться следующей конструкцией:

$param_value = $this->SelectParam($params, 'new_attribute_name,old_attribute_name,other_attribute_name');

которая вернёт атрибут, только если он передан. По любым вопросам касательно этого документа обращайтесь к Косте