get_tags() WP 2.3.0

Отримує масив об’єктів, з даними про мітки. Дані можна отримувати за різними критеріями (задається у параметрі $args).

Працює на основі:
get_terms()

Хуки з функції

Повертає

WP_Term[]|int|WP_Error. Масив об’єктів WP_Term , що містять дані про мітку. Кожен об’єкт містить такі дані:

  • term_id– ID мітки;
  • name– Назва мітки;
  • slug– альтернативна назва;
  • term_group– Група (не використовується);
  • term_taxonomy_id– ID елемента таксономії (зазвичай збігається з term_id);
  • taxonomy– Назва таксономії;
  • description– Опис;
  • parent– ID батьківського елемента таксономії (для міток не використовується);
  • count– кількість записів.

Шаблон використання

$ terms = get_tags ([
	'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' => '',
]);

Використання

$ tags = get_tags ($ args);
$args
(рядок/масив)
Аргументи відповідно до яких будуть отримані мітки. Значення агрументів дивіться опис функції
get_terms() .


За замовчуванням: встановлені

Приклади

0

#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;

список змін

З версії 2.3.0Введено.

Код get_tags() WP 6.0.2

function get_tags( $args = '' ) {
	$defaults = array( 'taxonomy' => 'post_tag' );
	$ args = wp_parse_args ($ args, $ defaults);

	$ tags = get_terms ($ args);

	if ( empty( $tags ) ) {
		$tags = array();
	} else {
		/**
		 * Filters array of term objects returned for 'post_tag' taxonomy.
		 *
		 * @ Since 2.3.0
		 *
		 * @param WP_Term [] |
		 * або WP_Error, якщо будь-яка taxonomies не існує.
		 * @param array $args An array of arguments. @see get_terms()
		 */
		$tags = apply_filters( 'get_tags', $tags, $args);
	}

	return $tags;
}

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *