SEO Маяк

С помощью функции get_categories() можно получить массив объектов с данными о категориях для вывода на экран или для дальнейших операций.

Работает на основе: get_terms().

Применение:

get_categories( $args );

$args (строка/массив) — аргументы, которые может принимать функция.

По умолчанию: Стандартный массив объектов для таксономии 'category'.

У данной функции есть всего один уникальный аргумент 'type', которого нет в арсенале get_terms().

Шаблон функции со всеми аргументами

$args = array(
    'type'                   => 'post', 
    'taxonomy'               => 'category',
    'orderby'                => 'name',
    'order'                  => 'ASC',
    'hide_empty'             => true,
    'exclude'                => '',
    'exclude_tree'           => '',
    'include'                => array(),
    'number'                 => '',
    'fields'                 => 'all',
    'slug'                   => '', 
    'parent'                 => '',
    'hierarchical'           => true,
    'child_of'               => 0,
    'childless'              => false,
    'get'                    => '',
    'name__like'             => '',
    'pad_counts'             => false,
    'offset'                 => '',
    'search'                 => '',
    'name'                   => '',
    'cache_domain'           => 'core',
    'update_term_meta_cache' => true,
    'object_ids'             => null,
    'meta_value'             => '',
    'meta_key'               => '',
    'meta_query'             => '',
    'suppress_filter'        => false,
);
$terms = get_categories($args);
 
foreach($tcategories as $cat){      
    echo print_r($cat);
}

Аргументы массива $args

type

'type' => 'post', (строка) — Тип таксономии, элементы которой требуется получить (необязательно).

'post' — будут получены данные о категориях постов.
'link' — данные о категориях ссылок.

По умолчанию: post.

Полный список аргументов, которые может принимать функция, можно посмотреть в описании get_terms().

Возвращаемые значения

Основное отличие функции get_categories() от get_terms() заключается именно в возвращаемых значениях:

term_id — идентификатор терма.
name — название терма.
slug — ярлык терма
term_group — порядковый номер в группе (не используется, по умолчанию: 0).
term_taxonomy_id — идентификатор таксономии.
taxonomy — название таксономии.
description — описание элемента таксономии.
parent — идентификатор родительского терма.
count — количество прикрепленных записей к терму.
filter — тип фильтра.
cat_ID — идентификатор категории.
category_count — количество прикрепленных записей к категории.
category_description — описание категории.
cat_name — название категории.
category_nicename — ярлык категории.
category_parent — идентификатор родительской категории.

Здесь явно просматривается выделение категорий на фоне остальных термов.

Хуки функции

В функцию заложен хук-фильтр get_categories_taxonomy.

Применение:

add_filter( 'get_categories_taxonomy', 'get_categories_taxonomy_filter', 10, 2 );
function get_categories_taxonomy_filter($taxonomy, $args){
	//какой-то сценарий
	return $taxonomy;
}

Отключение фильтра:

remove_filter('get_categories_taxonomy', 'get_categories_taxonomy_filter', 10, 2);

Примеры использования

1. Получим все категории произвольной таксономии 'own_tax', упорядоченные по ярлыкам.

Синтаксис строки:

categories = get_categories('taxonomy=own_tax&hide_empty=0&orderby=slug');

Синтаксис массива:

$args = array(
	'taxonomy'   => 'own_tax',
	'hide_empty' => 0,
	'orderby'    => 'slug',
	);
$categories = get_categories($args);

2. Выведем названия родительских категорий только верхнего уровня.

Без ссылки:

$categories = get_categories(array(
    'orderby' => 'name',
    'parent'  => 0
));
foreach ($categories as $category){
    printf( '%1$s<br/>', esc_html($category->name));
}

С ссылкой:

$categories = get_categories(array(
    'orderby' => 'name',
    'parent'  => 0
));
 
foreach ($categories as $category){
    printf( '<a href="%1$s">%2$s</a><br />',
        esc_url(get_category_link($category->term_id)),
        esc_html($category->name)
    );
}

3. Выведем все категории с ссылками в виде выпадающего списка:

$categories = get_categories();
echo '<select onchange="document.location.href=this.options[this.selectedIndex].value;"><option value="">Выберите категорию</option>';
foreach( $categories as $cat ){
echo '<option value="'.get_category_link($cat->term_id).'">'.$cat->name.'</option>';
}
echo '</select>';

4. Создадим простую карту таксономии с обозначением категорий и подкатегорий:

$рarent_categories = get_categories( 'orderby=name&order=ASC' );
foreach ( $рarent_categories as $category ){
	if ( $category->parent < 1 ) {
	echo '<strong>Категория:</strong></br>'.$category->name.'</br>';        
$childless_categories = get_categories( array( 'parent' => $category->term_id ));
    if (count( $childless_categories ) > 0 ){ 
    echo '<strong>Подкатегории:</strong></br>';
foreach ( $childless_categories as $childless ) 
	echo $childless->name.'</br>';
		} 
	}
}

На основе get_categories() работает функция: wp_list_categories().

Таблица изменений

function get_categories( $args = '' ) {
	$defaults = array( 'taxonomy' => 'category' );
	$args = wp_parse_args( $args, $defaults );

	$taxonomy = $args['taxonomy'];

	/**
	 * Filters the taxonomy used to retrieve terms when calling get_categories().
	 *
	 * @since 2.7.0
	 *
	 * @param string $taxonomy Taxonomy to retrieve terms from.
	 * @param array  $args     An array of arguments. See get_terms().
	 */
	$taxonomy = apply_filters( 'get_categories_taxonomy', $taxonomy, $args );

	// Back compat
	if ( isset($args['type']) && 'link' == $args['type'] ) {
		_deprecated_argument( __FUNCTION__, '3.0.0',
			/* translators: 1: "type => link", 2: "taxonomy => link_category" */
			sprintf( __( '%1$s is deprecated. Use %2$s instead.' ),
				'<code>type => link</code>',
				'<code>taxonomy => link_category</code>'
			)
		);
		$taxonomy = $args['taxonomy'] = 'link_category';
	}

	$categories = get_terms( $taxonomy, $args );

	if ( is_wp_error( $categories ) ) {
		$categories = array();
	} else {
		$categories = (array) $categories;
		foreach ( array_keys( $categories ) as $k ) {
			_make_cat_compat( $categories[ $k ] );
		}
	}

	return $categories;
}