Eklentinizi WordPress Eklenti Dizinine Ekleme

Oluşturduğunuz bir eklentiyi WordPress eklenti dizinine eklemek mi istiyorsunuz?

Dizine faydalı eklentiler eklemek, WordPress topluluğuna geri verebileceğiniz yollardan sadece biridir. Ancak eklentinizi resmi eklenti dizinine nasıl ekleyeceğiniz konusunda bazı ipuçlarına ihtiyacınız olabilir.

Bu makalede, eklentinizi depoya nasıl ekleyeceğiniz konusunda size adım adım bir kılavuz göstereceğiz.

Eklentinizi Neden WordPress Eklenti Dizinine Eklemelisiniz?

Başkaları için yararlı olacağını düşündüğünüz bir WordPress eklentisi oluşturduysanız, bunu resmi WordPress eklenti dizinine eklemeyi düşünmelisiniz. Bunun bir geliştirici olarak sizin için birçok faydası vardır.

WordPress eklenti dizini, birçok kullanıcının WordPress web siteleri için eklenti ararken gittiği ilk yerdir. Eklentinizi dizine eklemek, kullanıcıların onu bulmasını kolaylaştıracak ve bir geliştirici olarak size daha fazla güvenilirlik kazandıracaktır.

Ayrıca, eklentinizi indirmek için gereken bant genişliği için ödeme yapmak zorunda kalmayacaksınız. Dizin ayrıca kaç kişinin indirdiğini otomatik olarak takip edecek ve bir yükseltme olduğunda onları bilgilendirecektir.

Dizin ayrıca eklentiyi desteklemenize de yardımcı olacaktır. Kullanıcılar eklentinizi derecelendirebilir, geri bildirim ve hata raporları bırakabilir ve destek forumundan yararlanabilir.

Elbette bazı gereklilikler ve kısıtlamalar da vardır. Bunlardan ilki, eklentinizin WordPress ile uyumlu bir lisansa sahip olması gerektiğidir. GPLv2 veya üstü önerilir.

Akılda tutulması gereken bazı etik hususlar da vardır. Eklenti yasadışı veya ahlaki açıdan rahatsız edici bir şey yapmamalıdır ve kullanıcıların iznini almadan harici web sitelerine bağlantılar ekleyemezsiniz.

Eklentiyi gönderdikten sonra, yaygın hatalar ve eklenti dizini yönergelerine uygunluk açısından manuel olarak incelenecektir. Bu süreç 1 ila 10 gün arasında sürebilir.

Bununla birlikte, eklentinizi WordPress eklenti dizinine adım adım nasıl ekleyeceğinize bir göz atalım. Bu makalede gezinmek için aşağıdaki hızlı bağlantıları kullanabilirsiniz:

Adım 1: Eklentiniz için bir readme.txt Dosyası Oluşturun

Yapmanız gereken ilk şey, eklentiniz için bir ‘Beni Oku’ dosyası oluşturmaktır. Bu, eklentinizin eklenti dizinindeki sayfasında görüntülenecektir ve doğru biçimlendirmeyi kullanması gerekir.

İşte başlangıç noktası olarak kullanabileceğiniz örnek bir dosya. Metin düzenleyicinize yapıştırmanız ve dosyayı eklenti klasörünüze readme.txt olarak kaydetmeniz gerekecektir:

=== Your Plugin Name ===

Contributors: Your WordPress.org Username
Tags: wpbeginner, plugin tutorial
Requires at least: 6.0
Tested up to: 6.2
Stable tag: 1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A WordPress plugin to teach beginners how to write a WordPress plugin. 

== Description ==

This simple plugin is part of our beginner's guide to writing a WordPress plugin. 

== Installation ==

1. Upload the plugin folder to your /wp-content/plugins/ folder.
1. Go to the **Plugins** page and activate the plugin.

== Frequently Asked Questions ==

= How do I use this plugin? =

Answer to the question

= How to uninstall the plugin? =

Simply deactivate and delete the plugin. 

== Screenshots ==
1. Description of the first screenshot.
1. Description of the second screenshot. 

== Changelog ==
= 1.0 =
* Plugin released.

Dosyayı kendi eklentiniz için özelleştirmeniz gerekecektir, bu nedenle WordPress eklenti benioku dosyası sözdiziminin nasıl çalıştığını açıklayacağız.

İlk satır ‘Eklenti Adı’dır ve WordPress eklenti dizininde eklentinizin başlığı olarak görünecektir.

Bir sonraki satır ‘Katkıda Bulunanlar’dır. Bunlar eklentinizi yönetmekten sorumlu WordPress.org kullanıcı kimlikleridir. Halihazırda bir kullanıcı kimliğiniz yoksa, ücretsiz bir WordPress.org kullanıcı hesabı oluşturmanız gerekecektir.

‘En az gerektirir’ ve ‘En fazla test edildi’ alanları eklentinizin çalıştığı WordPress sürümlerini ifade eder. ‘Stable etiketi’ kendi eklentinizin sürümüdür.

Lisans alanlarını aynı bırakabilirsiniz. Ardından, eklentinizin ne yaptığını açıklamak için ‘Açıklama’ alanını düzenlemelisiniz.

Eklentinizin benioku dosyasını düzenledikten sonra değişikliklerinizi kaydetmeyi unutmayın. Dosyayı resmi Readme Validator ‘da çalıştırmak ve tespit edilen sorunları gidermek de iyi bir fikirdir.

Son olarak, eklenti klasörünüze sağ tıklamalı ve bir zip dosyası oluşturmalısınız. Mac kullanıcıları ‘Sıkıştır [eklenti adı]’ seçeneğini, Windows kullanıcıları ise ‘Sıkıştırılmış (sıkıştırılmış) klasöre gönder’ seçeneğini seçmelidir.

Adım 2: Eklentinizi İnceleme İçin Dizine Gönderin

Artık eklentiniz WordPress.org’un eklentiler ekibi tarafından incelenmeye hazır.

Göndermek için Eklentinizi Ekleyin sayfasını ziyaret edin. Henüz giriş yapmadıysanız, ekranın sağ üst köşesindeki ‘Giriş Yap’ düğmesine tıklayın.

Giriş yaptıktan sonra, eklentinizi yükleyebilir ve incelenmek üzere gönderebilirsiniz.

Eklentinizin zip dosyasını seçmek için ‘Dosya Seç’ düğmesine tıklamanız yeterlidir. Ardından, geçerli olan tüm kutuları işaretleyin ve ‘Yükle’ düğmesine tıklayın.

WordPress.org eklenti inceleme ekibi daha sonra yaygın hatalar ve güvenlik kontrolleri için eklenti kodunuza bir göz atacaktır. Onaylandıktan sonra eklenti ekibinden bir e-posta alacaksınız.

Bu e-posta, eklentinizin WordPress.org’da barındırılacağı Subversion (SVN) deposuna bir bağlantı içerecektir. Eklentinizi yüklerken bu bağlantıyı kullanmanız gerekecektir.

Adım 3: Subversion (SVN) Kullanarak Eklentinizi Yükleyin

Eklentiniz onaylandıktan sonra, eklentiyi yüklemek için Subversion (SVN) kullanmanız gerekecektir.

Subversion açık kaynaklı bir sürüm kontrol sistemidir. Kullanıcıların dosya ve dizinlerde değişiklik yapmasına, değişikliklerin kaydını tutmasına, farklı sürümleri yönetmesine ve diğer kullanıcılarla işbirliği yapmasına olanak tanır.

Eklentinizi yüklemek için bilgisayarınızda kurulu bir SVN istemcisine ihtiyacınız olacaktır. Windows kullanıcıları SilkSVN veya TortoiseSVN (ücretsiz) kullanabilir. Mac kullanıcıları SmartSVN veya Versions uygulamasını bilgisayarlarına yükleyebilirler.

Bu makalede, Mac için Versions uygulamasını kullanacağız. Ancak, yukarıda listelenen tüm SVN uygulamalarında süreç çok benzerdir.

Kurulduktan sonra Sürümler uygulamasını açmanız ve WordPress eklentinizin deposunun bir kopyasını kontrol etmeniz gerekir. Bunu yapmak için ‘Yeni Depo Yer İşareti’ düğmesine tıklamanız yeterlidir.

Bu, öncelikle bu yer imi için bir ad sağlamanız gereken bir açılır pencere getirecektir. Eklentinizin adını verebilirsiniz. Bundan sonra, WordPress eklentinizin SVN depo URL’sini eklemeniz gerekir.

Kullanıcı adı ve parola alanlarını boş bırakabilirsiniz.

Şimdi, ‘Oluştur’ düğmesine tıklamalısınız. Versions deponuza bağlanacak ve eklentinizin deposunun bir kopyasını bilgisayarınıza indirecektir.

Ardından, tarayıcı görünümünde depo adına sağ tıklamanız ve ardından ‘Ödeme’ seçeneğini seçmeniz gerekir.

Klasör için bir ad vermeniz ve bilgisayarınızda saklamak istediğiniz bir konum seçmeniz istenecektir. Eklenti dizininizle aynı klasör adını kullanabilir ve devam etmek için ‘Checkout’ düğmesine tıklayabilirsiniz.

Versions uygulaması şimdi bilgisayarınızda eklentiniz için gereken klasörleri oluşturacaktır. Bunu eklentinizin deposunda görüntüleyebilir veya Finder’da göz atabilirsiniz.

Şimdi, eklenti dosyalarınızı kopyalamanız ve yerel deponuzun trunk klasörünün içine yapıştırmanız gerekir.

Bunu yaptığınızda, Sürümler uygulamasında yeni dosyaların yanında bir soru işareti simgesi göreceksiniz.

Bu dosyalar daha önce mevcut olmadığından, onları eklemeniz gerekir. Yeni dosyaları seçin ve bu dosyaları yerel klasörünüze eklemek için ‘Ekle’ düğmesine tıklayın.

Artık eklenti dosyalarınız Subversion’a eklendiğine göre, onları yüklemeye hazırsınız. Bunu, yerel klasörünüzdeki ve subversion dizinindeki değişiklikleri senkronize ederek yaparsınız.

Seçmek için yerel deponuza tıklamalı ve ardından ‘Commit’ simgesine tıklamalısınız.

Yeni bir açılır pencere görünecek ve değişikliklerin listesini ve bir taahhüt mesajı eklemek için bir kutu göreceksiniz.

‘Commit’ düğmesine tıkladığınızda, Versions uygulaması değişikliklerinizi senkronize edecek ve eklentinizin deposuna işleyecektir.

Artık eklenti dosyalarınızı trunk’a yüklediğinize göre, bunları bir sürüme etiketlemenin zamanı geldi.

Eklentinizin yerel kopyasına gidin ve trunk klasörünün içindeki dosyaları kopyalayın. Bundan sonra, tags klas örünü açmanız ve içinde yeni bir klasör oluşturmanız gerekir.

Bu klasöre bir sürüm adı verin. Eklentinizin başlığına girdiğiniz sürümle eşleştiğinden emin olun. Yukarıdaki örnek kodda, eklentimiz için 1.0 sürümünü kullandık.

1.0 klasörünü ekledikten sonra, eklenti dosyalarınızı içine yapıştırmanız gerekir. Bu yeni bir klasör olduğu için, klasörü ve tüm dosyalarını depoya dahil etmek için ‘Ekle’ düğmesine de tıklamanız gerekecektir.

Bundan sonra, değişikliklerinizi daha önce yaptığınız gibi senkronize etmek için devam edebilir ve ‘Commit’ simgesine tıklayabilirsiniz. Artık WordPress eklentileri dizinini ziyaret edebilir ve eklentinizi önizleyebilirsiniz.

Eklenti dosyalarınızı düzenlemeniz gerektiğinde, yerel kopyayı düzenlemelisiniz. Değişikliklerinizi tamamladığınızda, WordPress eklenti dizini ile senkronize etmek için ‘Commit’ simgesine tıklamanız yeterlidir.

Eklentinizde büyük değişiklikler yaptığınızda, etiketler klasörüne bu sürüm numarasına sahip yeni bir klasör ekleyerek yeni bir sürüm eklemek isteyeceksiniz. Sürüm numarasının eklentinizin başlığıyla eşleştiğinden emin olun.

Adım 4: Resimleri WordPress Eklenti Dizinine Ekleyin

Şimdi, WordPress eklenti dizinine bazı çizimler ve ekran görüntüleri ekleyebiliriz. Bu öğelerin standart adlandırma uygulamalarını takip etmesi ve Subversion kullanılarak yüklenmesi gerekir.

Eklenti Başlık Bannerı

Başlık banner’ı, eklenti sayfasının üstünde görünen büyük resimdir. Boyutu 772×250 veya 1544×500 piksel olmalı ve JPEG veya PNG dosya formatını kullanmalısınız.

Görüntünüzün boyutuna ve dosya türüne bağlı olarak, başlık banner’ınıza bu adlardan birini vermeniz gerekecektir:

• banner-772×250.jpg
• banner-772×250.png
• banner-1544×500.jpg
• afiş-1544×500.png

Eklenti Simgesi

Simge daha küçük bir kare resimdir ve arama sonuçlarında ve eklenti listelerinde görüntülenecektir. Boyutu 125×125 veya 250×250 piksel olmalı ve JPEG veya PNG dosya formatını kullanmalısınız.

Görüntünüzün boyutuna ve dosya türüne bağlı olarak, simgenize bu adlardan birini vermeniz gerekecektir:

• icon-128×128.jpg
• icon-128×128.png
• icon-256×256.jpg
• icon-256×256.png

Ekran Görüntüleri

İstediğiniz kadar ekran görüntüsü ekleyebilirsiniz. Bu ekran görüntüleri readme.txt dosyanızdaki ekran görüntüsü açıklamalarında listelenmelidir.

Ekran görüntüsü dosyaları şu şekilde adlandırılmalıdır:

• ekran görüntüsü-1.png
• ekran görüntüsü-2.png

Tüm çizimleri hazırladıktan sonra, bunları eklentinizin yerel kopyasının assets klasörüne yerleştirebilirsiniz.

Bundan sonra, varlıklar klasörünün yanında bir soru işareti simgesi göreceksiniz. Deponuza yeni varlık dosyaları eklemek için ‘Ekle’ düğmesine tıklamanız gerekecektir.

Son olarak, devam edin ve dosyalarınızı WordPress eklenti dizinine yüklemek için ‘Commit’ simgesine tıklayın.

Bir süre sonra, resmin eklenti sayfanızda göründüğünü görebileceksiniz.

Umarız bu eğitim, eklentinizi WordPress eklenti dizinine nasıl ekleyeceğinizi öğrenmenize yardımcı olmuştur. Ayrıca WordPress kullanıcılarının yararlı bulduğu olmazsa olmaz eklentileri seçmemize göz atmak ve müşterilerin WordPress eklentilerini devre dışı bırakmasını nasıl önleyeceğinizi öğrenmek isteyebilirsiniz.

If you liked this article, then please subscribe to our YouTube Channel for WordPress video tutorials. You can also find us on Twitter and Facebook.