Плагин Simple Tagging. Русификация и интегрирование в шаблон.

После неудачной попытки разобраться с плагином Jerome’s Keywords установил и успешно интегрировал плагин Simple Tagging. Заодно решил полностью его русифицировать, т.к. опций там огромное количество и чтобы можно было быстро в них разобраться без языкового барьера.

Английский я знаю достаточно прилично, но многим думаю очень это пригодится. Воспользовавшись программой Poedit за несколько часов сделал перевод. Содержится описание установки в файле readme.txt архива. Также можно скачать полностью русифицированную версию плагина с интегрированным русским языком в тело плагина (не требует внешних языковых файлов). Ставится точно также как обычный.

Здесь и далее описана текущая версия 1.7. Предыдущие версии 1.6.8.1 и 1.6.7 отличаются в основном другой структурой меню в панели администрирования и меньшими возможностями. Версия 1.6.7 оставлена для скачивания, но использовать ее не рекомендуется (присутствует баг с уязвимостью).

Интересные возможности плагина

• Умеет автоматически угадывать окончание имя тега, если уже его вводили ранее
• Под строкой ввода тегов имеются кнопки для быстройвставки рекомендуемых тегов(учитывается текст сообщения) :)
• Умеет быстро переименовывать/добавлять/объединять теги во всех записях сразу
• Импортировать теги из таблиц других плагинов, работающих с тегами
• Умеет раскрашивать облако тегов, задавать различные варианты сортировки и масштабирования
• Отображет число использованных тегов в панели администрирования. Покопавшись в плагине можно сделать и вывод возле название тега в облаке.

Изменения в новой версии 1.7

• Все настройки в админке перенесены в отдельное меню с 4 закладками
• Новая возможность – просмотр тегов не целиком в облаке тегов, а с фильтрацией по начальным буквам (работает только с цифрами и английским алфавитом)
• Новая возможность – в админке появилась страница для массового редактирования тегов, не открывая записи. Причем панель с тегами “плавает” вверхв-вниз чтобы всегда быть на экране.
• Больше не требуется внешний плагин для правильного вывода тегов в заголовке блога
• Полностью изменена структура файлов. Если была установлена предыдущая версия, то необходимо отключить плагин, удалить папку с сервера и закачать новую версию. Никакие данные и настройки не потеряются :-)
• Официально совместимо с WP до 2.2.3 версии включительно. Следующая версия 1.8 обещает быть совместимой и с WP 2.3 (хотя там и есть уже встроенные теги, но функционально там пока все слишком ограниченно и решается только за счет отдельных плагинов)

Мои доработки версии 1.7

• В админке на странице массового редактирования тегов: оригинальная версия работает только с английским алфавитом, я сделал отдельную версию (на выбор), которая выводит весь список тегов, включая русские
• Там же исправил ошибку с путями: если у вас блог находится не в корне сайта, а в папке, то в оригинальном плагине при переходе на “следующую страницу” вылезает ошибка 404
• Исправил вывод заголовков: сделал в стиле как выводил добавочный плагин A2P Simple Tagging Titles. Т.е. вы его можете отключить, если установлен. Теперь это умеет делать сам плагин. НО в оригинале он работает ужасно. Для примера: У меня заголовок сайта Lecactus Home. В оригинале плагин выводит примерно так Lecactus Homeкино . Я исправил это на такой формат: Lecactus Home > Тег: кино (где “кино” это тег или несколько тегов). Если вы хотите это изменить, то надо открыть в UTF-8 редакторе файл плагина simpletagging.php и найти строку

 $title = " » Тег: ".STP_GetCurrentTagSet();  

//Здесь можно изменить формат вывода тега в заголовке страницы. Функцию переделал Lecactus

здесь вы можете задать свой формат вывода тегов в заголовке (требуется минимальное знание синтаксиса php)

• Как и ранее полностью перевел файл ru_RU.mo с учетом изменений и добавлений, а также сделал полностью русскую версию без внешних файлов локализации. Причем версия с ru_RU.mo представлена в двух видах: на странице массового изменения тегов есть различия: с фильтрацией по начальным буквам (английским) и вывод всего списка тегов. В целиком русской версии сделан вариант вывода всех тегов, как более корректный с точки зрения удобства использования.

Скриншоты из версии 1.7

Новое меню в разделе настроек

Панель массового редактирование тегов (мой вариант выводит все теги)

Панель массового редактирования тегов (оригинальный вариант с выбором по буквам)

Видеодемонстрация панели администрирования

Только для версии 1.7 и выше

Добавилась лишь одна опция: для вывода вкладок тегов (отфильтрованные по первой букве теги с учетом размеров в облаке) надо создать пустую страницу и выбрать в шаблон “Вкладки тегов”. Для этого надо предварительно поместить файл pagetemplate.tagtabs.php в папку вашей темы. Также можно выводить эту функцию в любом месте шаблона. для этого надо из вышеуказанного файла скопировать функцию

</p>
<h3>Вкладки тегов</h3>
<p> <?php if (class_exists('SimpleTagging')) : ?></p>
<div id ="tagtabs"> <?php STP_TagTabs(); ?> </div>
<p> <?php endif; ?>   

Порядок установки

• Скачиваем выбранную версию плагина (если вы потом хотите изменить версию плагина то нет никаких проблем. просто отключаете предыдущую. удаляете и ставите другую. после активации все настройки и данные будут на месте)
• Распаковываем загруженный архив и помещаем папку simpetagging (или simple-tagging) в вашу директорию plugins (/wp-content/plugins/).
• Если вы используете версию с локализацией через MO файл, то тут важно чтобы на сервере была установлена локаль ru_RU utf-8 (впрочем это требуется для всех плагинов с мультиязычной поддержкой). Если ваш блог использует локализацию аналогичным способом, то скорее всего у вас на хостинге уже все нормально

Пример для Debian linux: apt-get install i18ndata* localedef -c —no-archive —inputfile=ru_RU —charmap=UTF-8 ru_RU.UTF-8

• Включаем плагин в панели администрирования плагинов WordPress.
• Переходим в Admin > Tags > Tag Options (Администрирование > Теги > Настройки в рус.варианте), настраиваем по вкусу и сохраняем параметры.
• Переходим в Admin > Options > Permalinks (Администрирование > Настройки > Постоянные ссылки(ЧПУ)) и нажимаем кнопку чтобы обновить структуру постоянных ссылок (очень важно).

На этом установка плагина завершена и переходим к интегрированию в тему

Встраиваем в тему (на примере моего сайта)

• В архиве с плагином есть папка wordpress 2.2 template files for default theme (kubrick). Из нее берем файлы pagetemplate.simpletagging.php и pagetemplate.tagcloud.php и копируем в папку своей темы.
• В той же папке находим файл index.php и копируем оттуда строку

</p>
<p class="postmetadata"><?php if (class_exists('SimpleTagging')) { echo 'Tags: '; STP_PostTags(); } ?><?php edit_post_link('| Edit', '', ' | '); ?></p>
<p>   

Этот кусок кода вставляем в index.php а также в page.php, single.php и все остальные файлы нашей темы где есть вывод записей. Естественно, редактируем данный шаблон по вкусу.

У меня получилось так:

</p>
<p class="post-tags">Тэги: <?php STP_PostTags('<a href="http://lecactus.ru/tag/%tagname%">%tagname%</a>'); ?></p>
<p>  

В моем случае я задал свой формат вывода, отличный от того что мы настроили в панели управления. Все варианты можно увидеть на домашней странице плагина (англ.). Поясню: делал я этого до того как сделал перевод и не понял почему у меня сначала получались ссылки “вникуда”. Например вместо http://lecactus.ru/tag/видео получалось http://lecactus.ru/видео и ничего не работало. Просто по умолчанию в настройках стоит короткая ссылка на тег

%taglink% вместо полной %fulltaglink%

Одну особенность работы плагина заметил Evalusion :

если задать шаблон ссылок вида /archive/%year%/%monthnum%/%day%/%postname%/ т.е. добавить к началу шаблона еще какое то слово и при этом задать шаблон ссылки тега %fulltaglink% то ссылка пойдет по адресу /archive/tag/тег что не правильно. для исправления глюка надо задать шаблон вида /tag/%taglink% если у вас блог лежит в корне сайта или перед этим шаблоном добавить еще название каталога блога.

• В sidebar.php (или другое место где у нас будет облако тегов) вставляем в нужном месте код:

</p>
<h2>
<p><?php _e('Тэги'); ?></p>
</h2>
<p><?php if (class_exists('SimpleTagging')) : ?></p>
<ul id ="tagcloud">
<p><?php STP_Tagcloud(); ?></p>
</ul>
<p><?php endif; ?></p>
<p>

Также можно воспользоваться плагином Simple Tagging Widget Текущая версия 0.4 поддерживает работу со всеми последними версиями плагина Simple Tagging

• Создаем новую страницу с шаблоном Tag Cloud и вставляем ссылку на данную страницу в нужном месте. Там у нас будут отображено все облако тегов целиком
• Модифицируем следующий файл pagetemplate.simpletagging.php в соответсвии с шаблоном блога. Ниже приведен мой файл целиком:

</p>
<p><?php  /*  Template Name: Simple Tagging Search Results  */  ?></p>
<p><?php get_header(); ?></p>
<div id="content" class="narrowcolumn">
<p><h2 class="pagetitle">Результаты поиска по тэгам ‘<?php STP_CurrentTagSet(); ?>’</h2>
</p>
<p><?php if (have_posts()) : ?></p>
<p><?php while (have_posts()) : the_post(); ?></p>
<div class="post">
<p><h2 class="post-title"><a href="<?php the_permalink() ?>" rel="bookmark" title="Постоянная ссылка: <?php the_title(); ?>"><?php the_title(); ?></a></h2>
</p>
<p><p class="post-info"><em class="date"><?php the_time('j F Y в G:i'); ?></em><em class="user"><?php the_author_posts_link() ?></em><em class="cat"><?php the_category(' &amp;amp; ') ?></em></p>
</p>
<div class="entry">
<p><?php the_content('Далее »'); ?></p>
<p><?php wp_link_pages(); ?></p>
<p><?php edit_post_link('Редактировать'); ?></p>
<p class="post-comments">
<p><?php comments_popup_link('Комментариев нет', 'Комментарий всего 1 »', 'Комментариев: % »'); ?></p>
<p><p class="post-tags">Тэги: <?php STP_PostTags(); ?></p>
</p>
<p><?php if(function_exists('the_ratings')) { the_ratings(); } ?></p>
</p>
<p> <!-- <?php trackback_rdf(); ?> --> </div>
</div>
<p><?php endwhile; ?></p>
<div class="navigation">
<p><div class="alignleft"><?php next_posts_link('« вперед в будущее') ?></div>
</p>
<p><div class="alignright"><?php previous_posts_link('назад в прошлое »') ?></div>
</p>
</div>
<p><?php else : ?></p>
<p><h2 class="center">Не найдено</h2>
</p>
<p><p class="center">Извините, но здесь нет того что вы ищете.</p>
</p>
<p><?php endif; ?></p>
</div>
<div id="sidebar">
<ul>
<li id="relatedtags">
<p><h2>Связанные тэги</h2>
</p>
<ul>
<p><?php STP_RelatedTags() ?></p>
</ul>
<ul style="margin-top:1em;">
<p><?php STP_RelatedTagsRemoveTags() ?></p>
</ul>
</li>
</ul>
</div>
<p><?php // get_sidebar(); ?></p>
<p><?php get_footer(); ?></p>
<p>

Ничего нам конечно не мешает создать новую страницу с таким шаблоном, только смысла нету. выйдет одно и тоже. Если вы все же создадите страницу с таким шаблоном Simple Tagging Search Results, то не забудьте указать ее имя потом в панели настроек плагина. В принципе больше никаких особых настроек делать не нужно, кроме как подредактировать ваш CSS файл (если вы используете для вывода облака тегов виджет, то ничего делать не нужно).

Я добавил следующее (частично взял из дистрибутива плагина и создал еще свой стиль вывода тегов):

</p>
<p>/********* Tag Cloud *********/</p>
<p>ul#tagcloud { padding:0; margin:0; text-align:center; list-style:none; }</p>
<p>ul#tagcloud li { display:inline; font-size:70%; color:#ccc;}</p>
<p>ul#tagcloud li.t1 a { color:#797979; font-size: 120%; }</p>
<p>ul#tagcloud li.t2 a { color:#6d6d6d; font-size: 160%; }</p>
<p>ul#tagcloud li.t3 a { color:#616161; font-size: 190%; }</p>
<p>ul#tagcloud li.t4 a { color:#555555; font-size: 210%; }</p>
<p>ul#tagcloud li.t5 a { color:#484848; font-size: 230%; }</p>
<p>ul#tagcloud li.t6 a { color:#3c3c3c; font-size: 250%; }</p>
<p>ul#tagcloud li.t7 a { color:#303030; font-size: 270%; }</p>
<p>ul#tagcloud li.t8 a { color:#242424; font-size: 290%; }</p>
<p>ul#tagcloud li.t9 a { color:#181818; font-size: 310%; }</p>
<p>ul#tagcloud li.t10 a { color:#0c0c0c; font-size: 330%; }</p>
<p>ul#tagcloud a</p>
<p>{</p>
<p>text-decoration:none;</p>
<p>border-bottom: 0px solid;</p>
<p>}</p>
<p>ul#tagcloud a:hover</p>
<p>{</p>
<p>text-decoration:none;</p>
<p>border-bottom:1px dashed;</p>
<p>}</p>
<p>/********* Related Tags *********/</p>
<p>li#relatedtags ul li {</p>
<p>text-indent: 0;</p>
<p>list-style:none;</p>
<p>background: 0 none;</p>
<p>font-size: 120%;</p>
<p>}</p>
<p>li#relatedtags ul li:before {</p>
<p>content: ""</p>
<p>}</p>
<p>li#relatedtags ul li span {</p>
<p>margin-right: .5em;</p>
<p>}</p>
<p>#content .post-tags</p>
<p>{</p>
<p>font-size:0.9em;</p>
<p>margin:0;</p>
<p>color:#998;</p>
<p>background:#f9fcf9;</p>
<p>}</p>
<p>#content .post-tags a</p>
<p>{</p>
<p>text-decoration:none;</p>
<p>border-bottom: 0px solid;</p>
<p>color:#998;</p>
<p>}</p>
<p>#content .post-tags a:hover</p>
<p>{</p>
<p>text-decoration:none;</p>
<p>border-bottom:1px dashed;</p>
<p>color:#666;</p>
<p>}</p>
<p>

Вывод облака в сайдбаре можно разнообразить. Например следующий код

<?php STP_Tagcloud('</p>
<li class="t%scale%"><a title="%tagname% (%count%)" href="%fulltaglink%">%tagname%</a></li>
<p>',' ',FALSE,'Random','50','2'); ?>   

покажет в облаке только теги, если их количество не менее двух и не более 50, порядок вывода будет каждый раз случайным. А ссылку на все теги можно дать отдельно. Если заменить в строке FALSE на TRUE то к тегам будут добавлены и рубрики. Также можно добавить в файл вывода поиска по тегам следующий код, который покажет список всех записей, у которых также есть связанные теги

</p>
<ul>
<li>
<p><?php if (class_exists('SimpleTagging')) : ?></p>
<p><h2>Связанные записи:</h2>
</p>
<ul>
<p><?php STP_RelatedPosts() ?></p>
</ul>
<p><?php endif; ?></p>
</li>
</ul>
<p>

Подсказка как использовать Simple Tagging в WordPress Mu как “mu-plugins”. (источник)

Загрузите SimpleTagging, распакуйте его в папку wp-content/mu-plugins/simple-tagging/

Создайте файл stp.php в папке wp-content/mu-plugins/ отредактируйте “stp” и впишите в него :

<?php include('simple-tagging/simpletagging.php'); ?>   

Только для версии 1.6.8.1 и ниже

A2P SimpleTagging Titles добавочный плагин к данному плагину (устраняет недоработку с выводом название тега в заголовке). Обсуждение его работы на форуме maxsite.org

Часто задаваемые вопросы и ответы, а также возможные трудности и способы решения

Известные проблемы и ограничения (перевод страницы)

• Не работает с WordPress 2.3 beta 3, и без изменений не работает в 2.3. (с выходом патча для версии 1.7 уже не актуально)
• полностью протестировано выпадающее меню при наборе тегов в IE, Firefox и Opera, Однако неизвестно, работает ли это в других современных браузерах
• только в Internet Explorer: выпадающее меню тегов сдвигается вниз: абсолютная проблема IE. автор будет признателен если кто то сможет решить этот вопрос CSS. (от себя замечу что в IE как раз все работает, а вот в Опере выпадающи список съезжает глубоко вниз в конец страницы редактирования записи)
• только в WP 2.0.x: При использовании “связанных тегов” и просмотре более одного тега,ссылки ” Последние сообщения” и “Следующие сообщения” ссылки не работают должным образом, и показываются даже, если нет больше записей. Эта проблема не возникает в WordPress 2.1.
• проблемы с некоторыми не-английскими символами в тегах. грубо говоря это значит что тег “ščtest” не будет в пермалинке выглядеть как “sctest” (для русских это не актуально, т.к. все русские символы кодируются в юникод и выдаются в виде %C5 и т.п. (хотя Опера умеет показывать ссылки нормально))
• Конфликтует с плагином Inline Ajax Page v2.4.25 в WP2.2.1 при использовании локального сервера WAMP5.
• Панель администрирования->Теги->Управление тегами – с левой стороны где перечислены существующие теги, категории номеров предположим ссылку на тег дает 404 (я такого бага у себя не вижу. возможно у автора плагина просто стояли не полные ссылки там, а просто названия тегов и адрес был неправильным поэтому)
• Конфликтует с плагином WP Ajax Edit Comment v1.1.0.6 в WP 2.2.2 – последний пункт даже переводить не надо – он относится к старой версии 1.6.7

Протестирована работа с WordPress 2.2 – 2.2.3. Ошибок не выявлено. Официально заявлена совместимость с WP 2.1 – 2.2.3.

После выхода версии 1.7 автор выпустил патч для плагина, позволяющий использовать плагин и в версии WP 2.3, но с некоторыми ограничениями:

• нет возможности задавать основу для ссылок тегов вида вашсайт.ру/tag/какойто-тег, т.к. данный адрес уже занят новой системой тегов версии 2.3. Вместо этого приходится задавать другую базу. например tags , т.е. ссылки получатся вида вашсайт.ру/tags/какойто-тег. Данный патч пока проходит тестирование и я его в сборку 1.7 не включал, но вы можете скачать его отдельно здесь у автора плагина, чтобы поэкспериментировать.

FAQ от меня лично (накопилось после общения с пользователями)

• Если у вас после установки не работает поиск по тегам или например только по русским тегам не ищет и вы используете красивые ЧПУ, то разрешите запись в файл htaccess

т.к. даже если вставлять туда код вручную тогда почему то не хочет при этом искать по тегам. после сохранения можно вернуть снова запрет на запись.

• Второй очень важный момент – сразу после установки проверьте в какой кодировке у вас создались таблицы тегов. Если кодировка(сопоставление/collate) отлична от utf8_general_ci, то все ваши русские теги будут в большинстве случаев превращены в “вопросики” либо не будет работать поиск по ним.

Для решения проблемы через phpmyadmin поменяйте кодировки таблиц или если не умеете делать это там, то экспортируйте таблицу тегов (ПРЕФИКСБЛОГА_stp_tags) в файл, подправьте его в UTF-8 редакторе и поменяйте там значения ENGINE=MyISAM DEFAULT CHARSET=latin1 на ENGINE=MyISAM DEFAULT CHARSET=utf8 и сохранить сам файл в кодировке UTF-8, особенно если там уже заполнены теги на русском. Потом также зайти в phpmyadmin, удалите эту таблицу тегов и находясь в базе данных блога импортируйте все назад. Этот экспорт-импорт также удобен для удаления “вопросиков” если вы все же уже заполнили теги до конвертации кодировки, т.к. штатными средставми блога их не удалить, а в phpmyadmin это долго. Особенно надо внимательно смотреть при импорте тегов из других плагинов. т.е. проверить правильность кодировки таблиц плагина simpletagging до импорта. Иначе потом вместо импортированных русских тегов будут “вопросики”. Также поиск по русским тегам зависит от того, какая кодировка стоит на веб-сервере по умолчанию. Если это не UTF-8 то добавьте строку

AddDefaultCharset UTF-8 в файл htaccess

• Если у вас по какой либо причине что то не работает, в 99% случаев это проблема с кодировками базы или просто у вас очень запорчена база при экспериментировании с другими плагинами. В этом убедились уже несколько человек, кому я помогал при установке.
• Если у вас просто запорчена база – экспортируйте все ваши записи через панель блога или через phpmyadmin. В идеале нужно выгружать только записи, комментарии и настройки пользователей. Удалите все ненужные плагины и “хвосты” от них и залейте базу назад. Все это делайте, только если хорошо в этом разбираетесь! Лично у меня, когда я заглянул в phpmyadmin и увидел “кашу” в своей базе то не понимаю до сих пор как все при этом правильно работает, т.к. там все таблицы в перемешку храняться в разных кодировках и только внешняя выставлена как UTF-8. :) Как исправить кашу в базе данных описано здесь у меня

ВАЖНО: при копировании php кода из блога перебивайте вручную все кавычки!

---

Скачать

Модифицированная русская версия 1.7 с выводом всех тегов

Скачали 1956 раз

Скачали 694 раз

Оригинальная русская версия 1.7

Скачали 890 раз

Скачали 667 раз

Более старые версии плагина удалены. Комментарии отключены, все вопросы по плагину уже давно рассмотрены. читайте комментарии внимательно. Плагин не работает с WordPress 2.3 и выше и предназначен только для WordPress 2.2.3 и ранее.

Связанные записи

• Плагин Simple Tags для WordPress 2.3 – 2.7. Русская версия (333)
• Плагин WP-Useronline 2.1.1. Русская версия (56)
• Плагин Wp-postratings (версии для WP2.1-WP2.7) Русская версия (220)
• Плагин WP-Polls 2.20, 2.21, 2.31, 2.40 для wordpress 2.1-2.7. Русские версии (272)
• WP-Postratings 1.20 для WordPress 2.3. Русская версия (8)