Как найти все страницы с похожим именем — различия между версиями
Mad grant (обсуждение | вклад) |
Mad grant (обсуждение | вклад) |
||
Строка 110: | Строка 110: | ||
'''@lang''' | '''@lang''' | ||
− | Префикс языковой версии, на которой находится страница. | + | Префикс языковой версии, на которой находится страница. |
'''<total>''' | '''<total>''' | ||
Количество найденных страниц. | Количество найденных страниц. | ||
+ | |||
+ | == Применение в tpl == | ||
+ | |||
+ | '''Пример вызова макроса''' | ||
+ | |||
+ | <source lang="php"> | ||
+ | %custom getSimilarPages('test', 'default')% | ||
+ | </source> | ||
+ | |||
+ | '''Используемые шаблоны''' | ||
+ | |||
+ | Макрос оперирует шаблонами, находящимися в каталоге /tpls/content/. Вывод макроса осуществляется по шаблону, указанному в параметре template. | ||
+ | Вы можете не указывать этот параметр, тогда для вывода будет использован шаблон по умолчанию — default.tpl. | ||
+ | |||
+ | '''Используемые блоки шаблона''' | ||
+ | |||
+ | '''items''' | ||
+ | |||
+ | Выводит список страниц, отрисованных с помощью блока item. | ||
+ | |||
+ | %items% | ||
+ | |||
+ | Выводит список страниц, отрисованных с помощью блока item. | ||
+ | |||
+ | '''item''' | ||
+ | |||
+ | Отвечает за вывод отдельной страницы, полученной в результате работы макроса. | ||
+ | |||
+ | %id% | ||
+ | |||
+ | Выводит id страницы. | ||
+ | |||
+ | %link% | ||
+ | |||
+ | Выводит uri страницы. | ||
+ | |||
+ | %name% | ||
+ | |||
+ | Выводит имя страницы. | ||
+ | |||
+ | %alt-name% | ||
+ | |||
+ | Выводит имя страницы. | ||
+ | |||
+ | %domain% | ||
+ | |||
+ | Домен сайта, на котором находится страница. | ||
+ | |||
+ | %lang% | ||
+ | |||
+ | Префикс языковой версии, на которой находится страница. | ||
+ | |||
+ | '''empty''' | ||
+ | |||
+ | Выводится в том случае, если ничего найдено. | ||
+ | |||
+ | %request% | ||
+ | |||
+ | Выводит $name, который был передан в макрос. | ||
[[category:Вопросы и уроки разработки сайтов на UMI.CMS]][[Категория:API]] | [[category:Вопросы и уроки разработки сайтов на UMI.CMS]][[Категория:API]] |
Версия 16:08, 3 апреля 2014
Актуально для версии 2.9.6
Задача
Если Вы столкнулись с данной задачей, то решить её стандартными средствами нельзя. Необходимо написать кастомный макрос, пример оного дан ниже.
Решение
%custom getSimilarPages()% — выводит все возможные страницы контента(со всех сайтов и языковых версий) с похожим именем.
Параметры: custom getSimilarPages([$name = 'test', $template = 'default'])
$name
Имя страницы, с которым будет произведен поиск.
$template
Принимает имя шаблона, по которому выводится результат макроса, значение по-умолчанию 'default' В XSLT-шаблонизаторе не используется.
Для применения этого макроса скопируйте код макроса в файл /classes/modules/custom.php.
Код макроса
public function getSimilarPages($name = 'test', $template = 'default'){
list($items_template, $item_template, $empty_template) = def_module::loadTemplates('content/' . $template, 'items', 'item', 'empty');
$pages = new selector('pages');
$pages->types('hierarchy-type')->name('content');
$pages->where('domain')->equals(false);
$pages->where('lang')->equals(false);
$pages->where('name')->ilike($name . '%');
$pages->order('id')->asc();
$total = $pages->length();
if($total == 0){
$empty = array();
$empty['request'] = $name;
return def_module::parseTemplate($empty_template, $empty);
}
$pages_arr = $pages->result();
$domains_col = domainsCollection::getInstance();
$langs_col = langsCollection::getInstance();
$item = array();
$items= array();
foreach($pages_arr as $page){
$item['attribute:id'] = $page->getId();
$item['attribute:name'] = $page->getName();
$item['attribute:link'] = $page->link;
$item['attribute:alt-name'] = $page->getAltName();
$item['attribute:domain'] = $domains_col->getDomain($page->getDomainId())->getHost();
$item['attribute:lang'] = $langs_col->getLang($page->getLangId())->getPrefix();
$items[] = def_module::parseTemplate($item_template, $item);
}
$items = array('subnodes:pages' => $items);
$items['total'] = $total;
return def_module::parseTemplate($items_template, $items);
}
Применение в xslt
Пример вызова
udata://custom/getSimilarPages/te
XML-ответ UData
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="custom" method="getSimilarPages" generation-time="0.037057">
<pages>
<item id="5391" name="test" link="/test/" alt-name="test" domain="domain_1.ru" lang="ru"/>
<item id="5392" name="test123" link="http://domain_2.ru/test123/" alt-name="test" domain="domain_2.ru" lang="ru"/>
<item id="5393" name="test2" link="/en/test2/" alt-name="test2" domain="domain_1.ru" lang="en"/>
<item id="5394" name="test32" link="http://domain_2/en/test32/" alt-name="test32" domain="domain_2.ru" lang="en"/>
</pages>
<total>4</total>
</udata>
Элементы и атрибуты
<pages>
Ветвь, содержащая элементы item — страницы.
<item>
Элемент, описывающий отдельную страницу.
@id
Идентификатор страницы новости.
@link
Ссылка на страницу полного текста новости.
@name
Имя страницы.
@alt-name
Псевдостатический адрес страницы.
@domain
Домен сайта, на котором находится страница.
@lang
Префикс языковой версии, на которой находится страница.
<total>
Количество найденных страниц.
Применение в tpl
Пример вызова макроса
%custom getSimilarPages('test', 'default')%
Используемые шаблоны
Макрос оперирует шаблонами, находящимися в каталоге /tpls/content/. Вывод макроса осуществляется по шаблону, указанному в параметре template. Вы можете не указывать этот параметр, тогда для вывода будет использован шаблон по умолчанию — default.tpl.
Используемые блоки шаблона
items
Выводит список страниц, отрисованных с помощью блока item.
%items%
Выводит список страниц, отрисованных с помощью блока item.
item
Отвечает за вывод отдельной страницы, полученной в результате работы макроса.
%id%
Выводит id страницы.
%link%
Выводит uri страницы.
%name%
Выводит имя страницы.
%alt-name%
Выводит имя страницы.
%domain%
Домен сайта, на котором находится страница.
%lang%
Префикс языковой версии, на которой находится страница.
empty
Выводится в том случае, если ничего найдено.
%request%
Выводит $name, который был передан в макрос.