WordPress Eklentisi Yazarken Gerekli Kodlar
WordPress eklentileri, WordPress web sitelerinin işlevselliğini genişletmek için kullanılan güçlü araçlardır. Bir WordPress eklentisi yazmak, web geliştirme becerileri ve WordPress API’sı hakkında bilgi gerektirir. Bu makale, WordPress eklentisi yazarken gerekli temel kodları ve en iyi uygulamaları inceleyecektir.
1. Eklenti Başlığı ve Açıklaması
Her eklenti, benzersiz bir başlık ve açıklamaya sahip olmalıdır. Bu bilgiler, eklentinin WordPress eklenti dizininde nasıl göründüğünü belirler.
php
<?php
/*
Plugin Name: Eklenti Adı
Plugin URI: https://eklenti-web-sitesi.com/
Description: Eklenti açıklaması.
Version: 1.0
Author: Yazar Adı
Author URI: https://yazar-web-sitesi.com/
License: GPLv2 veya GPLv3
*/
2. Eklenti Dosyası
Eklenti dosyası, eklentinin işlevselliğini içerir. Genellikle plugin-name.php
olarak adlandırılır.
“`php
<?php
/
Eklenti dosyası
/
// Eklentiyi etkinleştirme işlevi
function eklenti_etkinlestir() {
// Etkinleştirme işlemleri
}
// Eklentiyi devre dışı bırakma işlevi
function eklenti_devre_disi_birak() {
// Devre dışı bırakma işlemleri
}
// Eklentiyi kaldırma işlevi
function eklenti_kaldir() {
// Kaldırma işlemleri
}
// Eklenti yüklendiğinde çalıştırılacak işlev
function eklenti_yuklendi() {
// Yükleme işlemleri
}
// Eklenti etkinleştirildiğinde çalıştırılacak işlev
register_activation_hook(FILE, ‘eklenti_etkinlestir’);
// Eklenti devre dışı bırakıldığında çalıştırılacak işlev
register_deactivation_hook(FILE, ‘eklenti_devre_disi_birak’);
// Eklenti kaldırıldığında çalıştırılacak işlev
register_uninstall_hook(FILE, ‘eklenti_kaldir’);
// Eklenti yüklendiğinde çalıştırılacak işlev
add_action(‘plugins_loaded’, ‘eklenti_yuklendi’);
“`
3. Eklenti Ayarları
Eklentiler, kullanıcıların yapılandırmasına izin vermek için ayarlar sağlayabilir. Ayarlar, WordPress Ayarlar API’si kullanılarak oluşturulur.
“`php
<?php
// Ayarlar sayfası
function eklenti_ayarlar_sayfasi() {
// Ayarlar sayfası içeriği
}
// Ayarlar kaydetme işlevi
function eklenti_ayarlari_kaydet() {
// Ayarları kaydetme işlemleri
}
// Ayarlar sayfası oluşturma
add_action(‘admin_menu’, ‘eklenti_ayarlar_sayfasi’);
// Ayarları kaydetme işlemi
add_action(‘admin_init’, ‘eklenti_ayarlari_kaydet’);
“`
4. Eklenti Widget’ları
Eklentiler, WordPress kenar çubuğuna widget’lar ekleyebilir. Widget’lar, WordPress Widget API’si kullanılarak oluşturulur.
“`php
<?php
// Widget sınıfı
class Eklenti_Widget extends WP_Widget {
// Widget kurulum işlevi
public function __construct() {
// Widget kurulum işlemleri
}
// Widget görüntüleme işlevi
public function widget($args, $instance) {
// Widget görüntüleme işlemleri
}
// Widget form işlevi
public function form($instance) {
// Widget form işlemleri
}
// Widget güncelleme işlevi
public function update($new_instance, $old_instance) {
// Widget güncelleme işlemleri
}
}
// Widget kaydetme
function eklenti_widget_kaydet() {
register_widget(‘Eklenti_Widget’);
}
// Widget kaydetme işlemi
add_action(‘widgets_init’, ‘eklenti_widget_kaydet’);
“`
5. Eklenti Kısa Kodları
Eklentiler, içerikte kullanılabilecek kısa kodlar sağlayabilir. Kısa kodlar, WordPress Kısa Kod API’si kullanılarak oluşturulur.
“`php
<?php
// Kısa kod işlevi
function eklenti_kisa_kod() {
// Kısa kod işlemleri
}
// Kısa kod kaydetme
add_shortcode(‘eklenti-kisa-kod’, ‘eklenti_kisa_kod’);
“`
6. Eklenti Eylemleri ve Filtreleri
Eklentiler, WordPress eylemlerine ve filtrelerine bağlanabilir. Bu, diğer eklentiler veya WordPress çekirdeği ile etkileşime girmelerini sağlar.
“`php
// Eyleme bağlanma
function eklenti_eylem() {
// Eylem işlemleri
}
// Eyleme bağlanma
add_action(‘wp_head’, ‘eklenti_eylem’);
// Filtreye bağlanma
function eklenti_filtre($icerik) {
// Filtre işlemleri
return $icerik;
}
// Filtreye bağlanma
add_filter(‘the_content’, ‘eklenti_filtre’);
“`
En İyi Uygulamalar
WordPress eklentisi yazarken aşağıdaki en iyi uygulamalara uymak önemlidir:
- Kodlama Standartlarına Uyun: WordPress kodlama standartlarına uyun.
- Güvenliği Sağlayın: Eklentilerinizi güvenlik açıklarına karşı test edin.
- Belgelerinizi Oluşturun: Eklentiniz için kapsamlı belgeler sağlayın.
- Güncellemeleri Sağlayın: Eklentilerinizi düzenli olarak güncelleyin.
- Destek Sunun: Kullanıcılarınız için destek sağlayın.
Faydalı Kaynaklar
- WordPress Eklenti Geliştirme Kılavuzu
- WordPress Eklenti API’si
- WordPress Kısa Kod API’si
- WordPress Eylemleri ve Filtreleri