get_tags с версии 2.3.0

Описание

Получает массив объектов, с данными о метках. Данные можно получать по разным критериям (задается в параметре $args).

get_tags() работает на базе get_terms().

Функция возвращает массив объектов, с данными (см. ниже).

Использование

<?php $tags = get_tags($args); ?>

Параметры по умолчанию

<?php
$args = array(
    'number' 		=> 0
    ,'offset' 		=> 0
    ,'orderby' 		=> 'id'
    ,'order' 		=> 'ASC'
    ,'hide_empty' 	=> true
    ,'fields' 		=> 'all'
    ,'slug' 		=> ''
    ,'hierarchical' => true
    ,'name__like' 	=> ''
    ,'pad_counts' 	=> false
    ,'get' 			=> ''
    ,'child_of' 	=> 0
    ,'parent' 		=> ''
);

$myterms = get_tags( $args );
?>

Параметры

$args (строка/массив)

Аргументы в соответствии с которыми будут получены метки. Значение агрументов смотрите в описании функции get_terms().
По умолчанию: предустановленные

Возвращает

Массив объектов, содержащих данные о метке. Каждый объект содержит следующие данные:

• term_id - ID метки;
• name - название метки;
• slug - альтернативное название;
• term_group - группа (не используется);
• term_taxonomy_id - ID элемента таксономии (обычно совпадает с term_id);
• taxonomy - название таксономии;
• description - описание;
• parent - ID родительского элемента таксономии (для меток не используется);
• count - количество записей.

Примеры

1. Выведем список меток, в виде ссылок на каждую метку. И зададим тегу <a> уникальный класс и атрибут title:

$tags = get_tags();
$html = '<div class="post_tags">';
foreach ($tags as $tag){
	$tag_link = get_tag_link($tag->term_id);

	$html .= "<a href='{$tag_link}' title='{$tag->name} Tag' class='{$tag->slug}'>";
	$html .= "{$tag->name}</a>";
}
$html .= '</div>';
echo $html;

На заметку

• Применяет фильтр get_tags к массиву объектов и аргументам функции.

get_tags()

function &get_tags( $args = '' ) {
	$tags = get_terms( 'post_tag', $args );

	if ( empty( $tags ) ) {
		$return = array();
		return $return;
	}

	$tags = apply_filters( 'get_tags', $tags, $args );
	return $tags;
}

Ещё из раздела

Смотрите также: Функции WordPress и Теги Шаблона.

Нужен удобный и надежный хостинг, но не знаете как выбрать наиболее подходящий из огромного множества предложений? Вам может помочь рейтинг хостингов, где вы без особого труда, указав интересующий вас параметры, сможете выбрать подходящий для вас хостинг.