Плагин tru_tags. Теги к статьям в TxP. Инструкция по применению.
Установка.
- Идем на официальную страничку релиза. Не сохраняем, а просто открываем в браузере.(хотя можно и сохранить, и потом открыть блокнотом)
- Копируем открытый “набор символов”. Идем в админку TxP “Настройки” – “Плагины”, вставляем в поле “Установить плагин”, нажимаем “Загрузить”, затем “Установить”.
- Активируем плагин. Чтобы в столбце “Активен” стояло “Да”.
Настройка плагина.
Шаг первый: Создание новой секции
Для работы tru_tags в Textpattern необходимо создать специальную секцию, по умолчанию “tag” 1. Создайте эту секцию, с любыми нужными вам настройками(Публиковать статьи в этой секции вы все равно не будете). Вот такие настройки поставил автор плагина 2

1 Вы можете использовать секцию с другим названием, но вам придется поменять настройки плагина через админку для его нормальной работы. Для этого нужно пройти “Расширения”->“tru_tags” и обновить настройки.
2 Обратите внимание что “Использовать страницу” стоит default – вам этот вариант может не подойти. Эта секция будет отображаться,когда человек кликнет на тег, для вывода поиска по тегам. Вам к примеру нужна будет страница, в которой правильно отображаются заголовки, слои. Для правильного вывода автор на своей default странице использует <txp:if_section name=“tag”> чтобы изменить вывод.
(Прим.переводчика – В общем вы можете как автор использовать по умолчанию default страничку и воспользоваться в ней тегом <txp:if_section name=“tag”> или же просто создать специально для этой секции отдельную страницу).
Шаг второй: Обратиться к плагину из соответствующей секции
Чтобы теги поиска по тегам и облака тегов работали, вам нужно вписать тег <txp:tru_tags_handler /> в ту страницу, которую вы выбрали в первом шаге. Автор переписал стандартный тег следующим образом:
<txp:if_section name="tag"> #если секция tag
<txp:tru_tags_handler />
<txp:else /> #,в любом другом случае
<txp:article />
</txp:if_section>
Примечание, that tru_tags_handler по умолчанию использует форму “search_form”, если вы хотите использовать другую форму, то её можно указать в атрибуте listform.
Шаг третий: Настройте ваши статьи для вывода тегов.
В том месте, где вы хотели бы вывести список тегов к определенной статье(форма вывода статьи), вписываем следующее:
<txp:tru_tags_if_has_tags>
tags: <txp:tru_tags_from_article />
</txp:tru_tags_if_has_tags>
Шаг четвертый: Если необходимо, выведите облако тегов
Если вы хотите вывести облако тегов на вашем сайте ещё где-то кроме как на странице http://вашсайт/tag/, делается это с помощью тега:
<txp:tru_tags_cloud />
Смотрите ниже описания тегов, если вы хотите вывести не облако,а список тегов можно воспользоваться специальным тегом tru_tags_list.
Шаг пятый: Начните расставлять теги!
Во время написания поста, вписывайте ваши теги в поле для ключевых слов, в левом блоке “Продвинутые настройки”. Теги необходимо разделять запятой с пробелом. Пробел нужен для правильной генерации URL тегов.
Другие возможные настройки плагина
Вы можете использовать tru_tags_if_tag_search, tru_tags_tag_parameter и txp:search_term для настройки заголовков ваших страниц или результатов поиска по тегам. Подробнее ниже.
Другие возможные настройки
Настройки заголовков страниц
Вы можете использовать теги tru_tags_if_tag_search, tru_tags_tag_parameter, и txp:search_term для настройки заголовков ваших страниц или вывода результатов поиска по тегам. Более подробное описание тегов будет ниже.
Настройка ваших RSS и Atom лент
По умолчанию tru_tags вставляет теги статей в RSS и Atom ленты, используя стандартные XML элементы, чтобы к примеру Technorati (и другие сайты) могли определить теги. Если вас это не очень устраивает, вы можете поменять настройки плагина во вкладке Расширения -> tru_tags в админке textpattern’а.
В tru_tags так же есть возможность добавления тегов статьи, в тело ленты. Но по умолчанию эта функция отключена. Вы всегда можете включить её в настройках.
Список тегов по умолчанию выводится в конце поста, в таком виде “tags: trees, flowers, animals, etc” (ссылками, и аттрибутом rel=“tag”). Если вы захотите настроить вывод под себя, то создайте новую форму ‘misc’ с названием “ru_tags_feed_tags”. Все что вы добавите в эту форму будет выведено в теле поста в ваших RSS или Atom лентах. К примеру предлагается вот такой вариант формы:
<txp:tru_tags_if_has_tags>
<h4>В рубриках: <txp:tru_tags_from_article /></h4>
</txp:tru_tags_if_has_tags>
В действительности же, эта функция намного более мощная чем может показаться. С её помощью в ленты можно добавлять много полезной информации. Автор плагина к примеру использует её для вставки в пост ссылки “Подробнее…”, а так же для вставки всех написанных пользователями комментариев. Если правильно воспользоваться, то можно вставить и другую полезную информацию.
Автор приводит в пример его форму ru_tags_feed_tags:
<txp:if_excerpt>
<p><txp:permlink>Подробнее...</txp:permlink></p>
</txp:if_excerpt>
<h4 class="tags">В рубриках: <txp:tru_tags_from_article /></h4>
</txp:tru_tags_if_has_tags>
<txp:if_comments>
<hr><h4>Комментарии:</h4>
<txp:comments />
</txp:if_comments>
<txp:tru_tags_if_has_tags>
P.S. В данный момент занимаюсь допереводом мануала. ждем обновлений.