WordPress Eklenti Geliştirme: Başlangıçtan Uzmanlığa – İlk Özel Eklentinizi Oluşturun

Neden eklentiler WordPress ekosisteminin çekirdeğidir?

WordPress’in güçlü genişletilebilirliği, büyük ölçüde eklenti sistemine bağlıdır. Eklentiler, geliştiricilere WordPress’in çekirdek kodunu değiştirmeden web sitelerine her türlü özellik eklemelerine olanak tanır; bunlar arasında basit iletişim formlarından karmaşık e-ticaret sistemlerine kadar birçok şey bulunur. Eklenti geliştirmeyi anlamak, her türlü ihtiyaca uygun bir WordPress sitesi oluşturmanın anahtarını elde etmek anlamına gelir. Eklentiler, “kurulumdan ziyade standartların tercih edilmesi” ilkesine göre çalışır ve çekirdek kodla etkileşim kurmak için belirli yaşam döngüsü işlemleri (life cycle hooks) kullanır.

Standart bir eklenti, esasen bir veya daha fazla belirli bir yerde bulunan bileşenden oluşur./wp-content/plugins/Katalogdaki PHP dosyalarının, WordPress’e bu eklentiyi tanıtmak için belirli bir eklenti başlık yorumunu içermesi gerekmektedir. Bu modüler tasarım, işlevlerin ayrılmasını ve sistemin stabilitesini sağlar; böylece eklentilerin etkinleştirilmesi, devre dışı bırakılması ve kaldırılması güvenli ve kontrol edilebilir hale gelir.

İlk eklentinizi oluşturun: Temel yapı

Bir eklenti oluşturmak için öncelikle temel dosyalarını ve yapısını oluşturmanız gerekmektedir. Bu sadece kod yazmakla kalmaz; aynı zamanda eklentinin gelecekteki bakımı ve genişletilmesi için de temel oluşturur.

Tavsiye edilen okuma WordPress Eklenti Geliştirmeyi Sıfırdan Öğrenin: Özel Özellikler Oluşturun ve Verimli Bir Şekilde Kazanç Elde Edin。

Öncelikle, yerel WordPress geliştirme ortamınızda…/wp-content/plugins/Dizin içinde, yeni bir klasör oluşturun. Klasör adı, eklentinin işlevlerini açıklayan ve küçük harflerden oluşan, benzersiz bir İngilizce ifade olmalıdır. Örneğin:my-first-greeting-pluginBu klasör içinde, genellikle klasör adıyla aynı olan bir ana PHP dosyası oluşturun. Örneğin:my-first-greeting-plugin.php。

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 Bilgileri Başlık Beyanı

Eklentinin ana dosyası, WordPress’in eklentiyi tanımasının anahtarı olan belirli bir yorum bloğu ile başlamalıdır. Aşağıdaki kodu ana PHP dosyanıza ekleyin:

<?php
/**
 * Plugin Name:       我的第一个问候插件
 * Plugin URI:        https://example.com/my-greeting-plugin
 * Description:       这是一个演示插件，用于在网站页脚添加一句自定义问候语。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-greeting-plugin
 * Domain Path:       /languages
 */

Bu yorum, eklentinin WordPress arka planındaki “Eklentiler” sayfasında görüntülenen tüm bilgileri tanımlamaktadır.Plugin NameBu bir zorunlu alandır; diğerleri ise isteğe bağlıdır. Dosyayı kaydettikten sonra, bu yeni eklentiyi WordPress arka uçundaki eklentiler listesinde görebilir ve diğer eklentiler gibi “etkinleştirebilirsiniz.”

Eylem kancalarını kullanarak işlevler ekleyin.

Eklenti etkinleştirildikten sonra, şu an için hiçbir şey yapmaz. Eklentinin işlev görmesini sağlamak için WordPress’in “Kancaları (Hooks)” kullanmamız gerekiyor. Kancalar “Eylem (Action)” ve “Filtre (Filter)” olarak ikiye ayrılır. Eylemler, belirli zaman noktalarında (örneğin sayfa yüklendiğinde, makale yayınlandığında) özel kodları çalıştırmanıza olanak tanır.

Sayfanın alt kısmına bir selam mesajı ekleyin.

Yaygın bir ihtiyaç, web sitesinin alt kısmına (footer bölümüne) içerik eklemektir. WordPress bunu sağlar.wp_footerBu eylem kancası; özelleştirilmiş fonksiyonları bu kancaya “bağlayabiliriz” (yani bu kancanın işlevlerini kullanarak özelleştirilmiş fonksiyonları çalıştırabiliriz).

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

Ana PHP dosyasının baş kısmındaki yorumların hemen altına aşağıdaki kodu ekleyin:

// 声明一个自定义函数，用于输出问候语
function my_greeting_display() {
    echo '<p style="text-align: center; color: #666; padding: 10px;">Merhaba, dünya! İlk WordPress eklentimizi kullanmaya hoş geldiniz.</p>';
}
// 使用 add_action 函数将我们的自定义函数挂载到 wp_footer 钩子上
add_action( 'wp_footer', 'my_greeting_display' );

add_actionFonksiyonlar, özel kodu WordPress çekirdeğiyle bağlayan bir köprüdür. İlk parametre, hook (düğüm) adıdır.‘wp_footer’İkinci parametre, bizim tanımladığımız fonksiyon adıdır.‘my_greeting_display’Dosyayı kaydedip web sitesinin ön yüzünü yenilediğinizde, sayfanın alt kısmında bu selamlaşma metnini göreceksiniz.

Filtrelerin kullanılması esnekliği artırır.

Eylem kancaları bize “bir şeyler yapma” imkanı verirken, filtre kancaları bize “verileri değiştirme” imkanı sunar. Bu kancalar, verilerin tarayıcıya gönderilmeden veya kullanılmadan önce değiştirilmesine olanak tanır. Bu özellik, eklentilerin daha esnek ve yapılandırılabilir hale gelmesini 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.

Makale başlığını değiştirme örneği

Diyelim ki tüm makale başlıklarının önüne otomatik olarak “【Tavsiye】” ifadesini eklemek istiyoruz. Bunu yapmak için şu yöntemleri kullanabiliriz:the_titleFiltreler.

Eklentinizin ana dosyasına aşağıdaki yeni fonksiyonu ve filtreleri ekleyin:

// 声明一个函数，用于修改文章标题
function my_prefix_post_title( $title, $post_id = null ) {
    // 确保只在主循环且是文章页面添加前缀
    if ( is_single() && in_the_loop() ) {
        $title = '【推荐】' . $title;
    }
    // 必须返回修改后的值
    return $title;
}
// 使用 add_filter 函数，挂载到 the_title 过滤器
add_filter( 'the_title', 'my_prefix_post_title', 10, 2 );

add_filterÜçüncü parametre10Öncelik meselesi; sayı ne kadar küçükse, işlem o kadar önce gerçekleşir. Dördüncü parametre…2“Bir fonksiyona aktarıldığını belirtir”my_prefix_post_titleFiltre fonksiyonunun döndürdüğü parametre sayısı önemlidir. Filtre fonksiyonu, sadece girdiyi çıkarmak yerine, değiştirilmiş değeri de döndürmelidir. Bu sayede kodunuz diğer eklentilerin veya temaların filtrelerle zincirleme olarak çalışmasına olanak tanır.

Tavsiye edilen okuma WordPress eklenti geliştirmeye hakim olmak: Sıfırdan bire özel özellikler oluşturmak.。

Eklenti Yönetim Sayfası Oluşturma

Eklentinin kullanıcı tarafından yapılandırılabilir bazı seçeneklere ihtiyacı olduğunda, bunlar için bir arka uç yönetim sayfası oluşturmamız gerekmektedir. Bu, WordPress’in yönetim menüsü API’sini kullanarak gerçekleştirilir.

Yönetim arayüzüne ayar sayfası ekleyin.

WordPress arayüzünün sol kenar çubuğuna basit bir üst düzey menü ekleyeceğiz.

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.

Eklentinin ana dosyasına aşağıdaki kodu eklemeye devam edin:

// 注册管理菜单
function my_greeting_add_admin_menu() {
    add_menu_page(
        '问候插件设置',       // 页面标题
        '问候插件',           // 菜单标题
        'manage_options',     // 权限（管理员）
        'my-greeting-plugin', // 菜单slug
        'my_greeting_admin_page', // 回调函数，用于显示页面内容
        'dashicons-admin-generic', // 菜单图标（WordPress Dashicons）
        80                    // 菜单位置
    );
}
add_action( 'admin_menu', 'my_greeting_add_admin_menu' );

// 定义设置页面的HTML内容
function my_greeting_admin_page() {
    // 安全检查
    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( 'my_greeting_options' );
            do_settings_sections( 'my-greeting-plugin' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="tr"/></form>
        <p>İlk eklentimin ayar sayfasına hoş geldiniz. Daha sonra buraya daha fazla seçenek ekleyebilirsiniz.</p>
    </div>
    &lt;?php
}

add_menu_pageFonksiyonlar, üst düzey menülerin oluşturulmasında temel bir rol oynar. Değişiklikleri kaydettikten sonra, WordPress arayüzüne yönetici olarak giriş yapın; sol tarafta “Selamlaşma Eklentisi” adında yeni bir menü öğesi göreceksiniz. Buna tıkladığınızda, tanımladığımız temel ayarlar sayfasına ulaşırsınız. Bu, daha karmaşık eklentiler oluşturmak için atılan ilk adımdır; ileride bu sayfada ayar alanları, form kaydetme gibi işlevleri entegre edebilirsiniz.

Özetle.

Basit bir selamlaşma eklentisi oluşturarak, WordPress eklenti geliştirmenin temel adımlarını takip ettik: Temel dosyaları ve başlık bilgilerini oluşturmaktan başlayarak, ardından bunları kullanarak…add_actionKancalar, belirli bir pozisyonda kodu çalıştırır ve ardından devam ederler.add_filterÇıktı içeriğini değiştirerek, son olarak eklentiye arka plan ayar arayüzü eklemek için yönetim menüsü API’sini kullanın. Bu dört temel unsur – dosya yapısı, eylem düğümleri, filtre düğümleri ve yönetim arayüzü – neredeyse tüm WordPress eklentilerinin temelini oluşturur. Bu kavramları anlamak ve ustaca kullanmak, başlangıç aşamasından uzmanlığa doğru bir adım atmanızı sağlar; böylece daha karmaşık ve daha güçlü özelliklere sahip özel araçlar oluşturmaya başlayabilir ve WordPress’in tüm potansiyelini gerçekten ortaya çıkarabilirsiniz.

Sıkça Sorulan Sorular.

###: Bir eklentinin en küçük yapısı nedir?
Bir eklenti yalnızca bir adet bağımsız PHP dosyasına sahip olabilir. Yeter ki bu dosya geçerli bir WordPress eklenti başlık yorumunu (yani…) içersin.Plugin Name…) ve bunu şu yere yerleştirin:/wp-content/plugins/WordPress, bir dizinin veya alt dizinlerinin içinde bulunan dosyaları tanıyabilir ve bunları listeleyebilir. Elbette, karmaşık eklentiler genellikle kodun bakımını kolaylaştırmak için kodu birden fazla dosya ve alt dizinde düzenlerler.

Aksiyon hook’larının ve filtre hook’larının temel farkı nedir?

Eylem kancaları, belirli bir zamanda “bir işlem yapmak” için kullanılır ve fonksiyonunuzdan bir dönüş değeri beklememektedir; asıl amacı belirli bir kod parçasını çalıştırmaktır. Filtre kancaları ise “verileri değiştirmek” için kullanılır ve fonksiyonunuzun mutlaka bir değer döndürmesi gerekmektedir (genellikle değiştirilmiş girdi değeri); böylece veriler filtreleme zincirinde ilerleyebilir. Kısacası, eylemler bir şey yapmak içindir, filtreler ise bir şeyi değiştirmek içindir.

Eklenti kodumun diğer eklentilerle çakışmamasını nasıl sağlayabilirim?

Fonksiyon adları, sınıf adları veya sabit adları arasında çakışmaları önlemek için en iyi uygulama, ad alanları (tavsiye edilir) kullanmaktır veya tüm tanımlayıcılara benzersiz bir önek eklemektir. Örneğin, bu makaledeki örneklerdeki tüm fonksiyonlar için bu yöntem uygulanmıştır.my_或my_greeting_Bir önek olarak… PHP 5.3’ten itibaren, ad alanlarının kullanılması daha modern ve kapsamlı bir yaklaşımdır.

Eklentiler geliştirirken nasıl hata ayıklama (debugging) yapılır?

Öncelikle, emin olun ki sizin…wp-config.phpDosyada etkinleştirildi.WP_DEBUG：define( ‘WP_DEBUG’, true );Kullanmakerror_log()Fonksiyon, hata ayıklama bilgilerini sunucunun hata günlüğüne yazar. Değişken kontrolü için ise belirli araçlar veya yöntemler kullanılabilir.print_r()或var_dump()Birleştirmekwp_die()Sayfada güvenli bir şekilde görüntülenmelidir. Ayrıca, Query Monitor gibi geliştirici eklentileri kullanmak hata ayıklama verimliliğini büyük ölçüde artırabilir.