คู่มือเริ่มต้นการพัฒนา WordPress Plugin: สร้างปลั๊กอินแรกของคุณตั้งแต่เริ่มต้น

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

การเตรียมสภาพแวดล้อมและเครื่องมือสำหรับการพัฒนา

ก่อนเริ่มเขียนโค้ด คุณต้องมีสภาพแวดล้อมการพัฒนาที่เหมาะสม ซึ่งจะทำให้กระบวนการพัฒนามีประสิทธิภาพและสอดคล้องกับแนวปฏิบัติที่ดีที่สุดของ WordPress

การติดตั้งสภาพแวดล้อมการพัฒนาท้องถิ่น

ตัวเลือกแรกคือการตั้งค่าเซิร์ฟเวอร์ท้องถิ่นบนคอมพิวเตอร์ของคุณเอง คุณสามารถใช้ XAMPP, MAMP (สำหรับ Mac), WAMP (สำหรับ Windows) หรือ Docker ที่มีความยืดหยุ่นมากขึ้น ชุดเครื่องมือเหล่านี้รวมเซิร์ฟเวอร์ Apache ฐานข้อมูล MySQL และ PHP เข้าด้วยกัน เพื่อจำลองสภาพแวดล้อมการทำงานของ WordPress ออนไลน์ได้อย่างสมบูรณ์ หลังจากติดตั้งเซิร์ฟเวอร์ท้องถิ่นแล้ว ให้ดาวน์โหลด WordPress เวอร์ชันล่าสุดจากเว็บไซต์ WordPress.org และทำการกำหนดค่าบนเครื่องท้องถิ่นตามขั้นตอนการติดตั้งมาตรฐาน “5 นาที”

แนะนำให้อ่าน คู่มือเริ่มต้นการพัฒนา WordPress Plugin: สร้างปลั๊กอินฟังก์ชันแรกของคุณตั้งแต่ศูนย์จนสำเร็จ。

โปรแกรมแก้ไขโค้ดและเครื่องมือที่จำเป็น

ตัวแก้ไขโค้ดที่มีประสิทธิภาพเป็นสิ่งจำเป็น Visual Studio Code, PhpStorm หรือ Sublime Text เป็นตัวเลือกที่ดี ซึ่งให้การเน้นไวยากรณ์ การแนะนำโค้ดอัจฉริยะ และฟังก์ชันการดีบัก นอกจากนี้คุณยังต้องการระบบควบคุมเวอร์ชัน เช่น Git เพื่อจัดการการเปลี่ยนแปลงโค้ดของคุณ แม้ว่าปลั๊กอินแรกอาจจะง่าย แต่การสร้างนิสัยใช้ระบบควบคุมเวอร์ชันมีความสำคัญต่อการพัฒนาในอนาคต

UltaHost WordPress โฮสติ้ง

การรับประกันคืนเงินภายใน 30 วัน, แบนด์วิธและฐานข้อมูลไม่จำกัด, การป้องกัน DDoS ฟรี, ซื้อ 3 ปีลดราคา 50%

เข้าถึงหน้าเว็บ

สร้างไฟล์ปลั๊กอินแรกของคุณ

ปลั๊กอิน WordPress ทุกตัวเริ่มต้นด้วยไฟล์หลัก ซึ่งประกอบด้วยข้อมูลหัวข้อที่จำเป็นสำหรับให้ WordPress รู้จักปลั๊กอิน

โครงสร้างไฟล์หลักของปลั๊กอิน

ในไดเรกทอรีการติดตั้ง WordPress ท้องถิ่นของคุณ ไปที่wp-content/pluginsโฟลเดอร์ ที่นี่สร้างโฟลเดอร์ใหม่ ตั้งชื่อว่าmy-first-plugin(ชื่อควรสั้นและอธิบายฟังก์ชันของปลั๊กอิน) ภายในโฟลเดอร์นี้ ให้สร้างไฟล์ PHP ซึ่งโดยทั่วไปจะมีชื่อเดียวกับโฟลเดอร์:my-first-plugin.phpไฟล์นี้จะเป็นจุดเริ่มต้นของปลั๊กอิน

เขียนข้อมูลหัวปลั๊กอิน

ที่ส่วนต้นของไฟล์หลักนี้ คุณต้องเพิ่มส่วนความคิดเห็นส่วนหัวของปลั๊กอินตามมาตรฐานของ WordPress ส่วนคิดเห็นนี้ให้ข้อมูลพื้นฐานเกี่ยวกับปลั๊กอิน ต่อไปนี้เป็นตัวอย่างพื้นฐานที่สุด:

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个用于学习的简单WordPress插件。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

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

แนะนำให้อ่าน คู่มือการพัฒนา WordPress Plugins ฉบับสมบูรณ์: สร้างปลั๊กอินที่มีฟังก์ชันการทำงานแรกของคุณตั้งแต่เริ่มต้น。

เพิ่มฟังก์ชันพื้นฐานให้กับปลั๊กอิน

หลังจากเปิดใช้งานปลั๊กอินแล้ว เราจะเพิ่มฟังก์ชันพื้นฐานสองอย่าง: การเพิ่มข้อความที่กำหนดเองหลังเนื้อหาบทความ และการสร้างหน้าจัดการอย่างง่าย

ใช้ Hook เพื่อแก้ไขเนื้อหาบทความ

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

// 在文章内容末尾添加自定义文本
function myfp_add_footer_text( $content ) {
    // 仅在主循环的单篇文章页面添加
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $custom_text = '<p><em>ขอบคุณที่อ่าน! บทความนี้ถูกสร้างขึ้นโดย “ปลั๊กอินแรกของฉัน”</em></p>';
        $content .= $custom_text;
    }
    return $content;
}
// 将函数挂载到‘the_content’过滤器上
add_filter( 'the_content', 'myfp_add_footer_text' );

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

hosting.com 共享主机

高性能，配备 AMD EPYC CPU、NVMe SSD 存储和 LiteSpeed，全天候24小时、全天候的专家内部支持，高级安全措施，包括 SSL、暴力破解、恶意软件和 DDoS 防护，节省高达 73%

เข้าถึงหน้าเว็บ

สร้างเมนูการจัดการแบบง่าย

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

// 在后台管理菜单中添加一个新页面
function myfp_add_admin_menu() {
    add_menu_page(
        '我的第一个插件设置', // 页面标题
        '我的插件',           // 菜单标题
        'manage_options',     // 所需权限
        'my-first-plugin',    // 菜单slug
        'myfp_admin_page_html', // 用于输出页面内容的回调函数
        'dashicons-admin-generic', // 图标（可选）
        100                   // 菜单位置
    );
}
add_action( 'admin_menu', 'myfp_add_admin_menu' );

// 定义管理页面的HTML内容
function myfp_admin_page_html() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
        <p>ยินดีต้อนรับสู่หน้าการตั้งค่า “ปลั๊กอินแรกของฉัน” นี่คือจุดเริ่มต้น!</p>
    </div>
    &lt;?php
}

บันทึกและรีเฟรช WordPress แอดมิน คุณควรเห็นเมนูใหม่ “ปลั๊กอินของฉัน” ใกล้ด้านล่างของแถบเมนูด้านซ้าย คลิกที่มันเพื่อเข้าสู่หน้าตั้งค่าที่เรียบง่าย ที่นี่add_menu_page()ฟังก์ชันมีหน้าที่ลงทะเบียนหน้าเมนูระดับบนสุด ในขณะที่myfp_admin_page_html()ฟังก์ชันมีหน้าที่แสดงผลเนื้อหา HTML ของหน้านั้น

ความปลอดภัยของปลั๊กอินและการปรับปรุงโค้ด

การพัฒนาโปรแกรมเสริม ความปลอดภัยและความสามารถในการบำรุงรักษาเป็นประเด็นสำคัญที่ต้องพิจารณาตั้งแต่เริ่มต้น

แนะนำให้อ่าน เริ่มต้นจากศูนย์: ทำไมต้องเลือกพัฒนา WordPress Plugin。

การตรวจสอบและหลีกเลี่ยงข้อมูล

อย่าไว้วางใจข้อมูลจากผู้ใช้หรือข้อมูลภายนอกเป็นอันขาด ต้องทำการประมวลผลก่อนที่จะส่งออกข้อมูลใด ๆ ไปยังเบราว์เซอร์หรือบันทึกลงในฐานข้อมูล WordPress มีฟังก์ชันช่วยเหลือมากมาย เช่น เมื่อส่งออกตัวแปรไปยังแอตทริบิวต์ HTML ให้ใช้esc_attr(); เมื่อส่งออกไปยังข้อความ HTML ให้ใช้esc_html()เมื่อส่งออกไปยัง URL ให้ใช้esc_url()。ก่อนหน้านี้myfp_admin_page_html()ในฟังก์ชัน เราได้ใช้esc_html()เพื่อแสดงชื่อหน้าอย่างปลอดภัย

ใช้คลาสเพื่อจัดระเบียบโค้ด

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

โฮสติ้งแบบแชร์ของ InterServer

共享主机每月 $2.50 USD , 首月 $0.1 USD 优惠码 tryinterserver, 461个云应用脚本，一键安装。

เข้าถึงหน้าเว็บ

class My_First_Plugin {
    // 构造方法，用于初始化钩子
    public function __construct() {
        add_filter( 'the_content', array( $this, 'add_footer_text' ) );
        add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
    }

public function add_footer_text( $content ) {
        // ... 函数实现同上 ...
    }

public function add_admin_menu() {
        // ... 函数实现同上 ...
    }

public function admin_page_html() {
        // ... 函数实现同上 ...
    }
}
// 实例化插件类
new My_First_Plugin();

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

สรุป

ผ่านคู่มือนี้ คุณได้ทำขั้นตอนหลักในการสร้างปลั๊กอิน WordPress ตั้งแต่เริ่มต้น: การตั้งค่าแวดล้อม การสร้างไฟล์ปลั๊กอินที่มีข้อมูลส่วนหัวมาตรฐาน การใช้ฮุคแอ็กชันและฮุคฟิลเตอร์เพื่อเพิ่มฟังก์ชันให้กับเนื้อหาโพสต์ รวมถึงการสร้างอินเทอร์เฟซผู้ดูแลระบบ และทำความเข้าใจเบื้องต้นเกี่ยวกับความสำคัญของความปลอดภัยและการจัดระเบียบโค้ด นี่เป็นเพียงจุดเริ่มต้น พื้นที่การพัฒนาปลั๊กอิน WordPress กว้างขวางมาก คุณสามารถสำรวจฟังก์ชันขั้นสูงเพิ่มเติม เช่น ชอร์ตโค้ด (Shortcode), วิดเจ็ต (Widget), ประเภทโพสต์กำหนดเอง (Custom Post Type), จุดปลายทาง REST API เป็นต้น จำไว้ว่า การอ่านโค้ดหลัก การอ้างอิงวิธีการใช้งานจากปลั๊กอินที่ดี และการค้นคว้าเอกสารสำหรับนักพัฒนาอย่างเป็นทางการเป็นวิธีที่ดีที่สุดในการพัฒนาตนเองอย่างต่อเนื่อง

คำถามที่พบบ่อย (FAQ)

การพัฒนาปลั๊กอินต้องเชี่ยวชาญเทคโนโลยีใดบ้าง?

การพัฒนา WordPress Plugin ต้องมีความรู้พื้นฐานเกี่ยวกับ PHP, HTML, CSS และ JavaScript PHP เป็นส่วนสำคัญ เนื่องจาก WordPress ถูกเขียนด้วย PHP คุณต้องใช้มันเพื่อเขียนตรรกะของปลั๊กอิน HTML/CSS ใช้สำหรับสร้างส่วนติดต่อผู้ใช้ส่วนหน้า ในขณะที่ JavaScript (โดยเฉพาะ jQuery และ ES6+ ที่ทันสมัย) สามารถใช้เพื่อเพิ่มการโต้ตอบและการร้องขอ AJAX การมีความเข้าใจพื้นฐานเกี่ยวกับ MySQL ก็ช่วยในการจัดการข้อมูลด้วย

ทำไมปลั๊กอินของฉันไม่แสดงในส่วนหลัง?

โปรดตรวจสอบประเด็นต่อไปนี้ก่อน: 1. ไฟล์หลักของปลั๊กอินถูกวางไว้ในwp-content/pluginsไดเรกทอรีภายในโฟลเดอร์ที่แยกต่างหาก 2. ส่วนหัวความคิดเห็นของปลั๊กอินในไฟล์หลัก (โดยเฉพาะอย่างยิ่งPlugin Name:) รูปแบบถูกต้องหรือไม่ 3. การเข้ารหัสไฟล์เป็น UTF-8 without BOM หรือไม่ 4. มีข้อผิดพลาดทางไวยากรณ์ที่ทำให้ PHP แยกวิเคราะห์ล้มเหลวหรือไม่ สามารถตรวจสอบบันทึกการดีบักของ WordPress (ต้องเปิดใช้งานwp-config.phpเปิดใช้งานWP_DEBUG）。

จะทดสอบปลั๊กอินโดยไม่ส่งผลกระทบต่อเว็บไซต์ออนไลน์ได้อย่างไร

ขอแนะนำอย่างยิ่งให้ทำการพัฒนาและทดสอบปลั๊กอินในสภาพแวดล้อมการพัฒนาท้องถิ่น (เช่น Local by Flywheel, XAMPP) หรือเซิร์ฟเวอร์ทดสอบแยกต่างหาก (Staging Site) อย่าทดสอบปลั๊กอินใหม่ที่ยังไม่ผ่านการตรวจสอบโดยตรงบนเว็บไซต์การผลิตที่มีข้อมูลสำคัญและกำลังทำงานอยู่ ใช้เครื่องมือควบคุมเวอร์ชัน (เช่น Git) เพื่อจัดการโค้ด เพื่อให้สามารถย้อนกลับได้ง่ายเมื่อเกิดปัญหา

ควรอัปเดตเวอร์ชันของปลั๊กอินอย่างไร

คุณควรอัปเดตในส่วนหัวของไฟล์หลักของปลั๊กอินVersion:ฟิลด์ สำหรับการอัปเดตขนาดใหญ่ ควรปฏิบัติตามการควบคุมเวอร์ชันเชิงความหมาย (SemVer) เช่น การแก้ไขบั๊กเพิ่มหมายเลขการแก้ไข (1.0.1) การเพิ่มฟังก์ชันใหม่ที่เข้ากันได้กับเวอร์ชันก่อนหน้าเพิ่มหมายเลขเวอร์ชันรอง (1.1.0) การอัปเดตที่ไม่เข้ากันเพิ่มหมายเลขเวอร์ชันหลัก (2.0.0) คุณยังสามารถทำให้ผู้ใช้ได้รับแจ้งการอัปเดตในแถบควบคุมได้โดยการนำกลไกการตรวจจับการอัปเดตไปใช้ (เช่น การโฮสต์ข้อมูลปลั๊กอินบนเซิร์ฟเวอร์ของคุณเองหรือไดเรกทอรีปลั๊กอินของ WordPress)

การเผยแพร่ปลั๊กอินไปยังไดเรกทอรีอย่างเป็นทางการต้องมีเงื่อนไขอะไรบ้าง?

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