Вывод последних зарегистрированных пользователей (XSLT)

Актуально для версии 2.9

Задача: Вывести на сайте список последних зарегистрированных пользователей (на примере шаблонов demodizzy).
Решение: Для решения задачи будем использовать макросы %users count_users()% и %users list_users()%.

Для начала, если Вы хотите чтобы список пользователей был виден всем пользователям сайта, а не только зарегистрированным, то необходимо изменить права на указанные макросы при помощи файла permissions.custom.php:

<?php
	$permissions = Array(
		             'registrate' => Array('list_users','count_users')
	                     );
?>

Так как макрос %users list_users()% выводит по умолчанию только 10 первых пользователей, то чтобы при вызове макроса получить последних пользователей, нам будет необходимо использовать пейджинг (udata://users/list_users/notemplate/10/?p=2).

Чтобы высчитать число последней страницы пейджинга, нам необходимо узнать общее количество всех активированных пользователей на сайте(для этого используем макрос %users count_users()%) и количество пользователей выводимых макросом %users list_users()% на одну страницу (задаем самостоятельно).

Этапы получения необходимых для отображения данных будут выглядеть следующим образом:
1. Получаем udata-результат работы макроса list_users (в этом результате содержится вся информация).
2. Из udata-результата получаем элементы списка по правилу отбора items/item и в каждом полученном элементе списка находим id объекта, по которому инициализируем его получение через протокол uobject.
3. Распределяем полученные из объекта данные (логин, дата регистрации, имя) по верстке.

Для упрощения кода и уменьшения количества вызовов темплейтов будем использовать такую функциональность как расширенные свойства - extProps. Данная функциональность позволяет получить в результате запроса нужные нам поля, такие как дата регистрации, логин, имя пользователя. Чтобы получить все необходимые данные, нам будет достаточно добавить к вызову GET параметр &extProps= с перечислением всех нужных нам свойств объекта.

В результате, количество этапов уменьшиться и станет следующим:
1. Получаем udata-результат работы макроса list_users (в этом результате содержится вся информация).
2. Из udata-результата получаем элементы списка по правилу отбора items/item и распределяем полученные данные (логин, дата регистрации, имя) по верстке.

Более того, по совету нашего разработчика, код можно ещё упростить пропустив этап получения udata-результата, ведь мы можем сразу вызвать макрос list_users с получением информации на нужном нам уровне, то есть вместо вызова \udata, мы можем сделать вызов \udata\items\item.

Приступим. В шаблоне дизайна (layouts/default.xsl) там, где мы хотим увидеть результаты своей работы, сделаем вызов темплейта с именем lastregusers:

<!-- @name="Вывод последних зарегистрированных пользователей" 
     @path="/modules/users/lastRegisteredUsers.xsl" 
-->
<xsl:call-template name="lastregusers" />

Разрабатываемая функциональность относится к модулю users, поэтому перейдем в папку /modules/users/ и скопируем какой-либо шаблон, сделав из него заготовку и переименовав в lastRegisteredUsers.xsl. Также подключим созданный файл шаблона в файле common.xsl:

      <xsl:include href="lastRegisteredUsers.xsl" />

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet	version="1.0"
	xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
	xmlns:umi="http://www.umi-cms.ru/TR/umi">
	
	<!-- @name="Вывод последних зарегистрированных пользователей"
             @import="common.xsl"
	     @call="/layouts/default.xsl" 
	-->

</xsl:stylesheet>

В следующем листинге, мы:
1) Описываем темплейт с именем lastregusers вызванный в файле default.xsl, подготавливая нужные для вызова макроса %users list_users()% данные: количество выводимых элементов на одной странице perpage, расчёт общего количества пользователей на сайте allusers и расчёт последней страницы пейджинга с результатами макроса countpage. Для расчёта мы используем функции floor() И div.

 Справка:
 floor()- возвращает наибольшее целое, меньшее, чем переданное функции число;
 div - деление;
 . (точка) - ссылка на текущий узел (в нашем случае это общее количество пользователей).

2) Вызываем макрос с подготовленными данными и сразу с помощью элемента sort сортируем результат по id.
3) Тянем за собой параметр allusers с общим количеством всех активных пользователей на сайте.
4) Пишем общий для всех элементов код верстки.

<xsl:template name="lastregusers">
<xsl:variable name="perpage" select="10" />
<xsl:variable name="allusers" select="document('udata://users/count_users')/udata" />
<xsl:variable name="countpage" select="floor((document('udata://users/count_users')/udata - 1) div $perpage)" />

<div class="infoblock">
<div class="title"><h2>К нам присоединились</h2></div>
<div class="body">
	<div class="in">
		<strong>Приветствуем новых пользователей: </strong>
		<ol class="recentPages">
			<xsl:apply-templates select="document(concat('udata://users/list_users//',$perpage,'/?p=',$countpage,'&amp;extProps=register_date,fname,login'))/udata/items/item" mode="lastreg">
				<xsl:with-param name="allusers" select="$allusers"/>
				<xsl:sort order="descending" select="@id"/>
			</xsl:apply-templates>
		</ol>
	</div>
</div>
</div>
</xsl:template>

В следующем листинге, мы:
1) Получаем элементы с расширенными параметрами и распределяем данные (порядковый номер, дата регистрации, имя пользователя, логин) по верстке.

<xsl:template match="item" mode="lastreg">
	<xsl:param name="allusers"/>
	<xsl:variable name="numberuser" select="($allusers - 1) - position()" />
	
		<li>
			<xsl:value-of select="$numberuser" />) 
			<xsl:value-of select=".//property[@name='register_date']/value/@formatted-date" /> - 
			<xsl:value-of select=".//property[@name='fname']/value" />
			(<xsl:value-of select=".//property[@name='login']/value" />)
		</li>
	
</xsl:template>

В следующем листинге, мы:
1) Запрещаем показывать пользователя sv из группы Супервайзеры и учетную запись Гостя. Можно было бы обойтись и без данного темплейта, а использовать в предыдущем конструкцию <xsl:if test="" />, но по заверениям разработчика, конструкции if работают в xslt медленно и если есть такая возможность, то лучше их не использовать.

<xsl:template match="items/item[.//property[@name='login']/value = 'sv' or .//property[@name='login']/value = 'Гость']" mode="lastreg" />

Принцип по которому все работает прост и скрывается в приоритетах: оба темплейта имеют одинаковый режим mode, но у второго темплейта условие выбора match задано конкретнее чем у первого, поэтому для XSLT данное правило будет иметь более высокий приоритет и при наступлении нужного match'а мы ничего не делаем, пропуская найденный удовлетворяющий условию item.

Результат: