Wordpress 2.3 tag fonksiyonları – wp_tag_cloud

Wordpress 2.3 ile sisteme yerleşik olarak işleyen bir etiket özelliği gelmişti. Bununla beraber etiketleri görüntülemek ve listelemek için de birkaç fonksiyon, wordpress fonksiyonları listesine eklendi. Şimdi gelin birlikte, bu yeni etiket fonksiyonlarıdan wp_tag_cloud olanı tanıyalım

Açıklama

Etiket bulutu olarak bildiğimiz ve etiketlerin kullanılma sayılarına göre ebatlandığı bir listeleme stili oluyor.

Kullanım

<?php wp_tag_cloud(''); ?>

Değişkenler

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

<?php wp_tag_cloud('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.