get_categories() — функция для вывода рубрик

2.1.0 wp-includes / category.php / Кодекс WordPress

Удобная функция для вывода категорий в WordPress. Очень широко используется в плагинах и темах. Хотя лично я вместо неё предпочитаю get_terms().

get_categories( $args = '' )

$args

(массив|строка) параметры функции:

taxonomy: (строка) таксономия, по умолчанию — category (т.е. рубрики).

Все остальные параметры переменной $args полностью идентичны параметрам массива $args функции get_terms().

Возвращаемые значения функции

Функция возвращает массив, состоящий из объектов категорий (или других таксономий), удовлетворяющих заданным критериям. Каждый из объектов содержит информацию о категории, например ID, название, ярлык, описание и т.д. Содержимое объекта я уже рассматривал тут.

Пример 1. Выводим названия всех категорий через запятую

Напоминаю, что подробное описание всех параметров есть в документации функции get_terms().

$all_categories = get_categories('fields=names');
echo implode(', ', $all_categories); // функция implode() преобразует массив в строку

Пример 2. Выводим все категории, даже пустые, в виде ссылок через запятую

Для получения ссылки на страницу архива рубрики можно использовать функции get_category_link() или get_term_link().

$all_categories = get_categories('hide_empty=0');
$category_link_array = array();
foreach( $all_categories as $single_cat ){
	$category_link_array[] = '<a href="' . get_category_link($single_cat->term_id) . '">' . $single_cat->name . '</a>';
}
echo implode(',', $category_link_array);

Пример 3. Создание выпадающего списка рубрик с автоматическим переходом на них при выборе

На момент написания этой статьи подобная навигация по рубрикам стоит у меня на блоге. На самом деле делается это совсем не трудно. Буквально одна строчка JavaScript — и всё готово.

$all_categories = get_categories();
if( $all_categories ){ // выводить пустой список в случае, если рубрик нет, ни к чему
	echo '<select onchange="document.location.href=this.options[this.selectedIndex].value;"><option value="">Выберите категорию</option>';
	foreach( $all_categories as $single_cat ){
		echo '<option value="' . get_category_link($single_cat->term_id) . '">' . $single_cat->name . '</option>';
	}
	echo '</select>';
}

Фильтр get_categories_taxonomy

Начиная с версии WordPress 2.7.0 параметр таксономии taxonomy можно пропустить через фильтр.

function change_taxonomy_for_get_categories($taxonomy, $args){
	// $taxonomy - таксономия по умолчанию, т е либо category, либо то, что было передано в параметрах функции
	// $args - все параметры функции
	return 'post_tag'; // в качестве таксономии задали метки поста 
}
add_filter('get_categories_taxonomy', 'change_taxonomy_for_get_categories', 20, 2);

Если просто вставить этот фильтр в functions.php вашей темы, то функция get_categories() уже будет работать неправильно — вместо рубрик возвращать метки.

Используйте этот фильтр при необходимости и с осторожностью.

Кодекс WordPress: Рубрики: cat_is_ancestor_of(), category_description(), get_cat_ID(), get_cat_name(), get_categories(), get_category(), get_category_by_slug(), get_category_link(), get_category_parents(), get_the_category(), get_the_category_by_ID(), in_category(), is_category(), single_cat_title(), the_category(), wp_get_post_categories(), wp_insert_category(), wp_list_categories()

Миша

Впервые познакомился с WordPress в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школе Нетология.

Пишите, если нужна помощь с сайтом или разработка с нуля.

Комментарии — 11

Dennis 25 Апр 2015
Подскажите пожалуйста, есть шаблон category.php.
Есть рубрики. В некоторых есть вложенные. Как выводить на странице site.ru/rubrika1 - вложенные рубрики и записи в них?
Не универсальное решение - сделать индивидуальный шаблон и по ID вывести...
Хотелось бы универсальное.
Dennis 25 Апр 2015
Сформулирую иначе.
Все публикации на сайте входят в рубрику Статьи. В рубрике Статьи много вложенных рубрик.
Как по адресу site.ru/vse-stati вывести все в таком виде

Название подрубрики (кликабельное)
-запись вложенной рубрики.
-запись вложенной рубрики.

Название подрубрики (кликабельное)
-запись вложенной рубрики.
-запись вложенной рубрики.
- Миша 26 Апр 2015
  Как раз таки при помощи get_categories() (обязательно используем параметр parent или child_of), а внутри цикла можно будет запустить ещё WP_Query.
  - Dennis 28 Апр 2015
    А что-то ближе к коду можно? :о)
  - Dennis 28 Апр 2015
    Разобрался. Спасибо за подсказку. Осталось прикрутить только проверку на наличие вложенных/дочерних рубрик.

Далв

1 Сен 2015

В целом все верно, но так было бы получше:

    $category_link = sprintf( '<a href="%1$s" alt="%2$s">%3$s</a>'
        esc_url( get_category_link( $category->term_id ) ),
        esc_attr( sprintf( __( 'View all posts in %s', 'textdomain' ), $category->name ) ),
        esc_html( $category->name )
    );

Взято из каментов к оф докам

Александр

6 Ноя 2015

у меня в шаблоне страница карат сайта не выводит подрубрики.
у меня в атрибутах страницы выбран шаблон map.php
вот код map.php:

пожалуйста, скажите как добавить сюда вывод подкатегорий в функцию get_categories

Миша

7 Ноя 2015

Используйте пожалуйста кнопки редактора для вставки кода, не надо мне тут помойку устраивать.

Александр

7 Ноя 2015

<?php  /* Template Name: map.php */
get_header(); 
?>
<div class="container">
    <div class="row" id="page">                          
        <div class="span12">                
             <div class="span8" id="maincolumn">     
                 <div class="content">    
                      <div class="row"> 
                           <?php the_breadcrumb() ?> 
 
                           <h1 class="<?php if (get_theme_mod('show_line') == '1') { ?>category-line<?php } elseif (get_theme_mod('show_line') == '2') { ?>category-gray-line<?php } else { ?><?php } ?>">Карта портала</h1>
                           <?php if (function_exists('ddsg_create_sitemap')) { 
                                  echo ddsg_create_sitemap();
                             } else {
                                  echo '<div id="site-map">';
             $cats = get_categories('parent=0&orderby=name&hierarchical=0');
                                    foreach ($cats as $category) {
                                        print '<div class="category category-map"><a href="'.get_category_link($category->cat_ID).'">'.$category->name.'</a></div>';
                                        print '<ul>';
                                        query_posts(array('cat' => $category->cat_ID,'showposts'=>1000));
                                        while (have_posts()) {  the_post();
                                      $showed_ids[] = get_the_ID();
                            ?>
                                      <li><a href="<?php the_permalink() ?>" rel="bookmark" title="<?php the_title(); ?>"><?php the_title() ?></a></li>
                            <?php } 
                                    echo '</ul>';
                                 }        
                                    echo '</div>';
                                 }
                            ?>                         
                      </div><!--End row--> 
                 </div><!-- End content--> 
             </div><!-- End span8--> 
 
             <div class="span4" id="sidebar"> 
                  <?php get_sidebar(); ?>
             </div>  
        </div><!-- End span12-->  
   </div><!-- End row-->      
</div><!-- End container -->
 
<?php get_footer(); ?>

Александр 7 Ноя 2015
очень жду от вас помощи. спасибо
- Миша 8 Ноя 2015
  Измените строчку:
  $cats = get_categories('parent=0&orderby=name&hierarchical=0');
  на:
  $cats = get_categories('orderby=name&hierarchical=0');
  .

Чтобы оставить комментарий, пожалуйста, зарегистрируйтесь или войдите.