Логотип

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

forum confs_list()

Название

%forum confs_list()% — Выводит список конференций

Параметры: forum confs_list([template='default', v_parent_path='', i_deep='0'])

template

Имя шаблона, по которому выводится список конференций.

v_parent_path

id элемента иерархии, относительно которого макрос должен совершить поиск конференций. Если указан, в список включаются только конференции, находящиеся в соответствующей ветке иерархии сайта, если нет (по-умолчанию) - все конференции на сайте независимо от их расположения в структуре

i_deep

Глубина, на которую следует осуществить поиск конференций относительно элемента с идентификатором v_parent_path, если таковой задан (см. предыдущий параметр). По умолчанию - 0 (ноль) - на всю глубину. Чтобы осуществить выборку только непосредственно в заданной рубрике сайта (среди "детей"), укажите 1, среди "детей" и "внуков" - 2, и т . д.

Описание

Макрос выводит список конференций по шаблону, указанному в параметре template. Вы можете не указывать этот параметр, тогда для вывода будет использован шаблон по умолчанию - /tpls/forum/default.tpl.

<?=$this->render($this->macros('forum', 'confs_list', array(null, $page->getId())), 'forum/confs_list')?>

Пример вызова

udata://forum/confs_list/

XML-ответ UData

<udata module="forum" method="confs_list" generation-time="0.051107">
  <items>
    <item id="3" link="/talks/obwij/" topics_count="2"
     messages_count="23" xlink:href="upage://3">Общий</item>
    <item id="9" link="/talks/gde_vzyat/" topics_count="1"
     messages_count="14" xlink:href="upage://9">Где взять?</item>
    <item id="99" link="/novaya_konferenciya/" topics_count="2"
     messages_count="11" xlink:href="upage://99">Новая конференция</item>
  </items>
  <total>3</total>
  <per_page>25</per_page>
</udata>

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

<items>

Ветвь, содержащая элементы item — конференции.

<item>

Элемент, описывающий отдельную конференцию. Содержимое элемента — название конференции.

@id

Идентификатор конференции.

@link

Ссылка на страницу конференции.

@topics_count

Количество тем в этой конференции.

@messages_count

Количество сообщений в этой конференции.

@xlink:href

Ссылка UPage на страницу конференции.

<total>

Общее количество конференций.

<per_page>

Количество конференций, отображаемое на странице.

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

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

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

confs_block

Блок вывода для списка конференций

%lines%

Список конференций, сформированный по блоку шаблона comments_block_line

%total%

Общее количество конференций

%per_page%

Количество выводимых на страницу конференций

confs_block_line

Блок вывода информации об отдельной конференции

%id%

Id конференции

%name%

Имя конференции

%link%

Url адрес конференции

%topics_count%

Количество тем в конференции

%messages_count%

Общее количество сообщений во всех темах конференции

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

Вывод списка конференций: %forum confs_list('sample')%

<?php

$FORMS = Array();

$FORMS['confs_block'] = <<<CONFS_BLOCK

 <br />

 <table width="100%" border="0" cellspacing="1" cellpadding="0" class="tforum">
   <tr>
     <td class="hforum">Рубрики</td>
     <td class="hforum">Темы</td>
     <td class="hforum">Сообщения</td>
     <td class="hforum">Последние&nbsp;сообщения</td>
   </tr>
   %lines%
 </table>

CONFS_BLOCK;

$FORMS['confs_block_line'] = <<<CONFS_LINE

 <tr>

   <td class="nforum"  width="200">
    <p>
     <a href="%link%" class="forum">%name%</a><br />
     %descr%
    </p>
   </td>

   <td class="nforum" align="center">
    %topics_count%
   </td>

   <td class="nforum" align="center">
    %messages_count%
   </td>

   <td class="nforum">
    %forum conf_last_message(%id%, 'default')%
   </td>

 </tr>

CONFS_LINE;

?>