การใช้ Subversion กับ WordPress Plugin Directory

ทำตามคำแนะนำทีละขั้นตอนเหล่านี้เพื่อเพิ่มและอัปเดตปลั๊กอินในไดเรกทอรีปลั๊กอิน WordPress สาธารณะ

ขั้นตอนสำคัญเหล่านี้จากวิดีโอมีดังต่อไปนี้:

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

เริ่มต้นใช้งานปลั๊กอินของคุณ

ไม่ว่าคุณจะมีไอเดียหรือใกล้จะเสร็จแล้วในเวอร์ชัน 0.1 คุณต้องมีชื่อและคำอธิบายสำหรับปลั๊กอินของคุณ ตั้งชื่อให้สั้นและสื่อความหมาย โดยให้แนวคิดว่าปลั๊กอินนี้ใช้ทำอะไร “Wax on Wax off Plugin” ไม่ใช่ชื่อที่ดี “Drop Shadow Maker” ดีกว่ามาก คุณไม่จำเป็นต้องเพิ่ม “ปลั๊กอิน” ให้กับชื่อจริง

เพื่อให้เข้ากับชื่อของคุณ คุณควรเขียนคำอธิบายสั้น ๆ เพื่อบอกผู้คนถึงประโยชน์ของปลั๊กอินของคุณ ฉันแนะนำว่าคำอธิบายนี้มีความยาวไม่เกิน 150 อักขระ

ลงทะเบียนสำหรับบัญชี WordPress.org

หากคุณยังไม่มีบัญชี WordPress.org ซึ่งใช้สำหรับการโต้ตอบในฟอรัมการสนับสนุนและสิ่งที่คล้ายกัน คุณต้องมีบัญชี เพียงเข้าไปที่: https://login.wordpress.org/register

ขอใส่ปลั๊กอินใหม่ของคุณในไดเรกทอรีปลั๊กอินของ WordPress

ปลั๊กอินที่สมเหตุสมผลส่วนใหญ่ที่มาพร้อมกับใบอนุญาตที่เข้ากันได้สามารถรับพื้นที่ในไดเรกทอรีปลั๊กอินของ WordPress

1. ไปที่: http://wordpress.org/extend/plugins/add/
2. กรอกชื่อและคำอธิบายของคุณ
   (ฉันบอกคุณแล้วว่าคุณต้องการสิ่งนั้น!)
3. ข้ามการอัปโหลดปลั๊กอินของคุณจากแบบฟอร์มนี้ แม้ว่าปลั๊กอินของคุณจะพร้อมใช้งานก็ตาม

คำขอไดเรกทอรีปลั๊กอินของคุณดำเนินการโดยคนจริง ดังนั้นอาจใช้เวลาสักครู่

ติดตั้งไคลเอ็นต์ SVN สำหรับเครื่องของคุณ

ในการทำงานกับ Plugin Directory คุณต้องมีไคลเอนต์ Subversion ในเครื่องของคุณ

• สำหรับ Windows ฉันแนะนำ TortoiseSVN
• สำหรับ Mac ดูเหมือนว่า SCPlugin จะเป็นแพ็คเกจที่ดี

เพียงเลือกและติดตั้ง ไม่มีอะไรจะพูดมากไปกว่านั้น

เลือกไดเรกทอรีท้องถิ่นสำหรับโครงการของคุณ

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

ตัวอย่างเช่น หากคุณมีการติดตั้ง WordPress ภายในเครื่องของคุณโดยที่โฟลเดอร์ปลั๊กอินคือ:

documents/public_html/devdomain.com/wp-content/plugins/

…อย่าคิดว่าคุณสามารถใช้ไดเร็กทอรีนั้นเพื่อซิงค์โปรเจ็กต์ WordPress Plugin Directory ของคุณได้ ที่จะทำให้คุณเจ็บปวด

ให้สร้างไดเร็กทอรีตามตัวอย่างนี้แทน:

documents/projects/wp-plugins-public/

โฟลเดอร์โปรเจ็กต์ปลั๊กอินแต่ละโฟลเดอร์จะอยู่ภายใน "wp-plugins-public" สำหรับบทช่วยสอนนี้ ฉันจะใช้โฟลเดอร์ปลั๊กอินชื่อ “content-scheduler” ดังนั้นฉันจะสร้างไดเร็กทอรีดังนี้:

documents/projects/wp-plugins-public/content-scheduler

อีเมลขออนุมัติปลั๊กอินของคุณ

เมื่อคำขอปลั๊กอินของคุณได้รับการอนุมัติ คุณจะได้รับอีเมลพร้อมลิงก์ไปยังที่เก็บ SVN ของคุณ สิ่งนี้มีไว้สำหรับปลั๊กอินตัวนั้นโดยเฉพาะ และจำเป็นสำหรับการซิงค์ Subversion ของคุณต่อ

ข้อกำหนดไดเรกทอรีสำหรับบทความนี้

ด้วยไดเรกทอรี โครงการ และโฟลเดอร์ต่างๆ ที่กล่าวถึงในบทความนี้ อาจทำให้สับสนได้ง่าย มาตกลงกันในสามสถานที่ที่แตกต่างกันเมื่อทำงานกับเวิร์กโฟลว์ Subversion นี้

1. ไดเรกทอรีการทำงาน
   นี่คือสำเนาปัจจุบันของรหัสที่คุณกำลังเปลี่ยนแปลงและทดสอบ ควรอยู่ในโฟลเดอร์ “/wp-content/plugins/” บนเว็บเซิร์ฟเวอร์การพัฒนาของคุณ ในเครื่องของฉันมันเป็น:
   documents/public_html/devdomain.com/wp-content/plugins/content-scheduler/
2. ไดเรกทอรีโครงการ
   นี่คือไดเร็กทอรีที่ไคลเอนต์ Subversion ของคุณจะซิงโครไนซ์กับไดเร็กทอรีปลั๊กอินของ WordPress ในเครื่องของฉันนี่คือ:
   documents/projects/wp-plugins-public/content-scheduler/
3. ไดเรกทอรีเซิร์ฟเวอร์
   นี่หมายถึงโครงการของคุณที่จัดเก็บไว้ในไดเรกทอรีปลั๊กอินของ WordPress นี่คือที่ที่สาธารณชนสามารถรับปลั๊กอินของคุณได้ ตำแหน่งรากเรียกว่า "ที่เก็บ SVN" ของคุณและจะกำหนดให้กับคุณในอีเมลขออนุมัติปลั๊กอินของคุณ สำหรับตัวอย่างของฉัน นี่คือ:
   http://plugins.svn.wordpress.org/content-scheduler

การดึงไดเร็กทอรีเซิร์ฟเวอร์ใหม่ไปยังเครื่องท้องถิ่นของคุณ

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

1. คลิกขวาที่โฟลเดอร์ปลั๊กอินไดเรกทอรีโครงการของคุณ
2. เลือก “การชำระเงิน SVN”
3. ป้อน URL ที่เก็บ WordPress SVN ของคุณ (จากอีเมลอนุมัติของคุณ) ลงในฟิลด์แรก
4. โฟลเดอร์ปลั๊กอินไดเรกทอรีโครงการของคุณควรอยู่ในฟิลด์ที่สอง
   เนื่องจากคุณเริ่มกระบวนการนี้โดยคลิกขวาที่โฟลเดอร์นั้น ฟิลด์นี้ควรได้รับการเติมแล้ว
5. คลิก “ตกลง”

เสร็จสิ้นการพัฒนาปลั๊กอินของคุณ

พัฒนาและทดสอบปลั๊กอินของคุณ ซึ่งรวมถึงการสร้างไฟล์ “readme.txt” ที่เหมาะสมเพื่อให้เข้ากันได้ ไฟล์ “readme.txt” ไม่ได้เป็นเพียงบันทึกย่อบางส่วนเกี่ยวกับปลั๊กอินของคุณ ไดเร็กทอรีปลั๊กอินของ WordPress ใช้เนื้อหาของไฟล์ "readme.txt" เพื่อทำความเข้าใจว่าเวอร์ชันใดของปลั๊กอินที่ถือว่าเป็นเวอร์ชันปัจจุบัน และเพื่อสร้างเนื้อหาของหน้าปลั๊กอินของคุณในไดเร็กทอรี

• สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการสร้างไฟล์ “readme.txt” ที่เหมาะสม โปรดดูตัวอย่าง WordPress readme.txt

ส่วนสำคัญของไฟล์ “readme.txt” ของคุณคือแท็ก “เสถียร” ขณะที่คุณกำลังพัฒนาปลั๊กอิน ปล่อยให้แท็กนี้อ่านว่า “ลำต้น” เมื่อคุณเผยแพร่เวอร์ชันสำหรับการบริโภคสาธารณะ เราจะอัปเดตด้วยหมายเลขเวอร์ชันที่ถูกต้อง

ทำให้เวอร์ชันแรกของคุณเผยแพร่สู่สาธารณะ

กำลังอัปเดตไดเรกทอรีโครงการ trunk

1. คัดลอกเนื้อหาของไดเร็กทอรีการทำงานของคุณไปยังโฟลเดอร์ "trunk" ของไดเร็กทอรีโครงการของคุณ
   ในกรณีของฉัน ฉันกำลังคัดลอกเนื้อหาทั้งหมดของปลั๊กอินจากไดเรกทอรีการทำงาน:
   /documents/public_html/devdomain.com/wp-content/plugins/content-scheduler/
   ไปยังไดเรกทอรีโครงการของฉัน:
   /documents/projects/wp-plugins-public/content-scheduler/
2. คลิกขวาที่โฟลเดอร์ปลั๊กอิน "content-scheduler" ในไดเร็กทอรีโครงการของคุณและเลือก "SVN Commit"
3. ป้อนความคิดเห็นสำหรับการคอมมิต หากคุณต้องการ
4. ตรวจสอบรายการไฟล์ที่ถือว่าเป็นไฟล์ใหม่และจะคัดลอกไปยังเซิร์ฟเวอร์ หากรายการนี้ดูถูกต้อง ให้คลิก "ตกลง" และไฟล์จะถูกคัดลอกไปยังไดเร็กทอรีเซิร์ฟเวอร์ของคุณที่ wordpress.org

การแท็กเวอร์ชันใหม่บนเซิร์ฟเวอร์

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

1. คลิกขวาที่โฟลเดอร์ "trunk" ของไดเรกทอรีโครงการและเลือก "Branch/Tag"
   สำหรับฉันนี่คือ:
   /documents/projects/wp-plugins-public/content-scheduler/trunk/
2. ฟิลด์ตำแหน่ง "To URL" จะลงท้ายด้วย "/trunk" คุณต้องเปลี่ยนเป็น “/tags/1.0” เพื่อสร้างเวอร์ชัน 1.0
3. คุณสามารถเพิ่มหมายเหตุเกี่ยวกับการดำเนินการติดแท็กนี้ได้หากต้องการ
4. คลิก “ตกลง” และไม่ต้อง สนใจ ข้อความใดๆ เกี่ยวกับ “สิ่งสำคัญในการเปลี่ยนแปลงสาขานี้…”

กำลังอัปเดตไดเร็กทอรีโปรเจ็กต์ในพื้นที่ของคุณด้วยเวอร์ชันที่แท็กใหม่

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

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

• คลิกขวาที่ไดเร็กทอรีโครงการอีกครั้งและเลือก "SVN Update"
  สิ่งนี้จะดึงการเปลี่ยนแปลงจากไดเร็กทอรีเซิร์ฟเวอร์ไปยังไดเร็กทอรีโปรเจ็กต์ในเครื่องของคุณ ในกรณีนี้ การเปลี่ยนแปลงเป็นการเพิ่มสำเนา “/tags/1.0” ของไฟล์ของคุณ

กำลังอัปเดตแท็กที่เสถียรของ readme.txt

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

1. แก้ไขไฟล์ “readme.txt” ในโฟลเดอร์ “trunk” ของไดเรกทอรีโครงการในพื้นที่ของคุณ
   สำหรับฉัน นี่คือสิ่งต่อไปนี้:
   /documents/projects/wp-plugins-public/content/scheduler/trunk/readme.txt
2. เปลี่ยน "แท็กเสถียร" เป็นเวอร์ชันเผยแพร่ "1.0"
3. บันทึกไฟล์
4. คลิกขวาที่ไฟล์ “readme.txt” ที่คุณเพิ่งอัปเดตแล้วเลือก “SVN Commit”

แค่นั้นแหละ! ใน 15 นาทีหรือมากกว่านั้น:

1. ไดเรกทอรีปลั๊กอินของ WordPress จะอัปเดตรายการโครงการของคุณ
2. “1.0” จะถูกมองว่าเป็นแท็กที่เสถียร
3. ข้อมูลใน “/tags/1.0/readme.txt” จะถูกใช้เพื่อกรอกหน้าโครงการของคุณ

การพัฒนาใหม่สำหรับปลั๊กอินของคุณ

เป็นไปได้มากว่าคุณจะปรับปรุงปลั๊กอินและจำเป็นต้องเผยแพร่ นี่คือวิธีการทำงาน

1. ทำการเปลี่ยนแปลงปลั๊กอินในไดเร็กทอรีการทำงานของคุณ
   การเปลี่ยนแปลงเหล่านี้ควรรวมถึงการเปลี่ยนแปลงในไฟล์ readme.txt ตามความจำเป็น เช่น รายการ Changelog
2. คัดลอกการเปลี่ยนแปลงจากไดเร็กทอรีการทำงานของคุณไปยังไดเร็กทอรีโครงการในเครื่องของคุณ
3. ตรวจสอบให้แน่ใจว่าไฟล์ readme.txt มีแท็ก "เสถียร" ที่ถูกต้องสำหรับเวอร์ชันสาธารณะปัจจุบัน
4. คลิกขวาที่ไดเร็กทอรีโครงการและเลือก "SVN Commit" เพื่อรับการเปลี่ยนแปลง trunk ใหม่ของคุณในไดเร็กทอรีเซิร์ฟเวอร์
5. คลิกขวาที่ไดเร็กทอรี "trunk" ในไดเร็กทอรีโครงการของคุณและเลือก "Branch/Tag" เพื่อสร้างแท็กเวอร์ชันใหม่สำหรับการเปิดตัว (ตรวจสอบให้แน่ใจว่า “สร้างสำเนาภายในที่เก็บจาก:” ถูกตั้งค่าเป็น “สำเนาที่ทำงาน”)
6. คลิกขวาที่ไดเร็กทอรีโครงการและเลือก "SVN Update" เพื่อดึงการเปลี่ยนแปลงแท็กจากไดเร็กทอรีเซิร์ฟเวอร์
7. อัปเดตแท็กที่เสถียรในไฟล์ “/trunk/readme.txt” ของไดเรกทอรีโปรเจ็กต์เพื่อให้ตรงกับแท็กรีลีสใหม่ที่คุณสร้างขึ้น
8. คลิกขวาที่ไดเร็กทอรีโครงการ (ใช่ อีกครั้ง) และเลือก "SVN Commit" เพื่อส่งไฟล์ readme.txt ที่อัปเดตของคุณไปยังเซิร์ฟเวอร์

วุ้ย. นั่นคือทั้งหมด!

• นักพัฒนา
• wordpress.org