WordPress Eklenti Geliştirme Kılavuzu: Sıfırdan İleri Seviyelere

Bir WordPress eklentisi geliştirmek, dünyanın en popüler içerik yönetim sisteminin temel özelliklerini genişletmek anlamına gelir. İster belirli bir ihtiyaca yönelik küçük bir araç oluşturmak isteyin, isterse ticari bir ürün piyasaya sürmeyi planlayın, geliştirme sürecini anlamak çok önemlidir. İyi yapılandırılmış bir eklenti sadece güçlü özelliklere sahip olmakla kalmaz; aynı zamanda güvenli, verimli, bakımı ve dağıtımı da kolaydır.

WordPress Eklentilerinin Temel Prensipleri

Kodun derinliklerine inmeden önce, WordPress eklentilerinin temel prensiplerini anlamak ilk adımdır.

Eklenti (plugin) nedir?

Esasen, bir eklenti bir veya daha fazla PHP dosyasından oluşan bir koleksiyondur ve WordPress çekirdeğine “bağlanır”. Önceden belirlenmiş “kancalar” (hooks) aracılığıyla yeni özellikler ekler, mevcut özellikleri değiştirir veya kaldırır. Her eklentinin bir ana dosyası vardır ve bu dosya genellikle, WordPress sisteminin kendisini tanımasını sağlayan özel bir başlık yorumu içerir.

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

Eklenti ana dosyası yapısı

Bu ana dosya, eklentinin giriş noktasıdır. Başlık kısmındaki yorumlar çok önemlidir; WordPress, bu yorumlar aracılığıyla eklenti bilgilerini tanır ve bunları arka plan yönetim panelinde gösterir.

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-first-plugin
 * Description: 这是一个简短的插件描述，解释其功能。
 * Version:     1.0.0
 * Author:      你的名字
 * Author URI:  https://example.com
 * License:     GPL v2 or later
 * Text Domain: my-first-plugin
 */

Yukarıdaki kod, eklentinin temel meta verilerini tanımlamaktadır. Bunlar arasında…Text DomainBu, uluslararasılaştırma (çeviri) amacıyla kullanılan bir tanımlayıcıdır. Bu dosyayı kaydederken, onu eklenti adıyla adlandırılmış bir klasöre yerleştirmeniz ve ardından bu klasörü WordPress’e yüklemeniz gerekmektedir. /wp-content/plugins/ Dizinin içinde. Böylece, arka plandaki “Eklentiler” sayfasında onu görebilir ve etkinleştirebilirsiniz.

Geliştirme ortamının kurulması ve araçlar

Verimli bir geliştirme ortamı, eklenti geliştirme deneyimini ve üretkenliğini büyük ölçüde artırabilir.

Yerel Geliştirme Ortamı Ayarları

Yerel sunucu ortamları kullanmanız önerilir; örneğin XAMPP, MAMP, Local by Flywheel veya Docker gibi. Bu sayede çevrimiçi web sitenizi etkilemeden geliştirme ve hata ayıklama işlemlerini gerçekleştirebilirsiniz. Lütfen yerel PHP sürümünüzün hedef sunucu ortamıyla uyumlu olduğundan emin olun ve hata raporlama özelliğini etkinleştirin; bu, geliştirme aşamasında oldukça faydalıdır.wp-config.phpDosyaya aşağıdaki kodu ekleyerek hata ayıklama modunu etkinleştirin:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // 将错误记录到 /wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false ); // 不要在页面上显示错误

Tavsiye edilen geliştirme araçları

Kod editörlerinin (örneğin VS Code, PhpStorm) yanı sıra, aşağıdaki araçlar eklenti geliştirmek için hayati öneme sahiptir:
1. Sürüm Kontrolü (Git): Kod sürümlerini ve işbirliğini yönetmek için Git ile GitHub/GitLab/Bitbucket kullanılır.
2. Kod Standartları Kontrol Araçları: WordPress’in kendine özgü bir kodlama standardı vardır. PHP_CodeSniffer ve WordPress Kodlama Standartları kurallarını kullanarak kod stilinizin topluluk standartlarına uygun olduğundan emin olabilirsiniz.
3. Tarayıcı Geliştirici Araçları: Ön uç JavaScript ve CSS kodlarını hata ayıklamak için kullanılır.
4. Veritabanı yönetim araçları (örneğin phpMyAdmin): Eklentiler tarafından oluşturulan veya değiştirilen verilerin doğrudan görüntülenmesi ve yönetilmesi için kullanılır.
5. CLI Araçları: WP-CLI’yi etkin bir şekilde kullanmak, birçok WordPress yönetim görevini hızlı bir şekilde gerçekleştirmenizi sağlar ve testler ile dağıtımlar için çok faydalıdır.

Tavsiye edilen okuma WordPress Eklenti Geliştirme Becerilerini Kazanın: Sıfırdan Başlayarak Verimli ve Özelleştirilebilir İşlev Modülleri Oluşturun。

Ayrıntılı Çekirdek Geliştirme Süreci

Temel prensipleri anladıktan ve gerekli araçları hazırladıktan sonra, ilk işlevi yazmaya başlayabiliriz.

Eklenti oluşturmak için temel sınıf

Eklentiler doğrudan fonksiyonlar kullanılarak da yazılabilir, ancak kodu nesne yönelimli programlama (OOP) ve sınıflar aracılığıyla düzenlemek daha profesyonel ve daha kolay bakım yapılabilir bir yaklaşımdır. Bu, işlevleri paketlemeye ve isim çakışmalarını önlemeye yardımcı olur.

class My_First_Plugin {
    public function __construct() {
        // 构造函数，在这里挂载钩子
        add_action( 'init', array( $this, 'register_shortcode' ) );
        add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_scripts' ) );
    }

public function register_shortcode() {
        add_shortcode( 'my_greeting', array( $this, 'render_shortcode' ) );
    }

public function render_shortcode( $atts ) {
        return '<p>Merhaba, benim eklentimden geliyorum!</p>';
    }

public function enqueue_scripts() {
        wp_enqueue_style( 'my-plugin-style', plugins_url( 'css/style.css', __FILE__ ) );
    }
}

// 实例化插件类
new My_First_Plugin();

Eylem ve filtre kancalarını kullanmak

Kancalar (Hooks), WordPress eklenti geliştirmenin temel mekanizmalarındandır. İki türe ayrılırlar: Eylemler (Actions) ve Filtreler (Filters).
* 动作钩子：允许你在特定的时间点（如“初始化后”、“保存文章前”）“注入”并执行你自己的代码。使用add_action()Bu fonksiyon, bir şeyi monte etmek için kullanılır.
* 过滤器钩子：允许你修改WordPress或其他插件即将要使用的数据。使用add_filter()Bir fonksiyon kullanarak montaj işlemi yapılır; fonksiyonunuzun değiştirilmiş değeri döndürmesi gerekir.

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.

// 动作钩子示例：在文章末尾添加内容
add_action( 'the_content', function( $content ) {
    if ( is_single() ) {
        $extra_text = '<div class="my-plugin-note">Bu makaleyi okuduğunuz için teşekkür ederiz!</div>';
        $content .= $extra_text;
    }
    return $content; // 注意：这里实际上用到了过滤器，但挂载在动作钩子‘the_content’上，它同时也是一个过滤器
} );

// 过滤器钩子示例：修改文章标题
add_filter( 'the_title', function( $title ) {
    return '【精选】' . $title;
} );

Yönetim menüsü ve ayar sayfaları oluşturun.

Kullanıcıların eklentinizi yapılandırabilmesi için, WordPress arayüzünde bir yönetim menüsü ve ayar sayfaları oluşturmanız gerekmektedir. Bu işlem esas olarak şu adımlarla gerçekleştirilir:add_menu_page()或add_options_page()Bu fonksiyonların gerçekleştirilmesi…

class Plugin_Admin {
    public function __construct() {
        add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
        add_action( 'admin_init', array( $this, 'register_settings' ) );
    }

public function add_admin_menu() {
        add_options_page(
            '我的插件设置',       // 页面标题
            '我的插件',          // 菜单标题
            'manage_options',    // 权限
            'my-plugin-settings', // 菜单slug
            array( $this, 'render_settings_page' ) // 显示页面的回调函数
        );
    }

public function register_settings() {
        register_setting( 'my_plugin_settings_group', 'my_plugin_option' );
        add_settings_section( 'section_id', '主要设置', null, 'my-plugin-settings' );
        add_settings_field( 'field_id', '选项名称', array( $this, 'render_field' ), 'my-plugin-settings', 'section_id' );
    }

public function render_field() {
        $value = get_option( 'my_plugin_option' );
        echo '<input type="text" name="my_plugin_option" value="' . esc_attr( $value ) . '" />';
    }

public function render_settings_page() {
        ?&gt;
        <div class="wrap">
            <h1>Eklenti ayarlarım.</h1>
            <form action="/tr/options.php/" method="post" data-trp-original-action="options.php">
                <?php
                settings_fields( 'my_plugin_settings_group' );
                do_settings_sections( 'my-plugin-settings' );
                submit_button();
                ?>
            <input type="hidden" name="trp-form-language" value="tr"/></form>
        </div>
        &lt;?php
    }
}
new Plugin_Admin();

İleri Düzey Konular ve En İyi Uygulamalar

Eklentilerin işlevleri karmaşıklaştığında, en iyi uygulamalara uyum sağlamak kaliteyi garanti etmenin anahtarıdır.

Özel bir veritabanı tablosu oluşturun.

WordPress’in…wp_optionsTablolar, basit yapılandırmaların saklanması için uygundur; ancak karmaşık veriler (örneğin siparişler, form gönderimleri) özel olarak oluşturulmuş veritabanı tablolarında saklanmalıdır. Bu işlem, eklentinin etkinleştirilmesi sırasında tabloların oluşturulmasını gerektirir.

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

Kullanmanız gereken şey…register_activation_hook()Kancalar, tablo oluşturma kodunun yalnızca eklenti etkinleştirildiğinde bir kez çalışmasını sağlar.

register_activation_hook( __FILE__, 'my_plugin_create_table' );

function my_plugin_create_table() {
    global $wpdb;
    $table_name = $wpdb->prefix . 'my_plugin_data'; // 使用前缀避免冲突
    $charset_collate = $wpdb->get_charset_collate();

$sql = "CREATE TABLE $table_name (
        id mediumint(9) NOT NULL AUTO_INCREMENT,
        name tinytext NOT NULL,
        email varchar(100) 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 );
}

Eklentinin güvenliğini ve performansını sağlayın.

Güvenlik son derece önemlidir. Kullanıcı girdilerini her zaman doğrulayın, temizleyin ve uygun şekilde işleyin (örneğin, kötü niyetli kodları engellemek için “escape” işlemleri yapın).
* 验证：检查数据是否符合预期格式（如是否为邮箱） - is_email()。
* 清理：移除数据中不允许的字符 - sanitize_text_field(), sanitize_email()。
* 转义：在将数据输出到HTML、JavaScript或URL之前，确保它们被安全编码 - esc_html(), esc_js(), esc_url()。

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.

Performans açısından, hook’ları (işlevsel araçları) mantıklı bir şekilde kullanmalı ve her sayfa yüklendiğinde gereksiz sorguların çalışmasını önlemelisiniz. Nesne önbelleğini (object caching) kullanmak da bu konuda faydalı olacaktır.wp_cache_set()和wp_cache_get()Pahalı sorgu sonuçlarını depolamak için belirli bir yapı kullanılır. Aynı zamanda, ön uç kaynaklarının (CSS/JS) bağımlılıklarının ve sürüm numaralarının doğru bir şekilde ayarlandığından emin olunmalı ve uygun zamanlarda koşullu yükleme (conditional loading) yöntemlerinin kullanılması düşünülmelidir.

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

Eklentinizin tüm dünya kullanıcıları tarafından kullanılabilmesi için uluslararasılaştırma (i18n) hazırlıklarının yapılması gerekmektedir. Bu, kullanıcılar tarafından görülebilecek tüm metinlerin belirli fonksiyonlar kullanılarak işlenmesi gerektiği anlamına gelir. Kodunuzda bunu gerçekleştirmek için ilgili işlemleri uygulamanız gerekir.__()Çeviri yapın ve dizgiyi döndürün, kullanarak._e()Tabii ki, lütfen metni bana verin.

`echo '`'<h2>' . __( '欢迎来到我的插件', 'my-first-plugin' ) . '</h2>';
_e( '这是一个段落。', 'my-first-plugin' );

Bunların arasında'my-first-plugin'Bu, eklentinin baş kısmında sizin tanımladığınız şeydir.Text DomainDaha sonra, Poedit gibi araçları kullanarak içeriği oluşturabilirsiniz..potŞablon dosyaları ve çeşitli diller için….po和.moÇeviri dosyası.

Özetle.

WordPress eklenti geliştirme, temel altyapıyı (hook’lar, ana dosyalar) anlamaktan başlayarak, eylemleri (actions) ve filtreleri (filters) ustaca kullanmaya, ardından da yönetim arayüzleri ve veritabanlarını oluşturmaya kadar ilerleyen bir süreçtir. Başarılı geliştiriciler sadece işlevlerin gerçekleştirilmesine odaklanmakla kalmaz; aynı zamanda kodun güvenliğine, performansına, sürdürülebilirliğine ve uluslararasılaştırılabilirliğine de büyük önem verirler. Profesyonel bir yerel ortam oluşturarak, WordPress kodlama standartlarına uymak ve güvenli girdi/çıktı uygulamalarını benimseyerek, güçlü, güvenilir ve popüler eklentiler geliştirebilirsiniz. Unutmayın: Küçük ve öz bir işlevle başlayıp, adım adım geliştirerek ilerlemek, eklenti geliştirme öğrenmenin en iyi yoludur.

Sıkça Sorulan Sorular.

WordPress eklentisi geliştirmek için hangi ön koşul bilgilerine ihtiyaç vardır?

Sağlam bir PHP programlama temeline sahip olmanız gerekmektedir; çünkü eklentinin temel mantığı PHP ile yazılmıştır. Ayrıca, ön uç arayüzlerini ve etkileşimlerini oluşturmak için HTML, CSS ve JavaScript konularında temel bilgilere sahip olmanız gerekmektedir. MySQL veritabanı hakkında temel kavramlara sahip olmanız da faydalı olacaktır; çünkü WordPress veritabanı ile etkileşim kurmanız gerekecektir.

Eklentimin diğer eklentilerle çakışmasını nasıl önleyebilirim?

Kodunuzu kapsüllemek için nesne yönelimli programlama (OOP) ve sınıfları kullanmak en önemli yöntemdir. İkincisi, tüm fonksiyonlarınızın, sınıf adlarınızın, sabitlerinizin, seçenek adlarınızın ve veritabanı tablo adlarının önüne benzersiz bir önek ekleyin (örneğin, eklentinizin kısaltmasını veya adını kullanın). Bu, ad çakışmalarının olasılığını en aza indirir. Ayrıca, montaj işlemleri sırasında geri çağırma fonksiyonlarınızın benzersiz olduğundan emin olun.

Eklenti kodumu nasıl hata ayıklamalıyım?

Öncelikle, 'den emin olun.wp-config.phpAçıldı.WP_DEBUGMod. Hata mesajları kaydedilecektir./wp-content/debug.logDosyada. İkincisi, kullanılabilir.error_log()Fonksiyon, özelleştirilmiş hata ayıklama bilgilerini günlüğe yazar. Karmaşık mantıklar için, Xdebug gibi profesyonel hata ayıklama araçlarını kendi kod düzenleyicinizle (örneğin VS Code) birlikte kullanarak duraklar belirleyip satır satır hata ayıklaması yapabilirsiniz.

Geliştirme işlemi tamamlandıktan sonra, eklentimi WordPress resmi eklenti dizinine nasıl gönderebilirim?

WordPress’in resmi eklenti geliştirici merkezine erişmeniz ve bir hesap oluşturmanız gerekiyor. Göndermeden önce, eklentinizin resmi eklenti geliştirme kılavuzlarına ve kod standartlarına tamamen uygun olduğundan emin olun. Eklentinizin kodu standart başlık açıklamalarını içermeli ve herhangi bir şifreleme veya karıştırılmış kod içermemelidir. Gönderim süreci, eklentinin sıkıştırılmış paketinin yüklenmesini, manuel inceleme için beklenmesini ve inceleme onaylandıktan sonra resmi katalogda yayınlanmasını içerir.