จะเพิ่มปลั๊กอินใน WordPress Repository ได้อย่างไร?


11

ฉันเพิ่งสร้างปลั๊กอินแรกและได้รับการอนุมัติโดย WordPress ข่าวดีสำหรับฉัน แต่ตอนนี้คืออะไร "คำแนะนำ" ใน Codex เป็นอะไรที่ชัดเจนสำหรับฉัน ฉันพบบทความเกี่ยวกับDig WPและฉันจัดการเพื่อรับรหัสบรรทัดที่ 3 หลังจากนั้นไม่มีความสุข

ใครบ้างที่นี่มีชุดคำสั่งที่ชัดเจนเกี่ยวกับวิธีการทำเช่นนี้โดยไม่จำเป็นต้องอ่านหนังสือทั้งเล่ม? ฉันแน่ใจว่ามีคนที่มีประสบการณ์มากที่ทำสิ่งนี้ตลอดเวลา ...

ขอบคุณล่วงหน้า!


ลองสิ่งนี้: digimantra.com/tutorials/wordpress/…นี่: 1manfactory.com/…
Bainternet

@Piet: หากลิงก์ Bainternet กล่าวถึงคำตอบของเขาด้านล่างไม่ตอบคำถามของคุณเราจะต้องรู้ว่าระบบปฏิบัติการ & svn tools ใดที่คุณใช้อยู่
Manzabar

ขออภัยฉันควรได้กล่าวว่าฉันใช้ OSX 10.6 (Mac) นอกจากนี้ยังเป็นวิธีที่ดีในการแนะนำขั้นตอนการเขียนไฟล์ readme.txt แต่ไม่จำเป็นเนื่องจากปลั๊กอินได้รับการอนุมัติโดย WordPress.org แล้ว ตอนนี้ฉันอยู่ภายใต้การสันนิษฐานว่ามันจะได้รับการอนุมัติเฉพาะถ้าไฟล์ readme.txt ตรวจสอบความถูกต้องซึ่งโดยวิธีการที่มันทำ :)

และฉันดาวน์โหลด SVN จากเว็บไซต์ทางการ (?) แต่ฉันไม่รู้ว่ามันทำงานยังไงและฉันควรทำยังไง ดังที่ฉันได้กล่าวไปฉันได้ติดตามการสอนเกี่ยวกับ DIG WP และจัดการเพื่อให้ได้ 3 บรรทัดแรกเสร็จก่อนที่โปรแกรมจะหยุดฉัน ($ mkdir my-local-dir $ svn co svn.wp-plugins.org/your-plugin- ชื่อ my-local-dir $ cd my-local-dir /)

ที่จริงแล้วแอปพลิเคชันไม่มีส่วนเกี่ยวข้องกับไฟล์ readme ฉันมักจะใช้ (และได้รับการอนุมัติ) ก่อนที่ฉันจะเริ่มพัฒนาปลั๊กอิน
EAMann

คำตอบ:


12

ขั้นตอนที่ 1 - ตรวจสอบให้แน่ใจว่ารูปแบบถูกต้อง

WordPress นั้นขึ้นอยู่กับส่วนหัวที่ด้านบนของไฟล์ปลั๊กอินหลักของคุณ ในหลายกรณีหากปลั๊กอินของคุณคือ "My Cool Plugin" ไฟล์นี้อยู่my-cool-plugin.phpในไดเรกทอรีหลักของโฟลเดอร์ของคุณ ตรวจสอบให้แน่ใจว่าส่วนบนของไฟล์เป็นไปตามรูปแบบนี้:

<?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 ขึ้นอยู่กับreadme.txtไฟล์ของคุณเพื่อสร้างคำอธิบายและหน้าดาวน์โหลด ดังนั้นตรวจสอบให้แน่ใจว่าreadme.txtไฟล์ของคุณตรงกับรูปแบบต่อไปนี้:

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

มีเครื่องมือตรวจสอบ readme ที่มีประโยชน์ใน WordPress.org คุณสามารถใช้เพื่อให้แน่ใจว่า readme ของคุณมีทุกอย่างที่ต้องการ เพียงคัดลอกวางแล้วมันจะตรวจสอบเพื่อให้แน่ใจว่าทุกส่วนมีและคุณพร้อมที่จะไป

ขั้นตอนที่ 2 - ตรวจสอบพื้นที่เก็บข้อมูล SVN

เป็นความคิดที่ดีที่จะแยกเวอร์ชันการพัฒนาออกจากที่เก็บปลั๊กอิน WordPress.org ใช่ SVN ใช้สำหรับควบคุมเวอร์ชัน แต่ WordPress ใช้มันมากกว่าสำหรับการจัดการรีลีส หากคุณเริ่มต้นยอมรับการเปลี่ยนแปลงทุกชุดในที่เก็บคุณอาจพบปัญหา สิ่งหนึ่งที่นักพัฒนาจำนวนมากทำคือการพัฒนาแบบโลคัลโดยใช้ Git จากนั้นถ่ายโอนไฟล์ของคุณไปยังพื้นที่เก็บข้อมูล Subversion เมื่อคุณพร้อมที่จะเปิดตัว

คำแนะนำเหล่านี้ถือว่าคุณใช้คอมพิวเตอร์ Windows หากคุณใช้ Mac คุณสามารถใช้SCPluginแทน TortoiseSVN ขั้นตอนที่คุณต้องปฏิบัติตามจะเหมือนกันเฉพาะเมนูบริบทและภาพหน้าจอจะแตกต่างกันเล็กน้อยเนื่องจาก UI ฉันไม่มี Mac ดังนั้นฉันจึงไม่สามารถสร้างภาพหน้าจอเพื่อแนะนำคุณผ่านการกวดวิชา ... แต่เชื่อใจฉันมันเป็นกระบวนการเดียวกัน

ติดตั้ง TortoiseSVN หากคุณยังไม่มี

TortoiseSVNเป็น Open Source Subversion GUI สำหรับ Windows เชื่อใจฉันการใช้ GUI นั้นง่ายกว่าการพยายามทำสิ่งต่าง ๆ จากบรรทัดคำสั่ง คุณจะพบปัญหาน้อยลงเช่นกัน

ตรวจสอบพื้นที่เก็บข้อมูล SVN ที่โฮสต์โดย WordPress ของคุณ

ค้นหาสถานที่ที่คุณต้องการเก็บปลั๊กอินเวอร์ชั่นที่โฮสต์โดย WordPress โดยค่าเริ่มต้นฉันใช้/My Documents/WordPress/สำหรับงาน dev ที่โฮสต์ทั้งหมดของฉัน คลิกขวาภายในโฟลเดอร์และเลือก "SVN Checkout" จากเมนูแบบเลื่อนลง

TortoiseSVN เมนูตามบริบท

ในหน้าต่างข้อความที่ปรากฏขึ้นให้ป้อน URL ที่เก็บปลั๊กอิน WordPress.org ของคุณ (ฉันใช้ของฉันเพื่อการสาธิต) และเลือกโฟลเดอร์ย่อยที่คุณต้องการสร้าง

กล่องโต้ตอบชำระเงิน

เต่าจะคิดสักเล็กน้อยจากนั้นจะดึงที่เก็บลงมาจาก WordPress.org โฟลเดอร์ที่สร้างขึ้นใหม่จะมีโฟลเดอร์ที่จำเป็นทั้งหมดติดตั้งไว้แล้วสำหรับคุณ ตอนนี้คุณเพียงแค่คัดลอกและวาง ... ทีละขั้นตอน

คัดลอกเวอร์ชันล่าสุดของคุณลงใน /tags

นี่คือที่ฉันทำสิ่งต่าง ๆ ย้อนหลังจากบทเรียนส่วนใหญ่ ทุกคนจะบอกให้คุณทำ/trunkก่อนอื่น แต่อย่าลืมว่า WordPress ไม่ได้ใช้สิ่งใด/trunkนอกจากไฟล์ readme เมื่อดูที่ปลั๊กอิน ดังนั้นหากคุณใส่ปลั๊กอินของคุณ/trunkและสูญเสียการเชื่อมต่อเครือข่ายของคุณ (หรือมีบางอย่างผิดปกติ) ก่อนที่จะส่งแท็กคุณจะพบปัญหา

ใน/tagsโฟลเดอร์ให้สร้างโฟลเดอร์ชื่อเดียวกับเวอร์ชันที่คุณกำลังเปิดตัวปลั๊กอิน ดังนั้นหากคุณกำลังปล่อยเวอร์ชั่น 0.1 ให้สร้าง/tags/0.1โฟลเดอร์

คลังเก็บแท็กโฟลเดอร์

คัดลอกปลั๊กอินทั้งหมดของคุณลงในโฟลเดอร์นี้

ตอนนี้คลิกขวาภายในโฟลเดอร์และเลือก "SVN Commit" จากเมนูแบบเลื่อนลง

คุณจะเห็นหน้าต่างป็อปอัพที่แสดงการเปลี่ยนแปลงทั้งหมดของคุณ (คุณควรเห็นไฟล์ใหม่ทั้งหมดของคุณถูกทำเครื่องหมายว่า "ไม่ใช่เวอร์ชัน")

หน้าต่างกระทำ

ทำเครื่องหมายที่ช่องถัดจากไฟล์ปลั๊กอินทั้งหมดของคุณ (หรือคลิก "เลือกทั้งหมด" เพื่อเลือกทั้งหมด)

ในกล่องด้านบนให้ป้อนข้อความยืนยัน เนื่องจากคุณกำลังทำแท็กคุณควรใช้สิ่งต่อไปนี้:

การแท็กเวอร์ชัน 0.1 ของ [ปลั๊กอินของฉัน]

คลิกตกลง

อีกครั้ง Tortoise จะคิดอีกสองสามนาทีจากนั้นจะขอชื่อผู้ใช้และรหัสผ่าน WordPress ของคุณเพื่อส่งไปยังเซิร์ฟเวอร์ ให้พวกเขารอสิ่งที่ต้องผ่านและพูดว่า "ความสำเร็จ" จากนั้นไปยังขั้นตอนต่อไป

คัดลอกเวอร์ชันล่าสุดของคุณลงใน /trunk

ตอนนี้นำทางไปยัง/trunkโฟลเดอร์ของที่เก็บและคัดลอกปลั๊กอินของคุณไปยังโฟลเดอร์นั้นอีกครั้ง ทำตามขั้นตอนเดียวกันด้านบนเพื่อเลือกไฟล์ของคุณและเตรียมการส่งมอบ แต่สำหรับข้อความให้ใช้สิ่งที่อธิบายถึงสิ่งที่รุ่นใหม่ทำ:

เวอร์ชั่น 0.1 ของ [My Plugin] - เพิ่มการรองรับ OpenID

เมื่อทุกอย่างผ่านไปแล้วคุณเพียงแค่รอให้เซิร์ฟเวอร์ของ WordPress.org ติดตามเท่านั้น อาจช้ากว่าวันอื่น ๆ แต่ภายในหนึ่งชั่วโมงหรือมากกว่านั้นคุณควรเห็นรีลีสใหม่ของคุณในที่เก็บ

การอัปเดตปลั๊กอินเป็นเวอร์ชันใหม่

เมื่อปลั๊กอินของคุณอยู่ในสภาพที่พร้อมการเตรียมการอัปเดตจะค่อนข้างง่าย

ขั้นแรกให้ใช้คำสั่ง SVN Update เพื่อให้แน่ใจว่าคุณมีที่เก็บเวอร์ชันล่าสุด หากคุณเป็นนักพัฒนาเพียงคนเดียวคุณควรมีอยู่แล้ว แต่ควรอัปเดตก่อนที่จะส่ง

จากนั้นทำตามขั้นตอนด้านบนเพื่อสร้างโฟลเดอร์ย่อยใหม่/tagsสำหรับรุ่นใหม่ของคุณ /tags/0.2กล่าวว่า อย่าแตะที่/0.1โฟลเดอร์เก่า มันอยู่ที่นั่นด้วยเหตุผลและคุณจะไม่มีวันแตะอีกครั้ง

ยอมรับแท็กใหม่ของคุณจากนั้นไปที่/trunkโฟลเดอร์ แทนที่ทุกสิ่ง/trunkด้วยเวอร์ชันใหม่ของคุณและกระทำตามข้างต้น เมื่อเซิร์ฟเวอร์อัปเดตแล้วพวกเขาจะเริ่มพูดคุยเกี่ยวกับเวอร์ชันใหม่แทนที่จะเป็นเวอร์ชั่นเก่า


1
ฉันชอบทำทุกอย่างจากท้ายรถเพราะมันช่วยให้ฉันได้รับประวัติศาสตร์ที่ดีว่าทุกบรรทัดมาจากไหน ด้วยวิธีการของคุณทุกอย่างจะไม่เหมือนที่ปรากฏในรุ่นล่าสุด?
Jan Fabry

ขอบคุณมากสำหรับคำแนะนำโดยละเอียด @EAMann น่าเสียดายที่ฉันอยู่บน Mac ขออภัยฉันควรได้กล่าวถึงว่าในคำถามของฉันไม่ดี ...

1
@Jan นั่นคือเหตุผลที่ฉันให้ฉันพัฒนา repo แยกจากฉันปล่อย repo ฉันเสียสิ่งมากมายเมื่อใช้ repos WP.org สำหรับการพัฒนาที่ใช้งานอยู่ดังนั้นฉันจึงพัฒนาโลคอลด้วย Git หรือ Hg สำหรับประวัติเวอร์ชันเต็มจากนั้นคัดลอกไปยัง WP Svn repo เมื่อฉันสร้างรีลีส
EAMann

@Piet ในกรณีนี้ให้ดูที่SCPluginสำหรับ Mac คำแนะนำจะเหมือนกันทุกภาพเท่านั้นจะแตกต่างกันไป มันทำโดยคนจำนวนมากดังนั้นมันจะทำงานเหมือนกับ Tortoise
EAMann

@EAMann ขอบคุณฉันดาวน์โหลดตอนนี้จะแจ้งให้คุณทราบว่ามันจะไป ...
โดยการใช้ไซต์ของเรา หมายความว่าคุณได้อ่านและทำความเข้าใจนโยบายคุกกี้และนโยบายความเป็นส่วนตัวของเราแล้ว
Licensed under cc by-sa 3.0 with attribution required.