WordPress eklenti geliştirme rehberi: Sıfırdan başlayarak ticari düzeyde uzantılar oluşturmaya kadar.

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

WordPress eklenti geliştirmeye başlamak için öncelikle profesyonel bir yerel geliştirme ortamı oluşturmanız gerekmektedir. Bu, sadece geliştirme verimliliğini artırmakla kalmaz, aynı zamanda çevrimiçi sitelerde yapılan testlerin getirebileceği riskleri de önler. XAMPP, MAMP veya Local by Flywheel gibi entegre ortam araçlarını kullanmanız önerilir; bu araçlar Apache, MySQL ve PHP’yi tek tuşla kurmanıza olanak tanır ve karmaşık yapılandırma işlemlerinden sizi kurtarır.

Çevre hazır olduktan sonra, WordPress’in kurulum dizini altındaki…wp-content/pluginsKlasörünüzde ilk eklentinizi oluşturun. Bir eklentinin en temel yapısı, bir ana PHP dosyasıyla başlar. Örneğin, “my_first_plugin.php” adında bir dosya oluşturabilirsiniz.my-first-pluginBelirtilen klasöre gidin ve içinde aynı adı taşıyan bir dosya oluşturun.my-first-plugin.phpDosya.

Her eklentinin, WordPress’in eklenti bilgilerini tanımasının temelini oluşturan standart bir eklenti başlık yorumu içermesi gerekir. İşte en temel bir eklenti dosyası örneği:

Tavsiye edilen okuma WordPress eklenti geliştirme: Temel tekniklerden ileri düzeye kadar kapsamlı bir rehber.。

<?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
 */

Bu dosyayı kaydettikten sonra, WordPress arayüzüne giriş yapın ve “Eklentiler” sayfasına gidin. Yeni eklenen eklentiyi eklenti listesinde göreceksiniz ve onu etkinleştirebilir veya devre dışı bırakabilirsiniz. Böylece eklenti geliştirme yolculuğunuz resmen başlamış olur. Geliştirme süreci boyunca eklentiyi her zaman etkin tutmanızı öneririz.WP_DEBUGBu mod, hataların zamanında tespit edilip düzeltilmesini sağlar.

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.

Eklenti Çekirdek Yapısı ve Hook Mekanizması

WordPress eklentilerinin temel yapısını ve çalışma prensiplerini anlamak, başarılı bir geliştirme için çok önemlidir. İyi bir şekilde tasarlanmış bir eklenti genellikle ana dosya, varlık dosyaları (CSS, JavaScript), dil paketleri ve isteğe bağlı sınıf kütüphaneleri veya şablon dosyalarını içerir. Ancak tüm eklentilerin özü, WordPress çekirdeğiyle olan etkileşim şekillerindedir ve bu etkileşim esas olarak “kancalar” (Hooks) aracılığıyla gerçekleştirilir.

Kancalar iki ana türe ayrılır: Eylem Kancaları (Action Hooks) ve Filtre Kancaları (Filter Hooks). Eylem Kancaları, belirli zaman noktalarında kendi kodunuzu “çalıştırmanıza” olanak tanır; örneğin, bir makale yayınlandıktan sonra veya sayfa başlığı yüklendiğinde.add_action()Bu fonksiyon, kendi fonksiyonunuzu bir eylem kancasına (action hook) bağlamak için kullanılır.

Bir yönetim menüsü nasıl eklenir?

Yaygın bir ihtiyaç, eklentilere ayrı bir arka plan yönetim sayfası eklemektir. Bu genellikle, ilgili fonksiyonların eklentiye monte edilmesiyle sağlanır.admin_menuBu işlem, bir “action hook” kullanılarak gerçekleştirilir. Eklentinin ana dosyasında kodu şu şekilde yazabilirsiniz:

function myplugin_add_admin_menu() {
    add_menu_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 权限
        'myplugin-slug', // 菜单别名（slug）
        'myplugin_settings_page', // 用于输出页面内容的函数
        'dashicons-admin-generic', // 图标
        80 // 菜单位置
    );
}
add_action('admin_menu', 'myplugin_add_admin_menu');

function myplugin_settings_page() {
    // 这里是输出设置页面HTML和逻辑的代码
    echo '<div class="wrap"><h1>Eklenti Ayarları Sayfası</h1></div>';
}

Makale içeriğini nasıl değiştiririm?

Filtre kancaları, verileri “değiştirmenize” olanak tanır. WordPress, verileri (makale içeriği, başlık, özet gibi) filtreler aracılığıyla iletir ve eklentiniz bu verileri yakalayıp değiştirebilir; ardından değiştirilmiş verileri geri gönderebilir.add_filter()Bir fonksiyon, filtreleri uygulamak için kullanılır. Örneğin, tüm makale içeriklerinin sonuna otomatik olarak bir metin parçası eklemek için:

Tavsiye edilen okuma WordPress Eklenti Geliştirme Başlangıç Kılavuzu: Sıfırdan Başlayarak Özelleştirilmiş İşlevler Oluşturma。

function myplugin_add_footer_to_content($content) {
    if (is_single()) { // 仅在单篇文章页面生效
        $footer_text = '<p><em>Bu makale, eklentim aracılığıyla sizin için sunulmuştur.</em></p>';
        $content .= $footer_text;
    }
    return $content;
}
add_filter('the_content', 'myplugin_add_footer_to_content');

Hareketleri ve filtre kancalarını esnek bir şekilde birleştirerek, WordPress’in işlevselliğini neredeyse sınırsız bir şekilde genişletebilirsiniz.

Eklentilerin Güvenliği ve Veri Yönetimi

Ticari sınıf veya genel olarak dağıtılan eklentiler geliştirilirken, güvenlik ve sağlam veri yönetimi en önemli hususlardır. Herhangi bir ihmal, web sitesinin saldırıya uğramasına veya verilerin zarar görmesine neden olabilir.

Öncelikli kural şudur: Kullanıcı tarafından girilen verilere asla güvenmeyin. Kullanıcıdan, formlardan veya URL parametrelerinden gelen tüm verilerin doğrulanması, temizlenmesi ve escape işleminden geçirilmesi gerekir. WordPress, bu işlemleri kolaylaştırmak için bir dizi fonksiyon sunar.sanitize_text_field()Metin dizisini temizlemek için kullanın.absint()Bir değerin negatif olmayan bir tamsayı olduğundan emin olmak için kullanılır.wp_kses()HTML etiketlerinin izin verilmesini veya filtrelenmesini 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.

Eklentiler veritabanıyla etkileşim kurarken, WordPress tarafından sağlanan veritabanı işleme sınıflarını doğrudan kullanmalısınız.wpdbYerel MySQL fonksiyonları yerine…wpdbSınıf, veritabanı bağlantısını, güvenli sorgulamaları ve hata işlemlerini zaten halletmiştir. Örneğin, verileri güvenli bir şekilde sorgulamak için:

global $wpdb;
$user_id = absint($_GET['user_id']); // 清理输入
$results = $wpdb->get_results(
    $wpdb->prepare(
        "SELECT * FROM {$wpdb->prefix}myplugin_table WHERE user_id = %d",
        $user_id
    )
);

$wpdb->prepare()Bu yöntem, PHP’nin ön işleme ifadelerine benzer ve SQL enjeksiyon saldırılarını etkili bir şekilde önleyebilir.

Eklenti seçeneklerini oluşturma ve yönetme

Ayarların kaydedilmesini gerektiren eklentiler için, WordPress Options API (Seçenekler API’si) en iyi seçenektir. Bu API, gerekli olan özellikleri sunar.add_option()、get_option()、update_option()和delete_option()Bu tür fonksiyonlar, serileştirilmiş verilerin güvenli bir şekilde yönetilmesini sağlar. Eklentinin tüm ayarlarının, birden fazla ayrı seçenek oluşturmak yerine tek bir dizi içinde saklanması önerilir.

Tavsiye edilen okuma Sıfırdan başlayarak WordPress eklenti geliştirmeyi öğrenmenize yardımcı olacak adım adım bir rehber.。

// 获取设置数组，如果不存在则使用默认值
$myplugin_options = get_option('myplugin_settings', array(
    'api_key' => '',
    'enable_feature' => true,
    'display_mode' => 'advanced'
));

// 更新某个设置值
$myplugin_options['api_key'] = sanitize_text_field($_POST['api_key']);
update_option('myplugin_settings', $myplugin_options);

Aynı zamanda, eklentinize CE (nonce) doğrulaması ve yetki kontrolü özellikleri eklemek, çapraz sitelik istek sahteciliğini (CSRF – Cross-Site Request Forgery) ve yetkisiz erişimi önleyebilir.

Eklentinin uluslararasılaştırılmasını ve yayınlamaya hazırlanmasını gerçekleştirme

Eklenti özelliklerinin geliştirilmesi tamamlandıktan ve yeterli testlerden geçtikten sonra, bir sonraki adım onun dünya genelindeki kullanıcılar tarafından kullanılabilir hale getirilmesidir. Ayrıca, WordPress resmi eklenti kataloğuna eklenmesi veya ticari olarak satılması için gerekli hazırlıkların yapılması gerekmektedir.

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 (i18n), eklentideki metin dizelerinin diğer dillere çevrilmesi işlemini ifade eder. Bu işlem için, tüm kullanıcıya yönelik metinleri WordPress’in yerelleştirme fonksiyonları kullanarak sarmanız gerekir. Öncelikle, eklentinin baş kısmındaki yorumlarda gerekli tanımlamaları yapın.Text Domain(Örneğin)my-first-pluginArdından kullanın.__()或_e()Fonksiyon, metin çıktısı verir.

// 在代码中
echo '<h2>' . __('插件设置', 'my-first-plugin') . '</h2>';
$description = __('这是一个功能强大的插件。', 'my-first-plugin');

// 在属性中（如表单的placeholder）
echo '<input type="text" placeholder="&#039; . esc_attr__(&#039;请输入关键词&#039;, &#039;my-first-plugin&#039;) . &#039;">';

Daha sonra, kullanmanız gerekecek…load_plugin_textdomain()Fonksiyon çalışıyor.plugins_loadedEylem sırasında çeviri dosyaları yükleniyor. Çeviri dosyaları (.po/.mo), Poedit gibi araçlar kullanılarak oluşturulabilir. Uluslararasılaştırma işlemi tamamlandıktan sonra, eklentiniz uluslararası pazarlara açılmak için gerekli temellere sahip olur.

Profesyonel bir eklenti sıkıştırma paketi oluşturun.

Yayınlamadan önce, kodu temizlemek ve ayrıntılı bir açıklama yazmak gerekiyor.readme.txtDosyaları birleştirin ve nihai yayın paketini oluşturun.readme.txtWordPress’in resmi format standartlarına uyulmalıdır; bu standartlar eklenti adı, açıklama, kurulum yöntemi, sık karşılaşılan sorunlar, güncelleme kayıtları gibi bölümleri içermelidir. Doğru bir biçimde hazırlanmış bir eklenti dosyası şu bölümleri içermelidir:readme.txtBu, eklentilerin resmi kataloga gönderilmesi için zorunlu bir gerekliliktir.

Son olarak, eklenti klasörünüzde yalnızca gerekli dosyaların bulunduğundan emin olun (diğer dosyaları kaldırın)..gitİçindekiler,node_modulesIDE ayar dosyaları vb.) oluşturun ve ardından bunları ZIP dosyası olarak sıkıştırın. Bu ZIP dosyası, WordPress arayüzündeki “Eklenti Yükle” özelliği aracılığıyla doğrudan yüklenebilir, ayrıca resmi kataloglara gönderilebilir veya ticari bir ürün olarak sunulabilir.

Özetle.

WordPress eklenti geliştirme, temel ortamın kurulmasını, çekirdek mekanizmaların öğrenilmesini, güvenli veri yönetiminin sağlanmasını ve son olarak uluslararasılaştırma ile yayın hazırlıklarının tamamlanmasını içeren bir süreçtir. Basit bir eklenti başlığı oluşturarak başlayarak, eylem (action) ve filtre (filter) hook’ları aracılığıyla WordPress’un yaşam döngüsüne derinlemesine dahil olmak, eklentinin işlevlerini geliştirmenin temelidir. Bu süreçte güvenliği her zaman öncelikli olarak göz önünde bulundurmalı ve tüm veri giriş/çıkış işlemlerini dikkatli bir şekilde yönetmelisiniz. Eklenti olgunlaştığında, uluslararasılaştırma işlemleriyle dünya çapında kullanılabilir hale getirilmeli ve yayın için gerekli materyaller standartlara uygun olarak hazırlanmalıdır. Böylece kişisel bir araçtan, binlerce kullanıcı tarafından kullanılan profesyonel bir eklentiye dönüşebilir. Topluluğun en iyi uygulamalarını sürekli öğrenmek ve kodunuzun netliğini ve sürdürülebilirliğini korumak, her eklenti geliştiricisinin uzun vadeli başarısının temel taşıdır.

Sıkça Sorulan Sorular.

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

PHP programlama diline dair temel bilgilere sahip olmanız gerekmektedir; çünkü eklenti kodunun büyük bir kısmı PHP ile yazılmıştır. Ayrıca, ön uç arayüzler ve etkileşimler oluşturmak için HTML, CSS ve JavaScript konularında temel bilgilere sahip olmanız faydalı olacaktır. MySQL veritabanının temel kavramlarını (sorgulama, ekleme, silme, değiştirme, sorgulama) anlamanız da yardımcı olacaktır; ancak WordPress’in…wpdbSınıflar, çoğu işlemi basitleştirir. En önemlisi, WordPress’in temel işlemlerine ve mimari kavramlarına aşina olmaktır.

Geliştirilmekte olan bir WordPress eklentisini nasıl hata ayıklarım?

En etkili yöntem, WordPress’in hata ayıklama (debugging) modunu etkinleştirmektir. Web sitesinin…wp-config.phpDosyada,WP_DEBUGSabit, olarak ayarlandı.trueAyrıca hepsini aynı anda da etkinleştirebilirsiniz.WP_DEBUG_LOG(Hataları bir günlük dosyasına kaydet) veSCRIPT_DEBUG(Sıkıştırılmamış betik dosyaları yükleniyor.) Ayrıca, tarayıcı geliştirici araçlarını kullanarak konsolu ve ağ isteklerini incelemek ve Query Monitor gibi profesyonel hata ayıklama eklentileri kurmak, performans sorunlarını ve mantık hatalarını tespit etmede büyük yardımcı olabilir.

Eklentim, temalar ve diğer eklentilerle nasıl uyumlu çalışır?

Maksimum uyumluluk sağlamak için eklentiniz WordPress kodlama standartlarına uymalı ve mümkün olduğunca WordPress çekirdeğinin sunduğu açık API’leri ve eklentileri kullanmalıdır; çekirdek dosyaları veya veritabanı tablolarını doğrudan değiştirmekten kaçının. Fonksiyonlarınızın, sınıflarınızın ve seçenek adlarının önüne benzersiz bir önek ekleyin (örneğin, eklentinin kısaltmasını kullanarak) böylece diğer kodlarla isim çatışmalarını önleyin. Mümkün olduğunda, diğer geliştiricilerin eklentinizin davranışlarını değiştirmesine izin veren filtre eklentileri sağlayın; bu, iyi bir genişletilebilirlik tasarımının göstergesidir.

Ücretsiz eklentiyi ücretli sürüme yükseltebilir miyim?

Evet, bu oldukça yaygın bir iş modelidir. WordPress’in resmi kataloğunda sınırlı özelliklere sahip ücretsiz bir sürüm (“Freemium” modeli) yayınlayarak kullanıcı sayısını ve itibarınızı artırabilirsiniz; aynı zamanda daha güçlü özelliklere sahip profesyonel veya kurumsal sürümleri de ücretli yükseltmeler olarak sunabilirsiniz. Ücretsiz sürümde, kullanıcıları satın almaya yönlendirecek yükseltme hatırlatmaları ve ayar arayüzleri yerleştirebilirsiniz. Önemli olan, ücretsiz ve ücretli özellikleri açık bir şekilde ayırt etmek ve ücretli kullanıcılara öncelikli güncellemeler, özel özellikler ve teknik destek gibi sürekli değerler sunmaktır.