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

สภาพแวดล้อมการพัฒนาและพื้นฐานการเตรียมตัวสำหรับปลั๊กอิน WordPress

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

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

แนะนำให้ใช้ชุดซอฟต์แวร์เซิร์ฟเวอร์ท้องถิ่น เช่น Local by Flywheel, XAMPP หรือ MAMP เครื่องมือเหล่านี้สามารถติดตั้งสภาพแวดล้อมที่สมบูรณ์ซึ่งรวมถึง PHP, MySQL และ Apache/Nginx ได้ในคลิกเดียว โปรดตรวจสอบให้แน่ใจว่าเวอร์ชัน PHP ของคุณตรงกับความต้องการของเวอร์ชัน WordPress ที่คุณกำหนดเป้าหมาย โดยทั่วไปแนะนำให้ใช้ PHP 7.4 หรือสูงกว่าเพื่อประสิทธิภาพและการสนับสนุนความปลอดภัยที่ดีขึ้น

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

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

แนะนำให้อ่าน คู่มือขั้นสูงสุดในการพัฒนา WordPress Plugin: สร้างปลั๊กอินระดับธุรกิจตั้งแต่เริ่มต้นจนสำเร็จ。

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

UltaHost WordPress โฮสติ้ง

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

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

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

โครงสร้างหลักของปลั๊กอินและกลไกฮุก

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

ทำความเข้าใจกับ Action Hooks และ Filter Hooks

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

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

function myplugin_add_footer_text() {
    echo '<p style="text-align:center;">ขอบคุณที่ใช้บริการเว็บไซต์ของเรา</p>';
}
add_action( 'wp_footer', 'myplugin_add_footer_text' );

สร้างหน้าเว็บจัดการปลั๊กอิน

ปลั๊กอินหลายตัวจำเป็นต้องมีหน้าตั้งค่าในแดชบอร์ด WordPress ซึ่งโดยทั่วไปแล้วจะทำได้โดยการเชื่อมต่อกับ admin_menu ฮุกแอ็กชัน คุณต้องกำหนดฟังก์ชันที่ใช้ add_menu_page() 或 add_options_page() ฟังก์ชันเช่น ในการลงทะเบียนหน้า และกำหนดฟังก์ชันอื่นเพื่อแสดงเนื้อหา HTML ของหน้า

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

function myplugin_add_admin_menu() {
    add_options_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 权限
        'myplugin-settings', // 菜单别名
        'myplugin_render_settings_page' // 用于显示页面内容的函数
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

function myplugin_render_settings_page() {
    ?>
    <div class="wrap">
        <h2>การตั้งค่าปลั๊กอินของฉัน</h2>
        <form method="post" action="/th/options.php/" data-trp-original-action="options.php">
            <?php
            settings_fields( 'myplugin_settings_group' );
            do_settings_sections( 'myplugin-settings' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="th"/></form>
    </div>
    &lt;?php
}

การนำฟังก์ชันของปลั๊กอินและการประมวลผลข้อมูลไปใช้

ปลั๊กอินที่สมบูรณ์มักต้องจัดการกับข้อมูลที่ผู้ใช้ป้อน บันทึกการตั้งค่า และโต้ตอบกับฐานข้อมูล WordPress มี API ที่ทรงพลังเพื่อทำให้การดำเนินการเหล่านี้ง่ายขึ้น

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

การจัดการการส่งแบบฟอร์มและการดำเนินการฐานข้อมูลด้วยตนเองนั้นยุ่งยากและไม่ปลอดภัย การตั้งค่า API ของ WordPress มีวิธีการมาตรฐานและปลอดภัยในการลงทะเบียน ตรวจสอบและบันทึกการตั้งค่า ซึ่งเกี่ยวข้องกับฟังก์ชันหลักสามอย่าง:register_setting()、add_settings_section() 和 add_settings_field()。

ตัวอย่างต่อไปนี้แสดงวิธีการลงทะเบียนการตั้งค่าฟิลด์ข้อความ:

hosting.com 共享主机

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

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

function myplugin_settings_init() {
    register_setting( 'myplugin_settings_group', 'myplugin_greeting_text' );

add_settings_section(
        'myplugin_section',
        '基础设置',
        null,
        'myplugin-settings'
    );

add_settings_field(
        'myplugin_field_greeting',
        '问候语',
        'myplugin_field_greeting_render',
        'myplugin-settings',
        'myplugin_section'
    );
}
add_action( ‘admin_init’， ‘myplugin_settings_init’ );

function myplugin_field_greeting_render() {
    $value = get_option( ‘myplugin_greeting_text’， ‘你好，世界！’ );
    echo ‘<input type=“text” name=“myplugin_greeting_text” value=“’ . esc_attr( $value ) . ‘” />’;
}

สร้างตารางฐานข้อมูลที่กำหนดเอง

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

ก่อนอื่น ลงทะเบียนฮุกการเปิดใช้งานในไฟล์ปลั๊กอินหลักของคุณ:

register_activation_hook( __FILE__， ‘myplugin_create_database_table’ );

จากนั้นกำหนดฟังก์ชันสำหรับสร้างตาราง:

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

function myplugin_create_database_table() {
    global $wpdb;
    $table_name = $wpdb->prefix . ‘myplugin_data’;
    $charset_collate = $wpdb->get_charset_collate();

$sql = “CREATE TABLE $table_name (
        id mediumint(9) NOT NULL AUTO_INCREMENT，
        name varchar(100) NOT NULL，
        email varchar(100) NOT NULL，
        created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL，
        PRIMARY KEY (id)
    ) $charset_collate;”;

require_once( ABSPATH . ‘wp-admin/includes/upgrade.php’ );
    dbDelta( $sql );
}

ความปลอดภัยของปลั๊กอิน การทำให้เป็นสากล และการเตรียมพร้อมสำหรับการเผยแพร่

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

การปฏิบัติตามแนวทางปฏิบัติที่ดีที่สุดด้านความปลอดภัย

ความปลอดภัยเป็นสิ่งสำคัญที่สุดในการพัฒนาปลั๊กอิน ตรวจสอบ (ตรวจสอบรูปแบบ) และทำความสะอาด (ลบส่วนที่เป็นอันตราย) อินพุตของผู้ใช้เสมอ ใช้ฟังก์ชันที่ WordPress จัดหาให้ เช่น esc_html()、esc_attr()、sanitize_text_field() เพื่อแสดงผลหรือประมวลผลข้อมูล ในการดำเนินการค้นหาฐานข้อมูล ใช้ $wpdb->prepare() เพื่อป้องกันการโจมตีแบบ SQL injection พร้อมกันนี้ ใช้ current_user_can() ตรวจสอบสิทธิ์ผู้ใช้ เพื่อให้แน่ใจว่ามีเพียงผู้ใช้ที่ได้รับอนุญาตเท่านั้นที่สามารถดำเนินการที่ละเอียดอ่อนได้

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

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

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

การทำให้ปลั๊กอินเป็นสากล

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

ในโค้ดของคุณ ควรเขียนดังนี้:

$greeting = __( ‘你好，世界！’， ‘my-first-plugin’ );
echo esc_html( $greeting );

_e( ‘设置已保存。’， ‘my-first-plugin’ );

ระวัง พารามิเตอร์ที่สองในฟังก์ชันการแปล “โดเมนข้อความ” (Text Domain) ต้องตรงกับที่กำหนดไว้ในส่วนหัวความคิดเห็นของปลั๊กอิน Text Domain อย่างแน่นอน จากนั้น คุณสามารถใช้เครื่องมือเช่น Poedit เพื่อสร้าง .pot ไฟล์เทมเพลตสำหรับนักแปลในการสร้าง .po 和 .mo ไฟล์แปล

สรุป

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

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

การพัฒนา WordPress ปลั๊กอินต้องเชี่ยวชาญ PHP หรือไม่?

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

วิธีการดีบั๊ก WordPress ปลั๊กอินที่กำลังพัฒนาอยู่?

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

ชื่อฟังก์ชันในปลั๊กอินควรหลีกเลี่ยงการขัดแย้งกับปลั๊กอินอื่นได้อย่างไร?

เพื่อหลีกเลี่ยงการชนกันของชื่อฟังก์ชัน ชื่อคลาส หรือชื่อค่าคงที่ ควรใช้คำนำหน้าที่ไม่ซ้ำกันเสมอ วิธีปฏิบัติที่ดีที่สุดคือใช้ชื่อปลั๊กอินหรือตัวย่อเป็นคำนำหน้า ตัวอย่างเช่น หากปลั๊กอินของคุณชื่อว่า “Awesome Slider” สามารถใช้คำนำหน้าเช่น as_ 或 awesome_slider_ เป็นคำนำหน้าสำหรับฟังก์ชันที่กำหนดเองทั้งหมด สำหรับชื่อคลาส ควรปฏิบัติตามหลักการเดียวกัน

สามารถส่งปลั๊กอินแบบเสียเงินไปยังไดเรกทอรีปลั๊กอินอย่างเป็นทางการของ WordPress ได้หรือไม่?

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