WordPress Eklenti Geliştirme: Başlangıçtan Uzmanlığa Kadar Kapsamlı Pratik Rehber

Neden WordPress eklenti geliştirme öğrenilmelidir?

WordPress, dünyanın en popüler içerik yönetim sistemi olarak, güçlü genişletilebilirliğini büyük ölçüde eklenti mimarisine borçludur. Eklenti geliştirmeyi öğrenmek, mevcut eklentilerin işlevselliğiyle sınırlı kalmayacağınız anlamına gelir; çözümleri tamamen projenizin ihtiyaçlarına göre özelleştirebilirsiniz. İster belirli bir müşteri için özgün web site özellikleri oluşturun, isterse küresel kullanıcılara yönelik bir ticari eklenti geliştirin; bu beceriyi kazanmak size büyük esneklik ve ticari değer sağlayacaktır.

Kendi eklentilerinizi geliştirerek kod kalitesini garanti altına alabilir, üçüncü parti eklentiler kullanımından kaynaklanan uyumluluk sorunlarından veya güvenlik açıklarından kaçınabilirsiniz. Aynı zamanda, eklenti mekanizmalarını derinlemesine anlamak, WordPress’in temel işleyişini daha iyi kavramanıza yardımcı olur ve böylece daha kapsamlı bir WordPress geliştiricisi olursunuz. Basit işlev geliştirmelerinden karmaşık SaaS uygulamalarının entegrasyonuna kadar, eklenti geliştirme tüm bunları başarmak için temel bir araçtır.

Geliştirme ortamı kurma ve ilk eklentiyi oluşturma

Kod yazmaya başlamadan önce, uygun bir geliştirme ortamı çok önemlidir. Local by Flywheel, XAMPP veya MAMP gibi yerel geliştirme araçlarını kullanmanız önerilir; bu araçlar PHP, MySQL ve Apache/Nginx içeren yerel bir sunucu ortamı hızlı bir şekilde kurmanıza olanak tanır. Aynı zamanda, VS Code veya PHPStorm gibi profesyonel bir kod editörü, geliştirme verimliliğinizi büyük ölçüde artırabilir.

Eklenti temel dosyasını oluşturun.

En basit WordPress eklentisi, yalnızca bir ana PHP dosyası içerebilir. Öncelikle, WordPress’in kurulum dizininde…wp-content/pluginsKlasörün içinde, örneğin, yeni bir klasör oluşturun.my-first-plugin。

Bu klasörde, genellikle eklentinin adıyla adlandırılan bir ana dosya oluşturun. Örneğin:my-first-plugin.phpHer eklentinin dosyanın başında standart bir eklenti bilgi açıklaması içermesi gerekmektedir; bu, WordPress’in eklentiyi tanıması için zorunludur.

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:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Yukarıdaki dosyayı kaydettikten sonra, WordPress arayüzünün “Eklentiler” sayfasına gidin; yeni eklenen eklentiyi eklenti listesinde görmelisiniz. Şu an herhangi bir özelliği olmasa da, yasal bir WordPress eklentisi oluşturmayı başardınız.

Eklentiye basit bir özellik ekleyin.

Bu eklentiye en temel özelliği ekleyelim: Web sitesinin alt kısmına özelleştirilmiş bir metin satırı ekleyelim. Bunu, WordPress’in hook (kancalar) mekanizmasını kullanarak gerçekleştireceğiz.

// 在 my-first-plugin.php 的插件头部注释下方添加以下代码

function my_first_plugin_add_footer_text() {
    echo '<p style="text-align: center;">İlk eklentimi kullandığınız için teşekkür ederim!</p>';
}
add_action( 'wp_footer', 'my_first_plugin_add_footer_text' );

Eklentiyi aktive ettikten sonra, web sitesinin ön yüzüne girdiğinizde, sayfanın alt kısmında eklenen metni göreceksiniz.add_action()Fonksiyon, bizim özelleştirdiğimiz şeyi kullanır.my_first_plugin_add_footer_text“Mount” fonksiyonu, WordPress çekirdeğine entegre edilmiştir.wp_footerBu “eylem kancası” üzerinde… İşte WordPress eklentilerinin genişletme özelliklerinin temel çalışma şekillerinden biri bu.

Özüne İnme: Hook’lar ve Filtreler (Deep Dive: Hooks and Filters)

Kancaları (hooks) anlamak, WordPress eklenti geliştirmede ustalaşmanın anahtarıdır. Kancalar iki türe ayrılır: Eylemler (Actions) ve Filtreler (Filters).

Eylem Düğümleri (Actions)

Eylem kancaları, WordPress’in belirli zaman noktalarında kendi kodunuzu eklemenize olanak tanır. Örneğin, bir makale yayınlandıktan sonra, bir kullanıcı giriş yaptığında veya sayfa başlığı yüklendikten önce. Daha önce kullandığımız…wp_footerBu, bir eylem kancasıdır. Kullanılır.add_action()Bir fonksiyon, kendisini başka bir fonksiyona monte etmek için kullanılabilir.

// 示例：在文章内容顶部添加一个提示框
function add_disclaimer_to_content( $content ) {
    if ( is_single() ) {
        $disclaimer = '<div class="notice">Bu metin özgün içeriktir; yeniden yayımlanması durumunda kaynağın belirtilmesi gerekmektedir.</div>';
        $content = $disclaimer . $content;
    }
    return $content;
}
// 注意：这是一个过滤器示例，为了对比，下面会给出动作示例

Daha tipik bir eylem örneği, yönetim arayüzünde bir menü eklemektir:

function my_plugin_add_admin_menu() {
    add_menu_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 权限
        'my-plugin-settings', // 菜单slug
        'my_plugin_settings_page' // 用于显示页面内容的函数
    );
}
add_action( 'admin_menu', 'my_plugin_add_admin_menu' );

Filtre kancaları (Filters)

Filtre hook’ları, işlem sırasında iletilen verileri değiştirmenize olanak tanır. WordPress, verileri filtreler aracılığıyla iletir; fonksiyonunuz bu verileri değiştirebilir ve ardından geri gönderebilir.add_filter()İşlev.

// 示例：修改文章摘要的长度
function my_custom_excerpt_length( $length ) {
    return 30; // 将摘要字数改为30字
}
add_filter( 'excerpt_length', 'my_custom_excerpt_length' );

// 示例：修改“阅读更多”链接的文本
function my_custom_excerpt_more( $more ) {
    return '... <a href="/tr/' . get_permalink() . '/">Devam etmek için okuyun.</a>';
}
add_filter( 'excerpt_more', 'my_custom_excerpt_more' );

Eklenti Mimarisi Oluşturma: Güvenlik, Seçenekler ve Uluslararasılaştırma

Olgun bir eklentinin iyi bir mimariye sahip olması gerekir; bu, güvenli işleme, veri depolama ve uluslararasılaştırma desteğini içerir.

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.

Güvenlik İyi Uygulamaları

Tüm eklentilerin WordPress güvenlik standartlarına uyması gerekmektedir. En önemli prensipler şunlardır: Girdilerin doğrulanması, kodların dönüştürülmesi ve temizlenmesi; çıktıların da aynı şekilde dönüştürülmesidir.

• Doğrulama (Validation): Kullanıcı tarafından girilen verilerin beklenen formata uyup uymadığını kontrol etme işlemidir (örneğin, bir e-posta adresi veya sayı olup olmadığı). Bu işlem, veriler veritabanına kaydedilmeden önce gerçekleştirilir.
• Temizleme (Sanitization): Kullanıcı girişini temizleyin ve herhangi bir güvensiz veya istenmeyen karakteri kaldırın. WordPress, aşağıdakiler de dahil olmak üzere çok sayıda temizleme fonksiyonu sağlar:sanitize_text_field()。
• Kaçış (Escaping): Herhangi bir veriyi tarayıcıya (ön uç veya arka uç) çıkarmadan önce, XSS saldırılarını engellemek için kaçış yapılmalıdır.esc_html()、esc_attr()、esc_url()Ve diğer fonksiyonlar.

// 从表单接收一个标题，清理后保存，输出时转义
$user_input_title = $_POST['title']; // 不安全！
$clean_title = sanitize_text_field( $user_input_title ); // 清理
update_option( 'my_plugin_title', $clean_title ); // 保存

// ... 在另一个地方输出 ...
echo '<h2>'`. esc_html( get_option( 'my_plugin_title' ) ) `.'</h2>'; // Güvenli çıkış

Verileri OptionAPI kullanarak saklayın.

Basit ayarlar için, WordPress’in seçenek API’si verileri saklamanın en iyi yoludur. Tek bir adlandırılmış veriyi saklamak, almak ve güncellemek için güvenli ve basit bir yöntem sunar.

// 保存或更新一个选项
update_option( 'my_plugin_setting_1', 'some value' );

// 获取一个选项，如果不存在则返回默认值
$setting = get_option( 'my_plugin_setting_1', 'default value' );

// 删除一个选项
delete_option( 'my_plugin_setting_1' );

Birden fazla ilgili ayar için, veritabanı sorgularını azaltmak amacıyla bunların bir dizi olarak saklanması önerilir.

// 保存一组设置
$settings_array = array(
    'api_key' => '12345',
    'enable_feature' => true,
    'color_scheme' => 'blue'
);
update_option( 'my_plugin_settings', $settings_array );

// 获取设置数组
$saved_settings = get_option( 'my_plugin_settings' );
$api_key = $saved_settings['api_key'] ?? ''; // PHP 7+ 空合并运算符

Eklentilerin uluslararasılaştırılması (Plugin Internationalization)

Eklentinizin tüm dünyadaki kullanıcılar tarafından kullanılabilmesi için uluslararasılaştırma (i18n) şarttır. Bunun için, tüm kullanıcıya yönelik metin dizelerini WordPress’in çeviri fonksiyonları kullanarak işlemeniz gerekmektedir.

1. Kullanım__()、_e()、_x()Bu fonksiyonlar, string (dize) verilerini işlemek için kullanılır.
2. Eklentinin baş kısmındaki yorumlarda tanımlayın.Text Domain(Örneğin: my-first-plugin).
3. Poedit gibi araçlar kullanarak oluşturun..potŞablon dosyası, çevirmenlerin kullanımı için hazırlanmıştır..po和.moDosya.

// 在插件主文件中加载文本域
function my_plugin_load_textdomain() {
    load_plugin_textdomain( 'my-first-plugin', false, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );
}
add_action( 'plugins_loaded', 'my_plugin_load_textdomain' );

// 在代码中使用翻译函数
$greeting = __( 'Hello, world!', 'my-first-plugin' );
_e( 'This text will be echoed and is translatable.', 'my-first-plugin' );

Eklentinizi yayınlamak ve dağıtmak

Geliştirme işlemi tamamlandıktan sonra, eklentiyi başkalarının kullanımına sunmayı seçebilirsiniz. Kişisel kullanım veya müşterilere yönelik olarak, eklentiyi doğrudan ZIP dosyası olarak paketleyebilirsiniz. Ancak, eklentiyi resmi WordPress eklenti dizinine göndermek istiyorsanız daha sıkı kurallara uymanız 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.

Yayınlamaya hazırlanıyor.

Kodunuzun WordPress kodlama standartlarına uygun olduğundan, eksiksiz dokümantasyon içerdiğinden ve kapsamlı bir şekilde test edildiğinden emin olun. Bir tane oluşturun.readme.txtDosya, formatının WordPress.org’un gerekliliklerine uygun olması gerekmektedir; içinde eklentinin açıklaması, kurulum adımları, sık karşılaşılan sorunlar, güncelleme kayıtları vb. bilgiler bulunmalıdır. Bu, eklenti kataloğu sayfasının içerik kaynağıdır.

WordPress.org’a gönderin.

WordPress.org’da bir hesap oluşturun ve eklentinizi inceleme için gönderin. İnceleme ekibi, kodun güvenliğini, uygunluğunu ve diğer gereklilikleri kontrol edecektir.readme.txtDosyayı onayladıktan sonra, eklenti kodunu SVN aracılığıyla resmi depoya gönderebilirsiniz. Böylece dünya genelindeki kullanıcılar eklentinizi arayıp indirebilirler. Başarılı bir eklentiyi sürdürmek için sürekli güncellemeler yapmak, güvenlik açıklarını gidermek ve kullanıcı desteğine yanıt vermek gereklidir.

Özetle.

WordPress eklenti geliştirme, temel yapıyı (eklenti dosyaları, başlık bilgileri) anlamaktan başlayarak, çekirdek genişletme mekanizmalarını (eylemler ve filtreler) öğrenmeye, ve sonunda sağlam, güvenli ve uluslararasılaştırılabilir ürünler oluşturmaya (güvenlik uygulamaları, seçenek API’si, i18n) kadar ilerleyen bir süreçtir. En iyi uygulamalara uyarak ve WordPress’in sunduğu zengin API’leri kullanarak, geliştiriciler kişisel ihtiyaçları karşılamaktan küresel kullanıcılara hizmet vermeye kadar geniş bir yelpazede işlevsel ve stabil eklentiler oluşturabilirler. Eklentilerin canlılığını sürdürmenin anahtarı, topluluğun yeni standartlarını ve API’lerini sürekli olarak öğrenmektir.

Sıkça Sorulan Sorular.

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

Eklenti geliştirmek için sağlam bir PHP programlama temeline sahip olmanız gerekmektedir; çünkü eklenti geliştirme işlemleri esas olarak PHP kullanılarak yapılır. Aynı zamanda, ön uç görünümünü ve etkileşimini yönetmek için HTML, CSS ve JavaScript konularında temel bilgilere sahip olmanız önemlidir. MySQL veritabanının temel kavramlarına aşina olmanız da faydalı olacaktır; ancak WordPress’in API’si çoğu veritabanı işlemini zaten içinde barındırmaktadır. En önemlisi, WordPress’in makaleler, sayfalar, kategoriler, etiketler, kullanıcı rolleri gibi temel kavramlarını net bir şekilde anlamanızdır.

Action hook’ların ve Filter hook’ların temel farkı nedir?

Eylem kancaları, belirli bir zamanda “bir kod parçasını çalıştırmak” için kullanılır ve bir dönüş değeri beklemezler; esas olarak menü ekleme, e-posta gönderme, sayfa öğeleri ekleme gibi işlemleri tetiklemek için kullanılırlar. Filtre kancaları ise “aktarılan verileri değiştirmek” için kullanılır ve bir değer döndürmelidir (genellikle değiştirilmiş girdi değeridir); bu değer, metin içeriğini değiştirmek, yapılandırma parametrelerini ayarlamak, sorgu sonuçlarını filtrelemek gibi amaçlar için kullanılır. Kısacası, eylemler “bir şey yapmak” içindir, filtreler ise “bir şeyi değiştirmek” içindir.

WordPress eklentimizi nasıl hata ayıklarız?

Öncelikle, 'den emin olun.wp-config.phpDosyada etkinleştirildi.WP_DEBUG和WP_DEBUG_LOGBu, PHP hatalarını ve uyarılarını kaydedecektir.wp-content/debug.logDosyada bulunur, ancak ziyaretçilere gösterilmez. İkincisi, kullanım…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ı IDE ile birlikte kullanarak kesme noktalarıyla hata ayıklaması yapabilirsiniz. Ayrıca, tarayıcı konsolundaki JavaScript hatalarını kontrol etmek de çok önemlidir.

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

Maksimum uyumluluk sağlamak için her zaman WordPress’in resmi API’lerini (örneğin Options API, Settings API, HTTP API) kullanmalı, özel PHP fonksiyonları tercih etmemelisiniz. Fonksiyonlarınızın, sınıflarınızın ve seçenek adlarının önüne benzersiz bir önek ekleyin; örneğin:myplugin_Aksine, genel kullanıma yönelik değil.get_data()Ad çakışmalarını önlemek için… Kancaları eklerken, öncelik parametrelerini mantıklı bir şekilde ayarlayın ve yürütme sırasının beklentilere uygun olduğundan emin olun. Küresel değişkenleri dikkatli bir şekilde değiştirin ve diğer geliştiricilerin eklentinizin varsayılan davranışlarını değiştirmesine izin veren filtreler sağlamayı düşünün.