Sıfırdan başlayarak: WordPress eklenti geliştirmenin temel süreçlerini ve güvenlik uygulamalarını öğrenin.

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

İlk satır kodu yazmaya başlamadan önce, uygun bir geliştirme ortamı oluşturmak çok önemlidir. Tüm geliştirme ortamları WordPress eklenti geliştirmek için uygun değildir; üretim ortamına mümkün olduğunca benzeyen bir yerel ortam, gelecekteki uyumluluk sorunlarını etkili bir şekilde azaltabilir. XAMPP, MAMP veya Docker gibi entegre ortamların kullanılması önerilir; bu ortamlar Apache, MySQL ve PHP’yi önceden yüklü olarak sunar ve yapılandırma sürecini büyük ölçüde kolaylaştırır.

Geliştirmenin temel aracı, Visual Studio Code, PhpStorm veya Sublime Text gibi verimli bir kod editörü veya entegre geliştirme ortamıdır (IDE). Bu araçlar sadece sözdizimi vurgulama ve kod önerileri sunmakla kalmaz, aynı zamanda eklentiler aracılığıyla WordPress’e özgü fonksiyon kütüphanelerini de destekleyerek kodlama verimliliğini önemli ölçüde artırır.

Daha sonra, test etmek için kullanabileceğiniz bir WordPress kurulum örneğine ihtiyacınız olacak. WordPress.org adresini ziyaret ederek en yeni sürümü indirin ve bunu yerel sunucu ortamınıza kurun. Kurulum tamamlandıktan sonra, arka plandaki “Ayarlar” -> “Sabit Bağlantılar” bölümüne girerek bağlantı yapısını varsayılan dışında bir forma değiştirmenizi öneririz (örneğin “Makale Adı” şeklinde). Bu, eklentinin çeşitli URL yapılarında nasıl çalıştığını test etmenize ve eklentinin işlevselliğinin sağlamlığını doğrulamanıza yardımcı olacaktır.

Tavsiye edilen okuma Sıfırdan başlayarak: Profesyonel düzeyde WordPress teması nasıl oluşturulur konusunda adım adım rehber.。

WordPress’in eklenti dizin yapısını anlamak, temellerin en temel parçalarından biridir. Tüm özel eklentiler burada saklanır./wp-content/plugins/Katalogun içinde. Her eklenti genellikle kendine ait bir klasöre sahiptir ve bu klasörün adlandırılması açık ve benzersiz olmalıdır; mevcut eklentilerle çakışmaktan kaçınılmalıdır. Bu klasörde en az bir ana PHP dosyası bulunur ve dosya adı genellikle klasör adıyla aynıdır. Örneğin, eklenti klasörünün adı “my-plugin” ise, ana PHP dosyasının adı da “my-plugin.php” olur.my-first-pluginAna dosya şu şekilde olmalıdır:my-first-plugin.phpBu ana dosyanın başında, WordPress’in eklentiyi tanıması için gerekli olan standart eklenti bilgileri açıklamaları bulunmalıdır; bu bilgiler eklentinin “kimlik kartı” niteliğindedir.

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.

Bu temel hazırlıkları öğrendiğinizde, gerçek kodlama aşamasına adım atmak için zemin hazırlamış olursunuz.

İlk WordPress eklentinizi oluşturun.

Tüm süreci uygulamak için basit bir “Hello World” eklentisi oluşturarak başlayalım. Bu eklentinin işlevi, web sitesinin makale içeriklerinin altına otomatik olarak özelleştirilmiş bir hoş geldiniz mesajı eklemektir.

Öncelikle, yerel WordPress sitenizde…/wp-content/plugins/Dizin içinde, “” adında bir dosya oluşturun.hello-world-greetingYeni bir klasör oluşturun. Daha sonra bu klasörün içinde ana PHP dosyasını oluşturun.hello-world-greeting.php。

Bu ana dosyayı açtığımızda, öncelikle eklenti başlık bilgilerini yazmamız gerekiyor. Bu yorum bilgileri çok önemlidir; eklentinin temel özelliklerini açıklar ve WordPress’e bunun geçerli bir eklenti olduğunu bildirir.

Tavsiye edilen okuma WordPress Eklenti Geliştirme Kılavuzu: Sıfırdan İleri Seviyelere。

<?php
/**
 * Plugin Name:  Hello World Greeting
 * Plugin URI:   https://www.yourwebsite.com/hello-world-greeting
 * Description:  一个简单的插件，用于在文章内容后添加问候语。
 * Version:      1.0.0
 * Author:       你的名字
 * License:      GPL v2 or later
 * Text Domain:  hello-world-greeting
 */

Çekirdek işlevleri gerçekleştirmek için WordPress’in “filtrelerini” (Filters) kullanmamız gerekiyor. Filtreler, belirli verilerin (örneğin makale içeriği) ekrana yazdırılmadan veya veritabanına kaydedilmeden önce değiştirilmesine olanak tanır. Kullanacağımız filtre şudur:the_contentKancalar, özellikle makale içeriklerini filtrelemek için kullanılır.

Eklenti başlık bilgilerinin altına aşağıdaki fonksiyonları ve işlevleri ekleyin:

/**
 * 在文章内容末尾添加问候语
 *
 * @param string $content 原始的文章内容。
 * @return string 修改后的文章内容。
 */
function hwg_add_greeting_to_content( $content ) {
    // 确保只在主循环的单篇文章页面添加
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $greeting = '<p style="color: #0073aa; font-style: italic;">Okuduğunuz için teşekkür ederiz! Daha fazla içerik için web sitemizi ziyaret etmeye hoş geldiniz.</p>';
        $content .= $greeting;
    }
    return $content;
}
// 将我们的函数挂载到‘the_content’过滤器上
add_filter( 'the_content', 'hwg_add_greeting_to_content' );

Dosyayı kaydettikten sonra, WordPress arayüzüne giriş yapın ve “Eklentiler” sayfasına gidin. Orada “Hello World Greeting” adında yeni bir eklenti görmelisiniz. “Etkinle” butonuna tıklayın; ardından web sitenizdeki bir makaleye gidin ve makalenin sonunda önceden ayarladığımız selam mesajının başarıyla eklendiğini göreceksiniz.

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.

Bu basit örnek, eklenti geliştirmenin temel adımlarını göstermektedir: Klasör ve dosya oluşturma -> Eklentinin başlık bilgilerini yazma -> İşlevsel fonksiyonları yazma -> Daha sonra…add_filter或add_actionBir fonksiyonu WordPress’in hook’larına bağlayın. Ardından, eklentilerin nasıl daha kolay yönetilebileceğini ve uluslararasılaştırılabileceğini öğreneceğiz.

Eklenti Geliştirmeinde İleri Mimariler ve En İyi Uygulamalar

Eklentilerin işlevleri giderek karmaşıklaştıkça, iyi bir kod mimarisi sürdürülebilirliği ve genişletilebilirliği sağlamanın anahtarıdır. Tipik bir ileri düzey eklenti, modülerlik ilkesine uymalıdır.

Eklentinin temel işlevlerini gerçekleştiren ana sınıf, iyi bir başlangıç noktasıdır. Eklentinin temel mantığını kapsayacak bir ana sınıf oluşturmanız önerilir; bu, fonksiyon adlarının temalar veya diğer eklentilerle çakışmasını önlemeye ve kodu daha iyi organize etmeye yardımcı olacaktır. Örneğin, “PluginCore” adında bir sınıf oluşturabilirsiniz.Hello_World_Greeting_PluginSınıfı ve onun içindeki…__constructTüm işlevleri (hook’ları) kurucu fonksiyonda başlatın.

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

class Hello_World_Greeting_Plugin {
    public function __construct() {
        add_action( 'init', array( $this, 'load_textdomain' ) );
        add_filter( 'the_content', array( $this, 'add_greeting' ) );
        add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
    }

public function load_textdomain() {
        load_plugin_textdomain( 'hello-world-greeting', false, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );
    }

public function add_greeting( $content ) {
        // ... 功能代码 ...
    }

public function add_admin_menu() {
        // 添加后台菜单项
    }
}
// 实例化插件类
new Hello_World_Greeting_Plugin();

Kullanıcı tarafından yapılandırılması gereken eklentiler için bir arka plan ayar sayfası oluşturmak standart bir uygulamadır. Bu genellikle WordPress’in özelliklerini kullanmayı içerir.add_options_page或add_menu_pageBu fonksiyonlara menü öğeleri ekleyin ve ardından seçenekleri güvenli bir şekilde kaydetmek, doğrulamak ve yönetmek için Ayarlar API’sini (Settings API) kullanın.register_setting、add_settings_section和add_settings_fieldBu tür fonksiyonlar kullanılarak, WordPress arka plan stiline uygun güvenlik ayarları formları oluşturulabilir.

Ayrıca, eklenti kaldırma işlemlerini de içermelidir. Kullanıcı bir eklentiyi sildiğinde, eklentinin oluşturduğu verilerin (örneğin formlar, özel veritabanı tabloları) temizlenmesi gerekir. Bu, eklentinin ana dosyasında bir kaldırma işlemi için bir mekanizma (hook) tanımlayarak sağlanır. İsterseniz ayrı bir kaldırma dosyası oluşturabilirsiniz, isterseniz ana dosyada bu işlemleri doğrudan gerçekleştirebilirsiniz.register_uninstall_hookİşlev.

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.

register_uninstall_hook( __FILE__, 'hwg_plugin_uninstall' );
function hwg_plugin_uninstall() {
    delete_option( 'hwg_greeting_text' ); // 删除保存的选项
}

Eklentilerin güvenliğini ve performansını sağlamanın temel önemli noktaları:

Güvenlik, eklenti geliştirmenin can damarındır. Güvensiz bir eklenti yalnızca kendi web sitesini tehlikeye atmakla kalmaz, aynı zamanda sunucudaki diğer siteleri de etkileyebilir. En önemli ilke şudur: Kullanıcıların girdilerine asla güvenmeyin. Kullanıcılardan veya dış kaynaklardan gelen tüm veriler…$_GET、$_POST、$_COOKIEGösterilmeden, saklanmadan veya veritabanı sorgularında kullanılmadan önce, her bir verinin doğrulanması, temizlenmesi ve uygun şekilde işlenmesi (örneğin: escape işlemleri yapılması) gerekmektedir.

Verileri çıkardığınızda, uygun kaçış fonksiyonlarını kullanın. Örneğin, HTML metnine çıktı yapılırken…esc_html; HTML özniteliklerine çıktı olarak gönderirken, kullanınesc_attrURL’ye gönderilecek içerik için şu yöntemi kullanın:esc_urlVerilerin bir veritabanına kaydedilmesi gerektiğinde, uygun yöntemlerin kullanılması gerekir.wpdbsınıfınprepareSQL sorgularını güvenli bir şekilde işlemek için yöntemler bulunmaktadır; bu yöntemler, SQL enjeksiyon saldırılarını etkili bir şekilde önleyebilir.

`nonces`, eklentiler içinde gerçekleştirilmelidir. WordPress, belirli işlemler için (örneğin form gönderimi, AJAX istekleri) benzersiz ve zaman sınırlı bir jeton oluşturabilen güçlü bir `Nonce` API’si sunar. Bu jeton, isteğin geçerliliğini doğrulamak ve çapraz sitelik istek sahteciliği (CSRF – Cross-Site Request Forgery) saldırılarını önlemek amacıyla kullanılır.

Performans açısından, WordPress’ü dikkatli bir şekilde kullanmalısınız.add_action和add_filterKancalar (hooks): Fonksiyonları yalnızca gerekli olduğunda kancalara bağlayın ve gereksiz olduğunda (örneğin, eklentinin devre dışı bırakılma işlemi sırasında) bunların kullanılmadığından emin olun.remove_action和remove_filterGerekli olmayan kodların çalıştırılmasını önlemek için bu kodları kaldırın.

Zaman alıcı veritabanı sorguları için, WordPress’in Transients API’sini kullanarak sonuçları önbelleğe almayı düşünebilirsiniz. Transients API, karmaşık sorguların sonuçlarını birkaç saat hatta birkaç gün boyunca önbelleğe alabilen, basit ve zaman sınırlı bir anahtar-değer çifti depolama yöntemidir; bu da veritabanı yükünü önemli ölçüde azaltır. Örneğin:

$cached_data = get_transient( 'my_plugin_expensive_query_result' );
if ( false === $cached_data ) {
    $cached_data = $wpdb->get_results( "SELECT ... FROM ..." ); // 复杂查询
    set_transient( 'my_plugin_expensive_query_result', $cached_data, HOUR_IN_SECONDS * 12 ); // 缓存12小时
}
// 使用 $cached_data

Özetle.

WordPress eklenti geliştirme, ortam kurulumundan temel kodlamaya, mimari tasarımdan güvenlik ve performans optimizasyonuna kadar sistematik bir süreçtir ve her adım son derece önemlidir. “Hello World” örneğiyle başlayarak, eklentilerin WordPress çekirdeğiyle nasıl etkileşimde bulunduğunu hızlı bir şekilde anlayabilirsiniz. Becerileriniz geliştikçe, nesne yönelimli ve modüler bir mimari kullanmak ve güvenli kodlama standartlarına sıkı sıkıya uymak, yüksek kaliteli ve güvenilir eklentiler geliştirmenin kaçınılmaz yoludur. Unutmayın ki, mükemmel bir eklentinin özelliği yalnızca güçlü işlevselliği değil; aynı zamanda güvenliği, sürdürülebilirliği ve tüm web sitesinin performansına olan olumlu etkisidir.

Sıkça Sorulan Sorular.

###: WordPress eklentisi geliştirmek için hangi programlama dilleri bilgisine ihtiyaç vardır?
WordPress eklentileri geliştirmek için öncelikle PHP diliyi iyi bilmek gerekmektedir; çünkü WordPress’ün çekirdeği PHP ile yazılmıştır. Aynı zamanda, eklentinin ön yüzünü ve etkileşim mantığını oluşturmak için HTML, CSS ve JavaScript konularında temel bilgilere sahip olmanız gerekir. Veritabanı işlemlerini içeren karmaşık özellikler için de temel SQL bilgisi gereklidir.

Eklentime bir arka plan ayarları sayfası nasıl eklerim?

Eklentilere arka plan ayarları sayfası eklemek için, WordPress’in resmi Settings API’sini kullanmanız önerilir; bu en güvenli ve en standartlara uygun yöntemdir. İlk olarak,add_options_page或add_menu_pageFonksiyon, arka planda bir menü içinde bir sayfa oluşturur. Daha sonra, bu sayfanın geri çağrı fonksiyonunda (callback function) ilgili işlemler yapılır.register_settingBir ayar seçenek grubu oluşturun ve bunu kullanın.add_settings_section和add_settings_fieldAyar bölgesini ve belirli alanları tanımlayın. Son olarak, sayfada bu ayarları çağırın.settings_fields和do_settings_sectionsBir fonksiyon, bağlanmış ayar formunu çıktı olarak verir.

Neden eklentimi etkinleştirdikten sonra web sitesi beyaz ekran gösteriyor?

Web sitelerinde beyaz ekran görünmesi genellikle PHP’nin ölümcül hatalarından (Fatal Errors) kaynaklanır. WP_DEBUG modu ise varsayılan olarak kapalıdır; bu nedenle hata mesajları gizlenir. Öncelikle, lütfen sitenizdeki PHP ayarlarını kontrol edin ve WP_DEBUG modunu etkin hale getirin. Böylece oluşan hatalar görülebilir ve sorunun kaynağı belirlenebilir.wp-config.phpDosyada,WP_DEBUGConstantın değeri şu şekilde ayarlandı:trueBelirli hata bilgilerini sayfada gösterebilmek için bu bilgilerin toplanması gerekmektedir. Yaygın nedenler arasında; sözdizimi hataları, tanımlanmamış fonksiyonların veya sınıfların çağrılması, temalarla veya diğer eklentilerle fonksiyon adı veya sınıf adı çakışmaları bulunmaktadır. Eklentilerin işlevlerini sınıflar kullanarak kapsüllemek ve ad alanı (namespace) veya önek (prefix) kurallarına uymak, çakışmaları önlemenin etkili yollarındandır.

Nasıl olur da eklentimi çok dilli (uluslararasılaştırılmış) hale getirebilirim?

Eklentilerin çok dilli desteklemesini, yani uluslararasılaştırma (i18n) ve yerelleştirme (l10n) özelliklerini sağlamasını, esas olarak WordPress’in çeviri fonksiyonlarına bağlıdır..po/.moÇeviri dosyası: Eklenti kodunda, çevrilmeye ihtiyaç duyan tüm metinler belirli bir format kullanılarak yer almalıdır.__()、_e()或_x()Bu fonksiyonları bir araya getirerek bir kapsül oluşturun ve bir “Metin Alanı” (Text Domain) belirleyin; bu metin alanı, eklenti başlık bilgilerinde tanımlanan “Metin Alanı” ile uyumlu olmalıdır. Daha sonra, Poedit gibi bir araç kullanarak eklentinin kaynak kodunu tarayın ve gerekli değişiklikleri yapın..potŞablon dosyaları; çevirmenler, bu dosyalara dayanarak ilgili dildeki içerikleri oluşturabilirler.zh_CN.poSon olarak, eklenti başlatılırken bunu kullanın.load_plugin_textdomain()Bir fonksiyon, çeviri dosyalarını yüklemek için kullanılır.