Логотип

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

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

<?= $this->macros('blogs20', 'postsByTag', array('yourTag'));?>

Вместо yourTag и yourTemplate указываются, соответственно, тег для поиска и страница шаблона для обработки данных работы макроса.

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

udata://blogs20/postsByTag/(технологии­)/notemplate/10

XML-ответ UData

<udata module="blogs20" method="postsbytag" generation-time="0.016517">
  <items>
    <item id="87" author_id="14">
      <name>пост первого блога</name>
      <post_link>/blog1/post_pervogo_bloga/</post_link>
      <blog_link>/blog1/</blog_link>
      <bid>61</bid>
      <blog_name>первый блог</blog_name>
      <cut>Текст поста первого блога.</cut>
      <tags>
        <item>
          <link>/blogs20/postsByTag/звезда</link>
          <tag>звезда</tag>
        </item>
        <item>
          <link>/blogs20/postsByTag/ледяной дворец</link>
          <tag>ледяной дворец</tag>
        </item>
      </tags>
      <publish_time>1258115400</publish_time>
    </item>
    <item id="65" author_id="14">
      <name>Пост блога</name>
      <post_link>/blog2/post_vtorogo_bloga/</post_link>
      <blog_link>/blog2/</blog_link>
      <bid>64</bid>
      <blog_title>Второй блог</blog_title>
      <blog_name>Второй блог</blog_name>
      <title>Пост второго блога</title>
      <cut>Текст поста второго блога.</cut>
      <tags>
        <item>
          <link>/blogs20/postsByTag/звезда</link>
          <tag>звезда</tag>
        </item>
      </tags>
      <publish_time>1223300880</publish_time>
    </item>
  </items>
  <per_page>10</per_page>
  <total>2</total>
</udata>

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

<items>

ветвь, содержащая элементы item — посты с данным тегом

<item>

ветвь, описывающая пост блога

@id

идентификатор поста

@author_id

идентификатор автора поста

<name>

название поста

<post_link>

ссылка на пост

<blog_link>

ссылка на блог, содержащий пост

<bid>

идентификатор блога

<blog_name>

название блога

<blog_title>

заголовок блога — поле title

<cut>

текст поста

<tags>

ветвь, описывающая теги поста

<item>

ветвь, описывающая отдельный тег поста

<link>

Ссылка на все посты по этому тегу.

<tag>

название тега

<publish_time>

Время публикации поста в UNIX TIMESTAMP. Для конвертации можно использовать %system convertDate()%.

<per_page>

количество постов, выводимых на страницу

<total>

общее количество постов с данным тегом

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

%blogs20 postsByTag('технологии','default',10)%

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

posts_list_block

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

%lines%

указывает место, куда выводится список блогов из блока posts_list_line

%bid%

id блога

%total%

общее количество публикаций

%per_page%

количество публикаций на странице

posts_list_line

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

%id%

id публикации

%author_id%

id пользователя - автора публикации

%post_link%

ссылка на просмотр публикации

%blog_link%

ссылка на блог, которому принадлежит данная публикация

%bid%

id блога, которому принадлежит данная публикация

%blog_title%

заголовок блога

%cut%

текст ката

%comments_count%

количество комментариев к публикации

%tags%

строка со списком тегов, теги выводятся по блоку tag_decoration

%list-class-first%

в случае, если элемент первый, выводит "first"

%list-class-last%

в случае, если элемент последний, выводит "last"

%list-class-odd%

в случае, если элемент четный, выводит "odd"

%list-class-even%

в случае, если элемент нечетный, выводит "even"

%list-position%

вставляет порядковый номер в списке

posts_list_block_empty

Используется вместо блока posts_list_block в случае, если публикаций, которые нужно вывести, нет.

%bid%

id блога

tag_decoration

выводит обрамление тегов в списке тегов публикации

%tag%

значение конкретного тега

Название

%blogs20 postsByTag()% — выводит сообщения, содержащие указанный тег.

Параметры: blogs20 postsByTag(tag[, template = 'default', limit])

tag

тег, если не указан, производится поиск в адресной строке

template

tpl-шаблон вывода (по умолчанию - default.tpl). В XSLT-шаблонизаторе игнорируется.

limit

Параметр, задающий количество выводимых постов. Если не задан, то выводит количество постов, заданное в настройках модуля.

Описание

Макрос выводит сообщения блогов домена, содержащие указанный тег. Также можно использовать его в адресной строке: http://ваш_домен/blogs20/postsByTag/тег/

Дополнительно