Дизайн та розробка сайту

Вывод рубрик в виде списка – функция wp_list_categories()

Доброго времени суток!
Сегодня мы рассмотрим функцию wp_list_categories(), с помощью которой можно вывести список рубрик, например в сайдбаре и настроить вывод как нам угодно. Можно исключить рубрики, указать метод сортировки и тд.
Вот пример списка с моего сайта.

   <ul>
	 <?php wp_list_categories('exclude=10&title_li='); ?>
   </ul>


exclude=10
- отключение вывода рубрики с ID 10
title_li= пустой параметр, чтобы избавиться от заголовка(РУБРИКИ). Я его прописал немного иначе.
Результат в html будет выглядеть примерно так:

<ul>
  <li class="cat-item cat-item-14">
        <a title="Просмотреть все записи в рубрике «Новости»" href=""></a>
  </li>
  <li class="cat-item cat-item-11 current-cat">
        <a title="Просмотреть все записи в рубрике «Статьи»" href=""></a>
  </li>
</ul>

для более тонкой настройки данной функции, у нее есть еще некоторые параметры, которые мы рассмотрим.

show_option_all
(строка) Нужно ли добавить ссылку на главную страницу? Можно указать любое значение, например ‘На главную’.

orderby
(строка) Каким образом вы хотите отсортировать категории?

  • ID – по id категории (по умолчанию)
  • name – по имени
  • slug – по ярлыку
  • count – по числу записей

order
(строка) Устанавливает порядок сортировки.

  • asc – по возрастанию (по умолчанию)
  • desc – по убыванию

style
(строка) Стиль вывода списка категорий.

  • list – в виде
  • -списка (по умолчанию)
  • none – в виде ссылок, разделенных тегом

show_count
(логическое) Указывает в скобках количество постов в каждой из рубрик.

  • 1 – да
  • 0 – нет (по умолчанию)

hide_empty
(логическое) Нужно ли исключить пустые рубрики (категории) из списка?

  • 1 – да (по умолчанию)
  • 0 – нет

use_desc_for_title
(логическое) Нужно ли использовать описание рубрик в атрибуте title для ссылок, если оно имеется.

  • 1 – да (по умолчанию)
  • 0 – нет

child_of
(целое число) Нужно указать id рубрики, подрубрики которой вы хотите вывести.

feed
(строка) Рядом с каждой категорией вставляет ссылку на RSS-ленту. Указанное значение будет текстом этих ссылок.

feed_image
(строка) Аналогичен предыдущему параметру, но только вставляет ссылку с картинкой. В качестве значения укажите адрес картинки.

feed_type
(строка) Тип RSS-ленты.

  • atom
  • rdf
  • rss
  • rss2 (по умолчанию)

exclude
(целое число) Перечислите через запятую id категорий, которые вы хотите исключить из списка.

exclude_tree
(целое число) Исключить рубрику и все её подрубрики из списка. Работает только при выключенном hierarchical.

include
(целое число) Укажите через запятую категории (их id), которые вы хотите включить в список.
hierarchical
(логическое) Нужно ли создавать вложенные списки для подкатегорий?

  • 1 – да (по умолчанию)
  • 0 – нет

pad_counts
(логический) Считать общее количество постов во вложенных категориях и показывать это число рядом с родительской категорией. Параметр включается автоматически при включенных show_counts и hierarchical. Добавлен с версии 2.9.
По умолчанию: 0 (false)
title_li
(строка) Заголовок для списка категорий. По умолчанию __( ‘Categories’ ). То есть в русском WordPress это будет переведено в «Рубрики». Оставьте параметр пустым, чтобы избавиться от заголовка.

number

(целое число) Сколько категорий нужно отобразить в списке?

echo

(логическое) Вывод списка категорий или сохранение результата в переменную.

  • 1 – да (по умолчанию)
  • 0 – нет

depth
(целое число) Количество уровней вложенности списка.

  • 0 – неограниченно (по умолчанию)
  • -1 – без уровней вложенности, параметр hierarchical игнорируется
  • n – любое целое число

taxonomy
(строка) Выберите таксономию для вывода

  • category – рубрики (по умолчанию)
  • taxonomy – любая зарегистрированная таксономия

current_category
(целое число) Укажите id категории из списка, для которой вы хотите добавить css-класс «current-cat». По умолчанию он добавляется к той категории, в которой в данный момент находится пользователь.

Есть еще один момент. Если вы много пропишите свойств, то в будущем просто запутаетесь где и что. Поэтому сначала функции можно присвоить массив $args, после чего он просто указывается в скобках. Вот как пример:

<?php
$args = array(
  'orderby'      => 'name',  // сортируем по названиям
  'show_count'   => 0,       // не показываем количество записей
  'pad_counts'   => 0,       // не показываем количество записей у родителей
  'hierarchical' => 1,       // древовидное представление
  'title_li'     => ''       // список без заголовка
);
?>

<ul>
<?php wp_list_categories( $args ); ?>
</ul>

На этом все. Спасибо за внимание 🙂

Дизайн та розробка сайту

Back to top