Wordpress 2.3 tag fonksiyonları – wp_generate_tag_cloud

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

<?= wp_generate_tag_cloud( $etiketler, $degiskenler); ?>

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:
  1. flat – Etiketler boşluk ile birbirinden ayrılır.
  2. list – Etiketler class=’wp-tag-cloud’ etiketini kullan Html listeleme formatında (<li></li>) birbirinden ayırt edilir.
  3. array – Etiketleri dizi değişken olarak (Array) döndürür.
• orderby – Etiketlerin listelenme tarzıdır.
  1. name – Etiketler alfabetik olarak listelenir. Ayrıca varsayılan listelenme şeklidir.
  2. count – Etiketler kullanılma sayılarısına göre listelenir.
• order – Listelemenin sıralanma şeklidir.
  1. ASC – Artan sıralama yapılır. (varsayılan)
  2. 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.

<?= wp_generate_tag_cloud( $etiketler, 'smallest=8&largest=22&number=30&unit=pt'); ?>

Ü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.