18 Ekim 2008

WordPress get_the_category Fonksiyonu

WordPress Yorum Ekle

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

  1. <?php
  2. foreach((get_the_category()) as $category) {
  3.     echo $category->cat_name . ' ';
  4. }
  5. ?>

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

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

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.

  1. <?php
  2. $category = get_the_category();
  3. echo $category&#91;0]->cat_name;
  4. ?>

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.


“WordPress get_the_category Fonksiyonu” yazısı için 3 Yorum

Bu yazıya yapılan yorumları dilerseniz, ( RSS 2.0 ) beslemesini kullanarak takibe alabilirsiniz.

  1. WordPress Fonksiyon Listesi · Yakup Gövler'in Not Defteri dedi ki:

    [...] get_category_parents get_category_link get_categories the_tags get_the_tags wp_tag_cloud get_the_category wp_update_post wp_insert_post wp_list_categories add_action Yazıyı Paylaş: Aşağıdaki [...]

  2. FFatih dedi ki:

    Gecenin şu saatinde sadece ilk kategorinin adını gösterme tam da aradığım şey (Unreal deyimiyle: headshot! :)). Teşekkürler.

  3. cemadam dedi ki:

    Hocam emeğinize sağlık, çok teşekkürler...