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