WordPress Deposuna Eklenti Nasıl Eklenir?


11

İlk eklentimi yaptım ve WordPress tarafından onaylandı. Benim için harika bir haber ama şimdi ne olacak? Kodeks'teki "talimatlar" benim için açık bir şey değil. Dig WP hakkında bir makale buldum ve kodun 3. satırına ulaşmayı başardım. Ondan sonra neşe yok.

Buradaki herkesin bir kitabın tamamını okumaya gerek kalmadan bunun nasıl yapılacağı konusunda açık bir talimat seti var mı? Eminim burada her zaman bu işi yapan çok deneyimli insanlar var ...

Şimdiden teşekkürler!



@Piet: Bainternet'in aşağıdaki cevabında bahsettiği bağlantılar sorunuza cevap vermiyorsa, hangi OS & svn araçlarını kullandığınızı bilmemiz gerekir.
Manzabar

evet üzgünüm, OSX 10.6 (Mac) üzerinde olduğumu söylemeliydim. Ayrıca, readme.txt dosyasının nasıl yazılacağı konusunda bana rehberlik etmek çok naziktir, ancak eklenti WordPress.org tarafından zaten onaylandığından gerekli değildir. Şimdi sadece readme.txt dosyası doğrular, bu şekilde doğrulanırsa onaylanabileceği varsayımı altındaydım :)

ve resmi siteden SVN indirdim (?) ama nasıl çalıştığı ve ne yapmam gerektiği konusunda bir fikrim yok. Bahsettiğim gibi, DIG WP ile ilgili öğreticiyi takip ettim ve program beni durdurmadan önce ilk 3 satırı tamamlamayı başardım ($ mkdir my-local-dir $ svn co svn.wp-plugins.org/your-plugin- adı my-local-dir $ cd my-local-dir /)

Aslında uygulamanın benioku dosyasıyla ilgisi yoktur. Bir eklenti üzerinde geliştirmeye başlamadan önce sık sık başvuruyorum (ve onaylanıyorum).
EAMann

Yanıtlar:


12

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.phpklasö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.txtbir açıklama ve indirme sayfası oluşturmak için dosyanıza bağlıdır . Bu nedenle readme.txtdosyanı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.

TortoiseSVN İçerik Menüsü

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.

Checkout İletişim Kutusu

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 /trunkilk önce taahhütte bulunmanızı söyleyecektir , ancak WordPress'in /trunkeklentilere 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 /tagsklasö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.1klasör oluşturun.

Havuz Etiketleri Klasörü

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).

İşlem Penceresi

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 /trunkdeponun 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.1klasöre dokunmayın . Bir sebepten dolayı orada ve bir daha asla dokunmayacaksınız.

Yeni etiketinizi girin, ardından /trunkklasöre gidin . Her şeyi /trunkyeni 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.


1
Her şeyi bagajdan yapmayı tercih ederim, çünkü her hattın nereden geldiğiyle ilgili güzel bir geçmişe sahip olmamı sağlıyor . Yaklaşımınızla, her şey en son sürümde görünmeyecek mi?
Jan Fabry

detaylı talimatlar için çok teşekkürler @EAMann. Ne yazık ki

1
Bu sebep @Jan benim tutmak gelişimini benim ayrı Repo bırakma repo. Aktif geliştirme için WP.org depolarını kullanırken çok kötü şeyler kırdım, bu yüzden tam sürüm geçmişi için Git veya Hg ile yerel olarak geliştiriyorum, sonra bir sürüm oluştururken sadece WP Svn deposuna kopyaladım.
EAMann

@Piet Bu durumda, Mac için SCPlugin'e bakın. Talimatlar tamamen aynı olacak, sadece ekran görüntüleri farklı olacak. Aynı insanlar tarafından yapılır, bu yüzden tıpkı Tortoise gibi işlev görür.
EAMann

@EAMann Teşekkürler Şimdi indiriyorum, nasıl gittiğini size bildirir ...
Sitemizi kullandığınızda şunları okuyup anladığınızı kabul etmiş olursunuz: Çerez Politikası ve Gizlilik Politikası.
Licensed under cc by-sa 3.0 with attribution required.