หน้าแรก/ความรู้/วูร์ดเพรส/รายละเอียดเนื้อหา

การพัฒนา WordPress Plugin ตั้งแต่เริ่มต้นจนเชี่ยวชาญ: สร้างฟังก์ชัน Plugin แรกของคุณ

อ่าน 3 นาที
2026-03-18
2026-06-03
2,290
I earn commissions when you shop through the links below, at no additional cost to you.

ทำไมต้องเรียนรู้การพัฒนา WordPress Plugin

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

WordPress plugin พื้นฐานโดยพื้นฐานแล้วคือไฟล์ PHP หนึ่งไฟล์ขึ้นไปที่อยู่ในไดเรกทอรีเฉพาะ ซึ่งทำงานร่วมกับระบบหลักผ่าน API ที่หลากหลายของ WordPress (เช่น action hooks, filter hooks, shortcodes, widgets เป็นต้น) การเข้าใจกลไกนี้เป็นเงื่อนไขเบื้องต้นสำหรับการพัฒนา plugin ใดๆ ให้สำเร็จ

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

ก่อนที่จะเขียนโค้ดบรรทัดแรก การตั้งค่า environment การพัฒนาที่ดีเป็นสิ่งสำคัญ คุณต้องมี environment เซิร์ฟเวอร์ท้องถิ่น (เช่น XAMPP, Local by Flywheel หรือ DevKinsta), โปรแกรมแก้ไขโค้ด (เช่น VS Code หรือ PhpStorm), และการติดตั้ง WordPress สำหรับการทดสอบ

แนะนำให้อ่าน คู่มือขั้นสูงสุดในการพัฒนา WordPress Plugin: เรียนรู้หลักการพื้นฐานและโปรเจกต์จริง。

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

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

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

ไฟล์หลักของปลั๊กอินมักถูกตั้งชื่อตามชื่อปลั๊กอิน ตัวอย่างเช่น เราสร้างปลั๊กอินชื่อ “ปลั๊กอินแรกของฉัน” ซึ่งไฟล์หลักสามารถตั้งชื่อเป็นmy-first-plugin.phpไฟล์นี้ต้องวางไว้ใน/wp-content/plugins/my-first-plugin/ไดเรกทอรีอย่างถูกต้องหรือไม่

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

<?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
 */

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

สร้างโครงสร้างไดเรกทอรีพื้นฐานของปลั๊กอิน

ปลั๊กอินที่มีโครงสร้างชัดเจนช่วยในการบำรุงรักษาในระยะยาว แนะนำให้สร้างไดเรกทอรีต่อไปนี้:
* /assets/: ใช้สำหรับเก็บไฟล์ทรัพยากรคงที่ เช่น CSS, JavaScript และรูปภาพ
* /includes/: ใช้สำหรับเก็บไฟล์คลาสและฟังก์ชันหลักของ PHP
* /languages/: ใช้สำหรับเก็บไฟล์แปลภาษาสากล (.po/.mo)

แนะนำให้อ่าน หลักการสำคัญของ Tailwind CSS: เปิดเผยกลไกการทำงานของเฟรมเวิร์ก CSS แบบอะตอมมิกที่เน้นยูทิลิตี้เป็นหลัก。

ไฟล์หลักmy-first-plugin.phpควรรับผิดชอบเฉพาะงานเริ่มต้นของปลั๊กอิน เช่น การกำหนดค่าคงที่ การนำเข้าไฟล์อื่น ๆ การลงทะเบียนฮุก เป็นต้น

การใช้งานหลัก: การสร้างเมนูและหน้าจัดการ

ฟังก์ชันทั่วไปของปลั๊กอินคือการเพิ่มหน้าเมนูการจัดการในแอดมินของ WordPress เราจะทำสิ่งนี้ผ่าน “API หน้าจัดการเมนู” ของ WordPress

การเพิ่มเมนูระดับบนสุดในแอดมิน

เราจำเป็นต้องใช้add_menu_page()ฟังก์ชันนี้มักถูกเรียกใช้ในadmin_menuเรียกใช้เมื่อการกระทำนี้ถูกเรียกใช้งาน เราเพิ่มโค้ดต่อไปนี้ในไฟล์หลัก:

hosting.com 共享主机
高性能，配备 AMD EPYC CPU、NVMe SSD 存储和 LiteSpeed，全天候24小时、全天候的专家内部支持，高级安全措施，包括 SSL、暴力破解、恶意软件和 DDoS 防护，节省高达 73%
โลโก้ Hosting.com เข้าถึงหน้าเว็บ 
// 定义在管理员菜单初始化时执行的功能
function mfp_add_admin_menu() {
    add_menu_page(
        '我的插件设置',         // 页面标题
        '我的插件',            // 菜单标题
        'manage_options',      // 所需权限
        'my-first-plugin',     // 菜单slug
        'mfp_display_settings_page', // 用于显示页面内容的回调函数
        'dashicons-admin-generic', // 菜单图标（Dashicon）
        6                      // 菜单位置
    );
}
// 将函数挂载到 `admin_menu` 钩子上
add_action('admin_menu', 'mfp_add_admin_menu');

สร้างเนื้อหาที่แสดงบนหน้าตั้งค่า

ในโค้ดด้านบนmfp_display_settings_pageเป็นฟังก์ชัน callback ที่รับผิดชอบในการแสดงเนื้อหา HTML ของหน้าตั้งค่า เราจำเป็นต้องกำหนดฟังก์ชันนี้:

// 设置页面的显示内容
function mfp_display_settings_page() {
    // 检查用户权限
    if (!current_user_can('manage_options')) {
        wp_die(__('你没有权限访问此页面。'));
    }
    ?&gt;
    <div class="wrap">
        <h1><?php echo esc_html(get_admin_page_title()); ?></h1>
        <form action="/th/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出设置字段和安全nonce字段
            settings_fields('mfp_options_group'); // 设置组的名称
            do_settings_sections('my-first-plugin'); // 页面slug
            submit_button('保存设置');
            ?>
        <input type="hidden" name="trp-form-language" value="th"/></form>
    </div>
    &lt;?php
}

โค้ดนี้สร้างโครงสร้างหน้าตั้งค่ามาตรฐานของ WordPress โดยใช้ฟังก์ชันsettings_fields()和do_settings_sections()ซึ่งหมายความว่าเราจะใช้ WordPress Settings API ในการจัดการตัวเลือกของเรา นี่เป็นวิธีที่ปลอดภัยและเป็นมาตรฐานมากที่สุด

ใช้ Settings API จัดการตัวเลือกปลั๊กอิน

จัดการโดยตรง$_POSTข้อมูลมีความเสี่ยงด้านความปลอดภัย WordPress Settings API จัดการการตรวจสอบความถูกต้อง ความปลอดภัย และการจัดเก็บข้อมูลให้เรา เป็นวิธีที่แนะนำสำหรับการจัดการการตั้งค่าปลั๊กอิน

แนะนำให้อ่าน คู่มือปลั๊กอิน WooCommerce ขั้นสูงสุด: สร้างร้านค้าออนไลน์ข้ามชาติอิสระระดับมืออาชีพตั้งแต่เริ่มต้น。

ลงทะเบียนการตั้งค่า ฟิลด์ และส่วน

เราจำเป็นต้องเริ่มต้นการตั้งค่าของเราในadmin_initฮุ๊ก ก่อนอื่นให้ใช้register_setting()ลงทะเบียนตัวเลือกการตั้งค่า

function mfp_register_settings() {
    // 注册一个设置：`mfp_options` 是存储在`wp_options`表中的键名
    register_setting(
        'mfp_options_group', // 设置组名，需与`settings_fields()`参数一致
        'mfp_options',       // 选项名
        'mfp_sanitize_options' // 可选：数据清洗回调函数
    );

// 添加一个设置章节
    add_settings_section(
        'mfp_main_section',                // 章节ID
        '主要设置',                         // 章节标题
        'mfp_main_section_callback',       // 章节介绍的回调函数
        'my-first-plugin'                  // 所属页面slug
    );

// 在章节中添加一个文本字段
    add_settings_field(
        'mfp_text_field',                  // 字段ID
        '示例文本',                         // 字段标签
        'mfp_text_field_callback',         // 用于渲染字段HTML的回调函数
        'my-first-plugin',                 // 所属页面slug
        'mfp_main_section'                 // 所属章节ID
    );
}
add_action('admin_init', 'mfp_register_settings');

กำหนดฟังก์ชันการแสดงผลและการทำความสะอาดข้อมูลของฟิลด์

ตอนนี้ เราจำเป็นต้องกำหนดฟังก์ชัน callback ที่ใช้ด้านบน เพื่อแสดงผล HTML ของฟิลด์และทำความสะอาดข้อมูล

โฮสติ้งแบบแชร์ของ InterServer
共享主机每月 $2.50 USD , 首月 $0.1 USD 优惠码 tryinterserver, 461个云应用脚本，一键安装。
โลโก้ InterServer เข้าถึงหน้าเว็บ 
// 主章节的描述文本
function mfp_main_section_callback() {
    echo '<p>นี่คือพื้นที่ตั้งค่าหลักของปลั๊กอิน</p>';
}

// 文本字段的HTML输出
function mfp_text_field_callback() {
    // 从数据库获取现有值
    $options = get_option('mfp_options');
    $value = $options['mfp_text_field'] ?? ''; // PHP 7.0+ 空合并运算符
    echo '<input type="text" name="mfp_options[mfp_text_field]" value="' . esc_attr($value) . '" class="regular-text">';
}

// 数据清洗函数（可选但推荐）
function mfp_sanitize_options($input) {
    $sanitized_input = [];
    if (isset($input['mfp_text_field'])) {
        // 对文本字段进行基本的清洗，如去除标签
        $sanitized_input['mfp_text_field'] = sanitize_text_field($input['mfp_text_field']);
    }
    return $sanitized_input;
}

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

เพิ่มความสามารถด้านหน้าบ้านให้กับปลั๊กอิน: การสร้างชอร์ตโค้ด

ความสามารถในส่วนหลังบ้านเป็นพื้นฐาน แต่โดยทั่วไปปลั๊กอินก็จำเป็นต้องส่งผลต่อหน้าบ้านของเว็บไซต์ด้วย การสร้างชอร์ตโค้ด (Shortcode) เป็นวิธีที่ยอดเยี่ยมในการนำผลลัพธ์ความสามารถของปลั๊กอินไปแสดงในบทความ หน้าหรือวิดเจ็ต

การลงทะเบียนชอร์ตโค้ดแบบง่าย

เราได้ลงทะเบียนชอร์ตโค้ดชื่อว่า[my_greeting]ชอร์ตโค้ดสำหรับแสดงข้อความทักทายบนหน้าเว็บ เพิ่มadd_shortcode()ฟังก์ชัน

ในไฟล์หลักหรือไฟล์ฟังก์ชันพิเศษ

// 注册短代码
function mfp_greeting_shortcode($atts, $content = null) {
    // 使用shortcode_atts设置默认属性并合并用户输入
    $atts = shortcode_atts(
        array(
            'name' =&gt; '访客', // 默认值
        ),
        $atts,
        'my_greeting' // 短代码名称
    );

// 获取插件选项中存储的文本
    $options = get_option('mfp_options');
    $custom_text = $options['mfp_text_field'] ?? '';

// 构造输出
    $output = '<div class="mfp-greeting">';
    $output .= '<p>สวัสดี, ' . esc_html($atts['name']) . '! ยินดีต้อนรับสู่เว็บไซต์ของเรา</p>';
    if (!empty($custom_text)) {
        $output .= '<p><strong>ข้อความที่กำหนดเอง:</strong>' . esc_html($custom_text) . '</p>';
    }
    $output .= '</div>';

// 返回输出内容，而不是直接echo
    return $output;
}
add_shortcode('my_greeting', 'mfp_greeting_shortcode');

ตอนนี้ผู้ใช้สามารถป้อนข้อมูลในตัวแก้ไขบทความ[my_greeting name="张三"]และส่วนหน้าของเว็บไซต์จะแสดงข้อความทักทายส่วนบุคคล และหากมีการตั้งค่า “ข้อความตัวอย่าง” ไว้ในส่วนหลังบ้าน ข้อความนั้นก็จะถูกแสดงด้วยเช่นกัน วิธีนี้เชื่อมโยงการตั้งค่าส่วนหลังบ้านกับการแสดงผลส่วนหน้าได้อย่างมีประสิทธิภาพ

สรุป

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

หลังจากที่คุณเข้าใจพื้นฐานเหล่านี้อย่างลึกซึ้งแล้ว คุณสามารถสำรวจหัวข้อขั้นสูงเพิ่มเติมได้ เช่น การสร้างประเภทบทความที่กำหนดเอง, ข้อมูลเมตา (Meta Box), ตารางฐานข้อมูลที่กำหนดเอง, จุดปลายทาง REST API, การจัดการ AJAX และการทำให้ plugin เป็นสากล จำไว้ว่าการปฏิบัติตามมาตรฐานการเขียนโค้ดของ WordPress และแนวปฏิบัติที่ดีที่สุด เป็นกุญแจสำคัญในการพัฒนา plugin ที่มีคุณภาพสูงและบำรุงรักษาได้

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

การพัฒนา plugin ต้องเรียนรู้ความรู้ PHP ด้านใดบ้าง

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

วิธีการดีบักปลั๊กอิน WordPress ที่พัฒนาขึ้นเอง

ขั้นแรก ตรวจสอบให้แน่ใจว่าได้เปิดใช้งานโหมดดีบักของ WordPress ในไฟล์wp-config.phpเปิดในไฟล์WP_DEBUG和WP_DEBUG_LOGเพื่อให้ข้อความผิดพลาดถูกบันทึกลงในไฟล์บันทึก ประการที่สอง สามารถใช้error_log()ฟังก์ชันเพื่อแสดงข้อมูลการดีบัก สำหรับตรรกะที่ซับซ้อน สามารถใช้เครื่องมือดีบักมืออาชีพ เช่น Xdebug เพื่อดำเนินการโค้ดทีละขั้นตอน

วิธีรับประกันความปลอดภัยของปลั๊กอินขณะพัฒนา

ตรวจสอบและทำความสะอาดข้อมูลที่ผู้ใช้ป้อนเข้าเสมอ ใช้ฟังก์ชันในตัวของ WordPress เช่นesc_html(), esc_attr(), sanitize_text_field()和wp_kses()เพื่อจัดการผลลัพธ์ ใช้ nonce (wp_nonce_field()) เพื่อป้องกันการโจมตีแบบ Cross-Site Request Forgery (CSRF) สำหรับการดำเนินการกับฐานข้อมูล ใช้วิธีการที่ให้โดยคลาส$wpdbหรือใช้prepare()เพื่อป้องกันการโจมตีแบบ SQL Injection เสมอ

ปลั๊กอินควรวางไว้ในเซิร์ฟเวอร์ท้องถิ่นหรือเซิร์ฟเวอร์ออนไลน์ในการพัฒนา

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

วิธีการเผยแพร่ปลั๊กอินของตัวเองไปยังไดเรกทอรีอย่างเป็นทางการของ WordPress

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

ขั้นต่อไป ฉันควรทำอย่างไรต่อไป

如果你正在搭建或优化 WordPress 网站，下一步建议继续阅读性能优化、插件配置和主题定制相关内容。

อ่านเพิ่มเติมและรับความรู้ที่มีประโยชน์

下面这些内容与本文主题相关，适合继续深入阅读。优先从与你当前问题最接近的文章开始看，再逐步扩展到周边主题，效果通常会更好。

แท็ก: