Wp_tag_cloud () - виводить - хмара міток список міток у вигляді хмари

Виводить "хмара міток": список міток у вигляді хмари. Можна вказати довільну таксономию.

Щоб вивести елементи довільної таксономії у вигляді хмари, вкажіть назву таксономії в параметрі taxonomy.

"Хмара міток" називається так, тому що розмір тексту кожної мітки залежить від того, скільки записів пов'язана з міткою. Чим більше записів, тим більше буде текст мітки (в результаті виходить щось схоже на хмару).

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

повертає

Виводить на екран html код списку.
Повертає HTML, якщо параметр echo = false.
Поверне масив хмари міток, якщо параметр format = array.
Поверне false, якщо не вдалося отримати мітки.

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

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

$ Args (рядок / масив) Аргументи, на основі яких буде побудований список.
За замовчуванням: базові значення

Аргументи параметра $ args

В $ args можна також вказати всі параметри функції get_terms (). Отримання елементів таксономії працює на базі цієї функції.

smallest (число) Розмір тексту для міток з меншою кількістю записів (одиниці виміру вказуються в параметрі unit).
За замовчуванням: 8 largest (число) Розмір тексту для міток з великою кількістю записів (одиниці виміру вказуються в параметрі unit).
За замовчуванням: unit (рядок) Одиниці виміру параметрів smallest і largest. Може бути будь-яким CSS типом розміру: pt. px. em. %.
За замовчуванням: 'pt' number (число) Максимально кількість міток, яке буде показано в списку. Якщо встановити на 0. то будуть показані всі мітки без обмеження.
За замовчуванням: 45 format (рядок)

В якому форматі виводити список. Може бути:

flat - мітки будуть розділені роздільником, зазначеним в параметрі separator;
list - UL список з CSS класом 'wp-tag-cloud';
array - поверне хмара міток в масиві для подальшої обробки в PHP.
За замовчуванням: 'flat'

separator (рядок) Текст між мітками.
За замовчуванням: "\ n" orderby (рядок) Сортувати мітки на ім'я (name) або кількості записів (count). Чи не впливає на запит до бази даних.
За замовчуванням: 'name' order (рядок)

Порядок сортування. Може бути:

ASC - по порядку (1,2,3);
DESC - в зворотному порядку (3,2,1);
RAND - хаотичний порядок (перемішати).

order і orderby не впливають на запит до бази даних. Мітки спочатку виходять з бази даних, потім сортуються. Ці параметри для отримання з бази даних рівні: orderby = count та order = DESC і їх не можна змінити.
За замовчуванням: 'ASC'

exclude (рядок) Виключити вказані мітки. Вказувати потрібно ID через кому.
За замовчуванням: null include (рядок) Показати тільки зазначені мітки. Вказувати потрібно ID через кому.
За замовчуванням: null topic_count_text_callback (рядок / масив) Функція, яка отримує кількість записів і повертає текст для мітки. Можна встановити свою функцію, якщо потрібно відображати будь-якої іншої текст з кількістю записів для кожної мітки.
За замовчуванням: default_topic_count_text link (рядок)

view - після натискання на мітку, потрапимо на сторінку мітки;
edit - після натискання на мітку, потрапимо на сторінку редагування мітки.
За замовчуванням: view

taxonomy (рядок / масив)

Назва таксономії або масив декількох назв, з яких буде побудовано хмара. Може бути:

post_tag;
category;
link_category;
Своя таксономія;
Масив назв таксономій - параметр введений у версії 3.1.
За замовчуванням: post_tag

show_count (логічний) Чи показувати кількість записів в мітці. За замовчуванням 0. Можливо: 0, 1 або true / false. З WP 4.8. echo (логічний) 1 - Виводити на екран, 0 - повертати результат для подальшої обробки.
За замовчуванням: 1 (true)

# 1 Базове використання

Виведемо хмара міток з заголовком "Популярні мітки":

# 1.2. Ще один приклад демонструє передачу різних параметрів

Змінимо розміри міток (smallest = 15largest = 40), обмежимо кількість виведених міток (number = 50) і відсортуємо їх за кількістю записів, а не по імені (orderby = count):

# 2 Отримаємо список, чи не будемо виводити його на екран

Запишемо список в параметр $ tag, щоб потім використовувати його в php для своїх цілей:

# 4 Зміна тексту атрибута title у тега

При наведенні на посилання, показується кількість записів мітки. Щоб змінити цей текст, можна використовувати параметр topic_count_text_callback. в якому вкажемо свою функцію для створення тексту:

# 5 Архів міток

Як один з варіантів використання міток, пропоную створити архівні сторінки міток. При кліці на певну мітку, ми потрапляємо на сторінку з постами пов'язаними з цією міткою. Як виглядати така сторінка, визначається файлом шаблону tag.php. якщо такого файлу немає (зазвичай його ент), то формування висновку віддається файлу archives.php.

Давайте зробимо сторінку мітки, на якій на самому початку буде показано хмара міток, а після нього записи відносяться до обраної мітці. Для цього створимо (якщо немає) або змінимо (якщо існує) файл tag.php. Створювати файл потрібно в каталозі теми.

Вміст файлу tags.php:

В даному прикладі не враховуються CSS стилі, тому можлива несумісність з шаблоном.

# 6 Зміна параметрів за замовчуванням для віджета хмари міток через фільтр

Припустимо, нам потрібно зменшити максимальний шрифти для міні-програми з хмарою міток. Потрібно поставити значення 16, а не 22 для параметра 'largest'. Для цього використовуємо хук widget_tag_cloud_args

У версії 3.1 доданий можливість передавати масиви в параметр taxonomy;
У версії 2.9 доданий параметр separator;
У версії 2.8 додані параметри taxonomy і echo;
У версії 2.7 доданий параметр link;