Sıfırdan başlayarak WordPress eklenti geliştirmeyi öğrenin: Kapsamlı bir rehber ve uygulamalı eğitimler.

Neden WordPress eklentisi geliştirmeyi seçtiniz?

Günümüz web sitesi ekosisteminde, WordPress benzersiz esnekliği ve geniş kullanıcı tabanıyla öne çıkmaktadır. Bu esneklik, büyük ölçüde eklenti sistemine borçludur. Geliştiriciler, kendi eklentilerini oluşturarak bir fikri yeniden kullanılabilir bir işlevsel modüle dönüştürebilir ve bu modülleri dünya genelindeki milyonlarca web sitesine sunabilirler. Bu, sadece belirli iş ihtiyaçlarını karşılamakla kalmaz; aynı zamanda WordPress resmi kataloğu veya üçüncü parti pazarlar aracılığıyla da dağıtılarak sürekli değer ve gelir yaratılmasını sağlar.

Doğrudan konuyu değiştirmekle karşılaştırıldığında… functions.php Dosyalar farklı olduğundan, eklentiler işlevsel mantığı temanın görünümünden ayırır; bu da web sitesinin sürdürülebilir bir şekilde bakımının sağlanmasını mümkün kılar. Bir temayı değiştirdiğinizde, eklentiler tarafından sağlanan özellikler sorunsuz bir şekilde aktarılır; ancak temada yazılan kodların yeniden işlenmesi gerekir. Bu tür modüler bir geliştirme yaklaşımı, profesyonel ve stabil WordPress siteleri oluşturmanın en iyi uygulamalarından biridir.

İlk eklentinizi oluşturun.

Eklenti geliştirmeye başlamanın ilk adımı, WordPress standartlarına uygun bir temel yapı oluşturmaktır. Bu sadece bir dosya oluşturmakla kalmaz; aynı zamanda sürdürülebilir ve genişletilebilir bir kod organizasyonu şekli de oluşturmayı içerir.

Tavsiye edilen okuma WordPress Eklenti Geliştirme Başlangıç Kılavuzu: İlk Özel Özellik Genişlemenizi Sıfırdan Oluşturun。

Çekirdek eklenti dosyasını oluşturun.

Her WordPress eklentisinin, genellikle eklentinin adıyla adlandırılan bir ana dosyası olmalıdır. my-first-plugin.phpBu dosyanın başlık kısmındaki yorumlar, eklentinin “kimlik kartı” niteliğindedir. Bu yorumlar, WordPress sisteminine eklentinin adı, açıklaması, sürümü, yazarı gibi meta bilgilerini sağlar. Bu başlık kısmı olmadan, WordPress eklentinizi tanıyamaz ve etkinleştiremez.

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:       这是一个用于学习 WordPress 插件开发的示例插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Basit bir işlevi gerçekleştirin.

Eklenti başlığını tanımladıktan sonra, işlevsel kod eklemeye başlayabiliriz. Klasik bir giriş örneği, web sitesinin alt kısmına özelleştirilmiş bir metin satırı eklemektir. Bu, WordPress’in “kancalar” (Hook) mekanizmasını kullanmayı içerir; daha spesifik olarak, `add_action` ve `add_filter` fonksiyonlarını kullanarak ilgili işlemleri gerçekleştiririz. wp_footer Bu eylem hook’u.

// 在 wp_footer 钩子上挂接我们的函数
add_action(‘wp_footer’， ‘my_first_plugin_display_footer_text’);

/**
 * 在网站前台页脚输出自定义文本
 */
function my_first_plugin_display_footer_text() {
    echo ‘<p style="“text-align:" center;”>Bu web sitesi, ilk eklentim tarafından teknik destek sağlanmaktadır.</p>’;
}

Yukarıdaki kod bloğunu ana eklenti dosyanıza ekleyin, dosyayı kaydedin ve ardından sunucuya yükleyin. /wp-content/plugins/ İçindekiler. Daha sonra WordPress arayüzünün “Eklentiler” sayfasına girin; “İlk Eklentim”i görebilecek ve etkinleştirebileceksiniz. Web sitesinin ön yüzünü yenileyin; eklediğiniz metin sayfanın alt kısmında görünecektir.

WordPress Eklenti Mimarisini Derinlemesine Anlama

Güçlü ve profesyonel eklentiler geliştirmek için, WordPress’in sunduğu temel programlama arayüzlerini ve mimari modellerini derinlemesine anlamak gereklidir. Bu, sadece PHP fonksiyonları yazmakla kalmaz; aynı zamanda WordPress çekirdeğiyle güvenli ve verimli bir şekilde etkileşim kurmayı öğrenmek anlamına gelir.

Kancalı Mekanizma: Eylemler ve Filtreler

WordPress’in hook mekanizması, genişletilebilirliğinin temel taşıdır ve esas olarak Action Hooks (Eylem Hook’ları) ve Filter Hooks (Filtre Hook’ları) olarak ikiye ayrılır. Action Hooks, belirli zaman noktalarında kendi kodunuzu “çalıştırmanıza” olanak tanır. Örneğin,init Kancalar, WordPress başlatıldığında tetiklenir.wp_enqueue_scripts Kancalar, betiklerin ve stillerin güvenli bir şekilde eklenmesi için kullanılır.

Tavsiye edilen okuma WordPress Eklenti Geliştirme Kılavuzu: İlk İşlevsel Eklentinizi Sıfırdan Oluşturun。

Filtre hook’ları, verileri “değiştirmenize” olanak tanır. Veriler kullanılmadan önce (örneğin, bir sayfada gösterilmeden veya bir veritabanına kaydedilmeden önce) onları durdurup değiştirebilirsiniz.the_content Filtreler, makalenin içeriğini değiştirmenize olanak tanır.

// 使用过滤器修改文章内容，在末尾添加一段话
add_filter(‘the_content’， ‘my_first_plugin_modify_content’);

function my_first_plugin_modify_content($content) {
    if (is_single()) { // 仅在单篇文章页面生效
        $extra_text = ‘<div class="“plugin-note”">Bu makaleyi okuduğunuz için teşekkür ederiz!</div>’;
        $content .= $extra_text;
    }
    return $content;
}

Eklenti Güvenliği ve Veri Doğrulaması

Güvenlik, eklenti geliştirme sürecinde göz ardı edilemeyecek bir unsurdur. Kullanıcılardan veya herhangi bir dış kaynaktan gelen verilere asla güvenmeyin. WordPress, veri doğrulama, kod dönüştürme ve temizleme işlemlerine yardımcı olacak bir dizi fonksiyon sunar.

Formdan gelen $_POST veya $_GET verileri işlerken, mutlaka şu yöntemleri kullanmalısınız: sanitize_text_field(), intval(), wp_kses_post() Bu fonksiyonları temizlemek gerekiyor. Verileri HTML sayfasına çıkardığınızda, mutlaka belirli yöntemler kullanmalısınız. esc_html(), esc_attr(), esc_url() Bu fonksiyonlar, çapraz sitelik betik (XSS) saldırılarını önlemek için kullanılır ve metinlerdeki özel karakterlerin doğru şekilde işlenmesini sağlar.

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.

// 安全地处理并输出一个来自短代码的属性
function my_first_plugin_safe_shortcode($atts) {
    // 使用 shortcode_atts 设置默认值并合并用户输入
    $atts = shortcode_atts(
        array(
            ‘message’ => ‘Hello World’,
        )， $atts
    );

// 清理用户输入的 message 属性
    $safe_message = sanitize_text_field($atts[‘message’]);

// 转义后安全输出
    return ‘<div>’ . esc_html($safe_message) . ‘</div>’`add_shortcode(‘safe_greeting’, ‘my_first_plugin_safe_shortcode’);`;

Tam özellikli bir eklenti oluşturun.

Hadi bu bilgileri bir araya getirip, biraz daha karmaşık ancak kullanışlı bir eklenti oluşturalım: “Makale Okuma Süresi Tahmini” adlı bir eklenti. Bu eklenti, makalenin tahmini okuma süresini otomatik olarak hesaplayacak ve bu süreyi makale başlığının altında gösterecektir.

Plugin sınıf yapısını oluşturma

Biraz daha karmaşık özelliklere sahip eklentiler için, nesne yönelimli programlama (OOP) temelli sınıf yapılarını kullanmak daha iyi bir seçenektir. Bu yapılar kodu düzenlemeye yardımcı olur, fonksiyon adı çakışmalarını önler ve bakım kolaylığını artırır.

<?php
/**
 * Plugin Name:       文章阅读时间估算
 */
class Article_Reading_Time {
    /**
     * 构造函数，初始化插件
     */
    public function __construct() {
        // 在文章内容前添加阅读时间
        add_filter(‘the_content’， array($this， ‘add_reading_time_to_content’));
        // 初始化脚本和样式（如果需要）
        add_action(‘wp_enqueue_scripts’， array($this， ‘enqueue_assets’));
    }

/**
     * 计算文章的阅读时间（以分钟计）
     * @param string $content 文章内容
     * @return int 预计阅读分钟数
     */
    private function calculate_reading_time($content) {
        // 去除 HTML 标签，只计算纯文本
        $text = strip_tags($content);
        // 估算中文阅读速度：每分钟约300-500字，这里取400字/分钟
        $word_count = mb_strlen($text， ‘UTF-8’);
        $reading_time = ceil($word_count / 400);
        // 至少1分钟
        return max(1， $reading_time);
    }

/**
     * 在文章内容前添加阅读时间显示
     * @param string $content 原始文章内容
     * @return string 添加阅读时间后的内容
     */
    public function add_reading_time_to_content($content) {
        // 确保只在主循环的单篇文章页面显示
        if (is_single() && in_the_loop() && is_main_query()) {
            $reading_minutes = $this->calculate_reading_time($content);
            $reading_time_html = sprintf(
                ‘<div class="“reading-time”"><strong>Tahmini Okuma Süresi:</strong>%d dakikası</div>’,
                esc_html($reading_minutes)
            );
            $content = $reading_time_html . $content;
        }
        return $content;
    }

/**
     * 加载插件所需的CSS样式
     */
    public function enqueue_assets() {
        if (is_single()) {
            wp_enqueue_style(
                ‘article-reading-time-style’,
                plugin_dir_url(__FILE__) . ‘assets/css/style.css’,
                array()，
                ‘1.0.0’
            );
        }
    }
}

// 实例化插件类，启动插件
new Article_Reading_Time();

Yönetim ayarları sayfası eklendi.

Profesyonel bir eklentinin genellikle, kullanıcıların davranışlarını özelleştirmesine olanak tanıyan bir arka plan ayar sayfasına ihtiyacı vardır. WordPress’in “Ayarlar API’sini” kullanarak seçenek sayfalarını standart bir şekilde oluşturabiliriz.

Tavsiye edilen okuma WordPress Tema Geliştirme Kılavuzu: Başlangıçtan Uzmanlığa Kadar Pratik Eğitim Kursu。

Öncelikle, eklenti sınıfına ayar menüsünü ve alanlarını kaydetmek için kullanılacak yeni bir metot eklememiz gerekiyor.

// 在构造函数中添加管理菜单钩子
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’，       // 权限
        ‘reading-time-settings’， // 菜单slug
        array($this， ‘render_settings_page’) // 回调函数
    );
}

public function register_settings() {
    register_setting(‘reading_time_settings_group’， ‘reading_time_words_per_minute’);
    add_settings_section(‘reading_time_main’， ‘主要设置’， null， ‘reading-time-settings’);
    add_settings_field(
        ‘words_per_minute’，
        ‘每分钟阅读字数’，
        array($this， ‘render_words_per_minute_field’)，
        ‘reading-time-settings’，
        ‘reading_time_main’
    );
}

public function render_words_per_minute_field() {
    $value = get_option(‘reading_time_words_per_minute’， 400);
    echo ‘<input type="“number”" name="“reading_time_words_per_minute”" value="“’" . esc_attr($value) ‘” />’;
    echo ‘<p class="“description”">Okuma süresini hesaplamak için kullanılan referans değer (kelime/ dakika).</p>’;
}

public function render_settings_page() {
    ?&gt;
    <div class="“wrap”">
        <h1>Makale Okuma Süresi Tahmini Ayarı</h1>
        <form action="/tr/“options.php”/" method="“post”" data-trp-original-action="“options.php”">
            <?php
            settings_fields(‘reading_time_settings_group’);
            do_settings_sections(‘reading-time-settings’);
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="tr"/></form>
    </div>
    &lt;?php
}

// 然后修改 calculate_reading_time 方法，使用用户设置的值
private function calculate_reading_time($content) {
    $text = strip_tags($content);
    $words_per_minute = get_option(‘reading_time_words_per_minute’， 400);
    $word_count = mb_strlen($text， ‘UTF-8’);
    $reading_time = ceil($word_count / $words_per_minute);
    return max(1， $reading_time);
}

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) adımı kaçınılmazdır. Aynı zamanda, yayınlamadan önce kapsamlı testler yapmak ve dokümantasyonu düzenlemek de son derece önemlidir.

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.

Metin çevirme özelliğinin desteklenmesini sağlayın.

WordPress, çok dilli destek sağlamak için GNU gettext teknolojisini kullanır. Eklentilerde doğrudan yazdırılan tüm metinleri belirli bir fonksiyon ile sarmanız gerekir. En yaygın kullanılan yöntem şudur: __() Çevrilen metni ve ayrıca… _e() Doğrudan çevrilmiş metni çıkarmak için kullanılır.

Öncelikle, eklentideki tüm sabit kodlanmış metinleri değiştirin:

// 在插件头部定义 Text Domain
// Text Domain:       article-reading-time

// 在插件初始化时加载语言文件
add_action(‘init’， array($this， ‘load_textdomain’));

public function load_textdomain() {
    load_plugin_textdomain(
        ‘article-reading-time’，
        false，
        dirname(plugin_basename(__FILE__)) . ‘/languages/’
    );
}

// 修改输出文本的代码，使其可翻译
$reading_time_html = sprintf(
    ‘<div class="“reading-time”"><strong>%s</strong>%d %s</div>’,
    esc_html__(‘预计阅读时间：’， ‘article-reading-time’)，
    esc_html($reading_minutes)，
    esc_html(_n(‘分钟’， ‘分钟’， $reading_minutes， ‘article-reading-time’))
);

Daha sonra, Poedit gibi bir araç kullanarak eklentinin kaynak kodunu tarayıp gerekli dosyaları oluşturmanız gerekiyor. .pot Şablon dosyası; çevirmenler bu dosyaya dayanarak ilgili içerikleri oluşturabilirler. zh_CN.po 和 .mo Çeviri dosyasını alın ve eklentinin içine yerleştirin. /languages/ Katalogun içinde.

Test etme ve resmi kataloga gönderme

Yayınlamadan önce, eklentinin tüm özelliklerini farklı ortamlarda (farklı PHP sürümleri, farklı WordPress sürümleri) test etmeyi unutmayın. PHP uyarılarının veya hatalarının olup olmadığını kontrol edin ve eklentinin yaygın olarak kullanılan temalarla veya diğer eklentilerle herhangi bir çatışma yaşamadığından emin olun.

Eğer planlanan eklentinin WordPress resmi eklenti kataloğuna gönderilmesi ise, katı kod standartlarına ve yönergelerine uymak zorundasınız. Bu, çakışmayan, açıklayıcı fonksiyon ve sınıf adları kullanmayı, kod güvenliğini sağlamayı ve ayrıntılı dokümantasyon sağlamayı içerir. readme.txt Dosya (formatın resmi standartlara uygun olması gerekmektedir) ve tüm hata ayıklama (debugging) kodları temizlenmelidir.

Hazırlayın bir açıklama metni… readme.txt Dosya, başarılı bir incelemenin anahtarıdır. İçinde eklentinin açıklaması, kurulum adımları, ekran görüntüleri, sık karşılaşılan sorunlar, güncelleme kayıtları gibi bilgiler bulunmalıdır.

Özetle.

WordPress eklenti geliştirme, yaratıcılığı dağıtılabilir ürünlere dönüştüren güçlü bir beceridir. Basit, tek dosyalı bir eklenti oluşturarak başlayarak, kancalama mekanizmaları, güvenlik uygulamaları, nesne yönelimli mimari, API ayarları ve uluslararasılaştırma konularına doğru ilerleyerek, ticari seviyede eklentiler geliştirmek için sağlam bir temel oluşturabilirsiniz. Önemli olan, WordPress’in temel etkileşim yöntemlerinden biri olan “kancaları” (hooks) anlamak ve güvenli kodlama ile veri doğrulama ilkelerine her zaman bağlı kalmaktır. Kodu modüler ve yapılandırılmış bir şekilde düzenleyerek, yönetim arayüzünü ve çeviri desteğini önceden planlayarak, eklentinizin profesyonelliğini, sürdürülebilirliğini ve pazar uyumunu artırabilirsiniz. Unutmayın; mükemmel bir eklenti sadece işlevlerin bir toplamı değil, aynı zamanda kullanıcı deneyimi, kod kalitesi ve ekosistemin entegrasyonunun da bir ifadesidir.

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ç gösterimi ve etkileşimi işlemek için HTML, CSS ve JavaScript konularında temel bilgilere sahip olmanız gerekmektedir. WordPress’in kolay veritabanı işleme sınıfları sunmasına rağmen, MySQL veritabanının temel kavramlarına aşina olmak ve nesne yönelimli programlama anlayışına hakim olmak, karmaşık eklentiler geliştirmek açısından oldukça faydalıdır.

Eklentilerin (plugins) ve temaların (themes) functions.php dosyaları arasındaki temel farklar nelerdir?

Kodu temaya ekleyin. functions.php Dosyalar, bir özelliği hızlı bir şekilde gerçekleştirmenin bir yoludur; ancak bu özellik mevcut temayla derinlemesine bağlantılıdır. Temayı değiştirdiğinizde, bu özellikler kaybolur. Eklentiler ise temadan bağımsız özellik modülleridir ve hangi tema kullanılırsa kullanılsın, eklenti etkinleştirildiği sürece özellikleri her zaman kullanılabilir durumda kalır. Bu durum, özelliklerin taşınabilirliğini ve web sitesinin bakımının esnekliğini sağlar.

Eklentimdeki fonksiyon adlarının diğer eklentilerle çakışmasını nasıl önleyebilirim?

Nesne yönelimli programlama (OOP) kullanmak ve kodunuzu bir sınıf içinde paketlemek, fonksiyon adı çakışmalarını önlemenin en iyi yoludur. Eğer prosedürel programlama kullanılıyorsa, tüm fonksiyonlar, sabitler ve küresel değişkenler için benzersiz bir önek kullanmak zorundasınız. Bu önek, markanızı veya eklentinizin kısaltmasını içeren ve yeterince özgün bir şey olmalıdır. myplugin_ 或 art_rt_。

Geliştirdiğim eklentiyi nasıl hata ayıklamalıyım?

Öncelikle, WordPress’te gerekli ayarların yapıldığından emin olun. wp-config.php Dosyada hata ayıklama modunu etkinleştirin: define(‘WP_DEBUG’, true); 和 define(‘WP_DEBUG_LOG’, true);Böylece, PHP hataları ve uyarıları kaydedilecektir. /wp-content/debug.log Dosyada bulunuyor. Ayrıca, tarayıcı geliştirici araçlarını kullanarak ön uç (front-end) sorunlarını inceleyebilir ve bunlardan faydalanabilirsiniz. error_log() Fonksiyon, kod içinde değişken değerlerini bir günlük dosyasına (log file) yazarak hata ayıklama (debugging) işlemi yapar.

Ticari eklentiler geliştirirken hangi hukuki konular göz önünde bulundurulmalıdır?

En önemli hukuki konu, WordPress’in lisans anlaşmasına uymaktır. Eğer WordPress’in resmi kataloğunda bir eklenti yayınlamayı planlıyorsanız, eklentinizin GPLv2 veya daha yüksek bir lisansı kullanması gerekmektedir. Bu, eklentinizin kodunun açık kaynaklı (open source) olması gerektiği anlamına gelir. Kar elde etmek için destek hizmetleri, gelişmiş özellikler, dokümantasyon veya barındırma hizmetleri gibi yolları kullanabilirsiniz. Ayrıca, kullanıcı verileriyle çalışıyorsanız GDPR gibi veri koruma yasalarına dikkat etmeniz ve bunlara uymanız gerekmektedir. Eklentinizin gizlilik beyanında veri toplama ve kullanım şeklini açıkça belirtmeniz önerilir.