เรียนรู้การพัฒนา WordPress Plugin: สร้างฟังก์ชันที่กำหนดเองตั้งแต่เริ่มต้น

เหตุใดจึงเลือกพัฒนา WordPress Plugin

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

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

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

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

แนะนำให้อ่าน คู่มือขั้นสูงสุดในการพัฒนา WordPress Plugin: สร้างฟังก์ชันที่กำหนดเองตั้งแต่เริ่มต้นจนสำเร็จ。

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

ปลั๊กอินทุกตัวต้องมีไฟล์หลักที่มีส่วนหัวข้อมูลปลั๊กอินมาตรฐาน ไฟล์นี้มักจะตั้งชื่อตามชื่อปลั๊กอิน เช่นmy-first-plugin.phpส่วนหัวความคิดเห็นในไฟล์นี้เป็นสิ่งสำคัญที่ WordPress ใช้ในการอ่านชื่อปลั๊กอิน คำอธิบาย เวอร์ชัน และข้อมูลอื่นๆ

UltaHost WordPress โฮสติ้ง

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

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

<?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
 * Domain Path: /languages
 */

นำไฟล์ที่มีโค้ดด้านบนไปวางใน/wp-content/plugins/my-first-plugin/หลังจากสร้างไดเรกทอรีแล้ว คุณจะเห็นปลั๊กอินในหน้า “ปลั๊กอิน” ของ WordPress แอดมิน และสามารถเปิดใช้งานหรือปิดใช้งานได้ ภายในนั้นText Domainสำหรับการทำให้เป็นสากล (Internationalization)Domain Pathกำหนดไดเรกทอรีที่เก็บไฟล์ภาษา

จัดระเบียบไดเรกทอรีและไฟล์ปลั๊กอิน

สำหรับปลั๊กอินที่เรียบง่าย ไฟล์เดียวอาจเพียงพอ แต่สำหรับปลั๊กอินที่มีฟังก์ชันซับซ้อน โครงสร้างไดเรกทอรีที่ดีมีความสำคัญอย่างยิ่ง ไดเรกทอรีปลั๊กอินทั่วไปอาจมีลักษณะดังนี้:

my-advanced-plugin/
├── my-advanced-plugin.php      // 主插件文件
├── includes/                   // 核心PHP类与函数
│   ├── class-core.php
│   └── functions.php
├── admin/                      // 后台相关文件
│   ├── css/
│   ├── js/
│   └── class-admin.php
├── public/                     // 前端相关文件
├── assets/                     // 静态资源（图片、图标等）
└── languages/                  // 国际化语言文件

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

ทำความเข้าใจและใช้ Core API: Actions และ Filters

หัวใจของการพัฒนา WordPress Plugin อยู่ที่สถาปัตยกรรมแบบขับเคลื่อนด้วยเหตุการณ์ ซึ่งส่วนใหญ่ดำเนินการผ่านระบบHook(Hooks) ระบบ Hooks แบ่งออกเป็นสองประเภท: Action Hooks และActionและฮุคตัวกรองFilterซึ่งเป็นสะพานเชื่อมระหว่างปลั๊กอินกับ WordPress Core, ธีม และปลั๊กอินอื่น ๆ

แนะนำให้อ่าน คู่มือการพัฒนา WordPress Plugin แบบครบวงจร: สร้างคุณสมบัติส่วนขยาย WordPress ที่มีคุณภาพตั้งแต่เริ่มต้นจนสำเร็จ。

ใช้ action hooks เพื่อดำเนินการโค้ด

action hooks อนุญาตให้คุณ “แทรก” โค้ดของคุณเองในช่วงเวลาเฉพาะของการดำเนินการของ WordPress เช่น เมื่อโพสต์ถูกเผยแพร่ เมื่อผู้ใช้เข้าสู่ระบบ หรือเมื่อเมนูแอดมินเริ่มต้น คุณสามารถใช้add_action()ฟังก์ชันเพื่อเชื่อมต่อฟังก์ชันที่กำหนดเองของคุณกับ action hook

ตัวอย่างเช่น หากคุณต้องการแสดงเนื้อหาที่กำหนดเองในส่วนหัวของเว็บไซต์ คุณสามารถเชื่อมต่อกับwp_headการกระทำนี้:

function myplugin_add_custom_head_content() {
    echo '<meta name="my-custom-tag" content="value">';
}
add_action( 'wp_head', 'myplugin_add_custom_head_content' );

อีกตัวอย่างทั่วไปคือการดำเนินการเริ่มต้นบางอย่างเมื่อเปิดใช้งานปลั๊กอิน เช่น การสร้างตารางฐานข้อมูล ซึ่งจำเป็นต้องเชื่อมต่อกับregister_activation_hookฮุกพิเศษนี้

hosting.com 共享主机

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

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

function myplugin_activate() {
    // 执行创建数据表等初始化代码
}
register_activation_hook( __FILE__, 'myplugin_activate' );

ใช้ filter hook เพื่อปรับเปลี่ยนข้อมูล

ฮุกตัวกรองใช้สำหรับการปรับเปลี่ยนข้อมูลที่ส่งผ่านในกระบวนการ ต่างจากฮุกการกระทำ ฟังก์ชันตัวกรองต้องรับค่าอินพุตและส่งคืนค่าที่ถูกปรับเปลี่ยนแล้ว ใช้add_filter()ฟังก์ชันเพื่อเพิ่มฟิวเตอร์

ตัวอย่างเช่น การปรับเปลี่ยนเนื้อหาที่แสดงของหัวข้อบทความ:

function myplugin_modify_post_title( $title ) {
    return '【推荐】' . $title;
}
add_filter( 'the_title', 'myplugin_modify_post_title' );

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

แนะนำให้อ่าน จากศูนย์ถึงหนึ่ง: คู่มือการพัฒนา WordPress Plugin แบบครบวงจรและแนวปฏิบัติที่ดีที่สุด。

การสร้างอินเทอร์เฟซการจัดการหลังบ้านสำหรับปลั๊กอิน

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

เพิ่มเมนูการจัดการและเมนูย่อย

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

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

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

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

function myplugin_add_admin_menu() {
    add_menu_page(
        '我的插件设置',           // 页面标题
        '我的插件',              // 菜单标题
        'manage_options',       // 所需权限（管理员）
        'myplugin-settings',    // 菜单别名（slug）
        'myplugin_settings_page', // 用于输出页面内容的回调函数
        'dashicons-admin-generic', // 图标（使用Dashicons）
        80                      // 菜单位置
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

ฟังก์ชันเรียกกลับที่เกี่ยวข้องmyplugin_settings_page()รับผิดชอบในการแสดงผลเนื้อหา HTML ของหน้าตั้งค่า สำหรับปลั๊กอินที่ซับซ้อนมากขึ้น คุณอาจต้องใช้add_submenu_page()เพื่อเพิ่มเมนูย่อย

ใช้ API การตั้งค่าเพื่อบันทึกการกำหนดค่า

การจัดการการส่งฟอร์มและการบันทึกตัวเลือกด้วยตนเองนั้นยุ่งยากและไม่ปลอดภัย WordPress Settings API มีวิธีการที่ปลอดภัยและเป็นมาตรฐานสำหรับการลงทะเบียนการตั้งค่า ฟิลด์ และส่วน

ก่อนอื่น ใช้register_setting()ลงทะเบียนชุดการตั้งค่าและกำหนดฟังก์ชันการตรวจสอบความถูกต้อง

function myplugin_register_settings() {
    register_setting(
        'myplugin_settings_group', // 设置组名，需与 settings_fields() 调用一致
        'myplugin_option_name',    // 存储在 wp_options 表中的选项名
        array( 'sanitize_callback' => 'myplugin_sanitize_input' ) // 清理回调
    );

// 添加一个设置区块
    add_settings_section(
        'myplugin_main_section',   // 区块ID
        '主要设置',                // 区块标题
        'myplugin_section_callback', // 区块介绍文本的回调函数
        'myplugin-settings'        // 所属页面的别名
    );

// 在区块中添加一个字段
    add_settings_field(
        'myplugin_text_field',     // 字段ID
        '示例文本输入',            // 字段标签
        'myplugin_text_field_callback', // 渲染字段HTML的回调
        'myplugin-settings',       // 页面别名
        'myplugin_main_section'    // 所属区块ID
    );
}
add_action( 'admin_init', 'myplugin_register_settings' );

จากนั้นในฟังก์ชันการเรียกกลับของหน้าการตั้งค่า ให้ใช้settings_fields()、do_settings_sections()和submit_button()ใช้ฟังก์ชันเพื่อแสดงฟอร์ม

เพื่อความปลอดภัยและความสามารถในการบำรุงรักษาของปลั๊กอิน

การพัฒนาโปรแกรมเสริมไม่ใช่แค่การทำให้ทำงานได้ แต่ที่สำคัญกว่าคือต้องมั่นใจว่าปลอดภัย มีประสิทธิภาพ และดูแลรักษาได้ง่ายในระยะยาว

การตรวจสอบข้อมูล การทำความสะอาด และการหลีกเลี่ยงอักขระพิเศษ

นี่เป็นแนวป้องกันแรกด้านความปลอดภัยของโปรแกรมเสริม ข้อมูลทั้งหมดที่มาจากผู้ใช้หรือแหล่งภายนอก (เช่น ) ก่อนที่จะเข้าสู่ฐานข้อมูลหรือแสดงผลบนหน้าเว็บ ต้องผ่านการประมวลผลทั้งหมด$_POST、$_GET、$_COOKIE）ก่อนที่จะเข้าสู่ฐานข้อมูลหรือแสดงผลบนหน้าเว็บ ต้องผ่านการประมวลผลเสมอ

• การตรวจสอบ (Validation): ตรวจสอบว่าข้อมูลตรงกับรูปแบบ ประเภท หรือช่วงที่คาดหวังหรือไม่ ใช้ฟังก์ชันเช่นfilter_var()、is_email()หรือนิพจน์ทั่วไปที่กำหนดเอง
• การทำความสะอาด (Sanitization): ล้างอักขระที่ผิดกฎหมายหรืออันตรายออกจากข้อมูล ทำให้ปลอดภัย สำหรับข้อมูลประเภทต่างๆ WordPress มีฟังก์ชันทำความสะอาดที่หลากหลาย เช่นsanitize_text_field()（สำหรับข้อความ）、sanitize_email()、sanitize_key()เป็นต้น
• การหนีตัวอักษร (Escaping): เมื่อส่งข้อมูลไปยัง HTML, JavaScript, URL หรือแอตทริบิวต์ ต้องทำการหนีตัวอักษรเพื่อป้องกันการโจมตีแบบ Cross-Site Scripting ใช้ฟังก์ชันเช่นesc_html()、esc_js()、esc_url()、esc_attr()。

กฎทองข้อหนึ่งคือ: ทำความสะอาดตั้งแต่เนิ่นๆ และหนีตัวอักษรเสมอ

การทำให้เป็นสากลและการปรับให้เป็นท้องถิ่น

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

ขั้นแรก ใช้ฟังก์ชันรอบสตริงทั้งหมดที่ต้องการแปล__()(สำหรับค่าที่ส่งคืน) หรือ_e()(สำหรับการส่งคืนโดยตรง) ฟังก์ชัน และระบุในส่วนหัวของปลั๊กอินText Domain。

$greeting = __( ‘Hello, world!’, ‘my-first-plugin’ );
_e( ‘Settings saved successfully!’, ‘my-first-plugin’ );

จากนั้น ใช้เครื่องมือเช่น Poedit เพื่อสแกนโค้ดปลั๊กอิน สร้าง.pot(เทมเพลต) ไฟล์ ผู้แปลสามารถใช้สร้างไฟล์ภาษาที่ตรงกัน.poและไฟล์ที่คอมไพล์แล้ว.moไฟล์ ให้นำไปไว้ในไดเรกทอรีปลั๊กอินของ/languages/จากนั้นใช้load_plugin_textdomain()ฟังก์ชันในการโหลดแพ็คเกจภาษาเมื่อเริ่มต้นปลั๊กอิน

สรุป

การพัฒนา WordPress Plugin คือกระบวนการเปลี่ยนความคิดสร้างสรรค์ให้เป็นฟังก์ชันการทำงาน ซึ่งอาศัยความเข้าใจอย่างลึกซึ้งในโครงสร้างหลักของ WordPress เริ่มจากการสร้างไฟล์หลักที่มีส่วนหัวมาตรฐาน ไปจนถึงการใช้ระบบ Hook (Action และ Filter) ที่ทรงพลังเพื่อผสานรวมกับแพลตฟอร์มอย่างลึกซึ้ง และการใช้ Settings API เพื่อสร้างอินเทอร์เฟซการจัดการหลังบ้านที่ปลอดภัย ทุกขั้นตอนปฏิบัติตามแนวทางปฏิบัติที่ดีที่สุดของ WordPress พร้อมกันนั้น การให้ความสำคัญกับความปลอดภัย (การตรวจสอบ การทำความสะอาด การหลีกเลี่ยง) และการทำให้เป็นสากลเป็นข้อกำหนดพื้นฐานในการพัฒนา เป็นกุญแจสำคัญในการสร้างปลั๊กอิน WordPress ที่เป็นมืออาชีพ น่าเชื่อถือ และสามารถใช้งานได้อย่างกว้างขวาง ด้วยการปฏิบัติตามหลักการและขั้นตอนเหล่านี้ นักพัฒนาสามารถสร้าง WordPress Plugin คุณภาพสูงที่ตอบสนองความต้องการที่หลากหลายได้อย่างมั่นใจ

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

การพัฒนา WordPress Plugin ต้องใช้ความรู้พื้นฐานอะไรบ้าง

การพัฒนา WordPress ปลั๊กอินจำเป็นต้องมีความรู้พื้นฐานเกี่ยวกับภาษาโปรแกรม PHP เนื่องจากปลั๊กอินส่วนใหญ่เขียนด้วย PHP นอกจากนี้ยังต้องมีความเข้าใจพื้นฐานเกี่ยวกับ HTML, CSS และ JavaScript เพื่อจัดการการแสดงผลและปฏิสัมพันธ์ส่วนหน้า ที่สำคัญที่สุดคือต้องเข้าใจโครงสร้างพื้นฐานของ WordPress เช่น ธีม, ปลั๊กอิน, ฮุค (Hooks) และหลักการทำงานของลูป ความคุ้นเคยกับการทำงานพื้นฐานของฐานข้อมูล MySQL ก็มีประโยชน์ต่อการจัดการข้อมูลปลั๊กอินเช่นกัน

วิธีการดีบั๊ก WordPress Plugin ที่กำลังพัฒนา

เปิดใช้งานWP_DEBUGเป็นขั้นตอนแรกในการดีบักปลั๊กอิน ในwp-config.phpในไฟล์, ตั้งค่าdefine( ‘WP_DEBUG’, true );เป็นtrueซึ่งจะแสดงข้อผิดพลาด, คำเตือน, และประกาศของ PHP บนหน้าเว็บ นอกจากนี้ยังสามารถใช้ฟังก์ชันerror_log()เพื่อเขียนข้อมูลดีบักที่กำหนดเองลงในบันทึกข้อผิดพลาดของเซิร์ฟเวอร์ สำหรับการดีบักที่ซับซ้อนมากขึ้น อาจพิจารณาใช้ปลั๊กอินดีบักเฉพาะ หรือเครื่องมือดีบักที่รวมกับ IDE

วิธีการพัฒนาปลั๊กอินโดยหลีกเลี่ยงการขัดแย้งกับปลั๊กอินอื่น

เพื่อหลีกเลี่ยงการขัดแย้ง คุณควรทำให้โค้ดปลั๊กอินของคุณมีการห่อหุ้มที่ดี เพิ่มคำนำหน้าที่ไม่ซ้ำกันให้กับฟังก์ชัน คลาส ตัวแปร และชื่อตัวเลือกทั้งหมด เช่น ใช้อักษรย่อหรือชื่อของปลั๊กอิน การใช้การเขียนโปรแกรมเชิงวัตถุ (OOP) เพื่อห่อหุ้มโค้ดไว้ในคลาส สามารถลดการรบกวนพื้นที่ชื่อส่วนกลางได้อย่างมีประสิทธิภาพ ใช้ตัวแปรส่วนกลางอย่างระมัดระวัง และตรวจสอบให้แน่ใจว่าฟังก์ชันคอลแบ็กของฮุกของคุณมีความสำคัญที่ชัดเจน ทดสอบอย่างเพียงพอก่อนเผยแพร่ ในสภาพแวดล้อมที่รวมปลั๊กอินยอดนิยมหลากหลาย

วิธีการส่งปลั๊กอินที่พัฒนาสำเร็จไปยังไดเรกทอรีปลั๊กอินอย่างเป็นทางการ

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