คู่มือการเริ่มต้นของการพัฒนาปลั๊กอิน WordPress

WordPress CMS ได้เปลี่ยนโฉมหน้าของอินเทอร์เน็ตของเราและอนุญาตให้กระแสความคิดใหม่ที่จะประสบความสำเร็จและการเคลื่อนไหวของโอเพนซอร์สมีสถานะที่แข็งแกร่งในการพัฒนาซอฟต์แวร์และการพัฒนาเว็บ WordPress เป็นแพลตฟอร์มการเขียนบล็อกที่มีความสามารถในการเปิดตัวเป็นสคริปต์อื่น ๆ อีกมากมายเช่นเว็บบอร์ดบอร์ดงานและแม้กระทั่งหน้าเว็บคลาสสิกระบบการจัดการเนื้อหา.

เราจะอธิบายเกี่ยวกับการเริ่มต้นในการพัฒนาปลั๊กอินสำหรับ WordPress ขั้นตอนนั้นค่อนข้างง่ายและไม่ต้องใช้ความทุ่มเทอย่างมากในการศึกษา ความรู้พื้นฐานของ PHP จะมีประโยชน์แม้จะมีความเข้าใจพื้นฐานเกี่ยวกับโครงสร้างไฟล์ WordPress และแผงการบริหาร.

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

ทำไมพัฒนาสำหรับ WordPress?

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

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

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

1. โครงสร้างโฟลเดอร์ WP

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

สำหรับปลั๊กอินขนาดเล็กซึ่งต้องการไฟล์. php เพียงไฟล์เดียวคุณมีตัวเลือกในการวางโดยตรงลงในปลั๊กอิน / ไดเร็กทอรี อย่างไรก็ตามเมื่อคุณเริ่มพัฒนาแอพพลิเคชั่นที่ซับซ้อนยิ่งขึ้นมีประโยชน์มากขึ้นในการสร้างไดเรกทอรีย่อยที่ตั้งชื่อตามปลั๊กอินของคุณ ภายในคุณสามารถสร้าง JavaScript, CSS และ HTML รวมถึงฟังก์ชัน PHP ของคุณ.

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

2. เริ่มต้นไฟล์ PHP ของคุณ

เมื่อสร้างปลั๊กอินใหม่คุณจะต้องเริ่มต้นด้วยไฟล์ PHP อย่างง่าย สิ่งนี้สามารถตั้งชื่ออะไรก็ได้ แต่โดยทั่วไปควรสะท้อนถึงชื่ออย่างเป็นทางการของปลั๊กอินของคุณ ตัวอย่างเช่นฉันได้สร้างรหัสพื้นฐานของเราและตั้งชื่อไฟล์ของฉัน hongkiat-excerpt.phps.

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

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

3. การตั้งชื่อ WordPress และวิธีปฏิบัติที่ดีที่สุด

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

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

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

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

4. ดำน้ำเข้าไปในตัวกรองและการกระทำ

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

โค้ดสองบิตนี้มาเป็นมาตรฐานใน WordPress API ตัวกรองและการดำเนินการอนุญาตให้นักพัฒนาปลั๊กอินอัปเดตรหัสบิตทั่วทั้งแผงผู้ดูแลระบบ WordPress ที่เกี่ยวข้องกับปลั๊กอินใหม่ของคุณ ซึ่งหมายความว่าคุณสามารถเพิ่มแท็บใหม่ในแถบด้านข้างหรือลิงค์การตั้งค่าเพิ่มเติมสำหรับตัวเลือกปลั๊กอินของคุณ.

การทำความเข้าใจ add_filter ()

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

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

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

add_filter ('wp_title', 'hongkiat_func');

ที่นี่เรากำลังเพิ่มตัวกรองในชื่อหน้า WordPress หมายเหตุรหัสนี้ไม่เกี่ยวข้องกับปลั๊กอินอย่างเป็นทางการของเราและมีการใช้เป็นตัวอย่างเท่านั้นที่นี่.

add_filter ฟังก์ชั่นเป็นพื้นเมืองของ WordPress และใช้ในการเพิ่มตัวกรองใหม่ให้กับตัวแปรที่พบในเนื้อหาของหน้า ในบรรทัดด้านบนเรากำหนดเป้าหมาย $ wp_title ซึ่งมีชื่อของหน้าปัจจุบันของเรา จากนั้นเราจะส่งตัวแปรนี้ไปยังฟังก์ชันปลอมที่ชื่อ hongkiat_func () ซึ่งสามารถจัดการและส่งคืนแท็กชื่อใหม่สำหรับวัตถุประสงค์อะไรก็ได้.

ทำความเข้าใจกับ add_action ()

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

• publish_post - เรียกว่าเมื่อโพสต์มีการเผยแพร่หรือเมื่อสถานะเปลี่ยนเป็น “การตีพิมพ์”
• save_post - เรียกเมื่อสร้างโพสต์ / หน้าตั้งแต่เริ่มต้นหรืออัปเดต
• wp_head - เรียกว่าเมื่อโหลดแม่แบบและเรียกใช้ wp_head () ฟังก์ชัน
• loop_end - เรียกทันทีหลังจากโพสต์สุดท้ายได้รับการประมวลผลผ่านลูป WordPress
• trackback_post - เรียกว่าเมื่อใดก็ตามที่มีการเพิ่ม trackback ใหม่ลงในโพสต์

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

add_action ('save_post', 'แจ้งเตือน');

ดังนั้นที่นี่เราเห็นการตั้งค่าที่คล้ายกับก่อนด้วย add_filter (). เราต้องการตัวแปร 2 ตัวอันแรกถือชื่อเบ็ดของเราที่เรากำลังกำหนดเป้าหมาย ในกรณีนี้ save_post ซึ่งหมายความว่าเมื่อใดก็ตามที่มีการบันทึกโพสต์ใหม่เราจะเรียกฟังก์ชั่นของเราที่กำหนดไว้ในตำแหน่งที่สอง (แจ้ง()) คุณสามารถอัปเดตการแจ้งเตือนได้อย่างชัดเจนว่าเป็นชื่อฟังก์ชันใดที่คุณต้องการเรียกใช้อย่างไรก็ตามไม่จำเป็นสำหรับปลั๊กอินตัวอย่างปัจจุบันของเรา.

จบลอจิกปลั๊กอินของเรา

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

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

ดังนั้นสำหรับตัวอย่างของเราเราสามารถ จำกัด เนื้อหาที่ตัดตอนมาได้เพียง 55 ตัวอักษรเท่านั้น hk_trim_content () ฟังก์ชัน คุณสามารถเรียกรหัสนี้จากวิดเจ็ตแถบด้านข้างหรือไฟล์ธีมของคุณเพื่อแทนที่ได้อย่างง่ายดาย $ the_content.

= $ limit) array_pop ($ content); $ content = implode ("", $ content). '…';  else $ content = implode ("", $ content);  $ content = preg_replace ('/\uty.+\ เหมือนกัน', ", $ content); $ content = Apply_filters ('the_content', $ content); ส่งกลับ $ content;?> 

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

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

ชื่อฟังก์ชั่นหลักด้านบน hk_trim_content (). ต้องการชื่อพารามิเตอร์ 1 ตัวเท่านั้น $ ขีด จำกัด. สิ่งนี้อาจสั้นลงได้ $ Lim ซึ่งควรเก็บจำนวนเต็มโดยระบุจำนวนอักขระที่จะ จำกัด ข้อความที่ตัดตอนมาของคุณ เนื้อหานี้ใช้ในหน้าโพสต์แบบเต็มและหน้าแบบสแตติก (เกี่ยวกับเราผู้ติดต่อ).

ดังนั้นเพื่อที่จะเรียกใช้ฟังก์ชั่นนี้เราจะต้องเพิ่มพารามิเตอร์ลงในไฟล์เทมเพลตของเรา สิ่งนี้จะถูกวางไว้ที่ไหนสักแห่งในของคุณ index.php หรือ loop.php ไฟล์และจะต้องให้คุณติดตั้งปลั๊กอินก่อน ตัวอย่างด้านล่าง:

การติดตั้งและเรียกใช้ปลั๊กอิน

ฉันได้สร้างไฟล์ตัวอย่างสำหรับปลั๊กอินเพื่อสาธิตหากคุณต้องการข้ามการเข้ารหัสฮาร์ด เพียงดาวน์โหลดไฟล์นี้ (เปลี่ยนชื่อเป็น. php) หรือคัดลอก / วางรหัสลงในเอกสาร PHP ใหม่แล้วอัปโหลดไฟล์นี้ไปยัง / wp-content / ปลั๊กอิน ไดเรกทอรี.

เมื่อเสร็จแล้วคุณจะต้องการเข้าถึงแผงการจัดการ WordPress และเรียกดูปลั๊กอินชุดปัจจุบันของคุณสำหรับการสาธิตที่เพิ่งติดตั้ง เมื่อคุณเปิดใช้งานจะไม่มีอะไรใหม่เกิดขึ้นไม่ได้จนกว่าเราจะเพิ่มการเรียกฟังก์ชันของเราด้วยตนเอง ในการทำสิ่งนี้เพียงแค่นำทาง ลักษณะที่ปรากฏ -> ตัวแก้ไข และมองหา single.php.

ไฟล์นี้มีเทมเพลต HTML / CSS ทั้งหมดสำหรับหน้าโพสต์บทความพื้นฐานของคุณ เลื่อนลงจนกว่าคุณจะพบ หัวข้อ() และแทนที่ด้วยรหัสตัวอย่างด้านบน สิ่งนี้จะ จำกัด หน้าบทความทั้งหมดของคุณไม่เกิน 55 อักขระไม่ว่าจะใช้มุมมองใด คุณสามารถเพิ่มฟังก์ชันนี้ในหน้าที่คล้ายกันในไดเรกทอรีแม่แบบของคุณเช่น search.php หรือ archive.php.

ข้อสรุป

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

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