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

Для того, чтобы указать макросу, куда нужно вывести список новостей, используется локальный макрос %items%. Здесь этот макрос поочередно вставляет каждую новость, из списка последних новостей запрошенной ленты. Для оформления отдельной новости используется блок lastlist_item, в котором задается то, как будет выглядеть каждый отдельный элемент списка новостей. Поэтому мы модифицируем файл шаблона следующим образом — указываем макросом %items% место, где будет отображен список, и добавляем в шаблон оформление блока lastlist_item:

файл ~/tpls/news/home.tpl

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

<div id="news" class="block">

 <h2>Новости и публикации</h2>
 
 %items%
 
 <hr/>

 
 
 

</div>

END;

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

<div class="item">

  <span class="date">
    
  </span> | 
            
  <a href="#ссылка_на_ленту">
        
  </a>

  <a href="#ссылка_на_новость" class="title">
    
  </a>

    

  <div>
    
  </div>

  <div class="comments">
    <a href="#ссылка_на_все_комментарии" >
      
    </a> | 
    
    <a href="#ссылка_на_добавление_комментария">
      
    </a>
  </div>

</div>

END;

Рассмотрим поля блока lastlist_item по порядку:

Итак, если внести все замены в блоке lastlist_item в шаблон ~/tpls/news/home.tpl, то этот блок будет выглядеть следующим образом:

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

<div class="item">

 <span class="date">
   %system convertDate(%publish_time%, d.m.Y)%
 </span> | 

 <a href="%lent_link%">%lent_name%</a>
 <a href="%link%" class="title">%header%</a>

 %data getProperty(%id%, 'anons_pic', 'news.anons.home')%

 <div>
   %anons%
 </div>

 <div class="comments">
   <a href="%link%#comments" >Комментарии (%comments countComments(%id%)%)</a> | 
   <a href="%link%#add_comment">Добавить комментарий</a>
 </div>

</div>

END;

Для отображения этой ссылки существует локальный макрос %archive% модуля "Новости" — этот макрос выводит содержимое блока lastlist_archive. Подставим макрос в нужное место и оформим соответствующий блок в шаблоне ~/tpls/news/home.tpl:

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

 <a id="archive" href="%archive_link%">Архив новостей</a>

END;

Для подписки по rss существует одноименный метод модуля "Шаблоны данных". Вызов метода можно осуществить непосредственно из url, указав идентификатор ленты при помощи макроса %id%:

<a id="rss" href="/data/rss/%id%/">RSS</a>

Для подписки по e-mail существует отдельный модуль "Рассылки", который для вывода формы подписки использует макрос %dispatches subscribe()%. Оформим нужным образом отдельный шаблон для отображения результатов работы этого макроса:

файл ~/tpls/dispatches/home.tpl:

<?php

$FORMS = Array();

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

<form method="post" name="sbs_frm" enctype="multipart/form-data" action="%pre_lang%/dispatches/subscribe_do/">

 <label for="subscribe">
   <div>Подписка на новости:</div>
 </label>

 <input name="sbs_mail" id="subscribe" class="textinputs" type="text" value="Введите E-mail" onfocus="if (this.value == 'Введите E-mail') this.value=''" onblur="if (!this.value.length) this.value='Введите E-mail';" />
 <input type="submit" value="Ok"/>

</form>

END;


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

<form method="post" name="sbs_frm" enctype="multipart/form-data" action="%pre_lang%/dispatches/subscribe_do/">

 <label for="subscribe">
  <div>Вы подписаны на рассылки:</div>
 </label>

 %subscriber_dispatches%
 
 <input type="submit" value="Ok"/>
</form>

END;


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

<table border="0" cellpadding="0" cellspacing="2">

 %rows%

</table>

END;


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

<tr>
 <td>

  <input type="checkbox" %checked% name="subscriber_dispatches[]" value="%disp_id%" /> 
 
  <span>
   %disp_name%
  </span>

 </td>
</tr>

END;

?>

Блок subscribe_unregistred_user отвечает за отображение формы для незарегистрированных пользователей, а subscribe_registred_user с двумя вложенными блоками subscriber_dispatches и subscriber_dispatch_row — за отображение формы и списка существующих подписок для текущего зарегистрированного пользователя. Подробнее с работой макроса %dispatches subscribe()% и его блоков можно ознакомиться в соответствующей главе этой документации.

файл ~/tpls/news/home.tpl

<?php

$FORMS = Array();

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

<div id="news" class="block">

 <h2>Новости и публикации</h2>

 %items%

 <hr/>

 %archive%

 <a id="rss" href="/data/rss/%id%/">RSS</a>

 %dispatches subscribe('home')%

</div>

END;


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

<div class="item">

 <span class="date">
   %system convertDate(%publish_time%, d.m.Y)%
 </span> |

 <a href="%lent_link%">%lent_name%</a>
 <a href="%link%" class="title">%header%</a>

 %data getProperty(%id%, 'anons_pic', 'news.anons.home')%

 <div>
  %anons%
 </div>

 <div class="comments">
  <a href="%link%#comments" >Комментарии (%comments countComments(%id%)%)</a> | 
  <a href="%link%#add_comment">Добавить комментарий</a>
 </div>

</div>

END;


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

<a id="archive" href="%archive_link%">Архив новостей</a>

END;


?>

Оформим для макроса %news lastlist()% блок вывода всей ленты и блок отдельной новости из списка. Для блока вывода всей ленты нам необходимо предусмотреть возможность разбиения списка по страницам — пейджинг. Оформление анонсов сделаем таким же, как и на главной странице (см. «Лента новостей на главной странице сайта»).

файл ~/tpls/news/default.tpl

<?php

$FORMS = Array();

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

<div>

  %items%

  

</div>

END;

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

  
 
END;

Локальный макрос %items%, как и в предыдущих примерах, указывает куда выводить список элементов, оформленных по блоку lastlist_item.

Для отображения списка страниц при постраничном выводе существует специальный макрос %system numpages()%, для вывода результатов которого мы создадим свой собственный шаблон:

файл ~/tpls/numpages/standart.tpl

<?php

$FORMS = Array();

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

 <div class="numpage" style="padding-left: 10px;">
  <div class="small">

   Страницы:&nbsp;&nbsp;%pages%
 
  </div>
 </div>

END;


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

 <a href="%link%">
  <b>%num%</b>
 </a>

 &nbsp;%quant%

END;

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

 <span class="active_num">%num%</span>
 &nbsp;%quant%

END;

$FORMS['pages_quant'] = <<<END
|
END;

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

 <div class="numpage" style="padding-left: 10px;">

 </div>

END;

?>

Блок pages_block задает оформление всего списка страниц, где pages_item задает оформление номеров страниц, pages_item_a — оформление текущего номера страницы, pages_quant — разделитель списка номеров. Описание всех блоков шаблона для макроса %system numpages()% можно посмотреть в топике посвященному этому макросу.

Для правильной работы макроса %system numpages()% необходимо передать ему еще 2 параметра: общее количество новостей и количество новостей, выводимых на странице. Для получения общего количества новостей воспользуемся специальным макросом %total%. Для получения количества элементов, выводимых на странице, воспользуемся макросом %per_page%, который в данном случае вернет значение, указанное в настройках модуля "Новости".

В итоге вызов макроса должен выглядеть следующим образом:

%system numpages(%total%, %per_page%, 'standart')%

Для вывода полного текста новости макрос %news view()% использует блок view. Поэтому оформим его в шаблоне ~/tpls/news/default.tpl с учетом поставленных задач:

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









END;

Рассмотрим поля блока view по порядку:

<?php

$FORMS = Array();

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

<div>

 %items%
 %system numpages(%total%, %per_page%, 'standart')%

</div>

END;

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

<div class="item">

 <span class="date">
   %system convertDate(%publish_time%, d.m.Y)%
 </span> |

 <a href="%lent_link%">%lent_name%</a>
 <a href="%link%" class="title">%header%</a>

 %data getProperty(%id%, 'anons_pic', 'news.anons.home')%

 <div>
  %anons%
 </div>

 <div class="comments">
  <a href="%link%#comments" >Комментарии (%comments countComments(%id%)%)</a> | 
  <a href="%link%#add_comment">Добавить комментарий</a>
 </div>

</div>

END;


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

 %data getProperty(%id%, 'publish_pic', 'news.view')%

 %content%

 %news related_links(%id%)%

 %comments insert(%id%)%

END;

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

<div id="related_news" style="margin-top:150px">

 <p>Похожие новости:</p>

 <ul>
  %related_links%
 </ul>

</div>

END;

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

<li>

 <a href="%link%">

   <b>%name%</b> 
  (%system convertDate(%publish_time%, 'Y-m-d')%)

 </a>

</li>

END;

?>