While-kit

Плагин состоит из 3 классов WK_terms, WK_Posts, WK_Pages с их помощью можно отображать списки категорий, постов или страниц, можно рассматривать их как альтернативу стандартным виджетам Категории и Страницы, Последние записи. В отличии от стандартных имеют огромное кол-во настроек. Их можно использовать как в виде виджета, так и в виде шоткода – непосредственно в тексте записи(страницы).

Скачать плагин whale-kit.zip.
WK_terms предназначен для вывода категорий, меток, любых других таксономий, работает через функцию get_terms().
WK_posts для вывода постов, страниц и любых других типов записей. , WK_posts получает данные через класс WP_Query.
WK_pages вывод иерархических структур страниц, постов и других типов записей, данные получает используя функцию get_pages().
get_terms(), WP_Query, get_pages() эти WordPress функции обеспечивает нам широчайший набор входных параметров, соответствующее описание смотрите по ссылкам.

Подробности о каждом классе смотрите по ссылкам WK_terms, WK_posts, а здесь я расскажу об общих правилах – как правильно составить строку запроса и что такое микро-шаблоны.

Правила для виджетов

wk_widjet2

Строка запроса формируется по парам имя=значение далее пары объединяются между собой через ампресанд &. Пример:

taxonomy=category&show_count=1&hierarchical=1&size_of_count=1&hint=в рубрике $name – $count записей

Обратите внимание на параметр hint – здесь задается микро-шаблон для всплывающей подсказки, никаких кавычек не требуется. Наличие ампресанда в самом значении не допускается, разборщик просто обрежет значение после него.
wk_widjet
Второй более наглядный вариант задать строку запроса это писать пары имя=значения построчно. Во время обработки переносы строк будут замещены на все тот же ампресанд, так что использовать его в значении все равно не получится.

Правила для шоткодов

Основные моменты, если кто не в курсе, можно прояснить тут ShortCode Api. От себя добавлю рекомендацию – значение заключать в одинарные кавычки, двойные кавычки оставить для использования внутри этого значения(если требуется). Это позволит удалить лишний код из тегов, типа такого style="".
Пример получим 5 записей из категории =Гостевая книга= id:18, поскольку там у записей нет заголовка придется использовать основной текст и надо предварительно обрезать его до 50 символов:

[wk_posts cat=18 posts_per_page=5 truncate_content=50, date_format = 'd.m.Y'
el_tmpl = '<li><b>$date</b> <a href="$href">$content</a></li>'
/]

Микро-шаблоны

При формировании конечного html кода классы используют микро-шаблоны пример:

hint='$count записей в категории «$name» id:$id'

В нужный момент происходит обработка этого шаблона — вместо $count, $name и $id будут подставлены, соответственно, кол-во записей в категории, имя категории, id категории. В итоге мы получим hitn — всплывающую подсказку. В свою очередь $hint может быть использован уже в другом шаблоне el_tmpl – элемента списка.

Этот простой механизм дает нам очень мощный инструмент – можно сделать вывод списка в виде UL-LI или вариант DIV-SPAN или, как продемонстрировано ниже в приме, таблицей TABLE-TR, вообщем выбор за вами.

[wk_terms hierarchical=0 taxonomy=category number = 5
lv_tmpl='<table>$elements\\n</table>' 
el_tmpl='<tr title="$hint"><td>id:$id</td><td><a href="$href">$name</a></td><td>count:$count</td></tr>' 
/]
id:4 Ads WordPress 3.x count:11
id:6 Ads Функции count:6
id:8 PHP count:7
id:17 Ads-WordPress count:13
id:25 Classfields count:4

\n – символ переноса строки
*для опытных товарищей — подстановка исключительно через str_replace(), никаких регулярных!

Комментарии 3 к “While-kit”

  1. admin:

  2. admin:

  3. Алексей:

    http://irent.com.ua/ использует этот плагин? У них рубрики так красиво выглядят. Скажите, как сделать так как у них?

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *

Можно использовать следующие HTML-теги и атрибуты: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code class="" title="" data-url=""> <del datetime=""> <em> <i> <q cite=""> <strike> <strong> <pre class="" title="" data-url=""> <span class="" title="" data-url=""> [php]…[/php] [html]…[/html] [css]…[/css] [text]…[/text] [code]…[/code]