WordPress Eklenti Geliştirme Kılavuzu: Sıfırdan Başlayarak Güçlü ve Özelleştirilebilir Eklentiler Oluşturmayı Öğrenin

WordPress Eklenti Geliştirme Ortamı ve Hazırlık İşlemleri

Herhangi bir kod yazmaya başlamadan önce, profesyonel ve verimli bir geliştirme ortamı oluşturmak başarının ilk adımıdır. Bu, sadece geliştirme verimliliğinizi artırmakla kalmaz, aynı zamanda kodun kalitesini ve sürdürülebilirliğini de garanti eder.

Yerel geliştirme ortamının kurulması

Yerel sunucu ortamlarını kullanmanız önerilir; örneğin Local by Flywheel, XAMPP veya Laragon. Bunlar, Apache/Nginx, MySQL ve PHP içeren bir WordPress çalışma ortamını bilgisayarınızda hızlı bir şekilde kurmanıza olanak tanır. Bunu yapmanın avantajı, çevrimiçi web sitenizi etkileme endişesi olmadan, bağımsız ve güvenli bir ortamda özgürce test ve hata ayıklama yapabilmenizdir.

Eklenti geliştirmek için gerekli araçlar

Sunucu ortamının yanı sıra, bir dizi araca da ihtiyacınız olacak. Güçlü bir kod editörü veya entegre geliştirme ortamı (IDE), örneğin Visual Studio Code veya PhpStorm, sözdizimi vurgulama, kod önerileri ve hata ayıklama özellikleri sunar. Ayrıca, kod değişikliklerini yönetmek ve takım çalışmalarını kolaylaştırmak için Git gibi sürüm kontrol sistemlerini bilmek ve kullanmak çok önemlidir. Son olarak, yerel PHP sürümünüzün hedef üretim ortamıyla uyumlu olduğundan emin olun; bu, sürüm farklılıklarından kaynaklanan uyumluluk sorunlarını önlemek için gereklidir.

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

Eklentinin temel yapısını anlamak.

Standart bir WordPress eklentisinin belirgin bir dosya ve kod organizasyon yapısı vardır. Bu yapıya uymak, sadece eklentinizin WordPress çekirdeği tarafından doğru bir şekilde tanınmasını ve yüklenmesini sağlamakla kalmaz; aynı zamanda resmi eklenti dizinine yüklenmesi için de temel bir gerekliliktir.

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 ana dosyasının yapısı

Her eklentinin bir ana dosyası olmalıdır. Bu dosya genellikle eklentinin adıyla adlandırılır, örneğin: my-awesome-plugin.phpBu dosyanın baş kısmında, WordPress’e eklentinizi tanıtmak için kullanılan belirli bir eklenti bilgisi yorum bloğu bulunmalıdır.

/**
 * Plugin Name:       我的强大插件
 * Plugin URI:        https://example.com/my-awesome-plugin
 * Description:       这是一个用于演示插件开发指南的强大定制插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-awesome-plugin
 */

Bu bilgi bloğunun ardından, eklentinin ana kodunu yazmaya başlayabilirsiniz. Tüm temel işlevler doğrudan bu dosyaya yazılabilir; ancak karmaşık eklentiler için kodun modüler hale getirilmesi daha tavsiye edilir.

Kod Düzeni ve Modülerleştirme

Kodun sürdürülebilirliğini sağlamak için modülerlik ilkesine uymak gerekir. Ana dosyanın yanı sıra, eklenti dizininiz aşağıdaki içerikleri de içerebilir:
* includes/ İçerik: Temel işlev sınıflarını veya fonksiyon dosyalarını depolamak için kullanılır.
* admin/ İçindekiler: Yalnızca arka plan yönetim arayüzüyle ilgili kodların saklanması için ayrılmıştır.
* public/ İçerik: Web sitesinin ön uç mantığını işleyen kodun depolandığı yer.
* assets/ İçerik: JavaScript, CSS ve resimler gibi statik kaynakları yerleştirmek için kullanılır.
* languages/ İçerik: Uluslararasılaştırılmış çeviri dosyalarının (.po/.mo) depolanması.
Bu yapı, kodun düzenli ve anlaşılır olmasını sağlar; bu da uzun vadeli bakım ve işlevsel genişletmeler için kolaylık sunar.

Çekirdek Geliştirme: Hook’lar ve API’ler

WordPress eklenti geliştirmenin temel felsefesi “Kancalar” (Hooks)“dır. Bu kancalar, kodunuzun belirli zaman noktalarında WordPress’in temel işleyişine dahil olmasına ve işlevlerin değiştirilmesine veya eklenmesine olanak tanır. İşte WordPress’in bu kadar esnek ve genişletilebilir olmasının temel taşı budur.

Tavsiye edilen okuma WordPress Eklenti Geliştirme Kılavuzu: Sıfırdan Başlayarak Yüksek Kaliteli WordPress Genişletmeleri Oluşturma。

Action Hook’ların Kullanımı

Eylem Kancaları (Action Hooks), WordPress tarafından belirli anlarda kendi kodunuzu çalıştırmanıza olanak tanır. Örneğin, bir makale yayınlandığında veya yönetim paneli menüsü başlatıldığında. Bunu kullanabilirsiniz. add_action() Bir fonksiyonu, belirli bir eylem kancasına (action hook) bağlamak için kullanılır.

function myplugin_send_notification_on_publish( $post_id ) {
    // 获取文章信息
    $post = get_post( $post_id );
    // 模拟发送邮件通知
    wp_mail( '[email protected]', '新文章已发布！', '文章标题：' . $post->post_title );
}
// 将函数挂载到 `publish_post` 这个动作钩子
add_action( 'publish_post', 'myplugin_send_notification_on_publish' );

Filtre kancalarının kullanımı

Filtre kancaları (Filter Hooks), verileri değiştirmek için kullanılır. Veriler kullanılmadan önce (örneğin veritabanına kaydedilmeden veya kullanıcılara gösterilmeden önce), filtreler aracılığıyla değerlerini değiştirebilirsiniz. Bu, add_filter() Bu, bir fonksiyon tarafından gerçekleştirilmiştir.

function myplugin_modify_excerpt_length( $length ) {
    // 将文章摘要的默认字数从55改为30
    return 30;
}
add_filter( 'excerpt_length', 'myplugin_modify_excerpt_length' );

Önemli Genel API Fonksiyonları

WordPress, kancaların yanı sıra, veritabanı üzerinde işlemler yapmak için kullanılabilecek birçok pratik API fonksiyonu da sunar. wpdb Sınıf, işlem seçenekleri… get_option() 和 update_option()Özel bir veri tablosu oluşturmak için… dbDelta() Fonksiyonlar vb. Bu API’leri ustaca kullanmak, verimli geliştirmenin anahtarıdır.

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.

Tam bir eklenti işlevselliği gerçekleştirin.

Yukarıdaki bilgileri bir gerçek örnek üzerinden birleştirerek, makale okuma süresini tahmin eden basit bir eklenti oluşturalım. Bu eklenti, makale içeriğinin önünde tahmini okuma süresini gösterecektir.

Bir eklenti çerçevesi ve ana dosya oluşturun.

Öncelikle, /wp-content/plugins/ Katalogda “” adında yeni bir klasör oluşturun. post-reading-timeBu klasör içinde, ana dosyayı oluşturun. post-reading-time.phpVe standart eklenti başlık bilgilerini doldurun.

Okuma süresini hesaplamak ve göstermek için kullanılan temel fonksiyon

Sonrasında, eklentinin ana dosyasına temel işlevleri ekleyin. Okuma süresini hesaplamak için bir fonksiyona ihtiyacımız var ve bu fonksiyonu sisteme entegre etmeliyiz. the_content Filtre üzerinde, makale içeriği görüntülenmeden önce bilgilerimizi ekleyebilelim.

Tavsiye edilen okuma WordPress Eklenti Geliştirme Kılavuzu: Başlangıçtan Profesyonel Seviye Genişletmelere。

function prt_calculate_reading_time( $content ) {
    // 1. 只有在单篇文章页面才生效
    if ( ! is_single() ) {
        return $content;
    }

// 2. 获取文章内容，去除短代码和HTML标签，计算字数
    $text_content = strip_shortcodes( wp_strip_all_tags( $content ) );
    $word_count   = str_word_count( $text_content );

// 3. 假设平均阅读速度为每分钟200字
    $reading_time = ceil( $word_count / 200 );

// 4. 生成显示HTML
    $reading_time_html = sprintf(
        '<div class="post-reading-time"><p><strong>Tahmini Okuma Süresi:</strong>Yaklaşık %d dakika</p></div>',
        $reading_time
    );

// 5. 将阅读时间信息放在文章内容之前
    return $reading_time_html . $content;
}
add_filter( 'the_content', 'prt_calculate_reading_time' );

Eklentiye basit bir stil ekleyin.

Görünümü daha estetik hale getirmek için biraz CSS ekleyebiliriz. İyi bir uygulama, stilleri sırayla yüklemektir (yani bir kuyruğa ekleyip sırayla işlemektir). wp_enqueue_style() Bu fonksiyon, stil şablonunun doğru bir şekilde yüklendiğinden ve diğer eklentilerle çakışmadığından emin olur.

function prt_enqueue_styles() {
    wp_enqueue_style(
        'prt-style',
        plugin_dir_url( __FILE__ ) . 'assets/css/prt-style.css', // 假设CSS文件路径
        array(), // 依赖
        '1.0.0' // 版本号
    );
}
add_action( 'wp_enqueue_scripts', 'prt_enqueue_styles' );

Sonra… assets/css/prt-style.css Dosyaya basit stiller ekleyin:

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.

.post-reading-time {
    background-color: #f0f8ff;
    border-left: 4px solid #3498db;
    padding: 10px 15px;
    margin-bottom: 20px;
    font-size: 0.95em;
}

Böylece, temel özelliklere sahip tam bir eklenti oluşturulmuş oldu. Eklentiyi aktive edebilir ve tek bir makale sayfasının üst kısmında estetik bir okuma süresi uyarısının görünüp görünmediğini kontrol edebilirsiniz.

Özetle.

WordPress eklenti geliştirme, yaratıcılığı güçlü özelliklere dönüştürme sürecidir. Profesyonel bir ortam oluşturarak, eklenti standart yapılarını anlayarak, Hook (Kancalar) mekanizmasını ve çekirdek API’yi derinlemesine öğrenerek, çeşitli özel eklentiler geliştirmek için gerekli temel yeteneklere sahip olursunuz. Bu makale, ortam hazırlığından kod yapısına, teorik temellerden pratik örneklerine kadar size net bir öğrenme yol haritası sunar. Önemli olan pratik yapmaktır; “Okuma Zamanı” gibi basit bir özellikle başlayarak, karmaşıklığı kademeli olarak artırın ve sonunda belirli ihtiyaçları karşılayan güçlü WordPress eklentileri geliştirebilecek seviyeye ulaşacaksınız.

Sıkça Sorulan Sorular.

Eklenti geliştirmek için PHP’yi iyi bilmek gerekiyor mu?

Evet, sağlam bir PHP temeli, WordPress eklenti geliştirmek için gereklidir. Çünkü WordPress çekirdeği ve eklentilerinin, temalarının büyük bir kısmı PHP ile yazılmıştır. Güvenli ve verimli eklenti kodları yazabilmek için değişkenler, fonksiyonlar, sınıflar, diziler, döngüler, koşullu ifadeler gibi PHP’nin temel sözdizimini ve nesne yönelimli programlamanın (OOP) temel kavramlarını anlamanız gerekir.

Geliştirdiğim eklentinin güvenli olduğundan nasıl emin olabilirim?

Eklentilerin güvenliğini sağlamak için çeşitli adımlar atılmalıdır. Öncelikle, tüm kullanıcı girdileri üzerinde sıkı bir doğrulama (validation), temizleme (cleaning) ve kaçınma (escaping) işlemi yapılmalıdır. Bunun için WordPress’in sunduğu fonksiyonlar kullanılabilir. sanitize_text_field(), esc_html(), wp_kses_post() İkincisi, veritabanı işlemleri gerçekleştirirken mutlaka uygun araçları ve yöntemleri kullanmalısınız. $wpdb Sınıfın metotları veya… prepare() SQL enjeksiyonunu önlemek için belirli kodlamalar kullanılmalıdır. Ayrıca, “en az yetki ilkesine” uymak önemlidir; yani eklentilere yalnızca işlevlerini yerine getirmek için gerekli olan yetkiler verilmelidir.

Geliştirdiğim eklenti, WordPress resmi kataloğuna yüklenebilir mi?

Tabii ki, ancak bir dizi katı kuralı karşılamanız gerekiyor. Eklenti kodunuz WordPress kodlama standartlarına uymalı, GNU GPL v2 veya daha yüksek bir lisans kullanmalı ve herhangi bir zararlı kod, ücretli bağlantı veya katalog yönergelerini ihlal eden içerik içermemelidir. Göndermeden önce, resmi eklenti geliştirme kılavuzunu ve gönderim rehberlerini dikkatlice okumanızı, ayrıca kapsamlı bir kendini kontrol ve test yapmanızı öneririz.

Eklentime nasıl bir yönetim ayarları sayfası ekleyebilirim?

Eklentilere ayar sayfaları eklemek genellikle WordPress’in “Menü Sayfaları API’si” kullanmayı gerektirir. Bunu yapabilirsiniz… add_menu_page() Bir fonksiyon kullanarak bir üst düzey menü öğesi oluşturabilirsiniz, veya başka bir yöntemle de bunu yapabilirsiniz. add_submenu_page() Mevcut menülerin (örneğin “Ayarlar”) altında alt sayfalar oluşturun. Ayarlar sayfasının geri çağırma fonksiyonunda, bir HTML formu oluşturmanız ve bunu kullanmanız gerekmektedir. settings API(Dahil olmak üzere) register_setting, add_settings_section, add_settings_field (Görevler, fonksiyonlar vb.) seçeneklerin kaydını, saklanmasını ve görüntülenmesini güvenli ve kolay bir şekilde gerçekleştirmek için kullanılır.