WordPress как на ладони
wordpress jino

get_tags() WP 2.3.0

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

Работает на основе: get_terms()
Хуки из функции:
Возвращает

массив объектов, с данными (см. ниже).

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

$tags = get_tags( $args );

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

$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: wp-includes/category.php WP 4.8.2

<?php
function get_tags( $args = '' ) {
	$tags = get_terms( 'post_tag', $args );

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

	/**
	 * Filters the array of term objects returned for the 'post_tag' taxonomy.
	 *
	 * @since 2.3.0
	 *
	 * @param array $tags Array of 'post_tag' term objects.
	 * @param array $args An array of arguments. @see get_terms()
	 */
	$tags = apply_filters( 'get_tags', $tags, $args );
	return $tags;
}

Cвязанные функции

Из раздела: Метки

get_tags 2 комментария
  • Эльвира

    Подскажите пожалуйста как сделать вывод случайных тегов? orderby rand не поддерживается sad

    Ответить4 года назад #
    • Евгений cайт: blog2k.ru @

      Можно получить все теги, потом их перемешать и выбрать первые N тегов.

      1
      Ответить3.9 года назад #

Здравствуйте, !

Ваш комментарий