Функція get_tags()
При створенні сайтів на WordPress інколи виникає необхідність вірсортувати публікації по певним міткам. В якості таких міток можуть виступати теги.
Отримує масив об’єктів, з даними про мітки. Дані можна отримувати за різними критеріями (задається в параметрі $ args).
get_tags () працює на основі get_terms ().
Повертає
масив об’єктів, з даними.
Використання
1 |
$ Tags = get_tags ($ args); |
Параметри за замовчуванням
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
$ 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:
1 2 3 4 5 6 7 8 9 10 |
$ 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 застосовує до масиву об’єктів і аргументам функції.