Логотип

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

blogs20 postsList()

Название

%blogs20 postsList()% — выводит список публикаций блога/блогов.

Параметры: blogs20 postsList([blogId, template, limit])

blogId

Идентификатор блога, публикации которого требуется вывести. Если не задан, выводит все публикации.

template

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

limit

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

Описание

Выводит список публикаций блога/блогов.

Кроме параметров, которые передаются в макрос при его вызове из шаблона, результат вывода данного макроса учитывает также такие параметры http-запроса как from_date и to_date. Таким образом вы можете вывести публикации, ограничив их список определенным временным интервалом. Значение этих параметров следует указывать в формате ГГ-ММ-ДД. Например, запрос к странице может выглядеть как http://ваш_сайт/blogs20/postsList/?from_date=12-11-10&to_date=12-12-21, что даст указание скрипту вывести только посты блога, опубликованные в промежутке между 10 ноября и 21 декабря 12 года.

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

<?=$this->render($this->macros('blogs20', 'getPostsList', array($variables['@pageId'])), 'blogs20/postList')?>

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

udata://blogs20/postsList/

XML-ответ UData

<udata module="blogs20" method="postsList" generation-time="0.018305">
  <items>
    <item id="62" 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>
      <blog_title>Первый блог</blog_title>
      <cut>Текст поста первого блога.</cut>
      <publish_time>1258115458</publish_time>
    </item>
    <item id="65" author_id="19">
      <name>Пост второго блога</name>
      <post_link>/blog2/post_vtorogo_bloga/</post_link>
      <blog_link>/blog2/</blog_link>
      <bid>64</bid>
      <blog_name>Второй блог</blog_name>
      <blog_title>Второй блог</blog_title>
      <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>

ссылка на все посты по этому тегу (см. %blogs20 postsByTag()% )

<tag>

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

<publish_time>

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

<per_page>

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

<total>

общее количество постов в блоге/блогах

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

%blogs20 postsList()%

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

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%

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