Использование плагина Tags

Плагин Tags нечасто используется владельцами сайтов на Cotonti Siena. Возможно, потому, что теги или метки ассоциируются у нас с термином блог, который на Котонти по странным причинам реализуется весьма редко. Если же вы решили использовать его, необходимо не просто понимать как его установить и настроить. И не менее важно то, как правильно использовать теги при наполнении сайта.

Tags – это готовый коробочный плагин, который можно установить, сконфигурировать и кастомизировать буквально в течение получаса. Установка и конфигурация обычно не вызывают особых сложностей. Все настройки данного плагина в админке подробно расписаны и затруднений в понимании не вызывают.

К каким элементам можно применять теги?

Стандартно теги можно указать для:

• страниц,
• форумных топиков.

Для этого в дефолтном шаблоне добавления страницы размещается следующий код:

<!-- BEGIN: TAGS -->
<tr>
	<td>{PAGEADD_TOP_TAGS}:</td>
	<td>{PAGEADD_FORM_TAGS} ({PAGEADD_TOP_TAGS_HINT})</td>
</tr>
<!-- END: TAGS -->

Аналогично в шаблоне для добавления топика:

<!-- BEGIN: FORUMS_NEWTOPIC_TAGS -->
<tr>
	<td>{PHP.L.Tags}:</td>
	<td>{FORUMS_NEWTOPIC_FORM_TAGS} ({FORUMS_NEWTOPIC_TOP_TAGS_HINT})</td>
</tr>
<!-- END: FORUMS_NEWTOPIC_TAGS -->

Вывод тегов для страниц и топиков схож: их можно публиковать в шаблоне самого элемента (страница или топик) или в соответствующем разделе (каталог страниц или форум).

В шаблоне page.tpl это выглядит так:

<p>
	<strong>{PHP.L.Tags}:</strong>
	<!-- BEGIN: PAGE_TAGS_ROW -->
	<!-- IF {PHP.tag_i} > 0 -->, <!-- ENDIF --><a href="{PAGE_TAGS_ROW_URL}" title="{PAGE_TAGS_ROW_TAG}" rel="nofollow">{PAGE_TAGS_ROW_TAG}</a>
	<!-- END: PAGE_TAGS_ROW -->
	<!-- BEGIN: PAGE_NO_TAGS -->
	{PAGE_NO_TAGS}
	<!-- END: PAGE_NO_TAGS -->
</p>

В разделе страниц (регулярный блок LIST_ROW) примерно так:

<!-- BEGIN: LIST_ROW -->
...
<!-- BEGIN: LIST_ROW_TAGS_ROW -->
<!-- IF {PHP.tag_i} > 0 -->, <!-- ENDIF --><a href="{LIST_ROW_TAGS_ROW_URL}">{LIST_ROW_TAGS_ROW_TAG}</a>
<!-- END: LIST_ROW_TAGS_ROW -->
<!-- BEGIN: PAGE_NO_TAGS -->
{LIST_ROW_NO_TAGS}
<!-- END: PAGE_NO_TAGS -->
...
<!-- END: LIST_ROW -->

Теги топика размещаются в шаблоне forums.posts.tpl:

<!-- IF {FORUMS_POSTS_TAGS} -->
{FORUMS_POSTS_TAGS}
<!-- ENDIF -->

В регулярном блоке списка топиков FORUMS_TOPICS_ROW (шаблон forums.topics.tpl) код следующий:

<!-- BEGIN: FORUMS_TOPICS_ROW -->
...
<!-- IF {FORUMS_TOPICS_ROW_TAGS} -->
	{FORUMS_TOPICS_ROW_TAGS}
<!-- ENDIF -->
...
<!-- END: FORUMS_TOPICS_ROW -->

Вывод облака тегов

Сводный список или облако тегов можно вывести:

• на главной странице,
• в разделе страниц,
• в разделе топиков.

Для главной страницы облако формируется следующим образом:

<!-- IF {INDEX_TAG_CLOUD} -->
	<h2>{PHP.L.Tags}</h2>
	{INDEX_TAG_CLOUD}
<!-- ENDIF -->

Для раздела страниц:

<!-- IF {LIST_TAG_CLOUD} -->
	<h2>{PHP.L.Tags}</h2>
	{LIST_TAG_CLOUD}
<!-- ENDIF -->

Для форума:

<!-- IF {FORUMS_SECTIONS_TAG_CLOUD} -->
	<h2>{PHP.L.Tags}</h2>
	{FORUMS_SECTIONS_TAG_CLOUD}
<!-- ENDIF -->

Локация тегов

Кроме использования в сторонних шаблонах, плагин тегов имеет и собственную локацию, перейти в которую можно, например, из шаблонизатора по ссылке

{PHP|cot_url('tags')}

Кастомизация локации осуществляется через шаблон tags.tpl, который необходимо скопировать в папку plugins вашей темы и уже там доработать под свой стиль.

Какие расширения совместимы с плагином Tags?

Кроме упомянутых выше модулей Page и Forums плагин Tags поддерживают:

• плагин News,
• функция cot_page_enum(),
• плагин Pagelist.

Поддержка в данном случае означает наличие TPL-тегов для вывода тегов страницы (извините за тавтологию).

Выводы

Настройка и кастомизация плагина Tags доступна администратору или разработчику сайта даже с начальными навыками. Главный вопрос состоит в том, в какой степени необходимо реализовывать весь доступный функционал. На мой взгляд, он слегка избыточен, хотя каждый волен решать это сам. Возможно, наша специальная статья по применению тегов поможет вам в принятии правильного решения.

Как обычно, ждем ваших комментариев или продолжения обсуждения данной темы на наших форумах.