WordPress Eklenti Geliştirme Kılavuzu: Sıfırdan Başlayarak Yüksek Kaliteli Eklentiler Oluşturma

Geliştirme Ortamı ve Temel Hazırlıklar

Kod yazmaya başlamadan önce, iyi bir geliştirme ortamı başarının temel taşıdır. Bu sadece verimliliği artırmakla kalmaz, aynı zamanda kodun standartlara uygunluğunu ve sürdürülebilirliğini de sağlar.

Yerel geliştirme sunucusunun kurulması

Yerel sunucu ortamlarını kullanmanızı öneririz; örneğin Local by Flywheel, XAMPP veya MAMP. Bu araçlar, yerel bilgisayarınızda Apache, MySQL/MariaDB ve PHP içeren bir WordPress çalışma ortamı hızlı bir şekilde kurmanıza olanak tanır. Local by Flywheel’i örnek alırsak, yeni bir siteyi tek bir tıklamayla oluşturabilir ve veritabanını ile alan adını otomatik olarak yapılandırabilir. yourplugin.localBu, ortam yapılandırma sürecini büyük ölçüde basitleştirir.

Kod Düzenleyicisinin Seçimi ve Temel Ayarları

Güçlü bir kod editörü çok önemlidir. Visual Studio Code veya PhpStorm mükemmel seçeneklerdir. Lütfen aşağıdaki eklentileri yükleyin veya ilgili ayarlamaları yapın: PHP sözdizimi vurgulaması ve kod önerileri, WordPress kod parçaları, ve sürüm kontrolü (örneğin Git) entegrasyonu. Ayrıca, Prettier gibi kod biçimlendirme araçlarını doğru şekilde ayarlayarak kod stilinin tutarlı olmasını sağlayın.

Tavsiye edilen okuma WordPress eklenti geliştirme rehberi: Profesyonel uzantıları sıfırdan bire kadar oluşturma。

Temel dosya yapısını anlamak

En temel bir WordPress eklentisinin en az bir ana dosyası olmalıdır. Bu ana dosya genellikle eklentinin adıyla adlandırılır, örneğin: my-awesome-plugin.phpBaşlık kısmındaki yorumlar, eklentinin WordPress tarafından tanınmasının anahtarıdır ve belirli meta bilgileri içermelidir. İşte en basit örnek:

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.

<?php
/**
 * Plugin Name:       我的超强插件
 * Plugin URI:        https://example.com/my-awesome-plugin
 * Description:       这是一个用于演示的 WordPress 插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-awesome-plugin
 */

İlk işlevsel eklentiyi yazın.

Şimdi, pratikte ilk adımı atalım ve gerçek işlevlere sahip bir eklenti oluşturalım. Basit bir “makale okuma süresi tahmini” eklentisi oluşturacağız.

Eklentinin ana mantığının uygulanması

Bu özelliğin temeli, bir makalenin kelime sayısını hesaplamak ve okunması için gereken dakika sayısını tahmin etmektir. Bunu… my-awesome-plugin.php Ana dosyaya bir fonksiyon ekleyin. Fonksiyon… myap_calculate_read_time Makale içeriğini almak, kelime sayısını hesaplamak ve istatistikler oluşturmakla sorumludur.

function myap_calculate_read_time( $content ) {
    // 去除HTML标签，获取纯文本
    $text = strip_tags( $content );
    // 计算字数（以中文字符和英文单词综合估算）
    $word_count = str_word_count( $text, 0, '1234567890中国字' );
    // 假设平均阅读速度为每分钟200字
    $reading_time = ceil( $word_count / 200 );
    // 避免显示为0分钟
    if ( $reading_time < 1 ) {
        $reading_time = 1;
    }
    // 将结果添加到文章内容前
    $reading_time_html = &#039;<p class="reading-time">Okuma süresi yaklaşık '.$reading_time.' dakikadır.</p>';
    return $reading_time_html . $content;
}

Filtre kancaları (filter hooks) kümesini kullanarak işlevleri başarıyla uygulayın.

Hesaplanan okuma süresinin makale sayfasında otomatik olarak görüntülenmesi için, WordPress’in filtre kancalarını (Filter Hooks) kullanmamız gerekiyor. Temel fonksiyon… add_filter Belirli bir filtreye fonksiyonlarımızı bağlamak için kullanılır. Burada bunu kullanıyoruz. the_content Filtreler.

// 将我们的函数挂载到‘the_content’过滤器上
add_filter( 'the_content', 'myap_calculate_read_time' );

Basit stiller ekleyerek görünümü güzelleştirin.

Görünümün daha dostane olmasını sağlamak için biraz CSS stil ekleyebiliriz. En iyi uygulama, stilleri doğrudan içe gömme yerine bir kuyruğa almaktır. Bunu kullanabiliriz. wp_enqueue_style İlk olarak, bir CSS dosyası oluşturun, örneğin: assets/css/style.cssArdından bunu kaydedin ve kuyruğa ekleyin.

Tavsiye edilen okuma WordPress Eklenti Geliştirme: Başlangıçtan Uzmanlığa – Yüksek Özelleştirilebilir İşlev Modülleri Oluşturmak İçin Kapsamlı Bir Rehber。

Eklentinin ana dosyasına şunu ekleyin:

function myap_enqueue_styles() {
    wp_enqueue_style(
        'myap-reading-time-style',
        plugin_dir_url( __FILE__ ) . 'assets/css/style.css',
        array(), // 依赖
        '1.0.0' // 版本号
    );
}
add_action( 'wp_enqueue_scripts', 'myap_enqueue_styles' );

在 style.css Orta:

.reading-time {
    font-size: 0.9em;
    color: #666;
    font-style: italic;
    border-left: 3px solid #3498db;
    padding-left: 10px;
}

Eklenti Mimarisi ve Gelişmiş Özellikler

Eklentilerin işlevlerinin artmasıyla birlikte, iyi bir mimari ve gelişmiş özelliklerin kullanıma sunulması kaçınılmaz hale gelmiştir.

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.

Nesne yönelimli bir eklenti sınıfı gerçekleştirme

使用类（Class）来封装插件功能是提高代码组织性的最佳方式。我们可以创建一个主类，例如 My_Awesome_PluginVe tüm “hook’ları (bağlantı noktalarını) yapıcısında (constructor’unda) başlatın.

class My_Awesome_Plugin {
    public function __construct() {
        add_action( 'init', array( $this, 'load_textdomain' ) );
        add_filter( 'the_content', array( $this, 'calculate_read_time' ) );
        add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_assets' ) );
    }

public function load_textdomain() {
        load_plugin_textdomain( 'my-awesome-plugin', false, dirname( plugin_basename( __FILE__ ) ) . '/languages' );
    }

public function calculate_read_time( $content ) {
        // ... 之前的计算逻辑
    }

public function enqueue_assets() {
        // ... 之前的资源排队逻辑
    }
}
// 初始化插件
new My_Awesome_Plugin();

Yönetim ayarları sayfasını oluşturun.

Eklentiye, kullanıcıların okuma hızını (örneğin, dakikada kaç kelime) özelleştirebilecekleri bir ayar sayfası ekleyin. Bu, WordPress’in “Ayarlar API’sini” kullanmayı gerektirir. Fonksiyonları kullanmanız gerekecektir. add_options_page Alt menü sayfasını ekleyin ve ardından bunu kullanın. register_setting、add_settings_section 和 add_settings_field Ayar alanlarını tanımlamak için…

Özel bir veritabanı tablosu ekleyin.

Karmaşık verilerin saklanması gereken eklentiler için (örneğin, form gönderim kayıtları gibi), özel bir veritabanı tablosu oluşturulması gerekebilir. Bu işlem genellikle eklentinin etkinleştirildiği sırada gerçekleştirilir. dbDelta Bu fonksiyon, tablo yapısını güvenli bir şekilde oluşturmak veya güncellemek için kullanılır. İşlemler mutlaka… register_activation_hook İşlem, kancanın (hook) kaydedildiği fonksiyon içinde gerçekleştirilir.

Tavsiye edilen okuma WordPress Eklenti Geliştirme Kılavuzu: Sıfırdan Başlayarak Profesyonel Eklentiler Oluşturma。

register_activation_hook( __FILE__, 'myap_create_db_table' );
function myap_create_db_table() {
    global $wpdb;
    $table_name = $wpdb->prefix . 'myap_data';
    $charset_collate = $wpdb->get_charset_collate();
    $sql = "CREATE TABLE $table_name (
        id mediumint(9) NOT NULL AUTO_INCREMENT,
        user_data text NOT NULL,
        created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
        PRIMARY KEY (id)
    ) $charset_collate;";
    require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );
    dbDelta( $sql );
}

Test Etme, Dağıtım ve Bakım

Geliştirme işleminin tamamlanması, projenin sona erdiği anlamına gelmez; eklentinin kalitesini garanti altına almak ve kullanıcılara sorunsuz bir şekilde teslim etmek de aynı derecede önemlidir.

Sistematik testler uygulayın.

Testler, işlevsellik testlerini (her bir fonksiyonun beklendiği gibi çalıştığından emin olmak için), uyumluluk testlerini (farklı PHP sürümleri, WordPress sürümleri ve temalar altında test etmek için) ve güvenlik kontrollerini (kullanıcı girdilerinin işlenmesi sırasında escape işlemlerinin yapılması, veri işlemlerinde “non-CES” yöntemlerinin kullanılması gibi) içerir. Karmaşık eklentiler için birim testleri yazmayı düşünebilirsiniz; bunun için PHPUnit framework’ü kullanılabilir.

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.

Uluslararasılaştırma ve Yerelleştirme Hazırlıkları

Tıpkı daha önce ana sınıfta gördüğümüz gibi… load_textdomain Yöntem olarak, uluslararasılaştırma, eklentilerin birden fazla dil desteği sağlamasının anahtarıdır. Kullanıcıya yönelik tüm metinlerin uygun dillerde sunulması gerekir. __() 或 _e() Fonksiyonlar paketlenir. Daha sonra, Poedit gibi araçlar kullanılarak bu paketler oluşturulur. .pot Şablon dosyası, çevirmenlerin kullanımı için hazırlanmıştır. .po 和 .mo Dosya.

Resmi eklenti deposuna gönderin.

Eğer bir eklentiyi WordPress.org’a yayınlamak istiyorsanız, öncelikle resmi web sitesinde bir hesap oluşturmanız ve eklentiyi göndermeniz gerekiyor. Daha sonra, kodunuzu belirtilen depo dizinine SVN aracılığıyla göndermelisiniz. Eklentinizin ana dosyası standartlara uygun olmalı ve içinde belirli bilgilerin bulunması gerekmektedir. readme.txt Dosyanın formatı, eklenti dizin sayfasında açıklamalar, ekran görüntüleri, güncelleme kayıtları gibi bilgilerin görüntülenmesi için resmi standartlara uygun olmalıdır.

Sonraki güncellemeler ve destek hizmetleri

2026 yılındaki teknolojik ortamda, sürekli güncellemeler yapmak son derece önemlidir. Güncellemeler yayınlandığında, eklentinin ana dosyasının baş kısmındaki sürüm numarasını mutlaka değiştirmeli ve dosyayı da güncellemelisiniz. readme.txt Değişiklik günlüğü. Etkili bir kullanıcı geri bildirim kanalı (örneğin destek forumları veya GitHub Sorunları) oluşturun ve rapor edilen hataları ve güvenlik açıklarını zamanında düzeltin.

Özetle.

WordPress eklenti geliştirme, yaratıcılığı işlevlere dönüştürme sürecidir; bu süreç, WordPress’in temel yapısına dair derin bir anlayışı ve standart PHP programlama uygulamalarını bir araya getirir. Ortam kurmaktan, filtre içeren ilk işlevi yazmaya; nesne yönelimli mimari kullanmaktan, yönetim arayüzleri oluşturmaya ve özel tablolar hazırlamaya kadar her adım, stabil, sürdürülebilir ve kullanıcı dostu eklentiler geliştirmeyi amaçlar. Son olarak, katı testler, uluslararasılaştırma hazırlıkları ve standart yayın süreçleri sayesinde geliştiriciler, eklentilerinin dünya genelindeki WordPress kullanıcılarına hizmet edebilmesini ve yaşam döngüsü boyunca sürekli olarak bakım görmesini sağlarlar. Bu tam süreci öğrenmek, WordPress ekosistemine yüksek kaliteli araçlar katkıda bulunma yeteneğinizi kazandırır.

Sıkça Sorulan Sorular.

WordPress eklentisi geliştirmek için PHP’de ustalaşmak zorunda mıyım?

Evet, sağlam PHP bilgisi temeldir. Çünkü WordPress kendisi PHP ile yazılmıştır ve eklentilerin kodları da çoğunlukla PHP’dir. Fonksiyonları, sınıfları, ad alanlarını (namespace’leri) ve veritabanı ile nasıl etkileşim kurulacağını anlamanız gerekir. Ayrıca, ön uç çıktısını ve etkileşimi işlemek için HTML, CSS ve JavaScript konusunda da belirli bir bilgiye sahip olmanız çok önemlidir.

Eklentilerin ve temaların işlevleri arasında ne fark var? Eklentileri ne zaman geliştirmelisiniz?

Temalar, web sitesinin görünümünü ve düzenini kontrol eder; eklentiler ise yeni özellikler eklemek için kullanılır. Basit bir kural şudur: Eğer bir özellik web sitesinin görünümüyle ilgili değilse ve temayı değiştirdikten sonra da bu özelliğin devam etmesini istiyorsanız, o özelliğin bir eklenti olarak oluşturulması gerekir. Örneğin, iletişim formları, SEO optimizasyonu, önbellekleme gibi özellikler tipik eklenti kategorisindedir.

Bir eklentimin diğer eklentilerle çakışmamasını nasıl sağlayabilirim?

Çakışmaları önlemek için lütfen her zaman en iyi uygulamalara bağlı kalın: Tüm fonksiyonlarınız, sınıflarınız, sabitleriniz ve eylem/filtre işlevleriniz için benzersiz bir önek kullanın. Örneğin,myplugin_Veya kişisel/kurumsal adınızın kısaltması ön ek olarak kullanılabilir. Nesne yönelimli programlama ve ad alanları (namespace’ler) kullanarak kodu daha iyi bir şekilde paketleyebilirsiniz. Ayrıca, etkinleştirme ve kaldırma işlemleri sırasında başlatma (initialization) ve temizleme (clean-up) işlemlerini doğru bir şekilde yapmak önemlidir.

Eklentim için bir veritabanı tablosu oluşturmam gerekiyor mu?

Mutlaka değil. Yalnızca karmaşık, yapılandırılmış verilerin saklanması gerektiğinde ve mevcut WordPress veritabanı tablolarının (örneğin…) yetersiz kaldığı durumlarda…wp_posts， wp_postmetaYalnızca ihtiyaçlar verimli bir şekilde karşılanamadığında, özel tablolar oluşturulması düşünülür. Örneğin, olay kayıtlarını, karmaşık günlükleri veya bağımsız ürün kataloglarını saklamak için. Basit anahtar-değer çiftleri verileri için ise standart yöntemler kullanılır. wp_options Tablo veya makale meta verileri (post meta) genellikle daha basit ve verimli bir seçenektir.

WordPress.org’a ücretsiz eklentiler yayınlamanın bazı avantajları vardır:

Resmi deposa yayınlamak, büyük bir tanınırlık sağlar; kullanıcıların tek tuşla kurmasına ve otomatik güncellemeler almasına olanak tanır. Kullanıcı güvenini artırır ve resmi destek forumları aracılığıyla merkezi bir geri bildirim ve yardım kanalı sunar. Aynı zamanda, daha yüksek kod ve kalite standartlarına uymanızı teşvik eder, bu da WordPress topluluğunda kişisel veya marka itibarınızı oluşturmak için çok faydalıdır.