WordPress Özel Alan Fonksiyonları

26 Ekim 2008

Yazılara eklenebilen özel alanlar vasıtasıyla, yazılarınıza birçok özellik katabilirsiniz. En basitinden her yazı için bir resim belirleyebilir ve bu resmi yazının önizlemesi olarak temanızda gösterebilirsiniz. Özel alanların kullanımı ve uygulamalar için daha önce de bildirdiğim gibi renkliteneke'nin yazısı güzel bir başlangıç olabilir.
Özel alanlarla ilgili yazılarımda, özel alanları efektif kullanmamızı sağlayarak fonksiyonları tanıtacağım. Tabi ince özel alanlar hakkında kısa bir bilgi.
Özel alanları eklemek çok kolay, bunun için yapmanız gereken Yazı Yazarken pencerenin altında bulunan, Özel Alanlar sekmesini açtıktan sonra özel alanı tanımlamak için bir anahtar (keyword) ve özel alanın değerini yazmanız yeterlidir. Başka bir yazıyı yazarken ise tekrar anahtar kelimeyi yazmak yerine açılır kutudan anahtar kelimeyi seçmeniz ve değerini yazmak yeterli olacaktır. Bir yazı aynı anahtardan birden fazla değer alabilir. Bu nedenle özel alan fonksiyonlarının çoğunda geri dönen değer dizi şeklindedir.
Özel alanlara girilen anahtarlar ve değerler veritabanında 'postmeta' isimli tabloda, aşağıdaki alan adlarıyla tutulurlar.
meta_id: Her bir kayıt için tekil id
post_id: Özel alanın ait olduğu yazının ID'si
meta_key: Özel alanın ismi (keyword)
meta_value: Özel alanın değeri.

Yazının Özel Alanlarını Listelemek

Bir yazıya ait özel alanların tamamını göstermek için 'the_meta' fonksiyonu kullanılır. Bu fonksiyon daha çok yazı sonunda post-meta olarak adlandırılan alanda kullanılır. Fonksiyon Loop (döngü) içerisinde kullanılmalıdır. Döngü içerisinde yazının özel alanlarını göstermek istediğiniz yere aşağıdaki kodu yazmanız yeterlidir.
<?php the_meta(); ?>
Fonksiyon aşağıdakine benzer bir çıktı verecektir.

<ul class='post-meta'>
<li>Anahtar Adı1: Anahtar Değeri 1</li>
<li>Anahtar Adı2: Anahtar Değeri 2</li>
</ul>

Bu çıktıyı CSS ile istediğiniz formatta biçimlendirebilirsiniz. O kısmı artık size kalmış.

Özel Alanlar İçin Gelişmiş Teknikler

Aşağıda, özel alanları almak ve özelleştirmek için gelişmiş tekniklerden örnekler yer almaktadır.

Özel Alanları Almak

Yazıya ait özel alanları almak için get_post_meta() fonksiyonu kullanılır:
get_post_meta($post_id, $key, $single)
Parametreler
$post_id: Özel alanlarını almak istediğiniz yazının ID'si. Yazının ID'si için $post->ID'yi kullanabilirsiniz.
$key: Yazının almak istediğiniz özel alanının adı.
$single: true ya da false değeri alır. Eğer true girilirse, özel alan değeri tek satırlık metin olarak döner, değer ilgili anahtarın ilk değeridir. false girilirse dönen değer dizi olur. Varsayılan false.
Örnek:
Tek bir değeri almak için,
$onizlemeresmi = get_post_meta($post->ID, "onizleme", true);
echo $onizlemeresmi;
Birden fazla değeri almak için,
$onizlemeresimleri = get_post_meta($post->ID, "onizleme", true);
foreach ($onizlemeresimleri as $onizlemeresmi) {
echo $onizlemeresmi;
}

Ön Belleği Kullanma

Bir yazı görüntülendiğinde yazıya ait bütün özel alanlar önbelleklenir. Yazıya ait önbellek bilgileri $post_meta_cache isimli bir dizi değişkende tutulur. Örneğin 256 ID'li yazının 'neokuyorum' adlı anahtarının değerlerini almak için:
$neokuyorumlistesi = $post_meta_cache[256]['neokuyorum'];
kodu kullanılır. Dönen değer dizi değeridir. Ancak bu değişken artık sık kullanılmıyor. Özel alanlarla işlem yapmak için aşağıdaki fonksiyonları kullanmak daha uygun olacaktır.

Dahili Özel Alan Fonksiyonları

Aşağıdaki fonksiyonlar Loop (yazı döngüsü) içerisinde kullanılmalıdır.

get_post_custom()

Yazının bütün özel alan anahtarlarını ve değerlerini döndürür. Genel kullanımı:

<?php
$custom_fields = get_post_custom();
$my_custom_field = $custom_fields['ozelalanlarim'];
foreach ( $my_custom_field as $key => $value )
echo $key . " => " . $value . " ";
?>

Ekran Çıktısı:
0 => Köpekler
1 => 86
2 => Başka bir değer
İstenirse parametre olarak yazı ID'si de girilebilir.

get_post_custom_keys()

Yazıya ait özel alan anahtarlarını dizi olarak döndürür. Genel kullanımı:

<?php
$custom_field_keys = get_post_custom_keys();
foreach ( $custom_field_keys as $key => $value )
echo $key . " => " . $value . " ";
?>

Ekran Çıktısı:
0 => onizleme
1 => ozelalanadi1
2 => ozelalanadi2
İstenirse parametre olarak yazı ID'si de girilebilir.

get_post_custom_values($key)

Yazıya ait belli bir özel alan adının değerini döndürür. Özellikle birden fazla değeri olan anahtar adlarının değerlerini almak için kullanılması önerilir. Anahtarın tek değeri varsa get_post_meta() fonksiyonunu kullanmanız uygun olacaktır.

<?php
$mykey_values = get_post_custom_values('anahtaradi');
foreach ( $mykey_values as $key => $value ) {
echo "$key => $value ";
}
?>

Ekran Çıktısı:
0 => Birinci değer
1 => İkinci değer
2 => Üçüncü değer
Fonksiyona istenirse yazı ID'si de parametre olarak verilebilir. Yani get_post_custom_values('anahtaradi', 25); şeklinde de kullanılabilir.

Bu fonksiyonların dışında özel alanların eklentiler içerisinde yönetilmelerini sağlayacak bazı fonksiyonlar da vardır. Bunlar:
add_post_meta, delete_post_meta, update_post_meta

Kaynak: WordPress.org Codex - Using Custom Fields,

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

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