15.01.2025

WordPress Kancaları Nedir ?

WordPress kancaları, WordPress geliştirme çerçevesinin önemli bir parçasıdır ve geliştiricilerin çekirdek dosyaları değiştirmeden çekirdek WordPress işlevselliği ile etkileşime girmesine olanak tanır. Kancaları kullanarak temalara ve eklentilere işlevsellik ekleyebilir veya bunları değiştirebilirsiniz. İki ana kanca türü vardır: Eylem Kancaları ve Filtre Kancaları. İşte ne olduklarının ve nasıl kullanılacaklarının bir dökümü.

WordPress Hook’ları Nedir?

Kancalar, WordPress’te WordPress işlevlerine “bağlanmanıza” ve özel kod çalıştırmanıza olanak tanıyan önceden tanımlanmış noktalardır. Bu, orijinal dosyaları doğrudan düzenlemeden WordPress çekirdeği, temaları ve eklentilerinin işlevselliğini değiştirmenize veya genişletmenize olanak tanır.

İki ana kanca türü vardır:

Eylem Kancaları: WordPress yürütmesi sırasında belirli noktalara özel kod eklemenize veya yürütmenize olanak tanır (örneğin, bir yazı yayınlandığında veya bir sayfa yüklendiğinde).
Filtre Kancaları: Tarayıcıya gönderilmeden veya veritabanına kaydedilmeden önce verileri değiştirmenize veya manipüle etmenize izin verir (örneğin, içeriği değiştirmek veya çıktıyı değiştirmek).

1. Eylem Kancaları

Eylem kancaları WordPress’in çalışması sırasında çeşitli noktalarda tetiklenir. WordPress yükleme sürecinin belirli aşamalarında veya belirli olaylar gerçekleştiğinde (bir yazı yayınlamak veya altbilgiyi görüntülemek gibi) işlevsellik eklemenize olanak tanırlar.

Eylem Kancaları Nasıl Kullanılır?

Bir eylem kancası kullanmak için temanızın functions.php dosyasında veya özel bir eklentide add_action() işlevini kullanırsınız. Bu fonksiyon özel fonksiyonunuzu belirli bir kancaya bağlar.

Sözdizimi:

add_action( ‘hook_name’, ‘your_custom_function’ ); function your_custom_function() { // Özel kodunuz burada. }

Örnek:

Diyelim ki her gönderinin sonuna özel içerik eklemek istiyorsunuz:

add_action( ‘the_content’, ‘add_custom_content’ ); function add_custom_content( $content ) { if ( is_single() ) { $content .= ‘

Okuduğunuz için teşekkürler!

‘; } return $content; }

Bu örnekte the_content, her gönderinin sonuna özel içerik ekleme işlevini tetikleyen kancadır.

2. Filtre Kancaları

Filtre kancaları, verilerin çıktısını ekranda işlenmeden veya veritabanına kaydedilmeden önce değiştirmenize olanak tanır. Filtreler verileri alır, değiştirir ve geri gönderir.

Filtre Kancaları Nasıl Kullanılır?

Bir filtre kancası kullanmak için, belirli içeriği değiştirmek üzere özel bir işlev uygulayan add_filter() işlevini kullanırsınız.

Sözdizimi:

add_filter( ‘hook_name’, ‘your_custom_filter_function’ ); function your_custom_filter_function( $content ) { // İçeriği değiştirin. return $modified_content; }

Örnek:

Diyelim ki her gönderinin başlığını büyük harflerle değiştirmek istiyorsunuz:

add_filter( ‘the_title’, ‘uppercase_post_title’ ); function uppercase_post_title( $title ) { return strtoupper( $title ); }

Bu örnekte, the_title yazı başlıklarını filtreleyen kancadır ve uppercase_post_title() işlevi tüm başlıkları büyük harfe dönüştürür.

Popüler WordPress Kancaları

İşte WordPress’te yaygın olarak kullanılan bazı kancalar:

Aksiyon Kancaları:

wp_enqueue_scripts: Komut dosyaları ve stilleri eklemek veya kaldırmak için bunu kullanın.
init: WordPress yüklemeyi tamamladıktan sonra ancak herhangi bir başlık gönderilmeden önce çalışır.
wp_footer: Temanızdaki kapanış etiketinden hemen önce kodu çalıştırır.
publish_post: Bir gönderi yayınlandığında tetiklenir.

Filtre Kancaları:

the_content: Gönderi içeriğini görüntülenmeden önce filtrelemenizi sağlar.
the_title: Gönderi başlıklarını değiştirmenizi sağlar.
excerpt_length: Yazı alıntılarının uzunluğunu değiştirmenizi sağlar.
wp_nav_menu_items: Gezinme menüsü öğelerinin çıktısını filtreleyin.

Kancaları Kullanmak için En İyi Uygulamalar

Çekirdek Dosyaları Düzenlemekten Kaçının: Gelecekteki güncellemelerle uyumluluğu korumak için her zaman özel temalarda veya eklentilerde kancalar kullanın.
Benzersiz İşlev Adları: Diğer eklentiler veya temalarla çakışmaları önlemek için özel işlevleriniz için her zaman benzersiz adlar kullanın.
Koşullu Mantık Kullanın: Kancaları kullanırken, kodunuzun yalnızca gerektiğinde çalışmasını sağlamak için is_single() veya is_admin() gibi koşullu kontrolleri kullanın.

Sonuç

WordPress kancaları (hem eylem kancaları hem de filtre kancaları) web sitenizin işlevselliğini özelleştirmek ve genişletmek için güçlü bir araçtır. Kancaları kullanarak, çekirdek dosyaları değiştirmeden özel özellikler ekleyebilir, web sitenizi daha esnek ve bakımı daha kolay hale getirebilirsiniz. Kancaların nasıl ve ne zaman kullanılacağını anlamak, verimli WordPress temaları ve eklentileri geliştirmenin anahtarıdır.