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 | Введено. |