คู่มือฉบับสมบูรณ์ในการพัฒนา WordPress Plugins: ตั้งแต่เริ่มต้นจนถึงการวางจำหน่าย

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

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

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

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

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

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

UltaHost WordPress โฮสติ้ง

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

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

สร้างไฟล์ Plugin แรกของคุณ

ปลั๊กอิน WordPress ทั้งหมดจะถูกเก็บไว้ใน wp-content/plugins ไดเรกทอรี ปลั๊กอินอาจเป็นไฟล์เดียวหรือไดเรกทอรีที่มีหลายไฟล์ วิธีพื้นฐานที่สุดคือเริ่มจากไฟล์เดียว

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

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

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个简短的描述，说明这个插件是做什么的。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

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

สร้างฟังก์ชันการทำงานแบบง่าย

หลังจากเปิดใช้งานปลั๊กอินแล้ว มันยังไม่มีฟังก์ชันการทำงานใดๆ ณ ขณะนี้ มาลองเพิ่มฟังก์ชันง่ายๆ เช่น การเพิ่มข้อความบรรทัดหนึ่งในส่วนท้ายของเว็บไซต์ ซึ่งจำเป็นต้องใช้ action hook หลักของ WordPress

แนะนำให้อ่าน คู่มือการพัฒนา WordPress Plugins ฉบับสมบูรณ์: ตั้งแต่พื้นฐานจนถึงการสร้างฟังก์ชันที่กำหนดเองได้อย่างเชี่ยวชาญ。

// 这个函数用于输出自定义文本
function my_first_plugin_add_footer_text() {
    echo '<p style="text-align: center;">ขอบคุณที่ใช้ปลั๊กอินแรกของฉัน!</p>';
}
// 将上面的函数挂载到 WordPress 的 wp_footer 钩子上
add_action( 'wp_footer', 'my_first_plugin_add_footer_text' );

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

การพัฒนาหลัก: Hook และ Filter

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

ใช้ Action Hook

Action Hook อนุญาตให้คุณดำเนินการฟังก์ชันที่จุดเฉพาะในวงจรชีวิตของ WordPress ตัวอย่างการเพิ่มข้อความในส่วนท้ายของหน้าเว็บที่กล่าวถึงข้างต้นใช้ wp_footer action อีก hook ที่ใช้บ่อยคือ initซึ่งจะทำงานเมื่อ WordPress เริ่มต้น มักใช้สำหรับการลงทะเบียนประเภทโพสต์หรือแท็กซอนอมีแบบกำหนดเอง

hosting.com 共享主机

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

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

function my_plugin_custom_init() {
    // 在这里执行初始化代码
    error_log('我的插件已随 WordPress 初始化！');
}
add_action( 'init', 'my_plugin_custom_init' );

การทำความเข้าใจและใช้งาน Action Hooks อย่างมีประสิทธิภาพเป็นกุญแจสำคัญในการผสานรวมปลั๊กอินกับ WordPress Core อย่างลึกซึ้ง

ใช้ Filter Hook เพื่อปรับเปลี่ยนเนื้อหา

Filter Hooks อนุญาตให้คุณปรับเปลี่ยนข้อมูลที่ WordPress สร้างขึ้นในระหว่างกระบวนการประมวลผล ตัวอย่างเช่น หากคุณต้องการแก้ไขข้อความก่อนหน้าชื่อเรื่องบทความ คุณสามารถใช้ the_title ตัวกรอง

function my_plugin_modify_title( $title, $id = null ) {
    // 只在主循环和单篇文章页为标题添加前缀
    if ( in_the_loop() && is_single() ) {
        return '【推荐】' . $title;
    }
    return $title;
}
add_filter( 'the_title', 'my_plugin_modify_title', 10, 2 );

ในที่นี้ 10 คือลำดับความสำคัญเริ่มต้น2 บ่งชี้ว่าฟังก์ชันตัวกรองนี้รับพารามิเตอร์สองตัว ผ่านตัวกรอง คุณสามารถเปลี่ยนเนื้อหาเกือบทั้งหมดที่ WordPress แสดงผลออกมาได้อย่างปลอดภัย

แนะนำให้อ่าน จากศูนย์ถึงหนึ่ง: สอนคุณทีละขั้นตอนให้เชี่ยวชาญเทคนิคหลักในการพัฒนา WordPress Plugin。

โครงสร้างปลั๊กอินและฟังก์ชันขั้นสูง

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

การจัดระเบียบไฟล์และไดเรกทอรี

ไดเรกทอรีปลั๊กอินที่มีโครงสร้างดีอาจมีลักษณะดังนี้:

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

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

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

my-advanced-plugin/
├── my-advanced-plugin.php      // 主插件文件，包含头部和引导代码
├── includes/                   // 主要 PHP 类或函数文件目录
│   ├── class-admin-settings.php
│   ├── class-public-handler.php
├── admin/                     // 仅后台相关文件
│   ├── css/
│   ├── js/
│   └── views/
├── public/                    // 仅前台相关文件
│   ├── css/
│   ├── js/
│   └── views/
├── assets/                    // 共享资源（如图标）
└── languages/                 // 国际化翻译文件

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

สร้างหน้าการจัดการ

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

function my_plugin_add_admin_menu() {
    add_menu_page(
        '我的插件设置',    // 页面标题
        '我的插件',        // 菜单标题
        'manage_options', // 权限 capability
        'my-plugin-slug', // 菜单 slug
        'my_plugin_settings_page', // 用于渲染页面的回调函数
        'dashicons-admin-generic', // 图标
        80                  // 菜单位置
    );
}
add_action( 'admin_menu', 'my_plugin_add_admin_menu' );

function my_plugin_settings_page() {
    // 检查用户权限
    if ( !current_user_can( 'manage_options' ) ) {
        wp_die( __( '你没有足够的权限访问此页面。' ) );
    }
    ?>
    <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
            // 输出设置字段和安全密钥
            settings_fields( 'my_plugin_options_group' );
            do_settings_sections( 'my-plugin-slug' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="th"/></form>
    </div>
    &lt;?php
}

โค้ดนี้จะเพิ่มเมนูใหม่ในแถบด้านข้างของ WordPress แอดมิน เมื่อคลิกจะโหลดหน้าซึ่งประกอบด้วยฟอร์มการตั้งค่า เพื่อให้ทำงานได้จริงคุณต้องใช้ Settings API เพื่อลงทะเบียนฟิลด์และตัวเลือกการตั้งค่าด้วย

การปฏิบัติด้านสากลนิยมและความปลอดภัย

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

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

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

ก่อนอื่น ตรวจสอบให้แน่ใจว่าได้กำหนด Text Domain 和 Domain Pathในส่วนหัวของปลั๊กอิน จากนั้น ให้ห่อสตริงทั้งหมดที่หันหน้าไปทางผู้ใช้ด้วยฟังก์ชันเช่น ()、_e() 或 esc_html() ใช้ฟังก์ชันห่อหุ้ม

// 在插件代码中
echo '<p>' . esc_html__( '这是一个可以被翻译的段落。', 'my-first-plugin' ) . '</p>';

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

เสริมความปลอดภัยของปลั๊กอิน

ความปลอดภัยไม่ควรละเลย หลักการพื้นฐานคือ: ตรวจสอบข้อมูลนำเข้า, หลีกเลี่ยงผลลัพธ์, ทำการตรวจสอบสิทธิ์
1. 验证与检查权限：任何处理用户数据或后台请求的函数，都必须检查当前用户是否有权执行该操作。使用 current_user_can() 和 check_admin_referer() ฟังก์ชันต่างๆ
2. 转义输出：在将任何数据（尤其是来自用户或数据库的数据）输出到 HTML、JavaScript 或 URL 时，必须进行转义。
- HTML: esc_html(), esc_attr()
- URL: esc_url()
- เฉพาะใน JavaScript เท่านั้น:wp_json_encode()
3. 数据库安全：与 WordPress 数据库交互时，永远不要手动拼接 SQL 查询。使用 $wpdb คำสั่งที่เตรียมไว้

    global $wpdb;
    $results = $wpdb->get_results(
        $wpdb->prepare(
            "SELECT * FROM {$wpdb->prefix}my_table WHERE id = %d AND status = %s",
            $user_id,
            $status
        )
    );

ทดสอบและส่งไปยังไดเรกทอรีอย่างเป็นทางการ

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

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

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

สรุป

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

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

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

ปลั๊กอินต้องมีไฟล์ใดบ้าง?

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

วิธีการเพิ่มตัวเลือกการตั้งค่าสำหรับปลั๊กอินของฉัน

แนะนำให้ใช้ WordPress Settings API เพื่อเพิ่มตัวเลือกการตั้งค่า ซึ่งรวมถึงการใช้ register_setting() ลงทะเบียนตัวเลือกโดยใช้ add_settings_section() 和 add_settings_field() เพื่อกำหนดพื้นที่และฟิลด์การตั้งค่า และใช้ settings_fields() 和 do_settings_sections() ในฟังก์ชัน callback ของหน้าเมนูหลังระบบปลั๊กอินเพื่อแสดงฟอร์ม แม้ว่าจะสามารถจัดการการส่งฟอร์มด้วยตนเองได้ แต่ Settings API จะจัดการการตรวจสอบข้อมูล การจัดเก็บ และการตรวจสอบความปลอดภัยโดยอัตโนมัติ

ฉันจะมั่นใจได้อย่างไรว่าปลั๊กอินของฉันเข้ากันได้กับปลั๊กอินหรือธีมอื่นๆ?

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

ปลั๊กอินของฉันจำเป็นต้องรองรับโหมดหลายไซต์ของ WordPress หรือไม่?

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