Bagaimana cara menambahkan plugin ke WordPress Repository?

11

Saya baru saja membuat plugin pertama dan disetujui oleh WordPress. Berita bagus untuk saya, tapi sekarang bagaimana? "Instruksi" pada Codex sama sekali tidak jelas bagi saya. Saya menemukan sebuah artikel di Dig WP dan saya berhasil mendapatkan ke baris kode ke-3. Setelah itu tidak ada sukacita.

Apakah ada orang di sini yang memiliki serangkaian instruksi yang jelas tentang cara melakukan ini tanpa perlu membaca seluruh buku? Saya yakin ada orang yang sangat berpengalaman di sini yang melakukan hal ini setiap saat ...

Terima kasih sebelumnya!


sumber
@Piet: Jika tautan yang disebutkan Bainternet dalam jawabannya di bawah tidak menjawab pertanyaan Anda, kami perlu mengetahui alat OS & svn apa yang Anda gunakan.
Manzabar
yup maaf, saya seharusnya menyebutkan bahwa saya menggunakan OSX 10.6 (Mac). Juga, sangat baik untuk membimbing saya melalui langkah-langkah cara menulis file readme.txt, tetapi tidak perlu karena plugin sudah disetujui oleh WordPress.org. Sekarang saya berada di bawah asumsi bahwa itu hanya dapat disetujui jika file readme.txt memvalidasi, yang omong-omong :)
dan saya mengunduh SVN dari situs resmi (?) tapi saya tidak tahu cara kerjanya dan apa yang harus saya lakukan dengannya. Seperti yang saya sebutkan, saya mengikuti tutorial tentang DIG WP dan berhasil menyelesaikan 3 baris pertama, sebelum program berhenti pada saya ($ mkdir my-local-dir $ svn co svn.wp-plugins.org/your-plugin-
Sebenarnya, aplikasi tidak ada hubungannya dengan file readme. Saya sering mendaftar (dan disetujui) bahkan sebelum saya memulai pengembangan di sebuah plugin.
EAMann

Jawaban:

12

Langkah 1 - Pastikan semuanya diformat dengan benar

WordPress sendiri tergantung pada tajuk di bagian atas file plugin utama Anda. Dalam banyak kasus, jika plugin Anda adalah "My Cool Plugin" file ini ada my-cool-plugin.phpdi direktori utama folder Anda. Pastikan bagian atas file mengikuti format ini:

<?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]
*/

Repositori WordPress.org bergantung pada readme.txtfile Anda untuk membuat deskripsi dan mengunduh halaman. Jadi pastikan readme.txtfile Anda sesuai dengan format berikut:

=== [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 ==

Ada validator readme berguna di WordPress.org yang dapat Anda gunakan untuk memastikan readme Anda memiliki semua yang dibutuhkan. Cukup salin-tempel dan itu akan memeriksa untuk memastikan semua bagian di sana dan bahwa Anda siap untuk pergi.

Langkah 2 - Lihat repositori SVN

Merupakan ide bagus untuk memisahkan versi pengembangan Anda dari repositori plugin WordPress.org. Ya, SVN digunakan untuk kontrol versi, tetapi WordPress lebih menggunakannya untuk manajemen rilis. Jika Anda mulai melakukan setiap perubahan pada repositori, Anda akan berpotensi mengalami masalah. Satu hal yang dilakukan banyak pengembang adalah mengembangkan secara lokal menggunakan Git, kemudian mentransfer file Anda ke repositori Subversion ketika Anda siap untuk melakukan rilis.

Petunjuk ini menganggap Anda menggunakan komputer Windows. Jika Anda menggunakan Mac, Anda dapat menggunakan SCPlugin alih-alih TortoiseSVN. Langkah-langkah yang harus Anda ikuti akan sama, hanya menu kontekstual dan tangkapan layar akan sedikit berbeda karena UI. Saya tidak punya Mac, jadi saya tidak bisa membuat tangkapan layar untuk memandu Anda melalui tutorial ... tapi percayalah, ini proses yang sama.

Instal TortoiseSVN jika Anda belum memilikinya.

TortoiseSVN adalah open source Subversion GUI untuk Windows. Percayalah, menggunakan GUI jauh lebih mudah daripada mencoba melakukan hal-hal dari baris perintah. Anda juga akan mengalami lebih sedikit masalah.

Lihat repositori SVN Anda yang di-hosting-WordPress

Temukan tempat di mana Anda ingin menyimpan versi plugin yang dihosting oleh WordPress. Secara default, saya menggunakan /My Documents/WordPress/untuk semua pekerjaan dev yang di-host saya. Klik kanan di dalam folder, dan pilih "SVN Checkout" dari menu dropdown.

Menu Kontekstual TortoiseSVN

Di jendela dialog yang muncul, masukkan URL repositori plugin WordPress.org Anda (saya menggunakan salah satu milik saya untuk tujuan demonstrasi) dan pilih subfolder mana yang ingin Anda buat.

Dialog Checkout

Tortoise akan berpikir sebentar, lalu akan menarik repositori dari WordPress.org. Folder yang baru dibuat akan memiliki semua folder yang diperlukan sudah disiapkan untuk Anda. Sekarang Anda tinggal menyalin dan menempelkan ... selangkah demi selangkah.

Salin versi terbaru Anda ke /tags

Di sinilah saya melakukan hal-hal mundur dari kebanyakan tutorial. Semua orang akan memberi tahu Anda untuk melakukan /trunklebih dulu, tetapi ingat bahwa WordPress tidak menggunakan apa pun /trunkkecuali file readme ketika melihat plugin. Jadi jika Anda memasukkan plugin ke dalam /trunkdan kehilangan koneksi jaringan Anda (atau sesuatu yang tidak beres) sebelum Anda melakukan tag, Anda akan memiliki masalah.

Di /tagsfolder, buat folder dengan nama yang sama dengan versi yang Anda rilis untuk plugin Anda. Jadi, jika Anda merilis versi 0.1, buat /tags/0.1folder.

Folder Tag Repositori

Salin seluruh plugin Anda ke folder ini.

Sekarang klik kanan di dalam folder dan pilih "SVN Commit" dari menu dropdown.

Anda akan melihat jendela sembulan yang menunjukkan semua perubahan Anda (Anda akan melihat semua file baru Anda ditandai sebagai "non-versi").

Jendela Komit

Centang kotak di sebelah semua file plugin Anda (atau klik "Pilih Semua" untuk memilih semuanya).

Di kotak di atas, masukkan pesan komit. Karena Anda melakukan tag, Anda mungkin harus menggunakan sesuatu seperti:

Memberi tag versi 0.1 dari [My Plugin].

Klik OK.

Sekali lagi, Tortoise akan berpikir selama beberapa menit, kemudian ia akan menanyakan nama pengguna dan kata sandi WordPress Anda untuk berkomitmen ke server. Berikan mereka, tunggu sampai semuanya selesai dan katakan "Sukses," kemudian lanjutkan ke langkah berikutnya.

Salin versi terbaru Anda ke /trunk

Sekarang navigasikan ke /trunkfolder repositori dan sekali lagi salin-tempel plugin Anda ke folder itu. Ikuti langkah-langkah yang sama di atas untuk memilih file Anda dan menyiapkan komit. Tetapi untuk sebuah pesan, gunakan sesuatu yang menjelaskan apa yang dilakukan oleh rilis baru:

Versi 0.1 dari [Plugin Saya] - menambahkan dukungan untuk OpenID.

Setelah semuanya berjalan, Anda hanya perlu menunggu sedikit agar server WordPress.org dapat menyusul. Mereka mungkin lebih lambat beberapa hari daripada yang lain, tetapi dalam satu jam atau lebih Anda akan melihat rilis baru Anda di repositori.

Memperbarui plugin ke versi baru

Setelah plugin Anda berada di alam bebas, menyiapkan pembaruan relatif mudah.

Pertama, gunakan perintah Pembaruan SVN untuk memastikan Anda memiliki repositori versi terbaru. Jika Anda adalah satu-satunya pengembang, Anda seharusnya sudah melakukannya, tetapi sebaiknya Anda memperbarui sebelum melakukan komitmen.

Kemudian lakukan proses di atas untuk membuat sub-folder /tagsbaru untuk versi baru Anda. Katakan /tags/0.2,. Jangan menyentuh /0.1folder lama . Itu ada di sana karena suatu alasan dan Anda tidak akan pernah menyentuhnya lagi.

Komit tag baru Anda, lalu buka /trunkfolder. Ganti semuanya /trunkdengan versi baru Anda dan komit seperti di atas. Setelah server diperbarui, mereka akan mulai berbicara tentang versi baru daripada yang lama.

EAMann
sumber
1
Saya lebih suka melakukan semuanya dari bagasi, karena memungkinkan saya untuk mendapatkan sejarah yang bagus dari mana setiap baris berasal . Dengan pendekatan Anda, tidakkah semuanya tampak seperti itu muncul di versi terbaru?
Jan Fabry
terima kasih banyak untuk petunjuk terperinci @EAMann. Sayangnya saya di Mac, maaf, saya seharusnya menyebutkan bahwa dalam pertanyaan saya, salah saya ...
1
@ Jan Itulah alasan saya menjaga repo pengembangan saya terpisah dari repo rilis saya . Saya telah memecahkan banyak hal ketika menggunakan repositori WP.org untuk pengembangan aktif, jadi saya mengembangkan secara lokal dengan Git atau Hg untuk riwayat versi lengkap, kemudian salin ke dalam repo WP Svn ketika saya membuat rilis.
EAMann
@Piet Dalam hal ini, lihat SCPlugin untuk Mac. Instruksi akan persis sama, hanya tangkapan layar akan berbeda. Itu dibuat oleh banyak orang yang sama, jadi itu akan berfungsi seperti Tortoise.
EAMann
@EAMann Terima kasih saya mengunduhnya sekarang, akan memberi tahu Anda bagaimana hasilnya ...