• Заметки
    •

    MODX. Теги для материалов сайта

    Меню

    Отредактировано: 13 Августа 2018

    Способ создания тегов на MODX можно выбрать исходя из потребностей. Если нужен только вывод цепочки тегов в статье, можно использовать маленький самодельный сниппет. Если же нужен расширенный функционал, то уместно использование компонента, к примеру tagLister. Независимо от того, какой способ будет выбран, у них есть общие этапы. Ниже приведены общие действия, и 2 различных способа создания тегов.

    Общие действия

    1. Для начала, создадим дополнительное поле (TV, Template Variables).  Параметры, которые необходимо проставить новому полю: 
      • Имя: tags;
      • Подпись: Теги;
      • Тип ввода: Авто-метка;
      • На вкладке «доступно для шаблонов» откроем доступ шалонам, в которых должно выводиться данное поле.
    2. Создадим страницу, на которой будут выводится результаты выборки по тегам. Для этого во вкладке со списком ресурсов создадим новый материал с полями: 

      Запомните ID созданного ресурса — он нам еще понадобится.

      • Заголовок: Поиск по тегу;
      • Псевдоним: tag;
      • Поставленными галочками: «Не показывать в меню» и «Опубликован»;
      • На вкладке «Настройки страницы» убираем галочки «Использовать html-редактор», «Доступен для поиска», «Кешируемый»;
      • Заполняем поле содержимого документа (Обратите внимание, вместо getResources можно использовать pdoResources): 
        [[!getResources?
  &parents=`1,4,10` 
  &tpl=`tpl.tag-item`      
  &includeTVs=`1` 
  &processTVs=`1` 
  &includeContent=`1`
  &limit=`100`   
  &hideContainers=`1`
  &tvFilters=`tags==%[[GET]]%`  
 ]]
        Параметры:
        • parents: указываем id ресурсов-папок, материалы которых будут выводиться при поиске;
        • tpl: шаблон вывода ресурсов;
        • includeTVs: включаем обработку TV параметров;
        • processTVs: тоже надо включить, чтобы TV параметры работали;
        • includeContent: указываем, что надо выводить содержимое ресурсов, в противном случае будет выведен массив данных ресурсов (иногда так же является полезным);
        • limit: число документов для отображения, пока поставим 100, чтобы вывести все, потом можно будет выставить необходимое;
        • hideContainers: не будем выводить ресурсы являющиеся папками;
        • tvFilters: фильтр на основе, которого будем решать выводить ресурс или нет.
    3. Создадим чанк tpl.tag-item в котором будет шаблон для вывода элементов. Его примерное содержание: 
      <div class="article">
	<h4><a href="[[+uri]]">[[+pagetitle]]</a></h4>
	<p>[[+introtext]]</p>
</div>

    ​Простейший вывод тегов с помощью сниппета

    1. Создадим снипет обрабатывающий запрос со следующим кодом: Имя сниппета: GET 
      <?php 

 if (!empty($_GET["tag"])) 
   { 
       echo ($_GET["tag"]); 
   } 
 else { echo ('none'); }
    2. Создадим сниппет для вывода тегов в материале (Обратите внимание на то, что вместо 27 в пятой строке надо поставить ID документа созданного для вывода результата): Имя сниппета: put_tags 
      <?php 

    if ($input == '') { return ''; } // Вывод если TV пустой 
      $tags = explode(',',$input); // Составление массива, по разделителю ',' 
    foreach ($tags as $key =--> $value) 
       { // цикл перебора тегов 
            $output[] = '<a class="tags" rel="nofollow" href="'.$modx->makeurl(120, '', array('tag' => $value)).'" title="'.$value.'"> '.$value.' </a>'; 
            // Добавление выходному массиву элемента 
            // ссылки на ресурс вывода 94 методом GET
       } 
    return implode(', ',$output); // Вывод получившегося массива ссылок
    3. Вывод тегов в шаблоне: 
      [[!put_tags? &input=`[[*tags]]`]]
    4. Теперь заходим в статью и заполняем TV поле tags. Для начала надо будет самому вписать нужные теги через запятую, а вот потом в ресурсах появиться возможность выбора тегов из уже использованных

    Создание тегов с помощью tagLister

    1. Устанавливаем компонент tagLister;

    Список тегов текущего ресурса

    Если нужен вывод тегов текущего ресурса, в шаблоне выводим

    [[!tolinks? &items=`[[*tags]]` &target=`123`]]

    Параметры:

    • &items — Имя или ID TV в котором находятся теги;
    • &target — ID страницы на которой должны выводиться результаты;
    • &tpl — шаблон вывода одного элемента;
    • &inputDelim — разделитель для входящего поля тегов. По умолчанию запятая;
    • &outputDelim — разделитель для вывода тегов. По умолчанию запятая; 
    • &tagRequestParam — ключ запроса REQUEST, который будет использоваться при создании ссылок;
    • &cls — имя CSS класса для добавления к каждому результату;
    • &toPlaceholder — если установлен, все данные вместо вывода будут записаны в плейсхолдер;
    • &tagKey — имя группы тегов, используемое при создании ссылок.

    Ссылка на полную документацию

    Облако тегов

    Для вывода облака всех возможных тегов используем

    [[!tagLister? &tv=`tags` &target=`123`]]

    Параметры:

    • &tv — Имя или ID TV в котором находятся теги;
    • &target — ID страницы на которой должны выводиться результаты;
    • &tpl — шаблон вывода одного элемента;
    • &toDelim — разделитель для входящего поля тегов. По умолчанию запятая;
    • &all — показывает ссылку «Все теги»;
    • &allTpl — шаблон для ссылки «Все теги».

    Шаблон для тегов по умолчанию

    <li class="[[+cls]]">
<a href="[[~[[+target]]? &[[+tagVar]]=`[[+tag]]`]]">[[+tag]]</a> ([[+count]])
</li>

    Ссылка на полную документацию tagLister

    Автопростановка тегов

    Для автоматического ввода тегов, в зависимости от раздела, контекста или каких либо еще параметров, надо в дополнительном поле tags, на вкладке параметры ввода, в поле "Значение по умолчанию" подключить сниппет, проставляющий теги. Ниже представлен пример с распределением по разделам родителя:

    // в поле значение по умолчанию пишем
@EVAL return $modx->runSnippet('tags_default');
    
// в сниппете tags_default 
$parentIds = $modx->resource->get('parent');

switch ($parentIds) {
    case 1:
        return "tag 1";
        break;
    case 2:
        return "tag 2";
        break;
    case 3:
        return "tag 3";
        break;
}
    modx back-end компоненты