Документация по макросам и шаблонам UMI.CMS

XML-ответ UData

<udata module="content" method="menu" generation-time="0.006117">
  <items>
    <item id="1" link="/" xlink:href="upage://1">Добро пожаловать</item>
    <item id="2" link="/talks/" xlink:href="upage://2">Форум</item>
    <item id="12" link="/vse_novosti/" xlink:href="upage://12">Все новости</item>
    <item id="26" link="/contacts/" xlink:href="upage://26">Обратная связь</item>
    <item id="27" link="/umicms/" xlink:href="upage://27">FAQ</item>
    <item id="33" link="/butterfly/" xlink:href="upage://33">Фотогалерея</item>
    <item id="42" link="/obychnaya_stranica/" xlink:href="upage://42">Обычная страница</item>
    <item id="43" link="/market/" xlink:href="upage://43" status="active">Каталог товаров</item>
  </items>
</udata>

Если нужно отобразить элементы вложенного подменю, следует задать параметр root_element_id, указав id элемента item, вложенные элементы которого требуется обработать.

Например так: udata://content/menu/notemplate/0/12

Тогда будет получен следующий ответ UData:

<udata module="content" method="menu" generation-time="0.007229">
  <items>
    <item id="13" link="/vse_novosti/politicheskie_novosti/"
     xlink:href="upage://13">Политические новости</item>
    <item id="19" link="/vse_novosti/novosti_ekonomiki/"
     xlink:href="upage://19">Новости экономики</item>
  </items>
  <id>12</id>
</udata>

Для того, чтобы помечать активный пункт меню, следует описать шаблон для элемента item с атрибутом status = 'active' (см. ниже пример использования).

Элементы и атрибуты

Примеры использования

Для того, чтобы вставить меню в определенное место на странице, необходимо вызвать макрос по протоколу UData. Укажем в шаблоне дизайна место вывода меню при помощи инструкции apply-templates:

<div class="page">

  <div class="left">
    <!-- вставляем результаты обработки данных макроса -->
    <xsl:apply-templates select="document('udata://content/menu/')/udata"/>
  </div>

  <div class="content">
    <!-- контент страницы -->
  </div>

</div>

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

<xsl:template match="udata[@module = 'content'][@method = 'menu']">
  <ul>
     <!--  здесь мы выведем отдельные элементы списка  -->
    <xsl:apply-templates select="items/item" mode="menu"/>
  </ul>
</xsl:template>

Теперь опишем шаблон для неактивного пункта меню:

<xsl:template match="item" mode="menu">
  <li>
    <a href="{@link}">
       <!-- выводим название страницы - содержимое item -->
      <xsl:value-of select="." />
    </a>
  </li>
</xsl:template>

И шаблон с уточняющим условием match="item[@status = 'active']" для активного пункта меню:

<xsl:template match="item[@status = 'active']" mode="menu">
  <li>
    <a href="{@link}" class="active">
       <!-- выводим название страницы - содержимое item -->
      <xsl:value-of select="." />
    </a>
  </li>
</xsl:template>

<xsl:template match="item[@status = 'active']" mode="menu">
  <li>
    <a href="{@link}" class="active">
      <xsl:value-of select="@name" />
    </a>
  </li>
</xsl:template>

Используемые шаблоны

Макрос оперирует шаблонами, находящимися в каталоге /tpls/content/menu/.

Используемые блоки шаблона

Примеры использования

Обратите внимание!
Параметр "Меню всегда развернуто" не будет действовать на указанный в примере шаблон, так как в нём не указано место для вывода списка страниц, дочерних неактивным страницам. Для того чтобы на каждой странице в меню выводились все страницы, отмеченные галочками "Отображать в меню" и "Показывать подменю" - следует вставить макрос %sub_menu% в нужные места блоков menu_line_level1, menu_line_level2, и т.д.

В шаблоне дизайна поставьте макрос %content menu('sample', 3)%.

Создайте в структуре сайта несколько вложенных страниц с произвольным содержанием.

Создайте файл sample.tpl в папке /tpls/content/menu/ следующего содержания:

<?php

$FORMS = Array();

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

 <div class="bg_header_forum">
   <div class="header_title">Рубрикатор</div>
 </div>
 <div class="background_forum">
   <ul id="left_forum">
    %lines%
   </ul>
 </div>

END;

$FORMS['menu_line_level1'] = <<<END
 <li><a href="%link%">%text%</a></li>
END;

$FORMS['menu_line_level1_a'] = <<<END
 <li><a href="%link%">%text%</a></li>
 %sub_menu%
END;


$FORMS['menu_block_level2'] = <<<END
 <ul id="submenu">
  %lines%
 </ul>
END;

$FORMS['menu_line_level2'] = <<<END
 <li><a href="%link%">%text%</a></li>
END;

$FORMS['menu_line_level2_a'] = <<<END
 <li class="active"><a href="%link%">%text%</a></li>
 %sub_menu%
END;

$FORMS['menu_block_level3'] = <<<END
 <li>
  <ul>
   %lines%
  </ul>
 </li>
END;

$FORMS['menu_line_level3'] = <<<END
 <li><a href="%link%">%text%</a></li>
END;

$FORMS['menu_line_level3_a'] = <<<END
 <li class="active">%text%</li>
END;

?>

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