Bir WordPress eklentisini yayınlamak bana her zaman sadece süper yetenekli PHP geliştiricilerinin yapabileceği göz korkutucu bir görev olarak göründü. WordPress deneyimimin çoğu özel tema geliştirmede yatmaktadır, bu nedenle eklenti geliştirmeye girişmek sahte ve korkutucu görünüyordu. Ama iyi haberler getirdim! Yakın zamanda WordPress eklenti dizininde bulunan iki eklenti yayınladım ve tahmin edin ne oldu? İnandığınız kadar korkutucu değildi! Geliştirme tamamlandıktan sonra WordPress.org'da yayınlamak aslında oldukça hoş bir deneyimdi.

Bu makale mutlaka eklenti oluşturma ayrıntılarına girmeyecek, bunun yerine eklentinizi gerçekten başlatmak ve WordPress.org dizininde ve dünyadaki her WordPress sitesinde kullanıma sunmak için gereken adımları kapsayacaktır. Yine de referans olarak, eklentilerim için bir başlangıç ​​noktası olarak WordPress Plugin Boilerplate kullandım ve hepsini GitHub'da açık kaynaklı hale getirdim (kesinlikle tavsiye edilir).

Benioku.txt

WordPress'in eklentinizi kabul etmesi için sahip olmanız gereken ilk şey bir Readme.txt dosyasıdır. Eklentinizle ilgili tüm bilgileri içerir ve WordPress.org dizininde eklentiniz için sayfalar oluşturmak için WordPress'in kullandığı şeydir (Açıklama, Kurulum ve Ekran Görüntüleri sekmeleri gibi).

Benioku formatı şöyle görünür:

=== Plugin Name ===

Contributors: yourname

Donate link: http://yoursite.com

Tags: business, directory

Requires at least: 4.3

Tested up to: 4.3

Stable tag: 4.3

License: GPLv2 or later

License URI: http://www.gnu.org/licenses/gpl-2.0.html
A simple description
== Description ==
A longer description with a
- list

- of

- features
== Installation ==
This section describes how to install the plugin and get it working.
1. Upload [`plugin-name`](link-to-github.zip) to the `/wp-content/plugins/` directory

2. Activate the plugin through the 'Plugins' menu in WordPress
== Frequently Asked Questions ==
= Is this a cool plugin? =
Yes
== Screenshots ==
1. Desktop view
2. Mobile view
== Changelog ==
= v1.0.0 =

* Initial release

Tam bir örnek burada bulunabilir. BeniOku'nuzun eşit olup olmadığını kontrol etmek için kullanışlı bir doğrulayıcı da mevcuttur.

Değişiklik günlüğü ve sürüm oluşturma

Eklentinizin sürüm numarasını güncel tutmanız önemlidir, böylece başka bir şey olmazsa, güncellemeler olduğunda kullanıcılar bilgilendirilebilir. Değişiklik günlüğünü güncellemek, BeniOku'daki değişiklik günlüğü bölümüne yeni bir giriş eklemek kadar basittir. Sürüm oluşturma ve neyin büyük veya küçük sürüm olarak kabul edilmesi gerektiğine ilişkin birkaç farklı bakış açısı vardır; Bununla ilgili referans için Semantic Versioning 2.0.0 sitesine başvurmayı seviyorum.

Örnek olarak, eklentinizi 1.0.0 sürümünde gönderdiğinizi varsayalım. Ardından ertesi gün, eklentiyi ilk yayınladığınızda unuttuğunuz küçük bir hatayı düzeltir veya küçük bir işlevsellik eklersiniz. Eklentiyi WordPress dizinine dağıtmadan önce (bunu daha sonra nasıl yapacağınız hakkında daha fazla bilgi için), Readme'deki değişiklik günlüğü bölümünü şuna benzer bir şekilde güncellersiniz:

== Changelog ==
= v1.0.1 =

* Fix a thing that allows users to do a thing
= v1.0.0 =

* Initial release

Ardından (bu önemlidir), eklenti önyükleme dosyasındaki sürüm numarasını güncellemeniz gerekir. Bir eklenti yazıyorsanız, önyükleme dosyasına aşina olmalısınız, ancak başvuru için, WordPress'e en üstteki yorum bloğu aracılığıyla tüm eklenti hakkında bilgi veren dosyadır.

Eklenti önyükleme dosyasının yorum bloğu.

WordPress.org'a gönderin

Yerinde bir Readme ve kapsamlı testler yapıldığında, eklentiyi WordPress'e göndermeye hazırsınız! Bu, tüm sürecin en kolay kısmıdır. https://wordpress.org/plugins/add/ adresine gidin, WordPress hesabınızla giriş yapın (veya bir tane oluşturun) ve kısa formu doldurun.

WordPress eklentisi gönderme formu.

Eklenti adında “WordPress” adını kullanmamaya dikkat edin. Bunu yaparsanız eklentiyi reddedeceklerdir. Ayrıca, ticari markalı bir ürünün adını eklerseniz veya eklentiniz başka bir eklentinin adıyla başlarsa eklentiyi reddederler. Göndermeye çalıştığım ve Ninja Forms'u genişleten bir eklentiyle bunu zor yoldan öğrendim ve bir e-postada şu yanıtı aldım:

Artık, bir eklentinin adı veya kısa bilgisi olarak ticari markalı bir ürün adı veya terimi içeren eklentileri kabul etmiyoruz. Adın/sümüklüböceğin başında başka bir eklentinin adını içeren eklentileri de kabul etmiyoruz.

Güzel bir açıklama yazmak için zaman ayırdığınızdan emin olun ve ardından eklentinizin bağlantısını son alana bir ZIP dosyasına bırakın. Eklenti geliştirme için GitHub'ı kullanmak, herkese açık bir ZIP'ye sahip olmayı gerçekten kolaylaştırır.

"Download ZIP" eklentisinin URL'sini GitHub deponuzdan kopyalayın.

Eklentiyi gönderdikten sonra arkanıza yaslanın ve bekleyin! Her iki eklentim de yaklaşık iki gün içinde kabul edildi. Kabul edilirse, yeni SVN deposu hakkında bilgi içeren bir e-posta alacaksınız. Bu da bizi bir sonraki adıma getiriyor – konuşlandırma!

SVN ile dağıtın

Eklenti kabul edildikten sonra, henüz yayında değil. Dosyaları aslında WordPress'in size sağladığı SVN deposuna yüklemeniz gerekir. Bundan önce SVN'yi hiç kullanmamıştım, ancak makaleleri, terminalden oldukça hızlı bir şekilde oturum açmanıza yardımcı oluyor. Temel olarak, bilgisayarınızda bir klasör oluşturursunuz, SVN deposunu kontrol edin, eklenti dosyalarınızı yeni oluşturulan /trunk klasörüne kopyalayın ve tekrar yukarı itin.

Bunu, her değişikliği dağıtmanız gerektiğinde terminal aracılığıyla yapabilir veya Ship adlı kullanışlı bir araç kullanabilirsiniz. Yaptığım her dağıtım için Ship kullandım ve GitHub'da yeni bir yayın etiketlediğinizde otomatik olarak SVN deposuna dağıtılarak bir cazibe gibi çalışıyor. GitHub kullanıyorsanız (ki yine öyle olmalısınız) bu ücretsiz hizmeti şiddetle tavsiye ederim.

En iyi dağıtım süreci ve sürdürülebilirlik için, her dağıtım yaptığınızda yayınları veya etiketleri kullanmak önemlidir. Eklenti dosyanızdaki ve değişiklik günlüğünüzdeki sürüm numarasını güncellediğiniz gibi, GitHub'da da yeni sürümler yayınlıyor olmalısınız. Aslında Ship'i kullanmak için bunu yapmak gerekiyor.

Son olarak, Ship'e kaydolduğunuzda ve ona bağlanmak için deponuzu seçtiğinizde, ilk sürümünüzü dağıtabilirsiniz (adın GitHub'daki sürüm adıyla eşleştiğinden emin olun). Bundan sonra, WordPress Ayrıntıları başlığı altındaki formu doldurduğunuz sürece, GitHub'da yeni bir sürüm yayınlandığında Ship sadece dağıtılacaktır.

Geminin depo ayarları kullanıcı arayüzü.

Ekran görüntüleri ve afiş görüntüleri

Eklentinizin ekran görüntülerini görüntülemek, insanların nasıl göründüğünü görsel olarak görmelerine yardımcı olmak ve nasıl çalıştığı hakkında onlara bir fikir vermek için çok önemlidir. Bu ekran görüntüleri, WordPress.org eklenti dizini sayfasında (örneğin, takvim eklentimin ekran görüntüsü sayfası burada) ve bir kullanıcı Eklentiler sayfası aracılığıyla sitelerine bir eklenti eklediğinde görünecektir.

Afiş resimleri ekran görüntüleri kadar önemli değildir, ancak eklentinizin biraz daha etkileyici görünmesini sağlar. Başlık resmi, WordPress.org eklenti dizini sayfasının üst kısmında gösterilen büyük resimdir.

Buradaki koyu mavi gradyan afiştir.

Bu resimlerin gösterilmesini sağlamak için onları SVN deponuzun /assets dizinine yerleştirmeniz gerekir. Ne yazık ki, yalnızca /trunk klasörünü dağıttığı için bunun için Ship'i kullanamazsınız, bu nedenle SVN deponuzda oturum açmak için bu makaleye tekrar başvurmanız gerekir.

İşleri basit tutmak için ekran görüntülerinizi ekran görüntüsü olarak adlandırmaya devam edin ekran screenshot-#.png (burada "#" sayıdır). Bu şekilde yapmak, BeniOku'daki resimlere bir açıklama vermek için kolayca başvurmanıza olanak tanır.

== Screenshots ==
1. Desktop view
2. Mobile view

Örneğin, Benioku bölümündeki Ekran görüntüsü bölümündeki "Masaüstü görünümü" açıklaması /assets klasöründeki screenshot-1.png ile eşleşecektir.
Afiş için aslında aynı görüntünün iki versiyonuna ihtiyacınız var – biri normal ekranlar için diğeri retina ekranlar için. Banner görsellerinin adları banner-1544x500.png ve banner-772x250.png .

Son

Bu kadar! Takip ettiyseniz, umarım eklentiniz kabul edilmiştir ve harika yeni eklentiniz hakkında bilgi vermeye hazırsınızdır. Eklentiyi her güncellediğinizde Benioku'yu, değişiklik günlüğünü ve yayın sürümlerini her zaman güncellemeyi unutmayın.