Wordpress kategori fonksiyonlarının kullanımı

WordPress sitenizdeki kategorileri görüntülemek için hali hazırda birkaç fonksiyon ve bunların farklı kullanımları yer alıyor. Bunların hepsini duymamış olabilirsiniz. Biraz bilgi edinmeniz açısından bunları inceliyoruz. Dediğimiz gibi bunların asıl önemi, kullanımları için herhangi bir eklenti kurmanıza gerek olmamasıdır.

Wordpress kategori fonksiyonlarının kullanımı

Wordpress kategori fonksiyonlarının kullanımları aşağıdaki gibidir.

the_category

Bu fonksiyonu yazılarınızın yer aldığı kategori(leri) göstermek için kullanabilirsiniz. Yani tema dosyanız içerisinde yazıların listelenmesi için kullanılan döngü satırlarının arasında olması gerekiyor.

Eğer yazılarınızı sadece tek bir kategori altında yayınlıyorsanız,

<?php the_category(); ?>

şeklindeki kullanım size yeterli olacaktır. Yok eğer birden fazla kategori altında ise bunlar, her kategori ismini birbirinden ayırmak için özel karakterler kullanabilirsiniz.

Örneğin birden fazla kategoriyi , (virgül) ile ayırmak için,

<?php the_category(', '); ?>

kullanılabilir.

the_category_rss

RSS ya da RDF formatında çıktı verilirken kategorinin adını veren fonksiyondur. Yine döngü satırları arasında yer alması gerekir.

RSS için;

<?php the_category_rss('rss') ?>

RDF için;

<?php the_category_rss('rdf') ?>

category_description

İlgili kategorinin açıklama metnini görüntüler. Fonksiyonunda kategori ID numarasını belirtmek zorundasınız.

Örneğin ID numarası 3 olan kategorinin açıklamasını görüntülemek için şu şekilde kullanacağız;

<?php echo category_description(3); ?>

wp_dropdown_categories

Kategori listesini açılır bir menü olarak görüntülemektedir.

<?php wp_dropdown_categories('ozellikler'); ?> 

olarak kullanımı vardır. Fonksiyon arasında adı geçen ozellikler ise şunlardır.

• show_option_all; Seçme kutusunun başına “Tümü” gibi bir seçenek ekleyebilirsiniz. Option değeri 0 gelir. Kullanımı: show_option_all=Tümü
• show_option_none; Seçme kutusunun başına hiçbiri gibi bir değer eklenebilir. Option değeri -1 gelir. Kullanımı: show_option_none=Hiçbiri
• orderby; Kategorilerin sıralanışıdır. ID ya da name kullanılabilir. ID, kategorilerin ID numarasıdır. Name, kategorilerin adıdır. Kullanımı: orderby=name
• order; Artan ya da azalan sıralama yapar. Artan sıralama için ASC, azalan için DESC kullanılmalıdır. Varsayılı olan ASC ‘dir. Kullanımı: order=desc
• show_last_update; Kategori isminin yanında, bu kategori altındaki en son güncellenen yazının tarihi yer alır. Tarih gösterimi için 1, aksi için 0 olmalıdır. Kullanımı: show_last_update=1
• show_count; Kategori içerisindeki toplam yazı sayısı parantez içerisinde gösterilir. Gösterim için 1 aksi durum için 0 girilmelidir. Kullanımı: show_count=1
• hide_empty; İçerisinde henüz yazı olmayan boş kategorileri gizler. Gizlemek için 1 aksi durum için 0 kodlanmalıdır. Kullanımı: hide_empty=1
• child_of; Sadece ID numarasını belirteceğiniz kategori içerisinde yer alan kategoriler görüntülenir. Kullanımı: child_of=5
• exclude; Kategori ID numarasını belirttikleriniz liste içerisinde görüntülenmez. Bu ID numaraları , (virgül) ile birbirinden ayrılabilir. Kullanımı: exclude=4,5,6 . ID numarası 4, 5 ve 6 olanlar listede yer almazlar.
• echo; Blogroll (bağlantılar) altında yer alan kategoriler de görüntülenebilir. 1 değeri için görüntülenir, 0 için görüntülenmez. Kullanımı: echo=1
• selected; ID numarasını vereceğiniz kategori seçili olarak gelecektir. Kullanımı: selected=16
• hierarchical; 1 değeri verilirse alt kategorilerde girintili olarak görüntülenir. Aksi için 0 girilmelidir. Kullanımı: hierarchical=1
• name; Kategori listesi kutusunun adıdır (name=”").
• class; Kategori listesi kutusunun stil adıdır (class=”").

Birden fazla özelliği & ile ayırmamız gerekiyor. Örneğin;

<?php wp_dropdown_categories("show_option_all=Tumu&orderby=name&order=desc&selected=16&hierarchical=1&name=kategori&class=stil5"); ?>

wp_list_categories

Kategorileri bağlantı olarak görüntüler. Wordpress 2.1 üstü sürümlerde list_cats() ve wp_list_cats() olarak da kullanılabilir. Kullanımı wp_dropdown_categories ile aşağı yukarı aynıdır.

<?php wp_list_categories('ozellikler'); ?> 

Yine burada da ozellikler içerisine listeleme özelliklerini tanımlayacağız.

• show_option_all; Tüm kategoriler bağlantısını içerir. Gösterim için 1 aksi için 0 girilmelidir. Kullanımı: show_option_all=1
• orderby; Kategorilerin sıralanışıdır. ID ya da name kullanılabilir. ID, kategorilerin ID numarasıdır. Name, kategorilerin adıdır. Kullanımı: orderby=name
• order; Artan ya da azalan sıralama yapar. Artan sıralama için ASC, azalan için DESC kullanılmalıdır. Varsayılı olan ASC ‘dir. Kullanımı: order=desc
• style; Kategorilerin listelenme stilidir. Eğer listelenmesini isterseniz list aksi için none girmelisiniz. None ile satır atlatılırken, list ile listeleme etiketleri kullanılır. Kullanımı: style=list
• show_count; Kategori içerisindeki toplam yazı sayısı parantez içerisinde gösterilir. Gösterim için 1 aksi durum için 0 girilmelidir. Kullanımı: show_count=1
• hide_empty; İçerisinde henüz yazı olmayan boş kategorileri gizler. Gizlemek için 1 aksi durum için 0 kodlanmalıdır. Kullanımı: hide_empty=1
• use_desc_for_title; Kategori başlıkları için açıklamalarında görüntülenmesini sağlayabilirsiniz (fare ile bağlantı üzerine gelip bir süre bekleyince görüntülenen metin). Görüntülemek için 1 aksi için 0 kodlanmalıdır. Kullanımı: use_desc_for_title=1
• child_of; Sadece ID numarasını belirteceğiniz kategori içerisinde yer alan kategoriler görüntülenir. Kullanımı: child_of=5
• feed; Kategori isimlerinin sonlarında RSS kaynağı metin bağlantısı olarak görüntülenir. Göstermek için 1 aksi için 0 kullanılır. Kullanımı: feed=1
• feed_image; RSS kaynağı bağlantısı metin değil simge olarak görüntülemek isterseniz, buraya simge adresini girmelisiniz. Kullanımı: feed_image=http://www.dmry.net/wp-includes/images/rss.png
• exclude; Kategori ID numarasını belirttikleriniz liste içerisinde görüntülenmez. Bu ID numaraları , (virgül) ile birbirinden ayrılabilir. Kullanımı: exclude=4,5,6 . ID numarası 4, 5 ve 6 olanlar listede yer almazlar.
• include; Sadece ID numarası belirtilen kategoriler görüntülenir. Birden fazla kategori , (virgül) ile ayrılabilir. Kullanımı: include=3,6,7
• hierarchical; 1 değeri verilirse alt kategorilerde girintili olarak görüntülenir. Aksi için 0 girilmelidir. Kullanımı: hierarchical=1
• title_li; Kategori listesinin başlığıdır. Kullanımı: title_li=Yazı Kategorileri

in_category

Yazıların listelendiği döngü satırları arasında kullanılmalıdır. İlgili yazının belirtilecek kategori içerisinde olup olmadığını doğru(true) ya da yanlış (false) olarak geri döndürür.
Örneğin;

<?php if ( in_category(24) ): ?>
Yazı 24 ID numaralı kategori altındadır.
<?php endif; ?>

get_category_parents

ID numarasını vereceğiniz kategori isminin, kendisinin altlarında yer aldığı üst kategorileri sıralar. Örneğin,

<?php echo(get_category_parents(24, TRUE, ' &raquo; ')); ?>

ID numarası 24 olan kategorimiz, aslında 16 ID numaraları kategori altında yer almaktadır. Böylece elde edeceğimiz çıktı,

Web Tasarım Çeşitli Bilgiler » CSS »

gibi olacaktır.

TRUE olarak tanımlanan alan, kategori bağlantılarının yaratılacağı anlamına gelir. Eğer FALSE kullanırsanız kategori bağlantıları yaratılmaz.

» karakteri ise kategori isimlerini birbirinden ayırmak için kullanılmıştır.

get_category_link

ID numarası verilen kategorinin bağlantı adresi görüntülenebilir.

<a href="<?php echo get_category_link(24);?>">Kategori Adı</a>

ID numarası 24 olan kategorinin URL değeri yazdırılıyor.

get_the_category

Kategorileri ve özelliklerini dizi değişken olarak getirir. Yazıları listelediğimiz döngü satırları arasında kullanılabilir ve her yazıya ait tüm kategorilerin özelliklerini barındırır. Barındıracağı kategori özellikleri şunlardır;

• cat_ID; Kategori ID numarası.
• cat_name; Kategori adı.
• category_nicename; Kategori adının kalıcı bağlantılarda görüntülenen adıdır.
• category_description; Kategori açıklamasıdır.
• category_parent; Bağlı olduğu üst kategorinin ID numarasıdır.