[SeoFilter] долгожданное обновление: меню, sitemap

[ купить дополнение ] [ демо ] [ документация ]

Выкладываю долгожданное обновление SeoFilter со сниппетами для формирования меню и карты сайта.



Кто ещё не знаком с SeoFilter, рассказываю его возможности.

Компонент позволяет создавать виртуальные страницы с красивым постоянным адресом по любым полям ресурса, товара, включая дополнительные поля(TV) и поля, значения которых хранятся в других таблицах. Также можно использовать одновременно несколько полей для формирования страниц.

Для виртуальных страниц предусмотрено динамическое формирование заголовков, контента с автоматической подстановкой значений полей с возможностью их склонения по падежам и с подсчётом количества ресурсов, удовлетворяющих условиям станицы.

Всё это может работать даже через AJAX совместно с mSearch2 или без него.
Подробнее про все возможности в первом анонсе и документации.

А в этом обновлении два новых сниппета и небольшие изменения в коде:

sfMenu — формирование меню

Первый и самый функциональный это sfMenu. Для формирования меню создал новый класс. Очень многое взято из pdoMenu, в том числе почти вся поддержка классов. Очередное спасибо Василию. Мой код, пока не такой изящный, но стараюсь делать всё красиво. Всю документацию напишу позже.

! Важно ! Отличается от pdoMenu тем, что за сформированную ссылку на страницу здесь отвечает параметр [[+url]], а за её название параметр [[+name]].
Вообще можете задавать пустые чанки и проверять что можно использовать :) Параметров, которыми можно управлять формированием меню много, что я наверно и не все проверил) Можно вообще не указывать параметры и получить все ссылки. Но вот основные:

• rules — список правил, чьи ссылки нужно использовать в меню; (можно с минусом)
• parents — список страниц, к которым привязаны правила; (можно с минусом)
• urls — отдельно id виртуальных страниц из таблицы url; (можно с минусом)
• countChildren — подсчёт ресурсов(товаров) которые будут на странице;
• mincount — минимальное количество ресурсов для включения ссылки в меню;
• sortcount: — сортировка по количеству ресурсов, приоритетнее той что в sortby;
• relative — экспериментальная перестройка меню исходя из выбранной seo-страницы;
• nesting — виртуальное вкладывание ссылок в ссылки, попробуйте :) ;
• double — дублирование ссылок при вкладывании, так как могут относится к нескольким правилам, так сказать мультикатегории;
• nesting — виртуальное вкладывание ссылок в ссылки, попробуйте :) ;
• groupbyrule — группировка по правилам (отдельный чанк-обёртка tplGroup);

Для всех параметров есть описания, что не понятно — пишите сюда) Вообще, не хватает пользовательских примеров использования меню. Но несколько своих примеров напишу:

1. Пример с группировкой на отдельной странице с исключением «пустых» страниц.
Самый первый скриншот.

[[!sfMenu? 
    &countChildren=`1`
    &groupbyrule=`1`
    &sortby=`createdon`
    &sortdir=`ASC`
    &mincount=`1`
    &parents=`9`
    &tplGroup=`@INLINE <div class="col-sm-6"><h4>[[+name]] <small>[[+total]] ссылок</small></h4>[[+wrapper]]</div>`
    &tplOuter=`@INLINE <ul[[+classes]]>[[+wrapper]]</ul>`
    &tpl=`@INLINE <li[[+classes]]><a href="[[+url]]">[[+name]]</a> <nobr><span>([[+total]] [[+total:units=`товар|товара|товаров`]])</span><small> - [[+count]] [[+count:units=`просмотр|просмотра|просмотров`]]</small></nobr>[[+wrapper]]</li>`
]]

2. Пример с вложенностью ссылок от двух ресурсов

[[!sfMenu? 
    &countChildren=`1`
    &nesting=`1`
    &double=`0`
    &mincount=`2`
    &parents=`9`
]]

3. Меню только первого уровня с сортировкой по количеству

[[!sfMenu? 
    &countChildren=`1`
    &sortcount=`1`
    &sortby=`createdon`
    &sortdir=`DESC`
    &mincount=`1`
    &parents=`9`
    &level=`1`
]]

sfSitemap — карта сайта

Сниппет создан на основе класса меню, поэтому поддерживает почти все те параметры, за исключением вложенности и группировки. Также здесь взято почти всё из pdoSitemap и использовать их можно совместно. Здесь напишу только этот пример, в остальном разобраться не сложно.
В pdoSitemap для параметра tplWrapper на демке я использовал чанк. Его содержимое:

<?xml version="1.0" encoding="{'modx_charset' | option}"?>
<urlset xmlns="{$schema}">
{$output}
{$_modx->runSnippet('sfSitemap',['tplWrapper'=>'sitemap.output', 'countChildren'=>1, 'mincount'=>1, 'forceXML'=>''])}
</urlset>

Где в сниппете sfSitemap в параметр tplWrapper написал чанк sitemap.output с содержимым {$output}.

! Важно ! При совместном использовании на одной странице нужно задавать пустой параметр forceXML, чтобы не было конфликтов заголовков header.

sfLink — обновление логики работы

Его смысл остался таким же, выводить ссылку при вводе id правила(или нескольких). Но код и формат использования стали лучше. Простой пример для того, чтобы вывести ссылку на сложную страницу. (у меня включён Fenom в шаблонах)

Ссылка на категорию:
{foreach $_modx->resource.color as $cvet}
	{'!sfLink'|snippet:[ 
	     'rules'=>'22,17',
	     'category'=>$_modx->resource.parent,
	     'cvet'=>$cvet
	]}
{/foreach}

Где-то выведет одну ссылку, где-то несколько:

Теперь не нужно вызывать дополнительные сниппеты для названия ссылки, так как в одном из предыдущих обновлений для всех ссылок правила (виртуальных страниц) можно задавать шаблон для формирования названия.

Если же какой-то цвет исключается правилом 22 (цвет + категория) или ссылка отключена, то будет поиск по правилу 17 (категория). Оно здесь специально стоит последним.

Меню и карта сайта кэшируются по-умолчанию на час. Подсчёт ресурсов дорогая операция на запросы, так как для каждой ссылки прогоняется. Но по времени у меня даже первый запуск не особо долгий, но всё сильно зависит от количества ссылок.

Описал, что вспомнил. Документация будет позже, а пока задавайте вопросы, если есть :)

<link rel="canonical" href="site.com/a">

[[!+sf.title:notempty=`[[!+sf.title]] / `]][[!pdoTitle? &registerJs=`1` &limit=`1`]]

[[!+sf.h1:default=`{$pagetitle}`]]

{$_modx->runSnippet('!mFilter2@filter', [
        'parents' => $_modx->resource.id,
        'paginator' => 'pdoPage@pagination',
        'element' => 'msProducts',
        'setMeta' => '1',
        'class' => 'msProduct',
        'limit' => '12',
        'pageLimit' => '7',
        'ajaxMode' => 'button',
        'tpl' => '@FILE chunks/productItem.tpl',
        'filters' => '
        ms|price:number,
        msoption|gender,
        msoption|povod,
        msoption|hobbymen,
        msoption|hobbywomen,
        msoption|yearold,
        ',
        'aliases' => '
        ms|price==price,
        msoption|gender==komy,
        msoption|povod==podarok,
        msoption|hobbymen==dlya,
        msoption|hobbywomen==whobby,
        msoption|yearold==vozrast
        
        ',
        'tplFilter.outer.price' => 'tpl.mFilter2.filter.slider',
        'tplFilter.row.price' => 'tpl.mFilter2.filter.number',
])}

{'sfMenu' | snippet : [
	'rules' => '2',
	'parents' => $_modx->resource.id,
	'urls' => '2,3,4'
]}