1. Adım - İşlerin doğru biçimlendirildiğinden emin olun
WordPress'in kendisi, ana eklenti dosyanızın üst kısmındaki başlıklara bağlıdır. Çoğu durumda, eklentiniz "Benim Serin Eklentim" ise bu dosya my-cool-plugin.php
klasörünüzün ana dizinindedir. Dosyanın üst kısmının şu biçime uygun olduğundan emin olun:
<?php
/*
=== [Plugin Name] ===
Plugin Name: [Plugin name]
Plugin URI: [Website where plugin information can be found - your blog, maybe]
Description: [Short description of your plugin]
Author URI: [Your website]
Author: [Your name]
Version: [This version number]
*/
WordPress.org deposu, readme.txt
bir açıklama ve indirme sayfası oluşturmak için dosyanıza bağlıdır . Bu nedenle readme.txt
dosyanızın aşağıdaki biçime uyduğundan emin olun :
=== [Plugin Name] ===
Contributors: [Your WordPress.org username]
Donate link: [A site people can go to to give you money]
Tags: [Search terms related to your plugin]
Requires at least: [Minimum version of WordPress required]
Tested up to: [Newest version of WordPress you've tested with]
Stable tag: [This version number]
[Short, one-sentence description of your plugin]
== Description ==
[Long description of your plugin]
== Installation ==
[Steps required to install the plugin]
== Frequently Asked Questions ==
= [A question] =
[An answer]
= [Another question] =
[Another answer]
== Screenshots ==
== Changelog ==
== Upgrade Notice ==
WordPress.org'da, benioku dosyanızın ihtiyaç duyduğu her şeye sahip olduğundan emin olmak için kullanabileceğiniz kullanışlı bir benioku doğrulayıcısı vardır. Sadece kopyalayıp yapıştırın ve tüm bölümlerin orada olduğundan ve gitmeye hazır olduğunuzdan emin olun.
Adım 2 - SVN deposuna bakın
Geliştirme sürümünüzü WordPress.org eklenti deposundan ayrı tutmak iyi bir fikirdir. Evet, SVN sürüm kontrolü için kullanılır, ancak WordPress bunu sürüm yönetimi için daha fazla kullanır. Depodaki her değişiklik kümesini gerçekleştirmeye başlarsanız, potansiyel olarak sorunlarla karşılaşırsınız. Bir çok geliştiricinin Git'i kullanarak yerel olarak geliştirmesi, ardından bir sürüm yapmaya hazır olduğunuzda dosyalarınızı Subversion deposuna aktarmasıdır.
Bu talimatlar bir Windows bilgisayar kullandığınızı varsayar. Mac kullanıyorsanız TortoiseSVN yerine SCPlugin kullanabilirsiniz . İzlemeniz gereken adımlar aynı olacaktır, kullanıcı arayüzü nedeniyle yalnızca bağlamsal menüler ve ekran görüntüleri biraz farklı olacaktır. Bir Mac'im yok, bu yüzden size bir eğiticiden geçmek için ekran görüntüleri oluşturamıyorum ... ama bana güven, aynı işlem.
Zaten sahip değilseniz TortoiseSVN'yi yükleyin.
TortoiseSVN , Windows için açık kaynaklı bir Subversion GUI'dir. Güven bana, GUI kullanmak komut satırından bir şeyler yapmaya çalışmaktan çok daha kolaydır. Siz de daha az sorunla karşılaşacaksınız.
WordPress tarafından barındırılan SVN veri havuzunuza göz atın
Eklentinizin WordPress tarafından barındırılan sürümünü depolamak istediğiniz bir yer bulun. Varsayılan olarak, /My Documents/WordPress/
barındırılan tüm dev işlerim için kullanıyorum. Klasörün içini sağ tıklayın ve açılır menüden "SVN Checkout" u seçin.
Açılan iletişim penceresinde, WordPress.org eklenti veri havuzu URL'nizi girin (bir tanesini tanıtım amaçlı kullanıyorum) ve oluşturmak istediğiniz alt klasörü seçin.
Kaplumbağa biraz düşünecek, daha sonra havuzu WordPress.org'dan indirecek. Yeni oluşturulan klasörde sizin için önceden ayarlanmış tüm gerekli klasörler bulunur. Şimdi kopyalayıp yapıştıracaksınız ... her seferinde bir adım.
En son sürümünüzü kopyalayın /tags
Çoğu öğreticiden geriye doğru şeyler yaptığım yer burası. Herkes size /trunk
ilk önce taahhütte bulunmanızı söyleyecektir , ancak WordPress'in /trunk
eklentilere bakarken benioku dosyası dışında hiçbir şey kullanmadığını unutmayın . Dolayısıyla /trunk
, bir etiketi uygulamadan önce eklentinizi koyar ve ağ bağlantınızı kaybederseniz (veya başka bir şey ters giderse) sorun yaşarsınız.
Gelen /tags
klasörüne Eklentinizde için serbest konum sürümüyle aynı adlı bir klasör oluşturun. Dolayısıyla, 0.1 sürümünü yayınlıyorsanız, bir /tags/0.1
klasör oluşturun.
Eklentinizin tamamını bu klasöre kopyalayın.
Şimdi klasörün içine sağ tıklayın ve açılır menüden "SVN İşlemi" ni seçin.
Tüm değişikliklerinizi gösteren bir pencere açılır (tüm yeni dosyalarınızın "sürümlendirilmemiş" olarak işaretlenmiş olduğunu görmeniz gerekir).
Eklentinizin tüm dosyalarının yanındaki kutuyu işaretleyin (veya tümünü seçmek için "Tümünü Seç" i tıklayın).
Üstteki kutuya bir taahhüt mesajı girin. Bir etiket yürüttüğünüz için muhtemelen şöyle bir şey kullanmalısınız:
[Eklentim] 'in 0.1 sürümünü etiketleme.
Tamam'ı tıklayın.
Yine, Tortoise birkaç dakika düşünecek, daha sonra sunucuyu taahhüt etmek için WordPress kullanıcı adınızı ve şifrenizi isteyecektir. Onları sağlayın, işlerin geçmesini bekleyin ve "Başarı" deyin, ardından bir sonraki adıma geçin.
En son sürümünüzü kopyalayın /trunk
Şimdi /trunk
deponun klasörüne gidin ve bir kez daha eklentinizi bu klasöre kopyalayıp yapıştırın. Dosyalarınızı seçmek ve taahhüdü hazırlamak için yukarıdaki aynı adımları uygulayın. Ancak bir mesaj için yeni sürümün ne yaptığını açıklayan bir şey kullanın:
[Eklentim] 'in 0.1 sürümü - OpenID desteği ekler.
Her şey bittiğinde, WordPress.org sunucularının yakalanması için biraz beklemeniz gerekir. Birkaç gün diğerlerinden daha yavaş olabilirler, ancak bir saat içinde depoda yeni sürümünüzü görmelisiniz.
Bir eklentiyi yeni bir sürüme güncelleme
Eklentiniz vahşi duruma geldiğinde, güncelleme hazırlamak nispeten kolaydır.
Öncelikle, deponun en son sürümüne sahip olduğunuzdan emin olmak için SVN Güncelleme komutunu kullanın. Tek geliştiriciyseniz, zaten yapmalısınız, ancak yine de taahhütte bulunmadan önce güncellemek iyi bir uygulamadır.
Ardından /tags
, yeni sürümünüz için yeni bir alt klasör oluşturmak üzere yukarıdaki işlemi uygulayın . Söyle /tags/0.2
. Eski /0.1
klasöre dokunmayın . Bir sebepten dolayı orada ve bir daha asla dokunmayacaksınız.
Yeni etiketinizi girin, ardından /trunk
klasöre gidin . Her şeyi /trunk
yeni sürümünüzle değiştirin ve yukarıdaki gibi işlem yapın. Sunucular güncellendikten sonra eski sürümden ziyade yeni sürüm hakkında konuşmaya başlarlar.