Başlangıçtan Uzmanlığa: WordPress Eklenti Geliştirme Kapsamlı Rehberi

WordPress Eklenti Geliştirme Temelleri ve Ortam Kurulumu

WordPress eklenti geliştirmeye başlamak için öncelikle temel kavramları anlamanız ve standart bir geliştirme ortamı oluşturmanız gerekmektedir. Bir WordPress eklentisi, esasen bir veya daha fazla PHP dosyasından oluşur ve bu dosyalar WordPress’in belirli işlevlerini genişletmek veya yeni özellikler eklemek için kullanılır./wp-content/plugins/Katalogda, belirli bir dosya başlığı (Plugin Header) aracılığıyla WordPress’e varlığınız bildirilir. Bu sadece kodla ilgili değil; aynı zamanda WordPress’in tasarım felsefesine nasıl uyulacağı ve bu sayede WordPress’in çekirdeği ile diğer eklentilerle sorunsuz bir şekilde entegre edilebileceğiyle de ilgilidir.

Geliştirme ortamı, verimli bir çalışmanın başlangıç noktasıdır. Geliştirme işlemleri için çevrimiçi üretim siteleri yerine, yerel bilgisayarda bağımsız bir WordPress kurulumu yapılması şiddetle önerilir. MAMP, XAMPP gibi yerel sunucu paketleri kullanılabilir; veya Local by Flywheel, Docker gibi daha modern araçlar da daha esnek bir çözüm sunar. Ayrıca, Visual Studio Code, PHPStorm gibi bir kod editörü veya entegre geliştirme ortamı (IDE) kurmak da çok önemlidir. Bu araçlar, sözdizimi vurgulama, kod önerileri ve hata ayıklama gibi özellikler sunarak geliştirme verimliliğini önemli ölçüde artırır.

Yeni bir eklenti oluşturmanın adımları çok basittir. Giriş yapın…/wp-content/plugins/“Katalog” bölümünde, yeni bir klasör oluşturun. Klasör adı olarak tamamen küçük harfler ve alt çizgiler kullanmak en iyisidir; örneğin: “my_new_folder”.my-first-pluginDaha sonra, bu klasörün altında ana PHP dosyasını oluşturun; bu dosya genellikle klasörün adıyla aynı adı taşır, örneğin:my-first-plugin.phpBu dosyanın başında belirli bir yorum bloğu (dosya başlığı) bulunmalıdır; bu, eklentinin “kimlik kartı”dır.

Tavsiye edilen okuma Sıfırdan Bir: WordPress Eklenti Geliştirme Kapsamlı Rehberi ve Pratik Eğitim Kursu。

<?php
/**
 * Plugin Name: 我的第一个插件
 * Plugin URI:  https://example.com/my-first-plugin
 * Description: 这是一个用于演示的简单WordPress插件。
 * Version:     1.0.0
 * Author:      插件作者
 * Author URI:  https://example.com
 * License:     GPL v2 or later
 * Text Domain: my-first-plugin
 */

Dosyayı kaydettikten sonra, WordPress arayüzüne giriş yapın ve “Eklentiler” menüsüne gidin. Yeni eklenen eklentiyi eklenti listesinde görmelisiniz ve onu etkinleştirebilir veya devre dışı bırakabilirsiniz. Böylece en temel geliştirme ortamı ve bir eklenti çerçevesi oluşturulmuş olur.

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 dosya yapısı ve çekirdek bileşenler

Yapısı net ve iyi organize edilmiş bir eklenti projesi, uzun süreli bakımın temel taşıdır. Ana dosya (dosya başlıklarını içeren dosya) dışında, işlevsel olarak tam bir eklenti genellikle birçok bileşenden oluşur.

Ana eklenti dosyası (örneğin…)my-first-plugin.phpBu, bir eklentinin giriş noktasıdır ve genellikle diğer dosyaların yüklenmesinden, küresel sabitlerin tanımlanmasından, kancaların (Hooks) kaydedilmesinden ve diğer başlangıç işlemlerinden sorumludur. İşlevler arttıkça, tüm kodun ana dosyada toplanmaması gerekir. Farklı işlevlere sahip kodların modüler hale getirilerek farklı alt dizinlerde saklanması önerilir. Örneğin,/includes/Katalog, temel işlev sınıflarını ve fonksiyon dosyalarını içerir./admin/Katalog, arka plan yönetimi ile ilgili kodları ve sayfaları içerir./public/或/frontend/Katalog, ön yüzde (frontend) kullanılan gösterim mantığını (display logic) içerir./assets/Katalog, JavaScript, CSS ve resimler gibi statik kaynakları içerir.

WordPress eklentilerinin temel itici gücü, “Kancalar” (Hooks) sistemidir ve bu sistem iki türe ayrılır: Eylemler (Actions) ve Filtreler (Filters). Eylem kancaları, belirli bir olay meydana geldiğinde özelleştirdiğiniz fonksiyonları çalıştırır ve “bir şey yapmak” için kullanılır; örneğin…init、wp_head或save_postFiltre kancaları, “belirli bir veriyi değiştirmek” için kullanılır; bu sayede veriler kullanılmadan önce üzerinde değişiklikler yapmanıza olanak tanır. Örneğin…the_content、wp_title或excerpt_length。

Eklenti geliştirmenin kritik adımlarından biri, işlem yapacak fonksiyonları kaydetmek ve yazmaktır. Bu genellikle eklentinin ana dosyasında yapılır. Bunun için gerekli araçları kullanmanız gerekecektir.add_action()或add_filter()Bu fonksiyon, WordPress’e belirli bir kancanın tetiklendiğinde hangi fonksiyonunuzun çağrılması gerektiğini bildirir.

Tavsiye edilen okuma WooCommerce eklenti geliştirme rehberi: özel e-ticaret eklentileri oluşturmanın temellerinden ileri düzeye kadar.。

// 添加一个动作钩子，在文章内容后追加一段文字
function mfp_add_text_to_content( $content ) {
    // 仅对主循环中的文章内容生效
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $custom_text = '<p><em>Bu metin “Benim İlk Eklentim” tarafından eklenmiştir.</em></p>';
        $content .= $custom_text;
    }
    return $content;
}
// 使用 add_filter 将我们的函数挂载到 ‘the_content‘ 过滤器上
add_filter( 'the_content', 'mfp_add_text_to_content' );

“Eklenti Arka Plan Ayarları Sayfası Oluşturma”

Eklentiniz için bir yapılandırma sayfası sağlamak, kullanıcı dostu bir eklenti oluşturmanın anahtarıdır. Bu sayede web site yöneticileri, kodu değiştirmeden eklentinin davranışlarını veya ayarlarını kolayca ayarlayabilirler.

WordPress, farklı seviyelerde yönetim sayfaları oluşturmak için birçok fonksiyon sunar. En yaygın kullanılan yöntemlerden biri…add_menu_page()Bu fonksiyon, yönetim kenar çubuğuna bir üst düzey menü öğesi ve ilgili sayfayı ekler.add_submenu_page()Mevcut üst düzey menülerin (örneğin “Ayarlar” veya “Araçlar”) altına alt sayfalar ekleyin.

Arka plan seçenekler sayfasının özü, kullanıcı tarafından girilen bilgilerle olan etkileşimdedir. Genellikle, sayfa bir formdan oluşur ve form verileri gönderildikten sonra, eklentinin bu verileri güvenli bir şekilde alması, doğrulaması ve veritabanına kaydetmesi gerekir. WordPress, bunun için belirli yöntemlerin kullanılmasını önerir.options Bu tür verileri işlemek için bir API kullanılır ve bu API gerekli olan özellikleri ve fonksiyonları sağlar.register_setting()、add_settings_section()和add_settings_field()Bu tür fonksiyonlar, güvenlik doğrulamalarını (Nonce kontrolü, yetki kontrolü vb.) ve veri depolamayı otomatik olarak gerçekleştirerek süreci büyük ölçüde basitleştirir.

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.

Aşağıda, basit bir ayar sayfası oluşturmak için kullanılabilecek bir çerçeve örneği bulunmaktadır:

// 步骤1: 在后台菜单注册一个选项页面
function mfp_register_options_page() {
    add_options_page(
        '我的插件设置',       // 页面标题
        '我的插件',           // 菜单标题
        'manage_options',    // 权限要求
        'mfp-options',       // 页面slug
        'mfp_options_page_html' // 用于输出页面HTML的回调函数
    );
}
add_action('admin_menu', 'mfp_register_options_page');

// 步骤2: 定义输出页面HTML的回调函数
function mfp_options_page_html() {
    // 权限检查
    if (!current_user_can('manage_options')) {
        return;
    }
    ?>
    <div class="wrap">
        <h1><?php echo esc_html(get_admin_page_title()); ?></h1>
        <form action="/tr/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            settings_fields('mfp_options_group'); // 输出安全字段
            do_settings_sections('mfp-options');  // 输出设置区域
            submit_button('保存设置');
            ?>
        <input type="hidden" name="trp-form-language" value="tr"/></form>
    </div>
    'mfp_custom_message']
    );
}
add_action('admin_init', 'mfp_settings_init');

// 步骤4: 定义字段HTML的回调
function mfp_field_message_html() {
    $value = get_option('mfp_custom_message', '默认消息');
    ?&gt;
    <input type='text' id='mfp_custom_message' name='mfp_custom_message' value='<?php echo esc_attr($value); ?>' class='regular-text'>
    &lt;?php
}

Eklentilerin Güvenliği ve En İyi Uygulamalar

Bir eklenti yayınlamak sadece işlevleri yerine getirmekle kalmaz; aynı zamanda güvenliği, stabilitesi ve uyumluluğunu da sağlamak gerekir. Güvenli kodlama standartlarına uymak, hem kendinizi hem de kullanıcıların web sitelerini korumanın ilk adımıdır.

Öncelikle, kullanıcılardan veya üçüncü taraflardan alınan tüm veriler güvenilmez olarak kabul edilmelidir. Bu, verilerin tarayıcıya (HTML, JavaScript), veritabanı sorguları için veya dosya sistemi işlemleri için çıkarılmadan önce uygun şekilde dönüştürülmesi, doğrulanması ve temizlenmesi gerektiği anlamına gelir. WordPress, bu amaçla birçok güvenlik fonksiyonu sunmaktadır.esc_html()、esc_attr()、esc_url()Çıkış için kullanılır;sanitize_text_field()、sanitize_email()Dezenfeksiyon için kullanılır;wp_kses()İzin verilen HTML etiketlerini filtrelemek için kullanılır.

Tavsiye edilen okuma WordPress eklenti geliştirmeye yeni başlayanlar için bir rehber: ilk işlevsel eklentinizi sıfırdan oluşturma.。

İkincisi, form gönderimleri veya AJAX istekleri işlenirken, çapraz sitelik istek sahteciliği (CSRF) saldırılarını önlemek için WordPress’in Nonce (Özel Sayı) mekanizmasının kullanılması gerekmektedir. Ayrıca…current_user_can()Fonksiyon, katı bir yetki kontrolü yapar.

Veritabanı ile etkileşimler mümkün olduğunca WordPress’in veritabanı sınıfları kullanılarak gerçekleştirilmelidir.$wpdbSunulan yöntemler doğrultusunda, SQL sorgularındaki değişkenler her zaman `prepare` ifadesi kullanılarak işlenmelidir; bu, SQL enjeksiyonlarını önlemek için gereklidir.

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.

global $wpdb;
$user_input = $_POST['search'];
$safe_input = $wpdb->esc_like($user_input); // 转义LIKE语句中的特殊字符
$prepared_sql = $wpdb->prepare(
    "SELECT * FROM {$wpdb->posts} WHERE post_title LIKE %s",
    '%' . $safe_input . '%'
);
$results = $wpdb->get_results($prepared_sql);

En iyi uygulamalar açısından, eklentinin fonksiyonları, sınıfları ve seçenek adlarına benzersiz bir önek eklenmesi önerilir (örneğin:mfp_Bu, konuyla, diğer eklentilerle veya WordPress çekirdeğiyle isim çatışmalarını önlemek içindir. Nesne yönelimli programlamanın (OOP) mantıklı bir şekilde kullanılması, kodun daha iyi organize edilmesini, kapsülleme ve yeniden kullanımın sağlanmasını sağlar. Ayrıca, eklentilerin uluslararasılaştırılmasını da düşünmek önemlidir; bunun için uygun araçlar kullanılmalıdır.__()、_e()Bu fonksiyonlar, tüm kullanıcı tarafından görülebilen metinleri kapsar ve hook’lar (düğümler) için gerekli işlemleri gerçekleştirir.plugins_loadedYükleme sırasında metin alanını hazırlayan bir başlatma fonksiyonu oluşturun; bu, ileride eklentiyi diğer dillere kolayca çevirmenizi sağlayacaktır.

Özetle.

WordPress eklenti geliştirme, yaratıcılığı yeniden kullanılabilir işlevlere dönüştürme sürecidir. Bu süreç, geliştiricilerin sadece PHP’yi iyi bilmelerini değil, aynı zamanda WordPress’in temel yapısını, özellikle de güçlü eklenti sistemi olan “hook” (kancalar) sistemini derinlemesine anlamalarını gerektirir. Basit bir eklenti klasörü ve tanımlama dosyası oluşturmakla başlayarak, işlevleri genişletmek için eylem (action) ve filtre (filter) hook’larını ustaca kullanmaya, ve son olarak kullanıcı dostu bir arka uç yönetim arayüzü oluşturmaya kadar her adım, güçlü bir eklenti geliştirmek için gereklidir.

Daha da önemlisi, tüm geliştirme süreci boyunca güvenliği en üstte tutmak ve veri doğrulama, çıktı escape işlemleri, yetki kontrolü ve SQL enjeksiyonu önleme gibi güvenlik ilkelerine uymak gerekmektedir. Modüler bir dosya yapısı, net adlandırma kuralları ve uluslararasılaştırma hazırlıkları gibi en iyi uygulamaları benimsemek, eklenti kodunun sürdürülebilirliğini, genişletilebilirliğini ve profesyonelliğini sağlar.

Sıkça Sorulan Sorular.

###: WordPress eklentisi geliştirmek için hangi ön bilgilere ihtiyaç vardır?
WordPress eklentisi geliştirmek için PHP programlama dilinin temel bilgilerine sahip olmak gerekmektedir; çünkü eklenti kodlarının büyük bir kısmı PHP ile yazılmaktadır. Aynı zamanda, ön ve arka uç arayüzlerinin oluşturulması için HTML, CSS ve JavaScript konularında temel bir bilgiye sahip olmak önemlidir. En önemlisi, WordPress’in temel kavramlarına aşina olmak gerekmektedir; örneğin Hook’lar (Eklentilerin WordPress sistemine entegre olmasını sağlayan mekanizmalar), Kısa Kodlar (Shortcodes), Özel Makale Türleri (Custom Post Types) ve Seçenek API’si (Options API). Bunlar, eklentilerin WordPress ile etkileşim kurmasını sağlayan araçlardır.

WordPress eklenti kodumu nasıl hata ayıklarım?

Hata ayıklama, geliştirme sürecinin kritik bir aşamasıdır. Öncelikle, yerel geliştirme ortamında çalışmanızı öneririm.wp-config.phpDosyada etkinleştirildi.WP_DEBUGBu mod, PHP hatalarını, uyarılarını ve bildirimlerini görüntüleyebilir. Query Monitor veya Debug Bar gibi özel hata ayıklama eklentileri de kurulup yapılandırılabilir; bu eklentiler veritabanı sorguları, fonksiyonların çalışma şekli ve performans analizi gibi ayrıntılı bilgiler sağlar. Karmaşık mantık sorunları için Xdebug gibi profesyonel hata ayıklayıcılar, IDE ile birlikte kullanılarak kesme noktaları aracılığıyla hata ayıklaması yapılabilir. Ayrıca, WordPress ve PHP’nin hata günlüklerini incelemek de sorunları tespit etmede etkili bir yöntemdir.

Eklenti geliştirildikten sonra, nasıl dağıtılır veya bir platforma yüklenir?

Kişisel kullanım veya küçük çaplı dağıtım için olan eklentiler, doğrudan ZIP dosyası olarak paketlenebilir ve WordPress arayüzü üzerinden yüklenerek kurulabilir. Eklentinizi resmi WordPress eklenti kataloğuna göndermek ve böylece dünya çapındaki kullanıcılar tarafından aranıp indirilebilir hale getirmek istiyorsanız, WordPress.org adresini ziyaret etmeniz, bir geliştirici hesabı oluşturmanız ve eklenti kodunuzu inceleme için göndermeniz gerekmektedir. İnceleme sürecinde kod kalitesi, güvenliği ve katalog kurallarına uygunluğu kontrol edilir. İncelemeden geçtikten sonra, eklenti sürümlerini barındırmak ve güncellemek için kullanabileceğiniz bir SVN deposu alırsınız.

Eklentimin farklı sürümlerdeki WordPress ile uyumlu olmasını nasıl sağlayabilirim?

Maksimum uyumluluğu sağlamak için geliştiriciler, WordPress’in resmi olarak belirlediği en düşük PHP sürüm gereksinimlerine dikkat etmeli ve mümkün olduğunca kendi eklentilerinin kodlarında eski PHP sözdizimi özelliklerini kullanmalıdır (aynı zamanda modern PHP özelliklerinden de yararlanarak sorunsuz bir geçiş yapmalıdırlar). Eklentinin ana dosyasının baş kısmında bunu gerçekleştirmek için şu kodu kullanabilirsiniz:Requires at least:和Tested up to:WordPress çekirdek sürümleri, belirli etiketlerin uyumluluğunu garanti eder. Farklı WordPress çekirdek sürümleri ve PHP ortamlarıyla düzenli olarak test yapmak şarttır. Kod değişikliklerini yönetmek için sürüm kontrol sistemleri (örneğin Git) kullanmak, sürüm yükseltmeleri nedeniyle ortaya çıkan sorunları kolayca takip etmenize ve düzeltmenize yardımcı olur.