WordPress 2.3’ün etiket bulutunu oluşturan fonksiyonu wp_generate_tag_cloud oluyor. Bu fonksiyonun wp_tag_cloud olandan farkı, etiket bulutunu sadece oluşturması ve geri döndürmesidir. wp_tag_cloud ise oluşturulan bu bulutu çıktı vermek içindir.
Açıklama
Tanımlayacağınız etiket ve değişkenler ile, etiket bulutunu oluşturur. wp_tag_cloud fonksiyonu ile tüm etiketler bulutu eklenir. Ancak bu fonksiyon içerisinde etiket listesi tanımlı değildir. Bu nedenle etiket listenizi de tanımlamak zorundasınız.
Kullanım
Görüldüğü üzere ilk olarak $etiketler adındaki dizi değişkeni tanımladık. Sonrasında ise etiket bulutunun özelliklerini tanımlayacağımız $degiskenler ‘i tanımladık.
Değişkenler
Buradaki tüm tanımlı değişkenler wp_tag_cloud fonksiyonu ile aynı.
- smallest – En az kullanılan etiketin font boyutudur
- largest – En çok kullanılan etiketin font boyutudur
- unit – Font ebatı ölçü birimidir. Örneğin; pt, px ..
- number – Görüntülenecek toplam etiket sayısıdır.
- format – Etiketlerin listelenme stili oluyor. 3 farklı stil bulunuyor:
- flat – Etiketler boşluk ile birbirinden ayrılır.
- list – Etiketler class=’wp-tag-cloud’ etiketini kullan Html listeleme formatında (<li></li>) birbirinden ayırt edilir.
- array – Etiketleri dizi değişken olarak (Array) döndürür.
- orderby – Etiketlerin listelenme tarzıdır.
- name – Etiketler alfabetik olarak listelenir. Ayrıca varsayılan listelenme şeklidir.
- count – Etiketler kullanılma sayılarısına göre listelenir.
- order – Listelemenin sıralanma şeklidir.
- ASC – Artan sıralama yapılır. (varsayılan)
- DESC – Azalan sıralama yapılır.
- exclude – Etiket listesi içerisinde yer almasını istemediğiniz etiketlerin term_id numaralarını virgül (,) ile ayırmak koşulu ile girebilirsiniz. Örneğin exclude=15,20,55 ile term_id numarası 15, 20 ve 55 olan etiketler, etiket listesi içerisinde yer almaz
- include – Sadece görüntülenmesini istediğiniz etiketler listelenir. Örneği include=1,3,8,11 ile sadece term_id numarası 1, 3, 8 ve 11 olanlar etiket bulutu içerisinde yer alır. Varsayılan olarak tüm etiketler listelenmektedir.
Değişkenlerin fonksiyon içerisinde kullanımı
Değişkenler & işareti ile birbirlerinden ayrılarak fonksiyon içerisinde kullanılabilirler.
Üstteki örnek ile en küçük etiket ebatı 8 pt, en büyük etiket ebatı 30pt olan toplamda 22 etiket aralarında boşluk bırakılarak listelenmektedir.