Funkcia/wp_tag_cloud

wp_tag_cloud zobrazuje zoznam štítkov (tagov), ktorý poznáme aj pod pomenovaním “oblak štítkov”, kde veľkosť každého z nich určuje ich frekvenciu použitia pri jednotlivých článkoch.

Použitie:

<?php wp_tag_cloud( $args ); ?> 

Predvolené hodnoty:

<?php $args = array(
    'smallest'  => 8,
    'largest'   => 22,
    'unit'      => 'pt',
    'number'    => 45,
    'format'    => 'flat',
    'separator' => '\n',
    'orderby'   => 'name',
    'order'     => 'ASC',
    'exclude'   => ,
    'include'   => ,
    'link'      => 'view',
    'taxonomy'  => 'post_tag',
    'echo'      => true ); ?>

Predvolene sa zobrazí:

• smallest – Veľkosť najmenšieho štítku (s najmenším počtom) je 8
• largest – Veľkosť najväčšieho štítku (s najväčším počtom) je 22
• unit – Nastaví ‘pt’ (point – bod) ako jednotku velkosti fontu pre najmenšie a najväčšie hodnoty
• number – Zobrazí najviac 45 štítkov
• format – Zobrazí štítky štýlom “flat” (oddelené bielymi medzerami)
• separator – Zobrazí biele medzeri medzi štítkami
• orderby – Zoradí štítky podľa mena
• order – Zoradí štíkty vzostupne
• exclude – Nevyradí žiadne štítky
• include – Obsiahne všetky štítky
• link – prezerať
• taxonomy – Používať štítky článkov
• echo – zobraziť výsledok

Parametre:

smallest
(celé číslo)(nepovinný parameter) Veľkost textu pre štítok s najmenším počtom (jednotka je zadaná cez parameter “unit”).
Predvolene: 8

largest
(celé číslo)(nepovinný parameter) Veľkost textu pre štítok s najväčším  počtom (jednotka je zadaná cez parameter “unit”).
Predvolene: 22

unit
(reťazec)(nepovinný parameter) Jednotka merania pre najmenšiu a najväčšiu hodnotu. Toto môže byť hocijaká dĺžková hodnota v CSS napr. pt, px, em, %.
Predvolene: ‘pt’

number
(reťazec)(nepovinný parameter) Maximálny počet štítkov, ktoré sa budú zobrazovať. (Použite “0″ pre zobrazenie všetkých.)
Predvolene: 45

format
(reťazec)(nepovinný parameter) Formát štítkov.

• “flat” (predvolene) štítky sú oddelené bielou medzerou definou cez parameter “separator”
• “list” štítky sú v UL s class=’wp-tag-cloud’
• “array” štítky sú vrátené ako pole (array) pre ďalšie použitie v PHP

separator
(reťazec)(nepovinný parameter) Text/medzera medzi štítkami.
Predvolene: ‘/n’ (biela medzera)

orderby
(reťazec)(nepovinný parameter) Zoradenie štítkov. Povolené hodnoty:

• “name”
• “count”

Predvolene: name

order
(reťazec)(nepovinný parameter) Ako zoradiť štítky. Povolené hodnoty (musia byť napísané veľkými písmenami!):

• “ASC” – vzostupne
• “DESC” – zostupne
• “RAND” – štítky v náhodnom poradí

Predvolene: ASC

exclude
(reťazec)(nepovinný parameter) Zoznam štítkov (term_id) oddelených čiarkou na vyradenie. Napríklad ‘include=5,27′ znamené, že term_id 5 a 27 nebudú zobrazované.
Predvolene: nevyradiť nič

include
(reťazec)(nepovinný parameter) Zoznam štítkov (term_id) oddelených čiarkou na zobrazenie. Napríklad ‘exclude=5,27′ znamené, že LEN term_id 5 a 27 budú zobrazované.
Predvolene: zobraziť všetky

link
(reťazec)(nepovinný parameter) Nastaviť odkaz na editovanie jednotlivých štítkov.

• “view” (predvolene)
• “edit”

taxonomy
(reťazec)(nepovinný parameter) Taxonómia, ktorá sa má zobrazovať.

• “post_tag” -(predvolene) Generované sú štítky článkov
• “category”- Generované sú kategórie článkov
• “link_category” – Generované sú kategórie odkazov

echo
(boolean)(nepovinný parameter) Zobraziť, alebo nechať ako premennú. Predvolene je “true” (zobraziť)

• 1 (true) – predvolene
• 0 (false)

Príklady:

Zobraziť “oblak štítkov” s nadpisom “Populárne štítky” a predvolenými nastaveniami

<?php if ( function_exists('wp_tag_cloud') ) : ?>
<li>
<h2>Populárne štítky</h2>
<ul>
<?php wp_tag_cloud(''); ?>
</ul>
</li>
<?php endif; ?>

Veľkosť pre štítok s najmenším počtom má veľkosť 15pt, s najväčším 50pt, maximálny počet štítkov je 50 a zoradiť podľa počtu

<?php wp_tag_cloud('smallest=15&largest=40&number=50&orderby=count'); ?>

Vrátiť ako pole (array), ale nezobraziť

Premenná $tag obsahuje “oblak štítkov” pre ďalšie použitie v PHP

<?php $tag = wp_tag_cloud('format=array' );?>

Zobraziť “oblak kategórií”

Používame parameter taxonomy.

<?php
wp_tag_cloud( array( 'taxonomy' => 'category' ) );
?>