WordPress add_filter() Nedir?

WordPress siteni açıyorsun, her şey güzel… ama bir eksik var. Başlıklar biraz renksiz, özetler çok uzun, ya da yüklemek istediğin dosya türü desteklenmiyor. İşte bu noktada add_filter() devreye girer. Kodu kökünden değiştirmeden, sadece istediğin noktada kendi dokunuşunu katmanı sağlar.

add_filter(), WordPress’te verilerin ekrana yansımadan önce veya bir fonksiyon tarafından işlenirken üzerinde değişiklik yapmana izin verir. Yani, sitenin arka planında “senin elin değmiş” bir sihir gibi çalışır.

add_filter() Nasıl Çalışır?

Basitçe söylemek gerekirse, add_filter(), WordPress’in belirli bir veri noktasına senin fonksiyonunu ekler. Böylece veri, senin süzgecinden geçmeden kullanıcıya ulaşmaz.

Örneğin:

• Bir yazı başlığı gösterilmeden hemen önce ona küçük bir emoji ekleyebilirsin.
• Yazı özetlerinin kelime sayısını kısaltabilirsin.
• Yüklenebilir dosya türlerine SVG ekleyebilirsin.

WordPress add_filter() Temel Kullanımı

add_filter( $hook_name, $callback, $priority, $accepted_args );

Parametreler:

• $hook_name: Filtre adı (zorunlu).
• $callback: Çalıştırılacak fonksiyon (zorunlu).
• $priority: Öncelik derecesi (varsayılan: 10).
• $accepted_args: Callback’in alacağı parametre sayısı. Yani, WordPress bu filtreye veri gönderirken senin fonksiyonuna kaç tane değişken ileteceğini belirtir. Çoğu filtrede tek bir veri iletilir (varsayılan: 1), ancak bazı durumlarda iki ya da daha fazla parametre alabilirsin. Bu değeri artırarak, fonksiyonunun ek verilerden de yararlanmasını sağlayabilirsin.

Örnek:

function wlnk_add_title_emoji( $title ) {
    return $title . ' ✨';
}
add_filter( 'the_title', 'wlnk_add_title_emoji' );

Bu kod, tüm yazı başlıklarının sonuna minik bir parıltı ekler.

Sık Kullanılan WordPress add_filter() Hook’ları

1. the_title — Yazı başlıklarını değiştirir.
2. the_content — Yazı içeriğini düzenler.
3. excerpt_more — “Devamını oku” metnini özelleştirir.
4. widget_title — Widget başlıklarını değiştirir.
5. upload_mimes — Yüklenebilir dosya türlerini kontrol eder.

WordPress add_filter() ile Yaratıcı Örnekler

Örnek: Özet uzunluğunu kısaltmak:

function wlnk_custom_excerpt_length( $length ) {
    return 20;
}
add_filter( 'excerpt_length', 'wlnk_custom_excerpt_length' );

Örnek: SVG yüklemeye izin vermek:

function wlnk_allow_svg_upload( $mimes ) {
    $mimes['svg'] = 'image/svg+xml';
    return $mimes;
}
add_filter( 'upload_mimes', 'wlnk_allow_svg_upload' );

WordPress add_filter() Kullanırken Dikkat

• Her zaman geri döndür: Veriyi değiştirip, sürecin sonunda tekrar geri vermesi gerekir.
• Abartma: Çok fazla filtre eklenmesi, sitenin yavaşlamasına yol açabilir.
• Doğru Hook: Yanlış filtre adı kullanıldığında kod beklenen şekilde çalışmayabilir.

Sonuç

add_filter(), sana WordPress’in içinde kendi imzanı atma şansı verir. Küçük dokunuşlarla bile siteni daha kişisel, daha farklı yapma şansı verir. Daha fazla ipucu ve rehber için önceki yazılarımıza göz atabilirsin. Soruların ya da kendi deneyimlerini paylaşmak istersen, yorumlarda ya da iletişim sayfamızdan bize ulaşabilirsin. Çünkü burada öğrendiklerin, belki de WordPress yolculuğunun sadece başlangıcı.