20.01.2025

WordPress’te Eylemler

WordPress’te Eylemler, geliştiricilerin WordPress‘in yürütülmesi sırasında belirli noktalara özel kod eklemesine olanak tanıyan Hooks API’nin bir parçasıdır. Eylemler, bir gönderi yayınlandığında, bir sayfa yüklendiğinde veya bir tema etkinleştirildiğinde olduğu gibi belirli olaylarda veya aşamalarda görevleri yerine getirmenizi veya işlevleri yürütmenizi sağlar.

Eylemler, çekirdek dosyaları değiştirmeden WordPress’in işlevselliğini genişletmek için özellikle kullanışlıdır ve sitenizi daha sürdürülebilir ve geleceğe dönük hale getirir.

WordPress Eylemleri Nasıl Çalışır?

WordPress’te bir yazının yüklenmesi veya bir yorumun yayınlanması gibi belirli bir olay gerçekleştiğinde bir eylem tetiklenir. Bir eylem tetiklendiğinde, bu eyleme bağlı olan tüm işlevler yürütülür.

Örneğin:

Bir kullanıcı oturum açtığında, WordPress wp_login eylemini tetikler, bu da bir kullanıcı oturum açtığında özel kod çalıştırmanıza olanak tanır.
Bir gönderi kaydedildiğinde, save_post eylemi tetiklenir ve bir gönderi yayınlandığında e-posta göndermek gibi özel işlevler eklemenize olanak tanır.

Add_action() ile Eylemleri Kaydetme

Bir işlevi bir eyleme bağlamak için add_action() işlevini kullanın. Bu işlev, bir eylem tetiklendiğinde WordPress’e belirli bir işlevi çalıştırmasını söyler.

Sözdizimi:

add_action( $hook, $function_to_add, $priority, $accepted_args );

$kanca: Eylem kancasının adı (örneğin, wp_login, save_post).
$function_to_add: Eylem tetiklendiğinde çalıştırılmasını istediğiniz işlevin adı.
$priority (isteğe bağlı): Fonksiyonların hangi sırada çalıştırılacağını belirtmek için kullanılır. Düşük sayılar daha yüksek öncelik anlamına gelir. Varsayılan değer 10’dur.
$accepted_args (isteğe bağlı): Fonksiyonun kabul ettiği argüman sayısı. Varsayılan değer 1’dir.

Örnek:

function my_custom_function() { // Custom code here echo “User has logged in!”; } add_action( ‘wp_login’, ‘my_custom_function’ );

Bu örnekte, bir kullanıcı oturum açtığında my_custom_function() işlevi çalışacak ve bir mesaj görüntüleyecektir.

Yaygın WordPress Eylemleri

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

wp_enqueue_scripts: Ön uçtaki komut dosyalarını ve stilleri sıraya koymak için kullanılır.
init: WordPress yüklemeyi tamamladıktan sonra ancak herhangi bir başlık gönderilmeden önce tetiklenir. Genellikle özel yazı türlerini veya taksonomileri kaydetmek için kullanılır.
wp_head: Temanın head bölümünde tetiklenir, meta etiketleri, stiller veya komut dosyaları eklemek için kullanışlıdır.
save_post: Bir gönderi kaydedildiğinde tetiklenir. Gönderi meta verilerini güncellemek gibi ek eylemler gerçekleştirmek için kullanılabilir.
admin_init: Bir kullanıcı yönetici kontrol paneline eriştiğinde tetiklenir, özel ayarlar eklemek veya yönetici alanı için özellikleri başlatmak için kullanışlıdır.

Özel Eylemler Oluşturma

Ayrıca kendi özel eylemlerinizi de oluşturabilirsiniz. Bu, diğer geliştiricilerin (veya sizin) özel temanızdaki veya eklentinizdeki belirli noktalara işlevler bağlamasına olanak tanır.

Örnek:

function my_custom_action() { // Bir şey yap echo “Özel eylem tetiklendi!”; } do_action( ‘my_custom_action’ );

Bu durumda, do_action( ‘my_custom_action’ ); yerleştirildiği her yerde my_custom_action kancasını tetiklersiniz ve buna şu şekilde işlevler bağlayabilirsiniz:

add_action( ‘my_custom_action’, ‘my_custom_function’ );

Do_action() ve do_action_ref_array() işlevlerini anlama

do_action(): Bu işlev, belirli bir eyleme bağlı işlevlerin yürütülmesini tetikler.

Örnek:

do_action( ‘wp_footer’ );

do_action_ref_array(): Bu fonksiyon, doğrudan değiştirmek istediğiniz nesneler veya dizilerle çalışırken yararlı olan bir dizi argümanı referans olarak kancalı fonksiyonlara iletir.

Örnek:

$my_data = array( ‘key’ => ‘value’ ); do_action_ref_array( ‘my_custom_action’, array( &$my_data ) );

Sonuç

WordPress Eylemleri, özel işlevleri belirli olaylara bağlayarak WordPress’in işlevselliğini genişletmek için güçlü bir yol sağlar. Geliştiriciler eylemleri kullanarak WordPress çekirdeğini değiştirmeden temaları, eklentileri ve temel özellikleri özelleştirebilir, böylece kolay güncelleme ve sürdürülebilirlik sağlarlar. Eylemlerin nasıl kullanılacağını ve oluşturulacağını anlamak, daha dinamik ve zengin özelliklere sahip web siteleri oluşturmak isteyen tüm WordPress geliştiricileri için çok önemlidir.