WordPress

WordPress 2.3 tag fonksiyonları – wp_generate_tag_cloud

20 Ekim
11:10 2007

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

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

Benzer Yazılar

Yorumlar