WordPress get_categories Fonksiyonu

19 Ekim 2008

Özellikle kategorilerle ilgili eklenti/bileşen yazarken, kategorilerin listesini elde etmek isteriz. Tabi ki bu listede sadece kategori adlarının değil de başka bilgilerin de olmasını, hatta bazen özelleştirdiğimiz bir liste elde etmek isteriz. Bunu yaparken kullanacağımız fonksiyonların başında şüphesiz get_categories fonksiyonu geliyor. Bu fonksiyon ile ilgili WordPress Codex'teki yazının Türkçe çevirisini yazımın devamında bulabilirsiniz.

Açıklama

Girilen parametrelere uyan kategorileri bir nesne dizisi olarak döndürür. Parametreler wp_list_categories fonksiyonu ile hemen hemen aynıdır ve hem sorgu ifadesi olarak hem de dizi olarak girilebilir.

Kullanım

<?php $categories = get_categories(parametreler); ?>

Örnekler

Fonksiyonun kullanımına ilişkin çeşitli örnekler.

Varsayılan Kullanım

Varsayılan kullanımdaki parametreler ve varsayılan değerleri.

<?php $defaults = array('type' => 'post',
'child_of' => 0,
'orderby' => 'name',
'order' => 'ASC',
'hide_empty' => true,
'include_last_update_time' => false,
'hierarchical' => 1,
'exclude' => ,
'include' => ,
'number' => ,
'pad_counts' => false);
?>

Açılır Kutu

Aşağıda geçmiş olayları göstermek için kullanılan bir kategoriye ait, alt kategorilerin listelendiği bir açılır kutunun nasıl yaratılacağı yer almaktadır. Aylık arşivlerin oluşturulmasında kullanılan wp_get_archives fonksiyonuyla aynı işi yapmaktadır.
Alt kategorisini göstermek istediğiniz kategorinin id'si 10 olsun ve kategorinin kısa adı "arsiv" olsun. Bu kategorinin alt kategorilerini açılır kutu şeklinde gösteren koda aşağıdan ulaşabilirsiniz.

<select name="event-dropdown" onchange='document.location.href=this.options[this.selectedIndex].value;'>
<option value=""><?php echo attribute_escape(__('Select Event')); ?></option>
<?php
$categories= get_categories('child_of=10');
foreach ($categories as $cat) {
$option = '<option value="/category/archives/'.$cat->category_nicename.'">';
$option .= $cat->cat_name;
$option .= ' ('.$cat->category_count.')';
$option .= '</option>';
echo $option;
}
?>
</select>

[

Parametreler

type: (metin) Kategorinin türü.

post - yazı kategorisi (varsayılan)
link - bağlantı kategorisi

child_of: (tamsayı) Sadece, ID numarası verilmiş olan kategorinin alt kategorilerini gösterir. Bu parametre için varsayılan değer yoktur. Eğer bu parametre kullanılırsa, hide_empty parametresi false değerini otomatik olarak alır.
orderby: (metin) Kategorileri ID ya da ismine göre sıralar. Varsayılan kategori ID'sine göre sıralamadır. Alabileceği değerler ID (varsayılan) ve name (isim)
order: (metin) Kategorilerin sıralama türü (artan ya da azalan). Varsayılan artan sıralamadır. Alabileceği değerler ASC (varsayılan - artan), DESC (azalan)
hide_empty: (mantıksal) Yazısı olmayan kategorileri gösterir/göstermez. Varsayılan 'true' (varsayılan - boş kategoriler gizlenir). Alabileceği değerler 1 (true - varsayılan), 0 (false)
include_last_update_time: (mantıksal) Ne yaptığı kesin belli değil. Alabileceği değerler 1 ve 0 (varsayılan)
hierarchical: (mantıksal) Alt kategorileri girdili şekilde listeler. Alabileceği değerler, 1 (true - varsayılan), 0 (false)
exclude: (metin) Bir ya da daha fazla kategoriyi listeden çıkartmayı sağlar. Bu parametre kategori ID'lerini aralarında virgül (,) ile ayrılmış olarak alır. Örnek için wp_list_categories
include: (metin) Sadece belli kategorilerle ilgili bilgileri almak için kullanılır. Bu parametre kategori ID'lerini aralarında virgül (,) ile ayrılmış olarak alır. Örnek için wp_list_categories
number: (metin) Gösterilecek kategori sayısı.
pad_counts: (mantıksal) Yazı/bağlantı sayısı hesaplanırken, alt kategorilerinkinin de dahil edilip, edilmeyeceğini belirler. Alabileceği değerler 1 (true) ve 0 (false - varsayılan)

Bu yazının kısa bağlantısı http://www.yakupgovler.com/?p=367.

Yazılarımı RSS aboneliği ile takip edebilir, yeni yazılarıma kolaylıkla ulaşabilirsiniz. Bunun için ise RSS adresimi kullanabilirsiniz.