Wp_tag_cloud () - display-uri - Tag Cloud lista de tag-uri în formă de nor

Printuri „nor de tag-ul“: lista de etichete în formă de nori. Puteți specifica o taxonomie arbitrară.

Pentru a afișa elementele unei taxonomie arbitrare sub formă de nori, introduceți numele taxonomia în parametrul taxonomie.

„Tag Cloud“ se numește așa pentru că dimensiunea textului fiecărei etichete depinde de numărul de înregistrări asociate cu eticheta. Cu cat mai multe intrări, cu atât mai mare va fi textul etichetei (în cele din urmă se dovedește ceva ca un nor).

Cîrligele funcții:

se întoarce

Se afișează lista cu ecran de cod HTML.
Returnează HTML, dacă parametrul ecou = fals.
Returnează o matrice de nori semne dacă formatul parametrului = array.
Return false, dacă nu puteți obține eticheta.

utilizarea

Utilizarea șabloanelor

$ Args (string / matrice) Argumentele pe baza cărora se va construi lista.
Implicit: valorile de bază

Argumente parametru $ args

De $ arg pot specifica, de asemenea, toți parametrii get_terms) funcția (. Obținerea de elemente taxonomice se bazează pe această caracteristică.

cea mai mică (număr întreg), etichete dimensiunea textului pentru un număr mai mic de intrări (unități sunt indicate în unitatea de parametri).
Implicit: 8 cel mai mare (număr) dimensiunea textului de pe etichete cu un număr mare de înregistrări (unități de măsură specificate în unitatea de parametri).
Implicit: Unitate (string) Opțiuni unitate cel mai mic și cel mai mare. CSS poate fi orice tip de dimensiune: pt. px. em. %.
Implicit: numărul „PT“ (număr întreg), Numărul maxim de etichete care vor fi afișate în listă. Dacă este setat la 0, atunci va fi afișat toate etichetele fără restricții.
Implicit: 45 Format (string)

În ce format pentru a afișa lista. Poate fi:

plate - etichetele sunt separate de un delimitator specificat în parametrul separator;
lista - lista UL cu clasa CSS 'wp-tag-nor';
matrice - va reveni nor etichetă în matrice pentru o prelucrare ulterioară în PHP.
Implicit: „plat“

separator (string) Textul între etichetele.
Implicit: "\ n" tag-uri orderby (string) Sorteaza dupa nume (nume) sau numărul de intrări (număr). Ea nu afectează interogarea bazei de date.
Implicit: comanda 'nume' (line)

ordinea de sortare. Poate fi:

: ASC - comandă (1,2,3);
DESC - în ordine inversă (3,2,1);
RAND - ordine haotic (shuffle).

comandă și nu afectează orderby interogarea bazei de date. Tag, obținută din baza de date, apoi sortate. Aceste setări sunt pentru baza de date sunt: orderby = count și ordine = DESC și nu pot fi schimbate.
Implicit: 'ASC'

exclud (string) Ștergeți eticheta specificată. Indicați ID-ul au nevoie separate prin virgulă.
Implicit: includ nul (string) Afișează numai tag-uri specificate. Indicați ID-ul au nevoie separate prin virgulă.
Implicit: topic_count_text_callback nul (/ matrice string) funcție, care ia numărul de înregistrări și returnează textul etichetei. Puteți seta o funcție dacă doriți să afișați orice alt text, cu numărul de intrări pentru fiecare etichetă.
Implicit: link-ul default_topic_count_text (string)

vizualizare - făcând clic pe etichetă, vom ajunge la etichetele de pagină;
editați - făcând clic pe etichetă, vom ajunge la etichetele de editare de pagină.
Implicit: vizualizare

taxonomie (linia / m)

Numele taxonomiei sau o serie de mai multe nume din care va fi construit nor. Poate fi:

post_tag;
categorie;
link_category;
taxonomie acestuia;
O serie de nume de taxonomii - opțiunea introdusă în versiunea 3.1.
Implicit: post_tag

SHOW_COUNT (boolean) dacă numărul de display de intrări în etichetă. Implicit 0. Poate fi: 0, 1, sau adevărat / fals. WP 4.8. echo (logic) 1 - pentru a afișa, 0 - returnează rezultatul la prelucrarea ulterioară.
Implicit: 1 (true)

# 1 Utilizarea de bază

Deducem un nor de tag-uri cu titlul „Tag-uri populare“:

# 1.2. Totuși, un alt exemplu care arată diferiții parametri de transmisie

Modificarea dimensiunii etichetei (cel mai mic = 15largest = 40), limita numărul de etichete afișate (număr = 50) și le sortați în funcție de numărul de intrări, dar nu după nume (orderby = count):

# 2 va primi o listă, nu-l vom afișa

Scrie o lista in $ tag-ul parametru, apoi să-l folosească în PHP pentru propriile lor scopuri:

# 4 Schimbarea în titlu atributul text din tag-ul

Atunci când treceți peste un link, acesta indică numărul de intrări. Pentru a modifica textul, puteți utiliza topic_count_text_callback. moment în care funcția sa de a crea un text:

# 5 tag-uri Arhiva

Ca una dintre utilizările de etichete oferă pentru a crea etichete arhiva paginii. Făcând clic pe o etichetă specifică, vom ajunge la pagina cu posturi legate de această etichetă. Cum să se uite o astfel de pagină este determinată de șablonul de fișier tag.php. Dacă nu există un astfel de fișier (de obicei UNT), formarea fișierului de ieșire este dat archives.php.

Hai să facem pagina de etichete, în cazul în care la început va fi afișat nor de tag-ul, și apoi înregistrează referitoare la eticheta selectată. Pentru a face acest lucru, creați (în cazul în care nu) sau modificare (dacă este cazul) fișier tag.php. Crearea unui fișier trebuie să fie în directorul temei.

fișier tags.php Conținut:

În acest exemplu, nu sunt considerate stiluri CSS, cu toate acestea posibile incompatibilități cu șablonul.

# 6 Modificați setările implicite pentru nor de etichete widget prin filtru

Să presupunem că avem nevoie pentru a reduce fontul maxim pentru nor de etichete widget. Ai nevoie pentru a pune valoarea 16 în loc de 22 pentru parametrul „cel mai mare“. Pentru a face acest lucru, folosim widget_tag_cloud_args cârlig

Versiunea 3.1 a adăugat capacitatea de a trece matrice la parametrul taxonomie;
In versiunea 2.9 a adăugat un separator parametru;
În versiunea 2.8 a adăugat opțiuni taxonomie și ecou;
Versiunea 2.7 include opțiunea de a link-ul;