WordPress eklenti geliştirmeye başlama rehberi: İlk özel işlev modülünüzü sıfırdan oluşturun.

Neden özel eklentiler geliştirmeye ihtiyaç var?

WordPress ekosisteminde, eklentiler web sitesinin işlevlerini genişletmenin temelini oluşturur. Piyasada binlerce hazır eklenti bulunmasına rağmen, özel eklentiler geliştirmek benzersiz avantajlar sunar. İhtiyaçlarınız çok spesifik olduğunda veya mevcut eklentiler yetersiz veya verimsiz olduğunda, özel olarak tasarlanmış bir eklenti en iyi çözümdür. Özel eklentiler iş mantığınızla mükemmel bir uyum sağlar, birden fazla eklenti kullanımından kaynaklanabilecek çakışmaları önler ve genellikle çok fonksiyonlu eklentilerden daha iyi bir performans sunar. Daha da önemlisi, kendi eklentinizi geliştirerek kod kalitesini ve güvenliğini tamamen kontrol edebilirsiniz.

Öğrenme açısından bakıldığında, eklenti geliştirme mekanizmalarını anlamak, WordPress’ü derinlemesine kavramanın kaçınılmaz bir yoludur. Bu süreç, sizi bir “kullanıcıdan” bir “yaratıcıya” dönüştürür ve çeşitli özelleştirme ihtiyaçlarına daha esnek bir şekilde yanıt vermenizi sağlar; aynı zamanda gelecekteki ürün geliştirmeleri veya kariyeriniz için sağlam bir temel oluşturur.

Hazırlık çalışmaları: Geliştirme ortamının kurulması

Kod yazmaya başlamadan önce, stabil ve izole bir geliştirme ortamı çok önemlidir. Bu, sadece üretim sitenizi korumakla kalmaz, aynı zamanda test ve hata ayıklama işlemlerini de özgürce yapmanıza olanak tanır.

Yerel Geliştirme Ortamı Ayarları

Yerel sunucu yazılım paketlerini kullanmanız önerilir; örneğin Local by Flywheel, XAMPP veya MAMP. Bu araçlar, bilgisayarınızda bir ağ sunucusu ortamı (Apache/Nginx, MySQL, PHP) simüle ederek çevrimdışı geliştirme yapmanıza olanak tanır. Kurulum tamamlandıktan sonra, “kum havuzu” (sandbox) olarak kullanmak üzere yeni bir WordPress sitesi oluşturun.

Kod Düzenleyici Seçimi

Güçlü bir kod editörü, geliştirme verimliliğini büyük ölçüde artırabilir. Visual Studio Code, hafif, ücretsiz olması ve PHP ve WordPress için özel olarak tasarlanmış sözdizimi vurgulama, kod önerileri ve hata ayıklama araçları gibi zengin eklentilere sahip olması nedeniyle şu anda çok popüler bir seçenektir. PHPStorm ise daha derinlemesine kod analizi ve yeniden yapılandırma özellikleri sunan başka bir güçlü entegre geliştirme ortamıdır (IDE).

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.

\n

Eklenti Temel Dosya Yapısı

En basit WordPress eklentisi, yalnızca bir ana PHP dosyasından oluşabilir. Ancak standart eklentiler genellikle net bir dosya ve klasör yapısına sahiptir. Bu yapı, yerel WordPress kurulumunuzun dizinlerinde de bulunur. wp-content/plugins Dosya içinde, eklentiniz için yeni bir klasör oluşturun; örneğin: my-first-pluginBu klasör, eklentinin tüm dosyalarını barındıracak.

İlk eklentinizi “Hello Admin” adıyla oluşturun.”

“Hello Admin” adında bir eklenti oluşturacağız ve bu eklentinin işlevi çok basit: WordPress yönetim panelinin kontrol panelinin üst kısmında özelleştirilmiş bir hoş geldin mesajı göstermek. Bu örnek, eklenti geliştirmenin temel unsurlarını kapsıyor: ana dosya, kancalar (Hooks) ve temel fonksiyonlar.

Ana eklenti dosyasını oluşturun.

Sizin eklenti dizininizde… my-first-plugin İçeride, “” adında bir şey oluşturun. my-first-plugin.php Bu, bir eklentinin giriş dosyasıdır. Dosyayı açtığınızda, öncelikle dosyanın baş kısmına standart eklenti bilgilerini içeren açıklamalar ekleyin. Bu açıklamalar, WordPress’in eklentiyi tanıması için gereklidir.

<?php
/**
 * Plugin Name:       Hello Admin
 * Plugin URI:        https://yourwebsite.com/hello-admin
 * Description:       一个简单的插件，用于在管理后台显示欢迎信息。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       hello-admin
 */

Fonksiyonları eklemek için kancalar (hooks) kullanın.

WordPress’in temel mekanizması “Kancalar” (Hooks)“dır; bu mekanizma, belirli zaman noktalarında kendi kodunuzu eklemenize olanak tanır. Kancalar esas olarak iki türe ayrılır: Eylem Kancaları (Action Hooks) ve Filtre Kancaları (Filter Hooks). İçeriği yönetim panelinden çıkarmak için Eylem Kancaları’nı kullanmamız gerekmektedir.

WordPress, yönetim arayüzünün üst kısmını yüklerken, “” adında bir özellik sunar. admin_notices Eylem kancaları (action hooks). Bunları kullanarak… add_action() Fonksiyon, özel fonksiyonumuzu bu kancaya (hook) bağlar.

Ana dosyanın yorumlarının altına aşağıdaki kodu ekleyin:

// 钩子函数：在管理后台显示通知
function hello_admin_display_message() {
    // 确保只对管理员显示，使用 current_user_can() 检查权限
    if ( current_user_can( 'manage_options' ) ) {
        echo '<div class="notice notice-success is-dismissible"><p>Hoş geldiniz, yönetici! Bu, sizin özelleştirdiğiniz “Hello Admin” eklentisinin çalıştığı an.</p></div>';
    }
}
// 将我们的函数挂载到 ‘admin_notices’ 这个动作钩子上
add_action( 'admin_notices', 'hello_admin_display_message' );

Test ve Aktivasyon

Dosyayı kaydedin. Şimdi, yerel WordPress sitenizin yönetim paneline giriş yapın (genellikle…). /wp-admin“Eklentiler” menüsüne gidin; eklentiler listesinde “Hello Admin”“ı görmelisiniz. ”Etkinle” butonuna tıklayın. Etkinleme işleminden sonra kontrol paneli sayfasını yenileyin. Sayfanın üst kısmında, tanımladığınız hoş geldin mesajını gösteren yeşil bir başarı bildirimi kutusu göreceksiniz. Bu, ilk eklentinizin başarıyla çalıştığını gösterir!

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.

Eklentiye yapılandırılabilir seçenekler ekleyin.

Sadece sabit bilgileri gösteren bir eklentinin kullanışlılığı sınırlıdır. Bir sonraki adımda, bu eklentiyi yapılandırılabilir hale getireceğiz ve yöneticilerin gösterilecek mesajları ayar sayfaları aracılığıyla özelleştirmelerine izin vereceğiz. Bu, yönetim menü sayfaları oluşturmayı, form verilerini işlemeyi ve verileri seçenek API’si kullanarak saklamayı içerir.

\n

Yönetim menüsü sayfası oluşturun.

Yönetim arayüzünde bir ayar sayfası eklememiz gerekiyor. Bunu şu şekilde yapabiliriz: add_menu_page() 或 add_submenu_page() Fonksiyonların gerçekleştirilmesi. Eklentinin ana dosyasına kod eklemeye devam ediyoruz.

Öncelikle, ayar sayfasının HTML içeriğini oluşturacak bir fonksiyon oluşturun ve bir menü öğesini kaydedin:

// 创建插件设置页面
function hello_admin_add_settings_page() {
    add_options_page(
        'Hello Admin 设置', // 页面标题
        'Hello Admin',      // 菜单标题
        'manage_options',   // 所需权限
        'hello-admin',      // 菜单slug
        'hello_admin_render_settings_page' // 用于渲染页面的回调函数
    );
}
add_action( 'admin_menu', 'hello_admin_add_settings_page' );
// 渲染设置页面的HTML
function hello_admin_render_settings_page() {
    ?>
    <div class="wrap">
        <h1>Merhaba, Admin Ayarları…</h1>
        <form method="post" action="/tr/options.php/" data-trp-original-action="options.php">
            <?php
            settings_fields( 'hello_admin_settings_group' ); // 设置组名称
            do_settings_sections( 'hello-admin' ); // 页面slug
            submit_button(); // 提交按钮
            ?>
        <input type="hidden" name="trp-form-language" value="tr"/></form>
    </div>
    &lt;?php
}

Kayıt Ayarları, Alanlar ve Veri Depolama

Bundan sonra, seçeneklerimizi güvenli bir şekilde kaydetmek, doğrulamak ve saklamak için WordPress’in Ayarlar (Settings) API’sini kullanmamız gerekiyor. Başka bir fonksiyon oluşturun ve bunu ilgili yerlerde kullanın. admin_init Onu kancada çalıştırın.

// 初始化设置
function hello_admin_settings_init() {
    // 注册一个设置，将其存储在 wp_options 表中
    register_setting( 'hello_admin_settings_group', 'hello_admin_custom_message', 'sanitize_text_field' );
// 在页面上添加一个设置区域（可以省略，此处为清晰而加）
    add_settings_section(
        'hello_admin_section',
        '自定义消息设置',
        null, // 可选的区域描述回调函数
        'hello-admin'
    );
// 在区域中添加一个字段
    add_settings_field(
        'hello_admin_message_field',
        '欢迎消息',
        'hello_admin_message_field_callback',
        'hello-admin',
        'hello_admin_section'
    );
}
add_action( 'admin_init', 'hello_admin_settings_init' );
// 渲染消息输入字段
function hello_admin_message_field_callback() {
    $message = get_option( 'hello_admin_custom_message', '欢迎回来，管理员！' ); // 获取已保存的值，没有则用默认值
    echo '<input type="text" name="hello_admin_custom_message" value="' . esc_attr( $message ) . '" class="regular-text" />'echo '<p class="description">Buraya, yönetim arayüzünde göstermek istediğiniz hoş geldin mesajınızı girin.</p>';
}

Görüntüleme fonksiyonunu, yapılandırma öğelerini kullanacak şekilde değiştirin.

Son olarak, başlangıçtaki bildirim gösterim fonksiyonunu değiştirmemiz gerekiyor. hello_admin_display_message()Bunu veritabanı seçeneklerinden çıkarın. hello_admin_custom_message İçeriği dosyadan okur, sabit olarak kodlamaz.

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.

function hello_admin_display_message() {
    if ( current_user_can( 'manage_options' ) ) {
        $custom_message = get_option( 'hello_admin_custom_message', '欢迎回来，管理员！' ); // 获取自定义消息
        if ( ! empty( $custom_message ) ) {
            echo '<div class="notice notice-success is-dismissible"><p>'`. esc_html($custom_message)`.'</p></div>';
        }
    }
}

Şimdi, tüm yaptığınız değişiklikleri kaydedin. WordPress arayüzüne geri dönün; “Ayarlar” menüsünde “Hello Admin” seçeneğini göreceksiniz. Bu sayfaya girin, mesajı değiştirin ve kaydedin. Panoyu yenileyin; artık görüntülenen mesajın az önce ayarladığınız içerik olduğunu göreceksiniz. Böylece, temel özelliklere sahip bir özel eklenti tamamlanmış olur.

Eklenti Geliştirme İçin En İyi Uygulamalar ve Sonraki Adımlar

Temel özelliklerin gerçekleştirilmesinin ardından, en iyi uygulamalara uyum sağlamak eklentinizin daha profesyonel, daha güvenli ve daha kolay bakım yapılabilir olmasını sağlar.

\n

Güvenlik her zaman önceliklidir: Kullanıcı girdilerini her zaman doğrulayın, escape edin ve temizleyin. WordPress tarafından sağlanan fonksiyonları kullanın. esc_html(), esc_attr(), sanitize_text_field(), wp_nonce_field() Ve benzerleri… Kullanıcılardan veya veritabanlarından gelen verilere asla doğrudan güvenmeyin.

Kod Düzeni ve Açıklamaları: Eklentilerin işlevleri arttıkça, kodu farklı sınıflara veya dosyalara bölmek daha mantıklı hale gelir. Nesne Yönelimli Programlama (OOP) kullanmak, kodun yeniden kullanılabilirliğini ve düzenliliğini artırır. Fonksiyonlarınıza ve sınıflarınıza açık ve anlaşılır açıklamalar ekleyin; bu, hem sizin için hem de gelecekteki iş birlikçileriniz için çok önemlidir.

Uluslararasılaşma Hazırlıkları: Eğer eklentinizi genel olarak kullanıma sunmayı planlıyorsanız, uluslararasılaştırmayı (i18n – Internationalization) desteklemelisiniz. Bu, çeşitli dildeki kullanıcılar için eklentinizin doğru şekilde çalışmasını sağlamanız gerektiği anlamına gelir. __() 或 _e() Bu fonksiyonlar, kullanıcıya yönelik tüm metinleri kapsar ve metin alanını (Text Domain) doğru bir şekilde ayarlar. Böylece, başkaları eklentinizi diğer dillere çevirebilirler.

Performans göz önüne alındığında: Eklenti kaynaklarınızı (CSS, JavaScript) yalnızca ihtiyaç duyulduğunda yükleyin. Her sayfada arka planda ihtiyaç duyulan komut dosyalarını yüklemekten kaçınmak için koşullu ifadeleri akıllıca kullanın. Veritabanı sorgularını optimize edin ve WordPress'in geçici (Transients) API'sini önbellek oluşturmak için akıllıca kullanın.

Derinlemesine Keşif: Temelleri öğrendikten sonra, daha ileri seviye konuları keşfedebilirsiniz; örneğin özel makale türleri (Custom Post Types – CPT) ve özel kategoriler oluşturma, kısa kodlar (Shortcodes) ekleme, özel araççıklar (Widgets) geliştirme, REST API’leri entegre etme veya eklentiniz için sürükle-bırak özelliğine sahip bloklar (Blocks) oluşturma gibi.

Özetle.

Bu rehber sayesinde, sıfırdan başlayarak işlevsel bir WordPress eklentisi oluşturma sürecinin tamamını tamamladınız. Eklenti geliştirmenin temel kavramlarını öğrendiniz; bunlar arasında dosya yapısı, çekirdek kancalar (Hooks) sistemi ve Settings API’sini kullanarak güvenli yapılandırma sayfaları oluşturma yer alıyor. “Hello Admin” eklentisi basit olsa da, eklenti geliştirmenin temel modellerini içeriyor: eklentiyi tanımlama, işlevleri yerine getirme, verileri işleme ve sonuçları görüntüleme. Bu temelleri öğrendiğinizde, WordPress’in geniş genişletme yeteneklerini keşfetme yolunda önemli bir adım atmış olursunuz. Unutmayın ki, sürekli öğrenmek, en iyi uygulamalara uymak ve pratik yapmaktan çekinmemek, eklenti geliştirme becerilerinizi geliştirmenin en etkili yollarıdır.

Sıkça Sorulan Sorular.

Bir WordPress eklentisi en az kaç dosyaya ihtiyaç duyar?

En basit özelliklere sahip bir eklenti, yalnızca bir ana PHP dosyasından oluşabilir. Bu dosya, doğru eklenti başlık bilgilerini içeren yorumları içerdiği sürece WordPress tarafından tanınır ve etkinleştirilir. Ancak özellikler karmaşıklaştıkça, kodun daha iyi organize edilebilmesi için genellikle birden fazla dosyaya bölünür; örneğin ayrı JavaScript ve CSS dosyaları veya işlevsel modüllere göre ayrılmış PHP sınıf dosyaları kullanılır.

动作钩子 add_action 和过滤器钩子 add_filter 有什么区别？

Eylem Kancaları (Action Hooks), belirli bir zamanda bir kod parçasını veya işlevi çalıştırmak için kullanılır ve herhangi bir değer döndürmesi beklenmez; sadece “bir şey yapar”. Örneğin, bir makale yayınlandıktan sonra e-posta göndermek gibi.

Filtre kancaları (Filter Hooks), verileri değiştirmek için kullanılır. Bir girdi değeri alır ve değiştirilmiş bir değer döndürmesi beklenir. Örneğin, bir makale başlığı tarayıcıya gösterilmeden önce içeriğini değiştirmek için kullanılabilir. Temel fark şudur: Eylemler gerçekleştirilirken, filtreler verileri değiştirir ve değiştirilmiş hallerini döndürür.

Kullanıcı girdilerini veritabanına nasıl güvenli bir şekilde kaydedebiliriz?

WordPress tarafından sağlanan seçenek API fonksiyonlarını mutlaka kullanın.update_option()和register_setting()。register_setting()Bu fonksiyon, temizleme işlemleri için bir geri çağırma fonksiyonu belirtmenize olanak tanır (örneğin:sanitize_text_fieldVeriler kaydedilmeden önce otomatik olarak işlenir. Asla doğrudan kullanmayın.$wpdbİşlenmemiş kullanıcı verilerini eklemek için SQL ifadeleri kullanılabilir; bu durum, ciddi güvenlik açıklarına (örneğin SQL enjeksiyonu) yol açabilir.

Eklentiler geliştirirken, diğer eklentilerle çakışmaları nasıl önleyebiliriz?

İyi kodlama uygulamaları, çakışmaları önlemenin anahtarıdır. Tüm fonksiyonlarınıza, sınıflarınıza, değişkenlerinize ve seçenek adlarına benzersiz bir önek ekleyin. Örneğin,hello_admin_display_messageBunun yerine, yaygın olanlar…display_messageCSS stilinizi ve JavaScript kodunuzu belirli sınıflar veya ID seçicileri içinde paketleyin. Hook’lar eklerken, geri çağırma fonksiyonlarınızın yalnızca ihtiyacınız olan koşullar altında çalıştığından emin olun (örneğin, mevcut sayfayı veya kullanıcı yetkilerini kontrol edin).