get_tags

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

Хуки из функции:
get_tags
Возвращает

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

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

$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.7.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;
}