Worpresse Eklenti Yükleme ve Güncellem Nasıl Yapılır?

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.
WordPress.org deposuna ilk kez eklenti gönderiyorsanız Eklentiler Nasıl Gönderilir? le ilgili bazı adımlar belirsiz veya kafa karıştırıcı olabilir; bu nedenle size yol göstermek için süreci özetledim. Ayrıca, ileride başvurmanız gerekirse bu sayfayı yer imlerinize eklemenizi öneririm.

WordPress.org’a Plugin Gönderme Süreci

WordPress.org’a Plugin Gönderme Süreci

Başvuru Hazırlığı (Eklentiler Nasıl Gönderilir?)

Öncelikle, ürününüzü depoda barındırmak için eklenti inceleme ekibinden onay almanız gerekiyor. Bunun için WordPress.org’da bir hesabınızın olması şart. Hesabınız yok mu? Hiç sorun değil, buradan kayıt olabilirsiniz .

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: myplugin.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ı.

WordPress.org’daki eklentinizin listeleme sayfası için kullanılacak, Markdown formatında bir readme.txt dosyası oluşturmanız gerekiyor. Bu dosya aşağıdaki bilgileri içermelidir:

• Eklenti adı
• Katkıda Bulunanlar (WordPress.org kullanıcı kimliğiniz)
• Eklenti etiketleri
• En az (WordPress sürümü) gerektirir.
• (WordPress sürümüne kadar) test edilmiştir.
• Kararlı etiket (eklenti sürümü)
• Lisans (GPLv2 veya sonrası)
• Lisans URI’si: www.gnu.org/licenses/gpl-2.0.html
• Açıklama (eklentinizin tam açıklaması)
• Sıkça Sorulan Sorular
• Ekran görüntüleri
• Değişiklik Günlüğü

Referans olması açısından, işte standart bir readme.txt dosya şablonu .

Eklentinizin readme.txt dosyasının doğru biçimde biçimlendirildiğinden ve yapılandırıldığından emin olmak için WordPress Readme Doğrulayıcısını kullanın .

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: myplugin.zip içinde myplugin/ klasörü ve onun içeriği yer almalı.

Eklentinizin adını dikkatlice seçin.

Eklentinizin listeleme URL’sini etkileyeceği ve bu da WordPress.org listelemenizin SEO’sunu ve sonuç olarak eklentinin organik görünürlüğünü ve büyümesini etkileyeceği için, ilk gönderimden önce “doğru” eklenti adını seçmek için zaman ayırmanız önemlidir.

İşte eklenti gönderim sayfasından ismin etkisine ilişkin ilgili bölüm:
Plugin Name
Eklentinizin URL’si, ana eklenti dosyanızdaki (eklenti başlıklarını içeren dosya) değerine göre oluşturulacaktır . 
Plugin Name: NT Image WebP & AVIF Converter
Örneğin, değeri olarak ayarlarsanız, URL’niz  https://wordpress.org/plugins/nt-image-webp-avif-converter
ve slug’ınız nt-image-webp-avif-converter olacaktır.

Eğer adınızla zaten mevcut bir eklenti varsa, URL’niz olacaktır  nt-image-webp-avif-converter-2 ve benzer şekilde devam eder. Tıpkı WordPress gönderi adları gibi davranır.

2. Adım — Eklenti Gönderme

Sorunlar çözüldükten sonra (varsa), onay e-posta yoluyla size iletilecektir. Eklentiniz bu aşamada herkese açık değildir, ancak komut satırı veya bir SVN istemcisi aracılığıyla dosya yükleyebilir, düzenleyebilir ve silebilirsiniz.

İpucu: Önemli e-postaları kaçırmadığınızdan emin olmak için, WordPress.org eklenti inceleme ekibinin eklenti geliştiricileriyle iletişim kurmak için kullandığı e-posta adresi olan plugins@wordpress.org adresini beyaz listeye eklemenizi öneririm.

https://wordpress.org/plugins/developers/add/ adresine git, WordPress.org hesabınla giriş yap ve formu doldur. Sayfada:

1. Plugin adı
2. Kısa açıklama
3. ZIP dosyası yükleme alanı — senin nt-webp-avif-converter-free-fixed.zip dosyasını buraya yükleyeceksin.

Hesabın yoksa önce https://login.wordpress.org/register adresinden ücretsiz kayıt ol.

2. Adım — İnceleme Süreci

Gönderildikten sonra plugin ekibi tarafından manuel olarak inceleniyor. Bu süreç 1 ila 10 gün alıyor; ekip 5 iş günü içinde tamamlamayı hedefliyor. WordPress

En sık reddedilme sebepleri şunlardır: kaçırılmamış (unescaped) çıktı, sanitize edilmemiş kullanıcı girdisi ve nonce olmadan işlenen form verisi. Bunları daha önce kontrol ettik, eklentinde bu sorunlar giderildi.

3. Adım — Onay Sonrası (SVN ile Yükleme)

Onaylandığında e-posta ile bir SVN deposu linki gelecek. Asıl dosyaları bu SVN üzerinden yüklemen gerekiyor. WPBeginner

SVN’i komut satırından kullanmak istemiyorsan Windows için TortoiseSVN, Mac için Cornerstone gibi görsel istemciler de var. Freemius

Kısaca SVN akışı şöyle:

svn checkout https://plugins.svn.wordpress.org/nt-image-webp-avif-converter ./nt-plugin
# trunk/ klasörüne dosyaları koy
svn add trunk/*
svn commit -m "Initial release"

Dikkat Etmen Gereken Bir Şey

Plugin’in URL’si (slug) ana PHP dosyasındaki Plugin Name değerinden otomatik oluşturuluyor ve sonradan değiştirilemiyor. Bu yüzden slug’ı baştan doğru seçmek önemli. Şu anda dosyandaki isim NT Image WebP & AVIF Converter → slug nt-image-webp-avif-converter olacak, bu güzel görünüyor.

Özet olarak tek yapman gereken şey: https://wordpress.org/plugins/developers/add/ adresine gidip ZIP’i yüklemek. Geri kalanı e-posta üzerinden ilerliyor.

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ı!

WordPress, geliştiricilere eklentilerini yayınlama ve barındırma fırsatını eklenti dizini aracılığıyla sunmaktadır. Ancak, eklentilerinizi buraya yüklerken İngilizce dil becerilerinizi iyi bir şekilde kullanmanız gerekmektedir. WordPress bu süreci, Subversion adı verilen bir versiyon kontrol sistemi aracılığıyla gerçekleştirir. Subversion genellikle sunucu tarafında çalışır ve Linux sistemlerinde komut satırı üzerinden kullanılır. Bu rehberde, Windows ortamında bu sistemi nasıl kullanabileceğinizi detaylı bir şekilde anlatacağım. Dolayısıyla, sistemin kendi web sitesinde veya WordPress.org’da bulunan genel Subversion bilgilerinin bu yazının kapsamı dışında olduğunu belirtmek isterim.

İşlem Adımları Bu yazıda, “Advanced Random Posts” eklentimi WordPress eklenti dizinine eklerken gerçekleştirdiğim adımları tek tek açıklayacağım. Siz de bu adımları takip ederek, kendi eklentinizi kolayca dizine ekleyebilirsiniz.

1. WordPress.org Hesabı Oluşturma İlk olarak, WordPress destek sayfasına giderek bir hesap oluşturuyoruz. Eklentinizi yükleme sürecinde bu hesaba ihtiyacınız olacak, bu yüzden kullanıcı adı ve şifrenizi güvenle saklayın.
2. Eklenti Yayın İsteği Gönderme
   Eklentinizi WordPress dizinine eklemek için https://wordpress.org/extend/plugins/add/ adrese giderek istekte bulunmanız gerekmektedir. Bu işlem için siteye giriş yapmış olmanız önemlidir. Başvurunuzu tamamlarken aşağıdaki bilgilere ihtiyaç duyacaksınız:

Eklenti Adı: İngilizce, uygun ve özgün bir isim seçin. Eklentinizin ismi için dizinde arama yaparak başka bir eklentiyle çakışmadığından emin olun.

Açıklayıcı Bilgi: Eklentinizin işlevini ve amacını birkaç cümle ile açıklayın. Bu açıklama İngilizce olmalı; diğer eklenti sayfalarını inceleyerek nasıl yazıldığını görebilirsiniz.

Eklentiye Özel Sayfa (Opsiyonel): İsterseniz, eklentiniz hakkında daha fazla bilgi içeren bir sayfa oluşturabilirsiniz. Bunu yapmazsanız, eklenti sayfanız varsayılan olarak WordPress dizini olacaktır. Ancak, daha profesyonel bir izlenim için özel bir sayfa hazırlamak önerilir.

Onay Sürecini Bekleme
İsteğinizi tamamladıktan ve gerekli bilgileri sağladıktan sonra başvurunuzu gönderin ve onay sürecini bekleyin. Başvurunuz onaylandığında, kullanıcı hesabınızda tanımlı e-posta adresinize aşağıdaki gibi bir bilgilendirme e-postası alacaksınız:

E-postada, eklenti dosyalarınızı yüklemeniz gereken dizin adresi (örneğin, http://svn.wp-plugins.org/advanced-random-posts/) ve süreci daha iyi anlamanıza yardımcı olacak bazı kaynak bağlantıları bulunur. Dosyaları bu dizine yüklerken WordPress.org kaydınız sırasında oluşturduğunuz kullanıcı adı ve şifreye ihtiyaç duyacaksınız.

4. TortoiseSVN Programını İndirme ve Kurma
   Eklenti dizinini yönetmek için kullanacağımız araç, sadece Windows ortamında çalışabilen TortoiseSVN’dir. TortoiseSVN, bir programdan ziyade kabuk (shell extension) olarak çalışır. Yani, kurulumun ardından doğrudan çalıştırabileceğiniz bir uygulama yerine, sağ tıklama menüsü aracılığıyla işlem yapabileceğiniz seçenekler eklenir. Kurulumu oldukça basittir ve “İleri” diyerek birkaç adımda tamamlanabilir. Kurulumdan sonra bilgisayarınızı yeniden başlatmanız gerekecektir. Programı resmi web sitesinden https://tortoisesvn.net/downloads.html indirebilirsiniz.

• Klasör Oluşturma
  Bilgisayarınızda, eklentilerinizi düzenli bir şekilde saklayabilmek için bir klasör oluşturun. Örneğin, ben “Eklentilerim” adında bir klasörü E: sürücüsünde oluşturdum. Bu klasörü istediğiniz yerde ve isimde oluşturabilirsiniz. Ancak, klasörün yerini değiştirmek zorunda kalmayacağınız sabit bir konumda oluşturmanız işlemlerinizi kolaylaştıracaktır.
• Depoyu (WP Eklenti Dizinindeki Alanı) Kontrol Etme
  Oluşturduğunuz klasöre gidin ve boş bir alanda farenin sağ tuşuna tıklayın. Açılan sağ tıklama menüsünden SVN Checkout seçeneğini seçin. Bu adım, eklentinizi WordPress eklenti dizinindeki depoyla senkronize etmenizi sağlar.

SVN Checkout seçeneğini tıkladığınızda, karşınıza e-posta ile gelen dizin adresini ve dosyaların saklanacağı yerel klasörü belirteceğiniz bir ekran çıkacaktır. ‘URL of repository’ alanına, e-postanızda belirtilen dizin adresini (örneğin,http://svn.wp-plugins.org/advanced-random-posts/) girin. ‘Checkout directory’ bölümü, seçtiğiniz klasör yoluna göre otomatik olarak doldurulacaktır. Bu ekranda ayarları kontrol ettikten sonra, gösterilen seçenekleri onaylayarak işleme devam edin. Bu adım, eklenti dosyalarınızın depoya bağlanmasını ve WordPress dizini ile senkronizasyonu sağlar.

OK düğmesine tıkladığınızda, aşağıdaki gibi bir uyarı mesajı ile karşılaşacaksınız: Bu mesajda, dosyaların depolanacağı klasörün mevcut olmadığı ve bu klasörü oluşturmak isteyip istemediğiniz sorulacaktır. Yes seçeneğini tıklayarak, gerekli klasörün otomatik olarak oluşturulmasını onaylayın. Bu işlem, eklenti dosyalarınızı uygun klasöre depolamak için gerekli ortamı hazırlayacaktır.

Eğer her şey yolunda giderse, aşağıdaki gibi bir pencere görüntülenir ve klasör başarıyla oluşturulmuş olur. Bu aşamada, eklenti dosyalarınızı bu yeni oluşturulan klasöre depolayabilirsiniz. Klasörün düzgün bir şekilde oluşturulduğuna emin olduktan sonra, işleminizi devam ettirebilirsiniz.

Oluşturulan ‘advanced-random-posts’ klasörü içerisinde, aşağıdaki gibi üç ana klasör daha otomatik olarak oluşturulacaktır:

• branches
• tags
• trunk

Bu klasör yapısı, SVN (Subversion) versiyon kontrol sisteminin standart yapısını yansıtır.

• trunk: Ana geliştirme dalı (burada eklentinizin ana dosyaları bulunur).
• branches: Farklı geliştirme dallarının yer aldığı alan.
• tags: Yayınlanmış sürümler veya stabil versiyonlar için kullanılan alan.

Sonuç olarak, klasör yapınız şu şekilde olacak:

Read Me Dosyasını Hazırlama
Eklentinizle ilgili bilgileri içeren bir readme.txt dosyası oluşturmanız gerekmektedir. https://wordpress.org/extend/plugins/about/readme.txt Bu dosya, eklenti dizininde eklentinizin sayfasının oluşturulmasında kullanılacak ve dolayısıyla doğru şekilde hazırlanması oldukça önemlidir. Readme dosyasını hazırlarken belirli kurallara uymanız gerekiyor. Aşağıdaki örneğe uygun şekilde, kendi eklentinize özgü bilgileri girerek dosyanızı oluşturmalısınız. Dosyayı hazırladıktan sonra, WordPress’in readme doğrulayıcı http://wordpress.org/extend/plugins/about/validator/ aracını kullanarak doğru hazırlanıp hazırlanmadığını kontrol edebilirsiniz. Ayrıca, dosyanın başlık kısmındaki eklenti adı, açıklaması ve eklenti adresi gibi bilgilerin de doğruluğuna dikkat etmelisiniz.

İpuçları:

• Etiketler: Eklentinize uygun etiketleri belirlemek için diğer eklentilerden ilham alabilirsiniz.
• Dosya Konumu: readme.txt dosyasını eklentinizin ana klasörüne kaydetmelisiniz.
• Ekran Görüntüleri: Eğer açıklamalarda ekran görüntüsü kullanacaksanız, bunların isimlerini screenshot-1, screenshot-2, vb. şeklinde numaralandırarak kaydedin. Dosya uzantılarının (.webp, .webp, .webp) bir önemi yoktur.
• Stable Tag: Eklentinizin stabil sürümünü belirlerken, örneğin Stable tag: 1.0 yazabilirsiniz.
• Not Defteri Kullanımı: Dosyayı, Not Defteri gibi basit bir metin editörüyle readme.txt olarak kaydedin.

Dosyaları Trunk Klasörüne Kopyalama
Eklentinizin tüm dosya ve klasörlerini, readme.txt dosyasını ve varsa ekran görüntülerini trunk klasörüne kopyalayın. Bu, eklentinizin ana dizinine yüklemeye hazır hale gelmesini sağlayacaktır.

Dosyaları Yüklüyoruz
Trunk klasörüne tüm eklenti dosyalarınızı ve readme.txt dosyasını ekledikten sonra, dosyaları yüklemek için şu adımları izleyebilirsiniz:

1. Trunk klasörüne gidin ve sağ tıklayın.
2. Kısayol menüsünden SVN Commit seçeneğini tıklayın. Bu işlem, dosyalarınızı WordPress’in eklenti dizinine yükleyecektir.

Bu adımı takip ederek eklentinizin dosyalarını SVN aracılığıyla WordPress’e gönderebilirsiniz. Yükleme sırasında, dosyaların doğru bir şekilde eklenti dizinine gönderildiğinden emin olun.

Dosyaların Yüklenmesi

1. SVN Commit seçeneğini tıkladığınızda, Trunk klasöründeki dosya ve klasörlerin listelendiği bir diyalog penceresi görüntülenecektir.
2. Bu pencerede, yüklenecek dosyaların tümünü seçmek için pencerenin alt kısmındaki Select/deselect all seçeneğine tıklayın.
3. Ardından, OK düğmesine tıklayarak dosyalarınızı WordPress eklenti dizinine göndermeye başlayabilirsiniz.

Bu işlem, tüm dosyaların doğru şekilde yüklenmesini sağlar ve eklentinizin yayına alınması için gerekli adımları atmış olursunuz.

Kullanıcı Adı ve Şifre Girişi

1. OK düğmesine tıkladıktan sonra, karşınıza kullanıcı adı ve şifrenizi girmeniz gereken bir pencere çıkacaktır.
2. Bu pencerede, WordPress.org hesabınızın kullanıcı adı ve şifresini girmeniz gerekecek.
3. Eğer şifreyi her seferinde girmek istemiyorsanız, Save authentication seçeneğini işaretleyerek giriş bilgilerinizi kaydedebilirsiniz. Bu sayede, gelecekteki işlemler için şifreyi tekrar girmenize gerek kalmaz.

Kullanıcı adı ve şifrenizi girdikten sonra, dosyalarınız WordPress eklenti dizinine yüklenmeye başlayacaktır.

Dosyaların Yüklenmesi Tamamlandı
Her şey yolunda giderse, SVN Commit işleminden sonra aşağıdaki gibi bir ekran görüntülenecektir. Bu ekranda, yüklediğiniz dosyaların başarıyla eklendiğini görebileceksiniz.

• Yüklenen dosyalar, Trunk klasöründe bulunan dosyalarla uyumlu olarak listelenir.
• Bu ekran, dosyaların doğru bir şekilde WordPress eklenti dizinine gönderildiğini onaylamak için son bir kontrol fırsatı sunar.

Ekranı inceledikten sonra, OK düğmesine tıklayarak işlem tamamlanmış olur ve eklentiniz WordPress eklenti dizininde yayımlanmak üzere onay sürecine geçer.

Dosyaların Yüklenip Yayımlandığını Kontrol Etme
Eklentinizi yükledikten sonra, dosyaların başarıyla gönderilip gönderilmediğini kontrol etmek için şu adımları izleyebilirsiniz:

1. Web tarayıcınızı açın ve Trunk klasörünüzün adresine gidin:
   http://svn.wp-plugins.org/advanced-random-posts/trunk/
2. Burada, yüklediğiniz dosyaların listelendiğini görmelisiniz. Eğer dosyalarınız doğru şekilde yüklendiyse, Trunk klasöründe yer alan eklenti dosyaları, readme.txt ve diğer ilgili dosyalar burada görünecektir.

Bu adımla, yüklediğiniz dosyaların doğru bir şekilde eklenti dizininde yer aldığını doğrulayabilirsiniz.

Eklentimizin Görünürlüğünü Kontrol Etme
Eğer readme.txt dosyanızı WordPress’in belirlediği kurallara uygun olarak doğru şekilde hazırladıysanız, eklentinizin başlığı ve açıklamaları, WordPress Eklenti Dizininde görünmeye başlayacaktır.

1. WordPress Eklenti Dizinine gidin:
   https://wordpress.org/plugins/
2. Burada, eklentinizin adı ve açıklamaları, readme.txt dosyanızdaki bilgilerle eşleşen şekilde listelenecektir.

Eklentiniz, başlık ve açıklamaları doğru biçimde girdiğiniz takdirde, dizinde görünür hale gelir. Bu, eklentinizin kullanıcılar tarafından bulunabilir ve indirilebilir olduğunu gösterir.

Eklentimizin Sayfasının Görünürlüğü ve İndirilebilirlik Durumu
Eklentimizin başlığına tıklayarak, WordPress Eklenti Dizininde yer alan eklentimize ait sayfayı görüntüleyebiliriz. Bu sayfa, readme.txt dosyanızda sağladığınız bilgilere dayalı olarak otomatik olarak oluşturulur.

1. Eklenti Sayfası: Sayfada, eklentimizin adı, açıklaması, sürüm bilgisi, kurulum talimatları gibi veriler yer alacaktır.
2. İndirilebilir Hali: Eklentinin en son sürümü, kullanıcıların kolayca indirebileceği şekilde sayfada otomatik olarak yer alır.
3. Sitemize Bağlantılar: Ayrıca, eklenti sayfasında eklentinin resmi web sitesi, destek sayfası gibi bağlantılar da bulunur, böylece kullanıcılar doğrudan sitemize yönlendirilir.

Eklentimizin başlığına tıkladığınızda, bu özelliklerin tümü doğru şekilde çalışacak ve kullanıcılara eklentiyi kolayca edinme imkanı sunacaktır.

Eklenti Güncellemeleri ve Yeni Sürümler
Bir sonraki yazımda, eklentimizin yeni sürümlerini nasıl dizine ekleyip güncelleyebileceğimizi adım adım anlatacağım. Bu işlemi, dizine eklediğim bir eklentimi güncellediğimde örnek olarak yapacağım.

Bu konuda, WordPress Eklenti Dizinindeki kaynak sitede kısa bir açıklama yer alıyor. İlgilenenler, şimdilik oradan da eklenti güncelleme işlemi hakkında bilgi edinebilirler. Yeni sürüm eklemek, eklentinizi sürekli güncel tutmak ve kullanıcılarınızın en son özelliklere erişebilmesini sağlamak adına oldukça önemli bir adımdır.

WordPress, kullanıcıların sitelerine yeni işlevsellikler eklemelerini sağlayan güçlü bir sistem sunar. Kendi eklentinizi oluşturmak, sitenizi özelleştirmenin en etkili yollarından biridir. Bu rehberde, adım adım WordPress eklenti geliştirmeyi öğreneceksiniz.

1. Eklenti Dosyalarını Oluşturma

Eklenti geliştirmeye başlamak için ilk adım, WordPress kurulumunun yer aldığı wp-content/plugins/ dizinine gidip yeni bir klasör oluşturmaktır. Örneğin, benim-eklentim adında bir klasör oluşturabilirsiniz.

Bu klasörün içinde, eklentinizin ana dosyası olacak index.php dosyasını oluşturun.

<?php
/*
Plugin Name: Benim Eklentim
Plugin URI: https://cihanustundag.com/benim-eklentim
Description: Bu, deneme amaçlı bir eklentidir.
Version: 1.0
Author: Cihan Ustundağ
Author URI: https://cihanustundag.com
License: GPLv2 or later
*/

Bu açıklama, eklentinizin WordPress panelinde tanınmasını sağlar.

SEO Notları: Bu bölümde, “WordPress eklenti oluşturma” gibi anahtar kelimeler doğal bir şekilde kullanılmalı. Ayrıca, açıklamalar kısmında hedef kitlenizle uyumlu ve ilgi çekici ifadeler yer almalıdır.

2. Yönetici Paneline Menü Ekleme

Eklentinizin bir yönetim paneli olması için, aşağıdaki kodu index.php dosyanıza ekleyin:

<?php
add_action('admin_menu', 'benim_eklentim_menu_olustur');

function benim_eklentim_menu_olustur() {
    add_menu_page(
        'Benim Eklentim Ayarları',
        'Benim Eklentim',
        'manage_options',
        'benim-eklentim',
        'benim_eklentim_ayar_sayfasi',
        '',
        100
    );
}

function benim_eklentim_ayar_sayfasi() {
    echo '<h1>Benim Eklentim Ayarları</h1>';
    echo '<p>Bu alandan eklentinizin ayarlarını yönetebilirsiniz.</p>';
}

Bu kod, WordPress panelinde “Benim Eklentim” adında bir menü oluşturur.

SEO Notları: Yönetici paneli özelliklerinden bahsederken, “WordPress admin menü” veya “eklenti ayarları ekleme” gibi anahtar kelimelere yer verin.

3. Stil ve Script Dosyaları Dahil Etme

Eklentiniz için özel CSS ve JavaScript dosyaları eklemek istiyorsanız, şu adımları takip edin:

1. css ve js adında iki klasör oluşturun.
2. CSS dosyanızı css/style.css, JavaScript dosyanızı js/script.js olarak adlandırın.
3. Aşağıdaki kodu index.php dosyanıza ekleyin:

<?php
function benim_eklentim_stil_ve_script() {
    wp_enqueue_style('benim-eklentim-style', plugins_url('css/style.css', __FILE__));
    wp_enqueue_script('benim-eklentim-script', plugins_url('js/script.js', __FILE__), array('jquery'), '1.0', true);
}
add_action('wp_enqueue_scripts', 'benim_eklentim_stil_ve_script');

SEO Notları: Bu bölümde “WordPress CSS ekleme” ve “WordPress script yükleme” gibi anahtar kelimeleri doğal olarak kullanabilirsiniz.

4. Güvenlik Önlemleri

Eklenti geliştirirken aşağıdaki güvenlik pratiklerini uygulamak önemlidir:

• Kullanıcı yetkilerini kontrol etmek için current_user_can('manage_options') fonksiyonunu kullanın.
• Gelen verileri temizlemek ve doğrulamak için WordPress fonksiyonlarını kullanın:

<?php
if (!current_user_can('manage_options')) {
    wp_die('Bu sayfaya erişim izniniz yok.');
}

$safe_data = sanitize_text_field($_POST['veri']);

SEO Notları: “WordPress güvenlik önlemleri” ve “eklenti güvenlik pratikleri” gibi terimler bu bölüm için uygundur.

5. Eklentiyi Test Etme

Eklentinizi “Eklentiler” sayfasından etkinleştirin ve menü öğesinin düzgün bir şekilde göründüğünü kontrol edin. Hatalar için tarayıcı konsolunu ve WordPress hata günlüklerini kullanabilirsiniz.

SEO Notları: “WordPress eklenti testi” ve “eklenti hata ayıklama” ifadelerine yer vererek içeriği zenginleştirin.

6. WordPress.org’da Yayınlama

Eklentinizi geniş bir kitleye ulaştırmak isterseniz, WordPress.org Plugin Repository’e gönderim yapabilirsiniz. WordPress Developer Handbook yardımcı rehberlik sunar.

SEO Notları: “WordPress.org eklenti yayınlama” ve “WordPress geliştirici rehberi” ifadeleri ile bu bölümün SEO değerini artırabilirsiniz.

Eklentinizin adını dikkatlice seçin.

Eklentinizin listeleme URL’sini etkileyeceği ve bu da WordPress.org listelemenizin SEO’sunu ve sonuç olarak eklentinin organik görünürlüğünü ve büyümesini etkileyeceği için, ilk gönderimden önce “doğru” eklenti adını seçmek için zaman ayırmanız önemlidir.

İşte eklenti gönderim sayfasından ismin etkisine ilişkin ilgili bölüm:

Plugin NameEklentinizin URL’si, ana eklenti dosyanızdaki (eklenti başlıklarını içeren dosya) değerine göre oluşturulacaktır . Plugin Name: Boaty McBoatfaceÖrneğin, değeri olarak ayarlarsanız, URL’niz https://wordpress.org/plugins/boaty-mcboatfaceve slug’ınız olacaktır boaty-mcboatface. Eğer adınızla zaten mevcut bir eklenti varsa, URL’niz olacaktır boaty-mcboatface-2ve benzer şekilde devam eder. Tıpkı WordPress gönderi adları gibi davranır.

Dolayısıyla ilk ismi seçerken, marka bilinirliğinden ziyade SEO optimizasyonunu düşünün. Hangi anahtar kelimeleri hedeflemek istediğinizi kendinize sorun ve ismi buna göre belirleyin. İsimlendirme ipuçlarını burada bulabilirsiniz .

Unutmayın, eklentinin adını ilk gönderimden sonra her zaman değiştirebilirsiniz; yani beğenmediğiniz bir isim seçseniz bile, daha sonra (ve istediğiniz kadar) değiştirebilirsiniz. Değiştiremeyeceğiniz şey ise eklentinin slug’ıdır, bu nedenle ilk isimlendirme önemlidir.

Ayrıca, slug’ın ana eklenti dosyanızdaki eklenti adından oluşturulduğunu ve bunun readme.txt dosyasındaki eklenti adı değerinden farklı olabileceğini de unutmayın.

Eklentinizi Gönderme

İyi bir SEO ismi belirledikten sonra — ve eklentiniz ile readme.txt dosyanız hazır olduğunda — Eklentinizi Ekleyin sayfasına gidin ve inceleme için gönderin.

İnceleme süreci manueldir ve inceleme sırasına ve eklentinizin karmaşıklığına bağlı olarak 1 ila 10 gün sürebilir. Herhangi bir sorun bulunursa, söz konusu sorunları ve bunları nasıl düzeltebileceğinizi ayrıntılarıyla açıklayan bir e-posta alacaksınız.

Sorunlar çözüldükten sonra (varsa), onay e-posta yoluyla size iletilecektir. Eklentiniz bu aşamada herkese açık değildir, ancak komut satırı veya bir SVN istemcisi aracılığıyla dosya yükleyebilir, düzenleyebilir ve silebilirsiniz.

İpucu: Önemli e-postaları kaçırmadığınızdan emin olmak için, WordPress.org eklenti inceleme ekibinin eklenti geliştiricileriyle iletişim kurmak için kullandığı e-posta adresi olan plugins@wordpress.org adresini beyaz listeye eklemenizi öneririm.

Eklentinin Yüklenmesi

SVN deposuna erişim izni aldıktan sonraki adım, eklentinizi WordPress.org deposuna yüklemektir. Bunu yapmadan önce, WordPress ile Subversion kullanımının temellerine aşina olmanızı öneririz .

Bu eğitimde komut satırı arayüzünü kullanacağım. Eğer komut satırı arayüzünü sevmiyorsanız ve görsel bir istemciyle çalışmayı tercih ediyorsanız, Windows için TortoiseSVN’i ve Mac için Cornerstone’u düşünebilirsiniz .

Eklenti dosyalarını SVN deposuna yüklemeden önce, dosyaların ve varlıkların saklanacağı yerel bir klasör oluşturmanız gerekir. Bu komut yerel bir dizin oluşturacaktır:

Tutarlılık sağlamak için, klasörü ve eklentinin ana PHP dosyasını, ilk gönderimden sonra size atanan slug’a göre adlandırmak iyi bir uygulamadır . Bu örnekte, eklentinizin adının My Awesome Pluginve onaylanmış slug’ınızın olduğunu varsayıyorum my-awesome-plugin.

Şimdi, önceden oluşturulmuş depoyu görüntülemek ve indirmek için:

Bu, aşağıdaki sonucu verecektir:

Burada, Adizinlerin merkezi depodan yerel klasöre eklendiği anlamına gelir. Ardından, eklentinizin dosyalarını ve klasörlerini bu trunkklasöre kopyalamanız gerekir:

Ve bunları depoya ekleyin.

Karşılığında, kimliğinizi doğrulamanız istenecektir. Giriş yaptıktan sonra, aşağıdaki gibi bir yanıt alacaksınız:

Önemli: WordPress.org, trunkklasörü eklentinizin en üst düzey klasörü olarak kabul eder. Bu nedenle, eklenti klasörünün tamamını olduğu gibi kopyalamayın, trunkyalnızca eklentinin içeriğini dahil edin .

Şunlardan kaçının: trunk/my-awesome-plugin/my-awesome-plugin.php

Tüm dosyaları ekledikten sonra, değişiklikleri merkezi depoya geri kaydedin:

Bu, aşağıdaki yanıtı döndürecektir:

Eklenti simgesi, afiş ve ekran görüntüleri yüklemek için SVN yerel deponuzda yeni bir varlıklar klasörü oluşturabilirsiniz:

Eklenti varlıklarının nasıl çalıştığını buradan öğrenebilirsiniz .

Varlıklarınız hazır olduğunda, eklenti varlıklarını SVN deposuna ekleyin:

Değişiklikleri tekrar kaydedin:

İşte bu kadar! Eklentiniz artık indirilmeye hazır ve tanıtımına başlayabilirsiniz.

Yeni Bir Yayını Teşvik Etmek

Eklentinizin bir sonraki güncelleme sürümü için adımlar biraz farklıdır. Yeni sürümü yayınlamadan önce, eklenti başlığı yorumundakiStable Tag alanı trunk/readme.txt fileve sürüm numarasını güncelleyin . Eklenti dosyalarınız hazır olduğunda, bunları /tags klasörünün bir alt klasörüne kopyalayın ve alt klasörün adını 1.0.1 gibi yeni sürüme ayarlayın .

Değişiklikleri kaydedin.

Ve işte böylece eklentinizin yeni sürümü hazır!

Sürüm Yönetimi İpuçları

• Yeni bir sürüm yayınlandıktan sonra WordPress.org eklenti listeleme sayfanızda indirilmeye hazır hale gelmesi arasında bir gecikme yaşayabilirsiniz. Birkaç saat bekleyin ve hala göremiyorsanız, sistemde zaman zaman sorunlar yaşandığı için plugins@wordpress.org adresine e-posta gönderebilirsiniz.
• trunkGenel bir kural olarak, senkronizasyon sorunlarını azaltmak için, klasörünüzdeki eklenti sürümünün , klasördeki en son sürümdeki eklenti sürümüyle aynı olması önerilir tags.

Sırada Ne Var?

Doğası gereği, ücretsiz eklentilerin geliştiricileri dünyaya faydalı şeyler sunmaya tutkuyla bağlıdırlar. Her şeyden önce, ürünlerimizin insanların karşılaşabileceği belirli sorunları çözmesini istiyoruz. Ancak eklentiniz ne kadar harika olursa olsun, insanlar onu bulamazsa pek bir faydası olmaz.

Ücretsiz eklentinizin görünürlüğünü artırmak için atılabilecek iyi bir sonraki adım, burada ele aldığımız gibi, readme.txt dosyasını SEO için optimize etmektir .

Eğer eklentinizden para kazanmayı düşünüyorsanız, ürününüzü ücretsiz olarak çevrimiçi sunmak yeterli değil; insanların onu keşfetmesini, kullanmasını, sevmesini ve (umarım) ücretli sürümüne yükseltmesini istiyorsunuz! Günümüzde bir WordPress geliştiricisi, ürün geliştiricisinden işletme sahibine ve pazarlamacıya kadar birçok şapka takıyor ve eklentinizin doğru kişiler tarafından görülmesi için pazarlama becerilerinizi geliştirmeniz ve iyileştirmeniz gerekiyor.

Bu konuyu WordPress Ürün Geliştiricileri için Pazarlama El Kitabımızda derinlemesine inceliyoruz . Ayrıca, WordPress eklentileri ve temaları satmak için aşağıdaki kısa kılavuzu incelemenizi şiddetle tavsiye ederim; bu kılavuz, fikir aşamasından lansmana ve büyümeye kadar başarılı bir WordPress işletmesi oluşturmak için özlü ve uygulanabilir bir yol haritası sunuyor.