WordPress get_the_category Fonksiyonu

18 Ekim 2008

WordPress'in güzel fonksiyonlarından birisi de get_the_category fonksiyonudur. Bu fonksiyon ile ekranda gösterilen bir yazının kategori bilgilerini, kategorilerin ID'lerini, adlarını, yazı sayılarını, açıklamalarını vs. alabiliyor ve istediğiniz gibi işleme şansı elde ediyorsunuz. Bu fonksiyonla ilgili WordPress Codex'te yayınlanan açıklama burada, yazımın devamında bu yazının Türkçe çevirisini ve kullanımına ilişkin örnekler bulabilirsiniz.

get_the_category Fonksiyonu

Açıklama

Bir yazının ait olduğu bütün kategorilerin her biri ile ilgili bilgileri bir nesne dizisi olarak döndürür. Fonksiyon mutlaka bir loop (döngü) içerisinde kullanılmalıdır.

Kullanım

Bu fonksiyon ekrana herhangi bir şey yazmaz, sizin nesnelerin değerlerini, echo ya da başka bir yöntemle ekrana yazmanız gerekir.
Aşağıdaki örnek, yazının ait olduğu kategorilerin isimlerini yazar (aynı the_category() fonksiyonu gibi ekrana yazar, fakat aralarına , (virgül) değil boşluk bırakır):

<?php
foreach((get_the_category()) as $category) {
echo $category->cat_name . ' ';
}
?>

Örnekler

Kategori Resimleri Göstermek

Diyelim ki yazı altlarında her bir kategori için bir resim göstermek istiyorsunuz. Kullanacağınız resimleri bir klasöre kategori id'leri adıyla kaydedin. Örneğin, 5 id'li kategori için 5.jpg dosya adını kullanın. Aşağıdaki örnek kategori id'sini kullanarak bu dosyaları göstermeyi, resim açıklaması olarak ise kategori adını kullanmayı sağlar.

<?php
foreach((get_the_category()) as $category) {
echo '<img src="http://example.com/images/' . $category->cat_ID . '.jpg" alt="' . $category->cat_name . '" />';
}
?>

Sadece İlk Kategorinin Adını Gösterme

Bazı yazılar birden fazla kategoriye ait olabilirler. Ama eğer siz sadece birinci kategorinin bilgilerine ulaşmak istiyorsanız, aşağıdaki örneği kullanabilirsiniz.

<?php
$category = get_the_category();
echo $category[0]->cat_name;
?>

Fonksiyondan Dönen Değerler

cat_ID: Kategorinin ID numarası (ayrıca 'term_id' olarak da döner)
cat_name:Kategorinin adı (ayrıca 'name' olarak da döner)
category_nicename:Kategorinin kalıcı bağlantılarda kullanılan kısa adı (ayrıca 'slug' olarak da döner)
category_description:Kategorinin açıklaması (ayrıca 'description' olarak da döner, kategori oluşturulurken Tanım alanına girilen metindir)
category_parent: Kategorinin ait olduğu ana kategori. En üstteki kategoriler için '0' değeri döner. (ayrıca 'parent' olarak da döner)
category_count: Kategorinin kullanıldığı sayı, bir nevi kategorideki yazı sayısı (ayrıca 'count' olarak da döner)

İlişkili yazılar

the_category, the_category_rss, single_cat_title, category_description, wp_dropdown_categories, wp_list_categories, in_category, get_category_parents, get_category_link

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

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