WordPress Eklentisi Nasıl Yayınlanır? .zip Paketleme ve wp.org’a Yükleme Rehberi

WordPress, açık kaynaklı yapısı sayesinde dünya genelinde milyonlarca geliştiriciyi, site sahibini ve içerik üreticisini bir araya getiren dev bir ekosistemdir. Bu ekosistemin temel taşlarından biri de eklentilerdir. Eklentiler sayesinde WordPress sitelerine yeni özellikler eklenebilir, işlevsellik artırılabilir ve kullanıcı deneyimi geliştirilebilir. Eğer sen de kendi yazdığın bir eklentiyi WordPress.org üzerinden dünya ile paylaşmak istiyorsan, bu rehberde ihtiyacın olan adımları adım adım bulabilirsin.

1. Eklentini Yayına Hazırlamadan Önce: Temel Gereklilikler

WordPress eklentisi yayınlamadan önce aşağıdaki şartların karşılandığından emin olmalısın:

• Eklentin GPL uyumlu bir lisansla lisanslanmalı (örneğin: GPLv2 veya üstü)
• Eklentin zararlı kod, açık reklam, izinsiz veri toplama gibi davranışlar içermemeli
• PHP hata ve uyarıları olmamalı (Kod kalitesi yüksek olmalı)
• Eklentinin en az bir .php dosyası ve içinde gerekli başlık bilgileri olan ana dosyası olmalı
• Bir readme.txt dosyası olmalı (WordPress.org’a özel formatta)

2. Eklenti Dosyalarını Paketleme (.zip Formatı)

Eklentinizi .zip haline getirmek için aşağıdaki adımları takip edin:

1- Klasör Yapısını Doğru Kurun
Eklenti dizin yapısı şöyle olmalı:

my-plugin/
├── my-plugin.php
├── readme.txt
├── /assets/
├── /includes/
├── /languages/
└── /css/, /js/, vb.

2- Ana Dosya: my-plugin.php
Dosyanın başında şu bilgilerin yer aldığı PHP yorum bloğu bulunmalı:

<?php
/*
Plugin Name: Örnek Eklenti
Plugin URI: https://seninsiten.com/ornek-eklenti
Description: Bu eklenti WordPress yeteneklerini artırır.
Version: 1.0
Author: İsmin
Author URI: https://seninsiten.com
License: GPL2
*/

3- readme.txt Hazırlığı
WordPress.org dizininde eklentinizi tanıtacak bu dosya WordPress Readme Validator ile kontrol edilmelidir. Dosyada eklenti adı, açıklama, kısa kodlar, kurulum talimatları, ekran görüntüleri, değişiklik geçmişi gibi bölümler yer almalı.

4- Zip Paketleme
Yukarıdaki klasör yapısına sahip klasörü .zip dosyası haline getirin. Klasörün içeriği değil, klasörün kendisi .zip dosyasına dahil edilmelidir:

• Örneğin: my-plugin.zip içinde my-plugin/ klasörü ve onun içeriği yer almalı.

3. WordPress.org Plugin Dizini Başvurusu

1. WordPress.org Hesabı Oluştur
   https://wordpress.org/ adresine giderek bir kullanıcı hesabı oluştur.
2. Eklenti Başvurusunu Yap
   Eklentinizi yayınlamak için aşağıdaki bağlantıya gidin:
   https://wordpress.org/plugins/developers/add/
   • Burada “Plugin Name” alanı, eklenti sayfanızın URL’sini de belirler. Örneğin: my-plugin → wordpress.org/plugins/my-plugin/
   • Kısa bir açıklama girilir, eklenti dosyası değil sadece başvuru yapılır.
3. İnceleme Süreci
   WordPress gönüllüleri eklentinizi manuel olarak inceler. Bu süreç genellikle 2-5 iş günü sürebilir.
   • Eğer onaylanırsa, bir e-posta alırsınız ve SVN deposu açılır.

4. SVN ile Eklenti Yükleme

WordPress.org, eklenti dosyalarının yüklenmesi için Git yerine SVN (Subversion) kullanır.

1- SVN Kurulumu ve Giriş
Bilgisayarınıza SVN kurun. Giriş yapmanız için SVN URL’si şu formatta olur: https://plugins.svn.wordpress.org/my-plugin/

2- Dizin Yapısı
SVN dizininde şu klasörler bulunur:

/trunk/       → Güncel sürüm kodları burada yer alır
/tags/        → Sürüm etiketleri (örn: /tags/1.0/)
/assets/      → Eklenti sayfası görselleri (banner, ikon vb.)

3- SVN Komutlarıyla Yükleme (Terminal Örneği)

svn checkout https://plugins.svn.wordpress.org/my-plugin/
cd my-plugin
cp -R /path/to/your/plugin/* trunk/
svn add trunk/*
svn commit -m "İlk sürüm"

4- Etiketleme (İsteğe Bağlı ama Tavsiye Edilir)

svn copy trunk tags/1.0
svn commit -m "v1.0 etiketi"

5- Görseller İçin Assets Klasörü

• banner-772x250.jpg → Sayfa üst görseli
• icon-128x128.png → Küçük eklenti simgesi

5. Eklenti Sayfası ve Güncellemeler

• Yayınlandıktan sonra eklenti sayfanız otomatik oluşur. Örnek:
  https://wordpress.org/plugins/my-plugin/
• Güncelleme için trunk/ içeriğini güncelleyin, readme.txt içindeki Stable tag: kısmını uygun şekilde ayarlayın ve svn commit komutuyla güncellemeleri yollayın.

6. Yayın Sonrası Süreçler ve İpuçları

• Kullanıcı yorumlarını ve geri bildirimleri düzenli takip edin.
• Güvenlik açıklarına karşı duyarlı olun; düzenli güncellemeler sağlayın.
• freemium modeliyle premium sürümünüzü tanıtmak istiyorsanız açıklamalarda bunu uygun şekilde belirtin.
• Destek sekmesini aktif kullanın; kullanıcılar desteğe önem verir.

Değerlendirme

WordPress eklentisi yayınlamak sadece teknik bir süreç değil, aynı zamanda büyük bir küresel topluluğa katkı sunmaktır. Başarılı bir eklenti geliştiricisi olmak için sadece kod yazmak değil; dokümantasyon, kullanıcı desteği ve sürekli bakım süreçlerine de hâkim olmak gerekir. Bu rehber, eklentinizi WordPress.org üzerinde başarıyla yayınlamanız için gerekli tüm adımları sunar. Eklentinizi hazırladıysanız, artık dünya ile paylaşma zamanı!