www.textpattern.ru

Статьи и Документация

Плагин stw_category_tree

Автор: Sandor Weisz aka santheo (США)
Первоисточник
Дата статьи: 15.06.2004

Скачать

Работает подобно тэгу category_list, но вместо линейного списка категорий, создается иерархическая структура категорий. Поддерживает контроль глубины вложенности категорий, упрощение структуры и некоторые CSS свойства.

Плагин поддерживает следующие параметры:

start Если вы хотите, чтобы дерево категорий начиналось не с корня(самый верхний уровень категорий), а с какой-то определенной категории, присвойте этому параметру имя этой категории. Будут отображаться все подкатегории, находящиеся ниже указанной. Если параметр не установлен, дерево начинается с корня. Если параметром указан *, дерево категорий будет начинаться с текущей категории. Если указано *s, в качестве корня будет установлена текущая секция.

maxlevel Максимальная вложенность подкатегорий, которую вы хотите отобразить. Если параметр не определен, отображаются все подкатегории.

minlevel Наименьший уровень вложенности отображаемых подкатегорий. Если параметр не определен, минимума нет.

prune Когда данный параметр установлен в true, дерево категорий будет упрощаться, модифицироваться в зависимости от текущего положения посетителя. Отображаться будут a) родители текущей категории, b) текущая категория, c) 1 уровень потомков текущей категории, или d) родственные категории {a} и {b}. По умолчанию установлено в false.

примечание переводчика: Наглядная работа этого параметра хорошо видна при глубокой вложенности категорий. Попробуйте создать 4-5 уровневую структуру и укажите в плагине prune=true. Получается симпатично.

cat Работает в комбинации с параметрами prune или onclass (ниже). Если параметру присвоено имя категории, то установленное значение отменяет вывод текущей категории когда prune=true. Параметр влияет на переназначение class=”...”, если используется параметр onclass.

примечание переводчика: При установленном prune использование данного параметра приводит к тому, что дерево категорий не реагирует на изменение текущей категории в отображении дерева при перемещении посетителя по сайту. Визуализируется только указанная категория, ее родители и ее потомок. Реакция параметра при onclass не проверялась.

section Если вы хотите вывести ссылки на категории какой-то определенной секции, присвойте этому параметру наименование этой секции. Если не определен, указываются ссылки в текущей секции.

примечание переводчика: Либо я неправильно понял назначение этого параметра, либо что-то там глючит. При попытке задать в качестве параметра имя несуществующей секции – вывод все равно происходит, то же самое происходит при выводе пустой секции – выводятся категории текущей секции.

cssid Значение CSS идентификатора, которое бы вы хотели задать тэгу ul верхнего уровня. Если не задан, параметр игнорируется.

примечание переводчика: Не испытывал

onclass Значение, которое вы хотели бы назначить свойствам class текущей категории и всех ее прародителей. Замечание: Если эта величина отличается от пустой строки, id параметра будет устанавливаться всем тегам li with the value set to that li’s category. Если параметр не установлен, то ни class, не id атрибуты не устанавливаются.

примечание переводчика: Не испытывал

type Определяет, какого типа выводить дерево категории: `article’, `image’ or `link’. По умолчанию выводит тип `article’.

count Если параметру присвоено значение true, то каждая ссылка на категорию сопровождается количеством реальных articles/links/images, присутствующих в соответствующей категории, выводится в скобках. Если вы планируете разместить числовые значения внутри другой пары символов, укажите в параметре count эти символы. Например, чтобы вывести “CategoryName {3}”, присвойте count значение ”{}”. По умолчанию count=false.

 
Rambler's Top100