get_tags()
Отримує масив об’єктів, з даними про мітки. Дані можна отримувати за різними критеріями (задається у параметрі $args).
Працює на основі:
get_terms()
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() .
За замовчуванням: встановлені
Приклади
#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 | Введено. |