Pro zobrazení mraku/oblaku štítků v je možné použít widget, ale pokud chceme zobrazit štítky v patičce bez použití widgetu, nebo na sitemap stránce, využijeme funkci wp_tag_cloud(), která zobrazí výpis všech štítků dle parametrů. V šabloně pak vložíme na řádek, kde chceme zobrazit štítky následující kód:
wp_tag_cloud();
Tím se nám vypíše mrak štítků s defaultními hodnotami, my si však budeme určitě chtít výpis upravit, aby nám to do šablony pasovalo. K tomuto účelu slouží následující parametry:
- smallest – velikost nejmenšího zobrazeného tagu, defaultní je 8
- largest – velikost největšího zobrazeného tagu, defaultní je 22
- unit – jednotky, určující velikost zobrazení smallest a largest, defaultní je pt, použít můžete %, em, px, pt
- number – počet zobrazovaných tagů, defaultní je 45, pro zobrazení všech 0
- format – formát v jakém budou tagy zobrazeny, použít můžete flat, list, array, defaultně je array
- separator – znak pro oddělení tagů v řetezci (souvisí s number => flat), defaultně \n
- orderby – řazení podle názvu (name), nebo počtu (count), defaultně name
- order – seřazení tagů, sestupně (DESC), vzestupně (ASC), náhodně (RAND), defaultně je ASC
- exclude – vyloučí tagy ze seznamu podle vloženého ID, defaultní none
- include – přidá do seznamu tagy dle ID, defaultní none
- topic_count_text_callback – tato funkce má vrátit počet příspěvků, které obsahují tag a vrátit text pro tooltip odkazu, defaultní default_topic_count_text
- link – nastaví tagu odkaz k editaci, hodnoty edit, view, defaultní – view
- taxonomy – umožňuje nastavit ke které taxonomy se vztahují štítky, hodnoty – post_tag, category, link_category a jakákoliv registrovaná taxonomy, defaultně je post_tag
- echo – určí, zda se mají štítky vypsal, nebo vrátit jako hodnota, vypsat – 1, vrátit hodnotu – 0, defaultně je 0
Jak je vidět, funkce má poměrně dost parametrů, které nám umožní zobrazit přesně takový shluk štítku, jaký potřebujeme. V šabloně pak jednoduše vypíšeme štítky:
wp_tag_cloud(array(
‚smallest‘ => 10,
‚largest‘ => 18,
‚unit‘ => ‚px‘,
‚orderby‘ => ‚name‘,
‚order‘ => ‚ASC‘
));
