[SeoFilter] 1.6.0 - большое обновление компонента для формирования SEO-страниц для фильтров

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

Планомерно продолжаю улучшать SeoFilter, но хотелось бы быстрее.
Спасибо, что «пинаете» в поддержке (и не только там) и просите обновлений :)
Объяснять, что это за компонент в данной заметке не буду, но можно пройтись по ссылкам выше и ознакомиться.

Мне тяжело выбрать, что же в обновлении самое главное, но как мне кажется — улучшение стабильности и устранение непонятных моментов и быстрый доступ к настройкам:

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

Помимо настроек, в обновлении есть ещё некоторые полезности:

• Вложенные хлебные крошки
• События для ваших плагинов
• Пошаговый пересчёт и удаление пустых страниц
• Визуальный редактор для полей SEO-страниц, правил (в FrontendManager тоже)
• Запоминание гридов, табов в админке. Сортировка активных по столбцу «Действия»
• Изменения по внешнему виду, много переименований, добавлены описания
• Нормальная поддержка условий для ограничений сбора значений в полях
• Переработан фронтенд JS-файл, по классу формы сможет отслеживать и подгружать SEO-страницу
• Ну и прочие полезности, фишки, которые я уже забыл, пока так долго готовил обновление

Ну и по традиции, дальше разберу некоторые пункты подробнее:

Вложенные хлебные крошки

Чтобы активировать хлебные крошки, нужно активировать соответствующую настройку на новой вкладке «Настройки» — или же по старинке (ключ seofilter_crumbs_nested).
Да, настройка добавит запросы, но найдёт страницы, состоящие из тех же полей (стараясь учесть порядок).
И да, нужно там же рядом заменить старый чанк на новый tpl.SeoFilter.crumbs.nested, а также в вызове !pdoCrumbs в настройке tplCurrent (вызов должен быть некэшированным).

Плагины для гибкого управления контентом

В компоненте появились первые плагины — 4 стандартных процессорных и 1 поинтереснее.

• sfOnBeforeWordAdd — перед добавление нового слова
• sfOnWordAdd — после успешного добавления слова
• sfOnBeforeUrlAdd — перед добавлением SEO-страницы
• sfOnUrlAdd — после успешного добавления страницы
• sfOnReturnMeta — перед возвращением всех meta-seo-данных на страницу через Ajax/или просто при открытии страницы. Отличить можно по $action. При открытии страницы $action='plugin'; Ниже приведу пример плагина, как можно управлять и даже изменять url

<?php
switch ($modx->event->name) {
    case 'sfOnBeforeWordAdd': 
            // все новые слова будут добавлены неактивными, значит SEO-страницы не будут сформированы
            // так как событие стандартное, доступны $mode, $data, $object, $word, $id = 0
            $word->set('active',0); // можно обратиться и через $object
        break;
    case 'sfOnReturnMeta': 
        //доступны переменные: $page - id физической страницы, $SeoFilter - объект SeoFilter, $meta - все данные
        // и $action с 3-мя возможными значениями:
        // 'plugin' - при срабатывании из плагина SeoFilter перед выставлением плейсхолдеров
        // 'getmeta' - при стандартном запросе через Ajax при submit фильтра 
        // 'metabyurl' - срабатывает, когда в браузере человек пользуется вперёд/назад
	$meta = $modx->getOption('meta', $scriptProperties, array(), true); //массив данных перед отдачей на страницу
        //$modx->log(1,print_r($meta,1)); //вот так можно распечатать все данные в журнал ошибок
        // будет множество данных, но по ним сможете делать какие-то условия и изменять 
        
        //простой пример для замены стандартного контента обычной страницы на SEO-странице
           if(empty($meta['content'])) {
                $meta['content'] = ' '; //символ пробела, чтобы пройти проверку на непустой плейсхолдер
            }
    
	  $values = $modx->Event->returnedValues;
          $values['meta'] = $meta;
          $modx->event->returnedValues = $values;
	break;
}

Пошаговый пересчёт и удаление пустых страниц

Да, многие просили, чтобы пустые страницы вообще не создавались.
Но у многих есть ещё проблемы с подсчётами, от которых зависит «пустота» страницы.
Это возможно и даже будет сделано в версии 2.0 (по плану она следующая после текущей ветки 1.6).

Но теперь хотя бы можно в пару кликов удалить все пустые страницы, даже если их 50 тысяч.
Для этого во вкладке SEO-страницы нужно выбрать "Ещё"->"Удалить пустые страницы".
Компонент сам всё пересчитает и будет сразу же удалять пустые страницы. Прогресс-бар будет держать в курсе насчёт количества удалённых страниц)

Ещё тестировал с пошаговым добавлением новых URL страниц. На 50 тысяч страниц отрабатывало хорошо, но пока есть проблемы с другими зависимыми частями. Поэтому сперва будет рефакторинг кода для версии 2.0, а потом массовое внедрение этого функционала.
Кому нужно сейчас много страниц добавлять, не упираясь в лимиты — пишите, что нибудь придумаем.

Подключение визуального редактора или ACE для SEO-полей

Разбавлю кучу текста картинками:

В описании расписал подробнее, через двоеточие — высота, с приставкой Rule. — для полей правила.

А вот как это выглядит в обновлённом интерфейсе для SEO-страницы: (кликабельно)

Очень удобно, когда видно подсветку синтаксиса, ошибок будет гораздо меньше :)

Условия для ограничения поиска в полях

Раньше были очень простенькие условия, которые, можно сказать, нормально и не работали.
Теперь же можно прописать условие по сбору слов по таким условиям: определённая категория, стоимость больше 0, учитывать ТВ значения или опции (но тв и опции гораздо реже понадобятся). Нужно указывать только названия классов, можно полностью, можно популярными сокращениями. Компонент сам приджойнит к ресурсам все поля (если они существуют).

{"parent":9,"Data.price:>":0}

Эти же условия будут учитываться и при сохранении ресурса, чего раньше не было.

Обработка фильтров

Мощно переделал javascript для фронтенда. Старый файл остался с названием -old.
В общем, теперь можно достаточно быстро к любому простенькому фильтру прикрутить SeoFilter.

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

var params = {"parent":10,"color":"green"}; //ваш массив с собранными значениями фильтров
SeoFilter.loadMeta(params); //заменит URL и все тексты

Ещё я немного поэкспериментировал в этом направлении и на основе статьи от Ильи Уткина про простой AJAX-фильтр почти прикрутил автоматический обработчик формы по классу sf_filters.
Это очень сырой функционал, который пока работает только через Ajax и имеет множество проблем, поэтому никому не советую его использовать, но если что улучшить можно) Пример: s9767.h8.modhost.pro/ajax-filter

Планы

Как обычно, планы грандиозные и на ближайшие месяцы:

• Обновить документацию под все возможности
• Переписать почти всё, что можно
• Подсчитывать результаты до добавления ссылки (чтобы не добавлять пустые страницы)
• Чтобы все добавления работали пошагово через ajax (чтобы хоть миллион страниц добавить)
• Для правила сделать выбор физической страницы через дерево категорий
• Сделать красивую демку с реальными фильтрами
• Возможность задавать свои шаблоны для формирования адресов
• Возможно, добавить работу со множественными значениями одного фильтра, если кто-то, наконец, объяснит мне, есть ли вообще от этого польза

Приглашаю в комментарии

Давайте обсудим, что я забыл сделать, что мне ещё нужно будет сделать и вообще, стало ли удобнее пользоваться на ваш взгляд?
Мой взгляд может быть сильно замыленным и в упор не увижу страшно-неудобные вещи.

Ах да, до следующего большого обновления цену менять не планирую :)
И ещё, я как автор компонента, буду рад настроить новую версию «под ключ» за какую-нибудь символическую стоимость на парочке проектов, чтобы больше понять потребности реальных клиентов. Бронируйте)

[[!sfMenu? 
&fast=`1`
&sortby=`total`
&sortdir=`DESC`
&mincount=`5`
&outerClass=`navigation`
&innerClass = `inner`
&levelClass = `level`
&parentClass = `parent`
&rowClass = `rows`
&selfClass = `self`
]]

Сырье —купить в {$_modx->getPlaceholder('sd.city_r')}