การสร้างปลั๊กอิน WordPress แบบกำหนดเอง: คำแนะนำทีละขั้นตอน
เผยแพร่แล้ว: 2023-12-01WordPress ได้รับความนิยมส่วนหนึ่งเนื่องมาจากลักษณะของโอเพ่นซอร์ส ทำให้นักพัฒนาสามารถสร้างปลั๊กอินที่ขยายฟังก์ชันการทำงานได้ ขณะนี้มีปลั๊กอินมากกว่า 55,000 รายการ แต่คุณอาจสนใจเรียนรู้วิธีสร้างปลั๊กอินของคุณเอง
ข่าวดีก็คือ WordPress ทำให้การสร้างปลั๊กอินที่จำเป็นเป็นเรื่องง่าย แม้ว่าคุณจะมีความรู้ด้านการเขียนโค้ดเพียงเล็กน้อยก็ตาม ด้วยการพัฒนาปลั๊กอิน คุณสามารถเพิ่มคุณสมบัติและฟังก์ชันการทำงานที่กำหนดเองให้กับไซต์ WordPress ของคุณได้ นอกเหนือจากที่มีอยู่
ในบทความนี้ เราจะเจาะลึกว่าปลั๊กอิน WordPress คืออะไร และให้คำแนะนำทีละขั้นตอนในการพัฒนาปลั๊กอินแรกของคุณ เราจะครอบคลุมพื้นฐานการเขียนโค้ดเพื่อสร้างปลั๊กอินง่ายๆ ที่เพิ่มคุณสมบัติและฟังก์ชันการทำงานที่กำหนดเองให้กับไซต์ WordPress ของคุณ
สิ่งที่คุณต้องการในการสร้างปลั๊กอิน WordPress
ในการสร้างปลั๊กอิน WordPress คุณจะต้องมีส่วนสำคัญสองสามอย่าง:
จำเป็นต้องใช้โปรแกรมแก้ไขข้อความเช่น Notepad++ หรือ Atom เพื่อเขียนโค้ดปลั๊กอิน คุณจะต้องเชื่อมต่อโปรแกรมแก้ไขกับเซิร์ฟเวอร์ FTP (File Transfer Protocol) ของบัญชีโฮสติ้งของคุณ เพื่อเปิดใช้งานการแก้ไขไฟล์โดยตรง เครื่องมือ FTP เช่น FileZilla และ WinSCP ช่วยให้การอัพโหลดไฟล์ปลั๊กอินไปยังเว็บไซต์ WordPress ของคุณง่ายขึ้น
นอกจากนี้ คุณจะต้องมีการติดตั้ง WordPress ที่ใช้งานอยู่ ซึ่งได้รับการอัปเดตเป็นเวอร์ชันล่าสุดอย่างเหมาะสม คุณสามารถอัปเดตไฟล์หลักของ WordPress ได้ด้วยตนเองหากคุณปิดใช้งานการอัปเดตอัตโนมัติ แต่อย่าลืมสำรองข้อมูลไซต์ของคุณก่อนเพื่อป้องกันข้อมูลสูญหาย อีกทางเลือกหนึ่งคือการติดตั้ง WordPress ในเครื่องเพื่อพัฒนาปลั๊กอินโดยไม่ส่งผลกระทบต่อไซต์ที่ใช้งานอยู่
แนะนำให้ใช้ความรู้ PHP พื้นฐานบางประการเมื่อสร้างปลั๊กอิน คุณจะต้องเขียนฟังก์ชัน PHP แบบกำหนดเองและใช้ฟังก์ชัน WordPress ที่มีอยู่ อย่างน้อยที่สุด ความคุ้นเคยกับรูปแบบ PHP และโครงสร้างไฟล์ก็มีประโยชน์
ประเภทของปลั๊กอิน WordPress
ปลั๊กอิน WordPress สามารถทำหน้าที่ได้หลากหลาย แต่ทั้งหมดทำหน้าที่ขยายขีดความสามารถของไซต์ WordPress ปลั๊กอินทั่วไปบางประเภท ได้แก่:
- ปลั๊กอินการบำรุงรักษาจัดการเรื่องความปลอดภัย การเพิ่มประสิทธิภาพความเร็ว การสำรองข้อมูล และงานการจัดการไซต์อื่นๆ
- ปลั๊กอินการตลาดและการขายสำหรับ SEO, การบูรณาการโซเชียลมีเดีย, อีคอมเมิร์ซ และอื่นๆ
- ปลั๊กอินเนื้อหาที่ช่วยให้คุณสามารถสร้างประเภทโพสต์ วิดเจ็ต รหัสย่อ แบบฟอร์ม แกลเลอรี และองค์ประกอบวิดีโอแบบกำหนดเองได้
- ปลั๊กอิน API ที่เข้าถึง WordPress REST API หรือรวมบริการภายนอกเช่น Google Maps
- ปลั๊กอินชุมชนที่เพิ่มความสามารถด้านเครือข่ายโซเชียล
มีหมวดหมู่ปลั๊กอินอื่นๆ อีกมากมายเช่นกัน เพื่อทำความเข้าใจถึงความเป็นไปได้ต่างๆ ให้ดูไดเรกทอรีปลั๊กอิน WordPress อย่างเป็นทางการและตลาดซื้อขายปลั๊กอิน WordPress ต่างๆ
WordPress Hooks คืออะไร?
ปลั๊กอิน WordPress ใช้ hooks เพื่อรวมเข้ากับโค้ดหลัก ตะขอมีสองประเภทหลัก:
Action hooks รันฟังก์ชั่นที่จุดเฉพาะ นักพัฒนาสามารถแนบตรรกะแบบกำหนดเองเข้ากับ Action hooks เพื่อทำงานเพิ่มเติมได้ ตัวอย่างเช่น hook wp_head จะรันโค้ดก่อนแท็ก head
hooks ตัวกรองแก้ไขข้อมูลที่ส่งคืนโดยฟังก์ชัน ปลั๊กอินสามารถเปลี่ยนค่าได้โดยการกรองผ่านตรรกะที่กำหนดเอง ตัวอย่างเช่น ตัวกรอง_content จะเปลี่ยนเนื้อหาโพสต์
Hooks เป็นไปตามบริบท – จะทำงานเฉพาะเมื่อเกี่ยวข้องเท่านั้น การอ้างอิงโค้ด WordPress แสดงรายการ hooks ที่พร้อมใช้งาน
หากต้องการใช้ hook ให้เพิ่มฟังก์ชันโทรกลับด้วย add_action()
หรือ add_filter()
พารามิเตอร์ระบุชื่อ hook และฟังก์ชันที่จะแนบ
add_action('wp_head', 'function_name');
พารามิเตอร์ทางเลือกควบคุมลำดับความสำคัญในการดำเนินการตามคำสั่งและจำนวนอาร์กิวเมนต์ที่ยอมรับ
การถอด hooks จะคล้ายกับการใช้ Remove_action() และ Remove_filter() อ้างอิงค่าลำดับความสำคัญดั้งเดิมเมื่อกำหนด
ตอนนี้เรามาดูตัวอย่างบางส่วน:
สิ่งนี้จะแสดงข้อความหลังส่วนท้ายของทุกหน้าโดยเชื่อมต่อ wp_footer:
<?php
/* Plugin Name: Footer Text */
function footerText(){
echo "<p>My footer text</p>";
}
add_action('wp_footer', 'footerText');
สิ่งนี้จะแก้ไขข้อความที่ตัดตอนมาโดยเชื่อมต่อ get_the_excerpt():
<?php
/* Plugin Name: Excerpt Changes */
function excerptText($text){
return "See the excerpt below: ". $text;
}
add_filter('get_the_excerpt', 'excerptText');
การทดสอบปลั๊กอินบนไซต์ชั่วคราวจะหลีกเลี่ยงไม่ให้ไซต์ที่ใช้งานอยู่เสียหาย ติดตั้ง WordPress ในเครื่องหรือใช้ปลั๊กอินชั่วคราว
ขั้นตอนในการติดตามการสร้างปลั๊กอิน WordPress
ขั้นตอนที่ 1: ตั้งค่าโครงสร้างไฟล์ปลั๊กอินเริ่มต้น
ขั้นตอนแรกในการสร้างปลั๊กอินคือการสร้างโฟลเดอร์ใหม่เพื่อเก็บไฟล์ต่างๆ เลือกชื่อโฟลเดอร์ที่ไม่ซ้ำและสื่อความหมาย ตรวจสอบโฟลเดอร์ปลั๊กอินที่มีอยู่ใน wp-content/plugins/ เพื่อให้แน่ใจว่าไม่ได้ใช้งานอยู่แล้ว
ใช้ไคลเอนต์ FTP เพื่อเชื่อมต่อกับบัญชีโฮสติ้งของคุณ ซึ่งทำให้การอัพโหลดง่ายขึ้น นำทางไปยังไดเร็กทอรีหลักของ WordPress จากนั้นเลือก wp-content -> ปลั๊กอิน สร้างโฟลเดอร์ใหม่ที่นี่เรียกว่า my-new-plugin เพื่อจัดเก็บปลั๊กอิน
แนวทางปฏิบัติที่ดีในการจัดระเบียบไฟล์ภายในโฟลเดอร์ปลั๊กอินตามฟังก์ชันการทำงาน ตัวอย่างเช่น บันทึกไฟล์ CSS, PHP และ JavaScript ในไดเรกทอรีย่อยของตนเอง สิ่งนี้จะช่วยรักษาความเป็นระเบียบเรียบร้อยในขณะที่ปลั๊กอินพัฒนา ทำให้ง่ายต่อการค้นหาไฟล์ที่ต้องการเมื่อจำเป็น
เมื่อเพิ่มไฟล์ PHP, CSS, JS ฯลฯ ใหม่สำหรับปลั๊กอิน ให้จัดเก็บไว้ในโฟลเดอร์ที่เหมาะสม การดูแลรักษาโครงสร้างนี้ตั้งแต่เริ่มต้นทำให้การจัดการไฟล์ง่ายขึ้นในระยะยาว
ขั้นตอนที่ 2: สร้างไฟล์ปลั๊กอินหลัก
ไฟล์ปลั๊กอินหลักมีข้อมูลสำหรับ WordPress เพื่อจดจำในรายการปลั๊กอินและอนุญาตให้เปิดใช้งานได้
สร้างไฟล์ PHP ใหม่ชื่อ my-first-plugin.php ภายในโฟลเดอร์ปลั๊กอินที่คุณสร้างไว้แล้ว นี่จะเป็นไฟล์หลัก
จำเป็นต้องมีความคิดเห็นส่วนหัวสำหรับ WordPress เพื่ออ่านข้อมูลเมตา เช่น ชื่อ คำอธิบาย และผู้แต่งเพื่อแสดง
เพิ่มโค้ดนี้ใน my-first-plugin.php โดยใช้โปรแกรมแก้ไขข้อความ:
<?php
/*
Plugin Name: My First Plugin
Description: This is my first plugin! It adds a new menu link!
Author: Your Name
*/
ไม่จำเป็นต้องใช้แท็กปิด ?>
ที่นี่ คู่มือ PHP อธิบายว่าทำไม
บันทึกไฟล์ จากนั้นไปที่หน้าปลั๊กอินในแดชบอร์ด WordPress คุณจะเห็น "My First Plugin" ในรายการหากใช้งานได้
ตอนนี้ไฟล์ปลั๊กอินเริ่มต้นได้รับการตั้งค่าแล้ว ต่อไปเราสามารถเปิดใช้งานและเริ่มเพิ่มฟังก์ชันการทำงานได้
ขั้นตอนที่ 3: การเพิ่มฟังก์ชันการทำงานของปลั๊กอิน
ใส่คำนำหน้าเฉพาะให้กับไฟล์ ฟังก์ชัน และตัวแปร เช่น “mfp” เพื่อหลีกเลี่ยงความขัดแย้ง
สร้างโฟลเดอร์ “รวม” เพื่อจัดเก็บไฟล์ที่รองรับ สร้าง mfp-functions.php ที่นี่เพื่อเก็บฟังก์ชันต่างๆ
ใน my-first-plugin.php ให้ใช้ need_once เพื่อรวม mfp-functions.php เพื่อให้ปลั๊กอินทำงานเฉพาะเมื่อมี:
require_once plugin_dir_path(__FILE__) . 'includes/mfp-functions.php';
ใน mfp-functions.php ให้สร้างฟังก์ชันเพื่อเพิ่มรายการเมนูโดยใช้ตะขอ admin_menu:
add_action('admin_menu', 'mfp_Add_My_Admin_Link');
function mfp_Add_My_Admin_Link() {
// Code to add menu item
}
ใช้ความคิดเห็นหลายบรรทัดเพื่ออธิบายฟังก์ชัน ช่วยในการแก้ไขข้อบกพร่องในภายหลัง
mfp_Add_My_Admin_Link() uses add_menu_page()
พารามิเตอร์:
- ชื่อหน้า
- ข้อความเมนู
- ข้อกำหนดด้านความสามารถ
- ไฟล์ที่จะโหลด
สิ่งนี้จะเพิ่มเมนูเมื่อ admin_menu เริ่มทำงาน อัปโหลด mfp-functions.php เพื่อเปิดใช้งาน
ต่อไป เราจะสร้างไฟล์เพจที่จะโหลด
ขั้นตอนที่ 4: การเพิ่มหน้าผู้ดูแลระบบสำหรับปลั๊กอิน
หลังจากเขียนฟังก์ชันที่เปิดใช้งานความสามารถของปลั๊กอินแล้ว ขั้นตอนต่อไปคือการสร้างหน้าผู้ดูแลระบบที่ลิงก์เมนูจะนำทางไป สร้างไฟล์ PHP ใหม่ชื่อ mfp-first-acp-page.php ภายในโฟลเดอร์รวมที่คุณสร้างไว้แล้ว จากนั้นเพิ่มรหัสต่อไปนี้:
<div class="wrap">
<h1>Hello!</h1>
<p>This is the first page for my plugin</p>
</div>
เมื่อสร้างหน้าผู้ดูแลระบบแบบกำหนดเอง WordPress แนะนำให้ล้อม HTML ของคุณในแท็ก <div>
ด้วยคลาส “wrap” การทำเช่นนี้รับประกันว่าเนื้อหาของคุณจะปรากฏในตำแหน่งที่เหมาะสมและหลีกเลี่ยงความยุ่งเหยิง
เมื่อไฟล์เพจเสร็จสิ้นแล้ว ให้ไปที่ส่วนปลั๊กอินในแดชบอร์ด WordPress และเปิดใช้งานปลั๊กอินใหม่ หากสำเร็จ ลิงก์เมนูผู้ดูแลระบบสำหรับปลั๊กอินแรกของคุณจะปรากฏที่ด้านล่างของเมนู
ขั้นตอนที่ 5: การติดตั้งปลั๊กอินบนเว็บไซต์ Live WordPress
หากคุณพัฒนาปลั๊กอินบนเว็บไซต์ WordPress ชั่วคราว คุณจะต้องติดตั้งบนเว็บไซต์ที่ใช้งานจริงโดยทำตามขั้นตอนเหล่านี้:
- ใน FileZilla คลิกขวาที่โฟลเดอร์ my-new-plugin แล้วเลือก Download บีบอัดไฟล์เป็นไฟล์ .ZIP
- ไปที่เมนูปลั๊กอินในแดชบอร์ด WordPress จากนั้นคลิกเพิ่มใหม่
- เลือกอัปโหลดปลั๊กอินและเลือกไฟล์ .ZIP ที่มีปลั๊กอินของคุณ
- คลิกติดตั้งทันทีเพื่อเริ่มกระบวนการติดตั้ง
แนวทางปฏิบัติที่ดีที่สุดในการพัฒนาปลั๊กอิน WordPress
เมื่อเว็บไซต์ของคุณพัฒนาขึ้น คุณอาจต้องอัปเดตโค้ดปลั๊กอินเพื่อรับคุณสมบัติใหม่และแพตช์ความปลอดภัย ปฏิบัติตามแนวทางปฏิบัติที่ดีที่สุดสำหรับการพัฒนาปลั๊กอินตั้งแต่เริ่มต้นเพื่อปรับปรุงกระบวนการนี้สำหรับตัวคุณเองและนักพัฒนารายอื่นๆ
นอกจากนี้ ให้ศึกษาตัวอย่างปลั๊กอินที่มีโค้ดอย่างดีเพื่อเป็นแรงบันดาลใจ วิเคราะห์การจัดระเบียบซอร์สโค้ด โครงสร้างโฟลเดอร์ และเทคนิคอื่นๆ เพื่อนำไปใช้เมื่อสร้างปลั๊กอิน WordPress ของคุณเอง
คำแนะนำยอดนิยมสำหรับการเขียนโค้ดและพัฒนาปลั๊กอิน WordPress แบบกำหนดเองคุณภาพสูง:
- สร้างและทดสอบในสภาพแวดล้อม WordPress ชั่วคราวก่อนเพื่อหลีกเลี่ยงการหยุดไซต์ที่ใช้งานจริงด้วยโค้ดบั๊กกี้
- จัดระเบียบไฟล์อย่างมีเหตุผลในโฟลเดอร์ย่อยตามฟังก์ชันและภาษาเพื่อจัดระเบียบ
- ตั้งชื่อไฟล์ โฟลเดอร์ และองค์ประกอบทั้งหมดด้วยคำนำหน้าที่ไม่ซ้ำกันเพื่อป้องกันความขัดแย้ง
- ฟังก์ชันแสดงความคิดเห็นเพื่อบันทึกสิ่งที่พวกเขาทำเพื่อการดีบักที่ง่ายขึ้นในภายหลัง
- สร้างเอกสารประกอบสำหรับปลั๊กอินที่ซับซ้อนซึ่งผู้ใช้หลายคนใช้
- ใช้การควบคุมเวอร์ชันเพื่อติดตามการเปลี่ยนแปลงโค้ดและป้องกันความขัดแย้งในการอัปเดต
- ปฏิบัติตามมาตรฐานการเข้ารหัส WordPress จาก Codex เมื่อทำงานร่วมกัน
- ใช้ WP_DEBUG หรือเครื่องมือแก้ไขข้อบกพร่องในระหว่างการพัฒนาเพื่อตรวจจับข้อบกพร่องตั้งแต่เนิ่นๆ
ห่อ
การสร้างปลั๊กอินแบบกำหนดเองเป็นวิธีหนึ่งในการเพิ่มฟังก์ชันการทำงานให้กับไซต์ WordPress ที่ปลั๊กอินที่มีอยู่ไม่มีให้บริการ ปลั๊กอินสามารถทำได้ง่ายๆ โดยมีการปรับแต่งเล็กน้อยหรือซับซ้อนในการปรับเปลี่ยนทั้งไซต์
เช่นเดียวกับทักษะอื่นๆ จำเป็นต้องฝึกฝนเพื่อให้มีความเชี่ยวชาญในการพัฒนาปลั๊กอิน WordPress ด้วยประสบการณ์ที่เพียงพอ คุณสามารถสร้างปลั๊กอินและเผยแพร่ในไดเร็กทอรีปลั๊กอิน WordPress หรือแม้แต่ขายในตลาดกลางก็ได้
ยิ่งคุณสร้างปลั๊กอินมากเท่าไร คุณก็จะยิ่งเชี่ยวชาญมากขึ้นในการสร้างโซลูชันที่ปรับแต่งเองเพื่อขยายไซต์ WordPress ในรูปแบบใหม่ ด้วยเวลาและความพากเพียร คุณสามารถเชี่ยวชาญการพัฒนาปลั๊กอิน WordPress ได้