Wordpress 2.3 tag fonksiyonları - wp_generate_tag_cloud

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.

Bu yazı 20 Ekim 2007, 11:10 tarihinde yazılmış olup bu zamana kadar 1,080 kez görüntülenmiştir