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

คู่มือการพัฒนา WordPress Plugin อย่างสมบูรณ์: สร้าง Plugin ฟังก์ชันแรกของคุณตั้งแต่เริ่มต้นจนสำเร็จ

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

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

ก่อนเริ่มต้นการเขียนโค้ด คุณต้องมีสภาพแวดล้อมการพัฒนาที่เหมาะสม ซึ่งรวมถึงการติดตั้ง WordPress ในเครื่อง, ตัวแก้ไขโค้ด และความรู้พื้นฐานบางประการ

ประการแรก ตรวจสอบให้แน่ใจว่าคุณมีสภาพแวดล้อมเซิร์ฟเวอร์ในเครื่อง คุณสามารถใช้เครื่องมือต่าง ๆ เช่น XAMPP, MAMP, Local by Flywheel หรือ Docker เพื่อตั้งค่าได้อย่างรวดเร็ว หลังจากติดตั้งและกำหนดค่า WordPress แล้ว คุณจะมีสภาพแวดล้อม Sandbox ที่ปลอดภัยสำหรับการทดสอบ โดยไม่ต้องกังวลว่าจะส่งผลกระทบต่อเว็บไซต์ออนไลน์

ประการที่สอง คุณต้องมีตัวแก้ไขโค้ดที่ใช้งานได้สะดวก Visual Studio Code, PhpStorm หรือ Sublime Text เป็นตัวเลือกที่ยอดเยี่ยม ทั้งหมดนี้รองรับ PHP, HTML, JavaScript และ CSS เป็นอย่างดี และมีคุณสมบัติเช่นการเน้นไวยากรณ์โค้ด, การเติมข้อความอัตโนมัติ และการดีบัก

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

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

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

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

ขั้นตอนแรกในการสร้างปลั๊กอินคือการสร้างไฟล์หลักและเพิ่มความคิดเห็นส่วนหัวที่ถูกต้อง ไฟล์นี้มักถูกตั้งชื่อตามฟังก์ชันการทำงานของปลั๊กอิน เช่น my-first-plugin.phpกรุณาในสภาพแวดล้อมท้องถิ่นของคุณ /wp-content/plugins/ สร้างโฟลเดอร์ใหม่ในไดเรกทอรีและตั้งชื่อว่า my-first-pluginแล้วสร้างไฟล์หลักภายในโฟลเดอร์นั้น

ส่วนหัวของปลั๊กอินคือชุดข้อมูลเมตาของปลั๊กอินที่บอก WordPress ถึงชื่อ คำอธิบาย เวอร์ชัน ผู้เขียน และอื่นๆ ของปลั๊กอิน นี่คือตัวอย่างส่วนหัวของปลั๊กอินพื้นฐานที่สุด:

<?php
/**
 * Plugin Name:       我的第一个功能插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个学习 WordPress 插件开发的示例插件，用于展示基础功能。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

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

สถาปัตยกรรมหลัก: ฮุคแอ็กชันและฟิลเตอร์

WordPress มีความสามารถในการขยายที่ทรงพลังซึ่งอยู่ที่ระบบฮุก (Hooks) ซึ่งช่วยให้นักพัฒนาสามารถแทรกโค้ดของตนเองได้ในจุดเวลาที่เฉพาะเจาะจงหรือก่อน/หลังข้อมูลถูกใช้งาน ฮุกแบ่งออกเป็นสองประเภท: แอ็กชัน (Actions) และฟิลเตอร์ (Filters)

แนะนำให้อ่าน คู่มือเริ่มต้นการพัฒนา WordPress Theme: สร้างเทมเพลตเว็บไซต์ส่วนตัวของคุณตั้งแต่เริ่มต้น。

ฮุกแอ็กชันอนุญาตให้คุณดำเนินการฟังก์ชันที่กำหนดเองเมื่อเหตุการณ์เฉพาะของ WordPress เกิดขึ้น ตัวอย่างเช่น เมื่อโพสต์ถูกเผยแพร่ (publish_post), เมื่อเมนูโหลดในแอดมินแบ็กเอนด์ (admin_menu), หรือเมื่อสคริปต์โหลดในส่วนหัวของหน้าเว็บ (wp_enqueue_scripts) การใช้ add_action() ฟังก์ชันเพื่อเชื่อมต่อฟังก์ชันของคุณกับ Action Hook

ใช้ Action Hook เพื่อเพิ่มเมนูในแอดมิน

สมมติว่าเราต้องการเพิ่มหน้าตั้งค่าให้กับปลั๊กอินใน WordPress แอดมิน เราจะใช้ admin_menu Action Hook นี้ เพิ่มโค้ดต่อไปนี้ในไฟล์หลักของคุณ หลังจากส่วนหัวของปลั๊กอิน:

// 在管理后台添加菜单
function mfp_add_admin_menu() {
    add_menu_page(
        '我的插件设置',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',       // 所需权限
        'my-first-plugin',      // 菜单 slug
        'mfp_settings_page',    // 用于显示页面内容的回调函数
        'dashicons-admin-generic', // 图标（可选）
        80                     // 菜单位置（可选）
    );
}
add_action( 'admin_menu', 'mfp_add_admin_menu' );

// 设置页面的回调函数
function mfp_settings_page() {
    ?&gt;
    <div class="wrap">
        <h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
        <p>ยินดีต้อนรับสู่หน้าการตั้งค่าปลั๊กอินแรกของฉัน!</p>
    </div>
    &lt;?php
}

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

hosting.com 共享主机
高性能，配备 AMD EPYC CPU、NVMe SSD 存储和 LiteSpeed，全天候24小时、全天候的专家内部支持，高级安全措施，包括 SSL、暴力破解、恶意软件和 DDoS 防护，节省高达 73%
โลโก้ Hosting.com เข้าถึงหน้าเว็บ

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

มาสร้างฟังก์ชันง่ายๆ: เพิ่มข้อความลิขสิทธิ์อัตโนมัติที่ท้ายเนื้อหาของทุกบทความ

// 在文章内容后添加自定义文本
function mfp_add_copyright_to_content( $content ) {
    // 仅对网站前端的主循环中的文章生效
    if ( is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query() ) {
        $custom_text = '<p><em>ข้อกำหนดด้านลิขสิทธิ์: เนื้อหาในบทความนี้เป็นกรรมสิทธิ์ของผู้จัดทำเว็บไซต์ทั้งหมด การนำไปใช้โปรดระบุแหล่งที่มา</em></p>';
        $content .= $custom_text;
    }
    return $content;
}
add_filter( 'the_content', 'mfp_add_copyright_to_content' );

การนำฟังก์ชันไปใช้: ชอร์ตโค้ดและโค้ดสั้น

ชอร์ตโค้ด (Shortcode) เป็นฟีเจอร์ทรงพลังที่ WordPress มอบให้ ช่วยให้ผู้ใช้สามารถแทรกแท็กง่ายๆ (เช่น [my_shortcode]) ลงในบทความหรือหน้าเพื่อแสดงเนื้อหาแบบไดนามิกที่ซับซ้อนหรือดำเนินการฟังก์ชันเฉพาะ ซึ่งให้ความยืดหยุ่นอย่างมากแก่ผู้สร้างเนื้อหา

สร้างและลงทะเบียน shortcode อย่างง่าย

การสร้าง shortcode ต้องใช้สองขั้นตอน: กำหนดฟังก์ชันจัดการ shortcode แล้วลงทะเบียนกับ WordPress โดยใช้ฟังก์ชัน add_shortcode() ให้เราสร้าง shortcode ที่แสดงวันที่ปัจจุบันและคำทักทาย

แนะนำให้อ่าน จากเริ่มต้นอย่างมั่นใจสู่ระดับเชี่ยวชาญ: คู่มือและบทเรียนปฏิบัติการที่สมบูรณ์สำหรับการพัฒนา WordPress Plugins。

// 定义简码的处理函数
function mfp_show_greeting_shortcode( $atts ) {
    // 使用 shortcode_atts 定义默认参数，并合并用户传入的参数
    $atts = shortcode_atts(
        array(
            'name' =&gt; '访客',
        ),
        $atts,
        'greeting'
    );

// 获取当前时间
    $current_time = current_time( 'mysql' );
    $hour = date( 'H', strtotime( $current_time ) );

// 根据时间生成问候语
    if ( $hour &lt; 12 ) {
        $greeting = &#039;上午好&#039;;
    } elseif ( $hour &lt; 18 ) {
        $greeting = &#039;下午好&#039;;
    } else {
        $greeting = &#039;晚上好&#039;;
    }

// 构建输出
    $output = &#039;<div class="mfp-greeting">';
    $output .= sprintf( '<p>%s, %s!</p>', esc_html( $atts['name'] ), esc_html( $greeting ) );
    $output .= sprintf( '<p>เวลาปัจจุบันคือ: %s</p>', esc_html( $current_time ) );
    $output .= '</div>';

return $output;
}
// 注册简码，第一个参数是用户使用的标签名
add_shortcode( 'greeting', 'mfp_show_greeting_shortcode' );

ตอนนี้ผู้ใช้สามารถใช้ shortcode นี้ในเครื่องมือแก้ไขบทความได้ [greeting name="张三"]เมื่อเพิ่มพารามิเตอร์ลงใน shortcode เช่น [greeting name=“Zhang San”] หน้าเว็บจะแสดง: “Zhang San สวัสดีตอนบ่าย! เวลาปัจจุบันคือ: 2026-...” หากไม่ระบุพารามิเตอร์ จะใช้ค่าเริ่มต้นเป็น "ผู้เยี่ยมชม"

การปฏิบัติขั้นสูง: การสร้างตารางฐานข้อมูลและหน้าตัวเลือก

ปลั๊กอินที่ซับซ้อนมากขึ้นอาจจำเป็นต้องจัดเก็บข้อมูลของตัวเอง WordPress มีสองวิธีหลัก: ใช้ WordPress Options API เพื่อเก็บข้อมูลคู่คีย์-ค่าที่เรียบง่าย หรือสร้างตารางฐานข้อมูลที่กำหนดเองเพื่อเก็บข้อมูลที่มีโครงสร้าง

โฮสติ้งแบบแชร์ของ InterServer
共享主机每月 $2.50 USD , 首月 $0.1 USD 优惠码 tryinterserver, 461个云应用脚本，一键安装。
โลโก้ InterServer เข้าถึงหน้าเว็บ

การใช้ Options API เพื่อเก็บการตั้งค่า

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

ก่อนอื่น เราจำเป็นต้องสร้างฟอร์ม ในฟังก์ชัน mfp_settings_page() ให้เพิ่มฟอร์มอย่างง่ายเพื่อจัดการการตั้งค่า:

function mfp_settings_page() {
    // 检查用户是否提交了表单
    if ( isset( $_POST['mfp_submit_settings'] ) ) {
        // 安全检查：验证 nonce
        if ( ! isset( $_POST['mfp_settings_nonce'] ) || ! wp_verify_nonce( $_POST['mfp_settings_nonce'], 'mfp_save_settings' ) ) {
            wp_die( '安全验证失败！' );
        }
        // 权限检查
        if ( ! current_user_can( 'manage_options' ) ) {
            wp_die( '权限不足！' );
        }
        // 清理并保存选项
        $custom_message = sanitize_textarea_field( $_POST['custom_message'] );
        update_option( 'mfp_custom_message', $custom_message );
        echo '<div class="notice notice-success is-dismissible"><p>ตั้งค่าเรียบร้อยแล้ว</p></div>';
    }

// 从数据库读取现有值
    $saved_message = get_option( 'mfp_custom_message', '这是默认的欢迎信息。' );
    ?&gt;
    <div class="wrap">
        <h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
        <form method="post" action="" data-trp-original-action="">
            <?php wp_nonce_field( 'mfp_save_settings', 'mfp_settings_nonce' ); ?>
            <table class="form-table">
                <tr>
                    <th scope="row"><label for="custom_message">ข้อความที่กำหนดเอง:</label></th>
                    <td>
                        <textarea name="custom_message" id="custom_message" rows="5" cols="50" class="large-text"><?php echo esc_textarea( $saved_message ); ?></textarea>
                        <p class="description">ข้อความนี้จะปรากฏขึ้น เมื่อใช้ชอร์ตโค้ด [show_message]</p>
                    </td>
                </tr>
            </table>
            <?php submit_button( '保存更改', 'primary', 'mfp_submit_settings' ); ?>
        <input type="hidden" name="trp-form-language" value="th"/></form>
    </div>
    &lt;?php
}

จากนั้น เราจะสร้างชอร์ตโค้ดใหม่เพื่อแสดงข้อความที่บันทึกนี้:

function mfp_show_message_shortcode() {
    $message = get_option( 'mfp_custom_message', '这是默认的欢迎信息。' );
    return '<div class="mfp-custom-message">' . wp_kses_post( wpautop( $message ) ) . '</div>';
}
add_shortcode( 'show_message', 'mfp_show_message_shortcode' );

ตอนนี้ ผู้ดูแลระบบสามารถกำหนดข้อความที่ต้องการได้ในหน้าการตั้งค่าปลั๊กอิน ในขณะที่ผู้เขียนเพียงแค่ใช้ [show_message] ชอร์ตโค้ดในบทความเพื่อแสดงข้อความนั้น

สร้างตารางที่กำหนดเองเมื่อปลั๊กอินเปิดใช้งาน

สำหรับปลั๊กอินที่ต้องการเก็บข้อมูลเชิงความสัมพันธ์ที่ซับซ้อน เช่น คำสั่งซื้อ บันทึกกิจกรรม ฯลฯ อาจจำเป็นต้องสร้างตารางฐานข้อมูลของตัวเอง ซึ่งมักจะดำเนินการเมื่อปลั๊กอินถูกเปิดใช้งาน WordPress มีฟังก์ชัน register_activation_hook เพื่อกำหนดฟังก์ชันที่ทำงานเมื่อเปิดใช้งาน

หมายเหตุ: รหัสต่อไปนี้เป็นเพียงตัวอย่าง ในระหว่างการพัฒนาจริงจำเป็นต้องมีการจัดการข้อผิดพลาดที่เข้มงวดยิ่งขึ้นและการใช้ชั้นข้อมูลนามธรรม (เช่น $wpdb).

// 插件激活时运行的函数
function mfp_create_custom_table() {
    global $wpdb;
    $table_name = $wpdb->prefix . 'mfp_plugin_logs'; // 确保表名唯一
    $charset_collate = $wpdb->get_charset_collate();

$sql = "CREATE TABLE IF NOT EXISTS $table_name (
        id mediumint(9) NOT NULL AUTO_INCREMENT,
        log_time datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
        user_id bigint(20) DEFAULT 0,
        action varchar(255) NOT NULL,
        details text,
        PRIMARY KEY  (id)
    ) $charset_collate;";

// 引入 WordPress 升级 API，用于执行 dbDelta 函数
    require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );
    dbDelta( $sql );
}
// 注册激活钩子
register_activation_hook( __FILE__, 'mfp_create_custom_table' );

สรุป

ผ่านคู่มือนี้ คุณได้ผ่านกระบวนการหลักในการพัฒนา WordPress plugin เริ่มต้นจากการตั้งค่าแวดล้อม การเขียนส่วนหัวของปลั๊กอิน คุณได้เรียนรู้การใช้ action และ filter hooks เพื่อขยายความสามารถของ WordPress ผ่าน shortcodes เพื่อให้ผู้ใช้มีวิธีการฝังเนื้อหาที่ยืดหยุ่น และได้ใช้วิธีพื้นฐานในการใช้ Options API เพื่อเก็บการตั้งค่า รวมถึงการสร้างตารางฐานข้อมูลแบบกำหนดเอง สิ่งเหล่านี้เป็นรากฐานสำคัญในการสร้างปลั๊กอินที่มีความสามารถ โปรดจำไว้ว่า โครงสร้างโค้ดที่ดี ความปลอดภัย (เช่น การตรวจสอบ nonce และการตรวจสอบสิทธิ์) และการเตรียมพร้อมสำหรับการทำให้เป็นสากล เป็นส่วนที่ขาดไม่ได้ในการพัฒนา plugin ระดับมืออาชีพ ขั้นตอนต่อไป คุณสามารถสำรวจ WordPress REST API, ประเภทเนื้อหาที่กำหนดเอง (Custom Post Types), เมตาดาต้า (Meta Boxes) รวมถึงการนำเข้า script และสไตล์ส่วนหน้า (frontend) อย่างเป็นมาตรฐาน เพื่อสร้างปลั๊กอินที่ซับซ้อนและมีประสิทธิภาพยิ่งขึ้น

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

ปลั๊กอินสามารถมีไฟล์หลักได้เพียงไฟล์เดียวหรือไม่?

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

จะจัดการข้อมูลที่ผู้ใช้ส่งผ่านฟอร์มด้านหน้าเว็บไซต์อย่างปลอดภัยได้อย่างไร?

เมื่อต้องจัดการข้อมูลที่ผู้ใช้ส่งมา จำเป็นต้องมีการตรวจสอบความถูกต้อง การทำความสะอาด และการหลีกเลี่ยงอักขระพิเศษอย่างเคร่งครัด สำหรับข้อมูลนำเข้า ควรใช้ sanitize_text_field()、sanitize_email()、sanitize_textarea_field() ใช้ฟังก์ชันเพื่อทำความสะอาด สำหรับข้อมูลที่ส่งออกไปยังหน้า HTML ให้ใช้ esc_html()、esc_attr() 或 wp_kses_post() เพื่อหลีกเลี่ยงปัญหา นอกจากนี้ อย่าลืมใช้กลไก nonce ของ WordPress เพื่อป้องกันการขอข้ามไซต์ปลอม และใช้ current_user_can() ตรวจสอบสิทธิ์ของผู้ใช้

ปลั๊กอินของฉันจะหลีกเลี่ยงการชนกันของชื่อฟังก์ชันกับปลั๊กอินอื่นได้อย่างไร?

แนวทางปฏิบัติที่ดีที่สุดคือการใช้เนมสเปซ (PHP 5.3+) หรือใส่ฟังก์ชัน คลาส และค่าคงที่ทั้งหมดภายใต้คำนำหน้าที่ไม่ซ้ำใคร ตัวอย่างเช่น ในคู่มือนี้ ฟังก์ชันทั้งหมดเริ่มต้นด้วย “mfp_” (ตัวย่อของ My First Plugin) หากคุณใช้การเขียนโปรแกรมเชิงวัตถุ การห่อหุ้มโค้ดไว้ในคลาสก็เป็นวิธีที่มีประสิทธิภาพในการแก้ปัญหาการชนกันของชื่อเช่นกัน

หลังจากพัฒนาเสร็จแล้ว จะแจกจ่ายหรือวางขายปลั๊กอินในไดเรกทอรีทางการได้อย่างไร?

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

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

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

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

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

แท็ก: