Action Streams

Материал из Movable Type Wiki

Перейти к: навигация, поиск

Этот тег доступен только при наличии плагина Action Streams, который есть в стандартном дистрибутиве Movable Type 4.25 и выше.

Пример

Этот блок с тегами шаблонов показывает, как отобразить на сайте последние действия пользователей, которые они совершили в профилях, указанных в Action Streams. 

<mt:ActionStreams>
    <mt:DateHeader>
        <div>
            <h3><$mt:StreamActionDate format="%b %d, %Y"$></h3>
            <ul>
    </mt:DateHeader>
                <li class="service-<$mt:var name="service_type"$>">
                    <mt:StreamActionDate format="%H:%M"> - <$MTStreamAction$>
                </li>
    <mt:DateFooter>
            </ul>
        </div>
    </mt:DateFooter>
</mt:ActionStreams>


Атрибуты

Ограничивает отображение действий одним конкретным пользователем.Используйте в этом атрибуте имя пользователя (username).

Например, если вы хотите отобразить действия пользователя «Melody»: 

<mt:ActionStreams author="Melody">

Чтобы отобразить действия нескольких пользователей, необходимо разделить их имена запятыми: 

<mt:ActionStreams author="Melody,Serge">


Тоже самое, что атрибут author. Только вместо имени пользователя необходимо указывать отображаемое имя.

Например, чтобы отобразить действия пользователя, у которого отображаемое имя — «Melody Nelson»: 

<mt:ActionStreams display_name="Melody">

Чтобы отобразить действия нескольких пользователей, необходимо разделить их отображаемые имена запятыми: 

<mt:ActionStreams display_name="Melody Nelson, Serge Gainsbourg">


Тоже самое, что author и display_name. Но вместо имён в этом атрибуте необходимо указывать ID пользователя.

Например, чтобы отобразить действия пользователя, у которого ID — 3: 

<mt:ActionStreams author_id="3">

Чтобы отобразить действия нескольких пользователей, разделите их ID запятыми: 

<mt:ActionStreams author_id="3,4,7">

Только один из атрибутов author_id display_name и author может быть использован одновременно. Если ни один их этих атрибутов не указан, то отображение действий происходит в зависимости от контекста: если тег используется в контексте автора (например, на странице архива автора, внутри <mt:Authors> тега, в контексте записи или на странице профиля пользователя), то будут показаны действия одного автора; в противном случае, если тег используется в контексте блога, то будут показаны действия всех авторов, которые имеют доступ к этому блогу.


Максимальное количество действий, которые будут показаны. Если действий меньше указанного числа, то будет отображено меньшее количество.


Ограничение вывода действий временным отрезком. Будут отображены только записи за указанное количество дней. 

<mt:ActionStreams days="10">

Может быть использован либо days, либо limit. Если ничего не указано, то будут отображены последние 20 действий.


Идентификатор сервиса, действия с которого будут отображены. Идентификатор сервиса отличается от его написания. Например, идентификатор сервиса Twitter — twitter, а Delicious — delicious.

Если сервис содержит несколько потоков, ограничение атрибутом service без атрибута stream, выведет все потоки этого сервиса.Например, при указании service="flickr" будут отображены добавленные фотографии на Flickr, а также избранное на Flickr. 

<mt:ActionStreams service="flickr">
    <!-- Фотографии с Flickr, избранное оттуда и т.д. -->
</mt:ActionStreams>


Идентификатор потока, который будет отображён. Идентификатор потока — это определённые ключи, используемые для разграничения нескольких потоков в рамках одного сервиса. Например, поток ссылок Delicious имеет идентификатор links, а поток фотографий Flickr — photos.

Поскольку разные сервисы могут использовать одни и те же названия для потоков, вы можете использовать идентификатор потока в атрибуте stream, что в результате приведёт к отображению всех действий с этим идентификатором с различных сервисов.Например, вы можете указать stream="photos", без указания атрибута service, чтобы отобразить все действия с фото, или stream="favorites" для отобразить избранное. 

<mt:ActionStreams stream="photos">
    <!-- Фотографии со всех сервисов -->
</mt:ActionStreams>

Чтобы получить список определённых действий с одного конкретного сервиса можно использовать атрибуты service и stream. 

<mt:ActionStreams service="flickr" stream="favorites">
    <!-- Только избранное с Flickr -->
</mt:ActionStreams>


Определяет поле, по которому будут сортироваться действия. По умолчанию действия сортируются по полю created_on (то есть времени, когда действие произошло или было впервые получено). Доступные поля для сортировки:

  1. author_id — числовой идентификатор автора;
  2. created_on — дата и время, когда действие произошло или было впервые получено;
  3. modified_on — дата и время, когда действие было в последний раз изменено.


Определяет порядок, по которому сортируются действия. Возможные значения:

  1. descend — самое новое вверху, самое старое внизу);
  2. ascend — самое старое вверху, самое новое внизу).

По умолчанию действия отсортированы по порядку descend. 

<mt:ActionStreams sort_by="author_id" direction="ascend">
    <!-- Действия остортированы по ID автора, самое старое вверху -->
</mt:ActionStreams>
Источник — «http://movable-type.ru/wiki/Action_Streams»
Личные инструменты
Пространства имён
Варианты
Действия
Навигация
Инструменты