WordPress Eklenti Geliştirme Kılavuzu: Sıfırdan Başlayarak Yayına Hazırlamaya Kadar Pratik Bir Rehber

WordPress Eklenti Geliştirme Ortamının Kurulması

Herhangi bir kod yazmaya başlamadan önce, profesyonel bir yerel geliştirme ortamı oluşturmak çok önemlidir. Bu, kodu güvenli bir şekilde test etmenizi sağlamakla kalmaz, aynı zamanda geliştirme verimliliğinizi de önemli ölçüde artırır. Genellikle, Apache/Nginx, MySQL ve PHP’nin entegre edildiği bir yerel sunucu ortamı hızlı bir şekilde kurmak için Local by Flywheel, XAMPP veya MAMP gibi araçların kullanılması önerilir.

Bir kod editörüne ihtiyacınız var; örneğin Visual Studio Code veya PHPStorm. Visual Studio Code, hafifliği ve güçlü eklenti ekosistemi (PHP Intelephense, WordPress Snippet gibi) nedeniyle birçok geliştirici tarafından tercih edilir. Ayrıca, eklenti kodlarınızı bir sürüm kontrol sistemi (örneğin Git) aracılığıyla yönetmek iyi bir alışkanlıktır; bu, değişiklikleri takip etmenize, yeni dallar oluşturmanıza ve gerektiğinde önceki stabil sürümlere geri dönmenize yardımcı olur.

Çekirdek Dosya Yapısı Planlaması

Yapısı net bir eklenti, hem sizin için bakımını kolaylaştırır hem de diğer geliştiricilerin anlamasını sağlar. Standart bir WordPress eklentisi en az bir ana PHP dosyası içerir ve bu dosyanın adı genellikle eklentinin adıyla aynıdır. Projenin başından itibaren dizin yapısını önceden planlamanız önerilir; örneğin:

Tavsiye edilen okuma WordPress Eklenti Geliştirme: Başlangıçtan Uzmanlığa Kadar Kapsamlı Pratik Rehber。

your-plugin/
│
├── your-plugin.php      // 主文件，包含插件头部信息
├── uninstall.php        // 可选，插件卸载时执行的清理脚本
├── includes/            // 存放核心功能类或函数文件
│   ├── class-core.php
│   └── functions.php
├── admin/               // 后台相关文件
│   ├── css/
│   ├── js/
│   └── class-admin.php
├── public/              // 前端相关文件
│   ├── css/
│   ├── js/
│   └── class-public.php
├── assets/              // 静态资源（图片、字体等）
└── languages/           // 国际化翻译文件（.po, .mo）

Bu modüler yapı, ön uç (front-end) ve arka uç (back-end) mantığını birbirinden ayırarak kodun yönetilmesini ve genişletilmesini daha kolay hale getirir.

UltaHost WordPress Sunucusu

30 gün iade garantisi, sınırsız bant genişliği ve veritabanı kullanımı, ücretsiz DDoS koruması; 3 yıllık abonelikte indirim (50%).

Sayfaya erişin.

İlk eklenti ana dosyasını oluşturun.

Her WordPress eklentisinin girişi, belirli bir başlık yorumuna sahip bir PHP dosyasıdır. Bu başlık yorumu, WordPress’in eklenti bilgilerini (ad, açıklama, sürüm, yazar vb.) tanımasının tek yoludur. Bu yorum, ana dosyanın başında bulunmalıdır.

Aşağıda, en temel bir eklenti ana dosyası örneği bulunmaktadır. “” adında bir dosya oluşturun. my-first-plugin.php Belgenin içeriğini alın ve bunu WordPress’e ekleyin. wp-content/plugins Kataloğda.

<?php
/**
 * Plugin Name:       我的第一个自定义插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个用于学习WordPress插件开发的示例插件。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

// 防止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

// 定义一个插件常量，便于引用插件目录路径
if ( ! defined( 'MFP_PLUGIN_DIR' ) ) {
    define( 'MFP_PLUGIN_DIR', plugin_dir_path( __FILE__ ) );
}

// 包含其他必要文件
require_once MFP_PLUGIN_DIR . 'includes/functions.php';

Dosyayı kaydettikten sonra, bu eklentiyi WordPress arayüzünün “Eklentiler” sayfasında görebilir ve etkinleştirebilirsiniz. Şu an için herhangi bir özelliği yok, ancak eklentinin temel yapısını başarıyla oluşturdunuz. MFP_PLUGIN_DIR Bu tür sabitler iyi bir uygulamadır; çünkü eklentideki dosya yol referanslarının doğruluğunu ve tutarlılığını sağlar.

Hook’ları (eylemler ve filtreler) kullanarak işlevselliği genişletme

WordPress eklenti geliştirmenin temel felsefesi “Kancalar” (Hooks)dır; bu sayede çekirdek kodu değiştirmeden işlevleri değiştirebilir veya ekleyebilirsiniz. Kancalar iki türe ayrılır: Eylemler (Actions) ve Filtreler (Filters).

Tavsiye edilen okuma WordPress eklenti geliştirmeye giriş: ilk işlevsel uzantınızı sıfırdan oluşturun.。

Eylem kancaları, belirli zaman noktalarında özelleştirilmiş kodları çalıştırmanıza olanak tanır. Örneğin, bir makale yayınlandığında, yönetici menüsü yüklendiğinde veya ön uç betikleri sıraya eklendiğinde. add_action() Bu fonksiyon, kendi fonksiyonunuzu bir eylem kancasına (action hook) bağlamak için kullanılır.

// 示例：在文章内容顶部自动添加一段文字
function mfp_add_text_to_content( $content ) {
    if ( is_single() ) {
        $custom_text = '<p>Bu makaleyi okuduğunuz için teşekkür ederiz!</p>';
        $content = $custom_text . $content;
    }
    return $content;
}
// 将函数挂载到‘the_content’过滤器钩子
add_filter( 'the_content', 'mfp_add_text_to_content' );

Filtre hook’ları, verileri değiştirmenize olanak tanır. Bir değer alır ve bu değer, fonksiyonunuz tarafından işlendikten sonra bir değer döndürülmelidir. Yukarıdaki örnek aslında bir filtredir ve makale içeriğini değiştirmektedir. $contentHook’ları anlamak ve ustaca kullanmak, güçlü ve iyi uyumlu eklentiler oluşturmanın anahtarıdır.

Yönetim sayfası oluşturma ve ayar seçeneklerini belirleme

Çoğu eklentinin bir arka plan yapılandırma sayfasına ihtiyacı vardır. WordPress, üst düzey menüler ve alt menüler eklemek için gerekli fonksiyonları sağlar. add_menu_page() 和 add_submenu_page()。

hosting.com Paylaşımlı Barındırma

AMD EPYC CPU'lar, NVMe SSD depolama ve LiteSpeed ile yüksek performans, 7/24, 7x7 uzman şirket içi destek, SSL, kaba kuvvet, kötü amaçlı yazılım ve DDoS koruması dahil gelişmiş güvenlik önlemleri, 73%'ye kadar tasarruf

Sayfaya erişin.

Daha modern ve önerilen bir yaklaşım, ayar sayfaları oluşturmak için WordPress Ayar API’sini kullanmaktır. Bu API, güvenlik doğrulaması (Nonce), alanların kaydedilmesi ve arayüzün renderlanması gibi karmaşık işlemleri sizin yerinize yapar ve ayar sayfalarınızın WordPress standartlarına uygun olmasını sağlar. Aşağıdaki örnek, bir ayar grubu ve bir alanı nasıl Ayar API’si kullanarak kaydedeceğinizi göstermektedir.

// 在admin_init钩子中注册设置
add_action( 'admin_init', 'mfp_register_settings' );
function mfp_register_settings() {
    register_setting(
        'mfp_settings_group', // 设置组名
        'mfp_option_name',    // 选项名
        'sanitize_text_field' // 清理回调函数
    );

add_settings_section(
        'mfp_section_id',     // 区块ID
        '示例设置区块',       // 区块标题
        null,                 // 区块说明回调函数
        'mfp-settings-page'   // 所属页面slug
    );

add_settings_field(
        'mfp_field_id',       // 字段ID
        '示例文本字段',       // 字段标签
        'mfp_field_callback', // 字段渲染回调函数
        'mfp-settings-page',  // 页面slug
        'mfp_section_id'      // 所属区块ID
    );
}

// 渲染字段的HTML
function mfp_field_callback() {
    $option = get_option( 'mfp_option_name' );
    echo '<input type="text" name="mfp_option_name" value="' . esc_attr( $option ) . '" />';
}

Eklentilerin uluslararasılaştırılması ve yayınlama hazırlıkları

Eklentinizin tüm dünyadaki kullanıcılar tarafından kullanılabilmesi için uluslararasılaştırma (i18n) şarttır. Bu, kullanıcıya yönelik tüm metinleri WordPress’in sağladığı çeviri fonksiyonları kullanarak işlemeniz gerektiği anlamına gelir.

Kodda kullanmak __() Çeviri yapın ve dizgiyi döndürün, kullanarak. _e() Translate and directly output the string. You need to define it at the top of the plugin. Text Domain(Örneğin ‘my-first-plugin’ gibi) ve uygun zamanlarda kullanın. load_plugin_textdomain() Bir fonksiyon, çeviri dosyalarını yüklemek için kullanılır.

Tavsiye edilen okuma WordPress'in temel becerilerini öğrenin ve hem işlevsel hem de estetik açısından profesyonel bir web sitesi oluşturun.。

// 示例：加载翻译文件
add_action( 'plugins_loaded', 'mfp_load_textdomain' );
function mfp_load_textdomain() {
    load_plugin_textdomain( 'my-first-plugin', false, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );
}

// 在代码中使用翻译函数
$message = __( 'Hello, world!', 'my-first-plugin' );
_e( 'Settings saved successfully!', 'my-first-plugin' );

Yayınlamadan önce, lütfen farklı PHP sürümleri, WordPress sürümleri ve farklı temalar ile diğer eklentilerin etkinleştirildiği ortamlarda uyumluluk testleri de dahil olmak üzere kapsamlı bir test yapın. Hata ayıklama kodlarını temizleyin, ön uç kaynakları (CSS/JS) sıkıştırın ve ayrıntılı bir dokümantasyon hazırlayın. readme.txt Son olarak, eklentinizi WordPress’in resmi eklenti kataloğuna veya üçüncü parti pazarlara gönderebilir ve çalışmalarınızı tüm dünyadaki kullanıcılarla paylaşabilirsiniz.

Özetle.

WordPress eklenti geliştirme, yaratıcılığı işlevlere dönüştürme sürecidir ve temelinde WordPress’in hook (kancalama) sistemini anlamak ve kullanmak yatar. Standart bir geliştirme ortamı kurmak, yapısal olarak net bir ana dosya oluşturmakla başlayarak, eylemler (actions) ve filtreler (filters) aracılığıyla işlevlerin gerçekleştirilmesine, ardından profesyonel arka plan ayar sayfalarının oluşturulmasına kadar her adımda en iyi uygulamalara uyulması çok önemlidir. Son olarak, uluslararasılaştırma ve kapsamlı testler sayesinde eklentinin yayınlanması için her şey hazır hale getirilir. Bu becerileri öğrenerek, çeşitli web sitesi ihtiyaçlarını karşılayacak güçlü, stabil ve kolayca bakımı yapılabilecek WordPress eklentileri geliştirebilirsiniz.

InterServer Paylaşımlı Barındırma

Paylaşımlı hosting aylık $2.50 USD, ilk ay $0.1 USD promosyon kodu tryinterserver, 461 bulut uygulaması komut dosyası, tek tıklamayla yükleme.

Sayfaya erişin.

Sıkça Sorulan Sorular.

WordPress eklentisi geliştirmek için hangi temel bilgilere ihtiyaç vardır?
PHP programlama diline dair temel bilgilere sahip olmanız gerekmektedir; çünkü eklentinin çekirdek mantığı PHP ile yazılmıştır. Ayrıca, ön uç arayüzlerini ve etkileşimleri oluşturmak için HTML, CSS ve JavaScript konularında temel bir bilgi birikimine sahip olmanız beklenir. En önemlisi, WordPress’in temel yapısını ve işleyiş sürecini anlamanızdır; özellikle makaleler, sayfalar, kullanıcılar, meta veriler gibi temel kavramları bilmelisiniz.

Geliştirdiğim eklentinin hem güvenli hem de verimli olmasını nasıl sağlayabilirim?

Güvenlik açısından, kullanıcı girdileri her zaman doğrulanır ve temizlenir. WordPress tarafından sağlanan “non-ces” alanları ve yetki kontrol fonksiyonları kullanılır. check_admin_referer() 和 current_user_can()Verileri tarayıcıya gönderirken, uygun kaçırma (escaping) fonksiyonlarını kullanmanız şarttır. esc_html()、esc_attr()Verimlilik açısından, veritabanında gereksiz sorgulamalardan kaçının; Transients API’sini önbellekleme amacıyla mantıklı bir şekilde kullanın ve CSS ile JavaScript dosyalarınızın yalnızca ihtiyaç duyulan sayfalarda yüklenmesini sağlayın (doğru bir şekilde uygulayın). wp_enqueue_style() 和 wp_enqueue_script()）。

Eklentim diğer popüler eklentilerle nasıl uyumlu olabilir?

Kodun modüler kalmasını ve WordPress standartlarına uyulmasını sağlamak, uyumluluğu garanti altına almanın anahtarıdır. Fonksiyonlarınız, sınıflarınız ve sabitleriniz için benzersiz önekler kullanın; bu sayede temalar veya diğer eklentilerle isim çatışmalarından kaçınabilirsiniz. Küresel değişkenleri dikkatli bir şekilde kullanın. Mümkün olduğunca, diğer geliştiricilerin eklentinizin davranışlarını doğrudan çekirdek dosyaları değiştirmeden değiştirebileceği genişletme noktaları (hook’lar) sağlayın. Yayınlamadan önce, çeşitli popüler eklentilerin bulunduğu bir ortamda kapsamlı testler yapın.

WordPress.org’a bir eklenti (plugin) yayınlamadan önce dikkat edilmesi gereken bazı önemli noktalar vardır. Bunlar şunlardır:

Resmi kataloga gönderilen eklentilerin sıkı kurallara uyması gerekmektedir. Kodunuzun GPLv2 veya daha yüksek bir lisans sürümüne uygun olması gerekmektedir. Eklentilerde şifrelenmiş veya karıştırılmış kod bulunmamalıdır. Ayrıca, ayrıntılı ve doğru biçimde hazırlanmış bir belge sunulmalıdır. readme.txt Dosya: Eklentinin gereksiz kullanıcı verilerini toplama gibi casusluk faaliyetlerinde bulunmadığından veya kötü niyetli web sitelerine yönlendiren bağlantılar içermediğinden emin olun. İnceleme sürecinde, kod kalitesi, güvenlik ve dokümantasyon konularında değişiklik talepleri yapılabilir.