WordPress add_filter Fonksiyonu ve Örnekler
Merhaba, bu yazıda WordPress’te yer alan add_filter fonksiyonu hakkında detaylı bilgi vereceğim. Add_filter, WordPress’in sunduğu bir API fonksiyonudur ve WordPress’in çekirdek kodunu değiştirmeden filtreleme yapmanızı sağlar. Filtreleme, bir değerin veya çıktının işlenmeden önce veya sonra değiştirilmesi anlamına gelir. Örneğin, bir yazının başlığını veya içeriğini, bir resmin boyutunu veya kalitesini, bir eklentinin ayarlarını veya fonksiyonlarını filtreleyebilirsiniz.
Add_filter fonksiyonunun kullanımı şöyledir:
|
0 1 2 |
add_filter( $tag, $function_to_add, $priority, $accepted_args ); |
Bu parametrelerin anlamları şunlardır:
– $tag: Filtrelemenin uygulanacağı etiketin adıdır. WordPress’in kendisi birçok etiket sunar ve ayrıca eklentiler de kendi etiketlerini oluşturabilirler. Örneğin, the_title etiketi yazı başlıklarını filtrelemek için kullanılır.
– $function_to_add: Filtrelemenin nasıl yapılacağını belirleyen fonksiyonun adıdır. Bu fonksiyon, etiketten gelen değeri alır, istediğiniz değişiklikleri yapar ve geri döndürür.
– $priority: Aynı etikete birden fazla filtre uygulanması durumunda, hangi filtrenin önce çalışacağını belirleyen sayısal bir değerdir. Düşük sayılar yüksek öncelik anlamına gelir. Varsayılan değer 10’dur.
– $accepted_args: Fonksiyonun kaç tane argüman kabul edeceğini belirleyen sayısal bir değerdir. Varsayılan değer 1’dir.
Add_filter fonksiyonunu daha iyi anlamak için bazı örnekler verelim:
– Örnek 1: Yazı başlıklarının sonuna bir emoji eklemek istiyoruz.
|
0 1 2 3 4 5 6 |
function add_emoji_to_title( $title ) { return $title . "😊"; } add_filter( 'the_title', 'add_emoji_to_title' ); |
Bu kodda, the_title etiketine add_emoji_to_title fonksiyonunu ekliyoruz. Bu fonksiyon, başlığı alır ve sonuna bir emoji ekleyerek geri döndürür.
– Örnek 2: Yazı içeriklerindeki bütün küçük harfleri büyük harfe çevirmek istiyoruz.
|
0 1 2 3 4 5 6 |
function uppercase_content( $content ) { return strtoupper( $content ); } add_filter( 'the_content', 'uppercase_content' ); |
Bu kodda, the_content etiketine uppercase_content fonksiyonunu ekliyoruz. Bu fonksiyon, içeriği alır ve bütün harfleri büyük harfe çevirerek geri döndürür.
– Örnek 3: Resimlerin kalitesini düşürmek istiyoruz.
|
0 1 2 3 4 5 6 |
function lower_image_quality( $quality ) { return 50; } add_filter( 'jpeg_quality', 'lower_image_quality' ); |
Bu kodda, jpeg_quality etiketine lower_image_quality fonksiyonunu ekliyoruz. Bu fonksiyon, kalite değerini alır ve 50 olarak geri döndürür.
– Örnek 4: Bir eklentinin ayarlarını değiştirmek istiyoruz.
|
0 1 2 3 4 5 6 7 8 |
function change_plugin_settings( $settings ) { $settings['color'] = 'red'; $settings['size'] = 'large'; return $settings; } add_filter( 'plugin_settings', 'change_plugin_settings' ); |
Bu kodda, plugin_settings etiketine change_plugin_settings fonksiyonunu ekliyoruz. Bu fonksiyon, ayarları alır ve renk ve boyut değerlerini değiştirerek geri döndürür.
– Örnek 5: Bir fonksiyonun çalışmasını engellemek istiyoruz.
|
0 1 2 3 4 5 6 |
function disable_function( $output ) { return false; } add_filter( 'some_function', 'disable_function' ); |
Bu kodda, some_function etiketine disable_function fonksiyonunu ekliyoruz. Bu fonksiyon, çıktıyı alır ve false olarak geri döndürür. Böylece some_function çalışmaz.
Add_filter fonksiyonu ile WordPress’te filtreleme yapmanın temellerini öğrendiniz. Daha fazla bilgi için WordPress Codex’i ziyaret edebilirsiniz. WordPress’te filtreleme yapmanın avantajları nelerdir? Siz hangi filtreleri kullanıyorsunuz? Yorumlarınızı bekliyorum.
