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

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

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

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

สร้าง Plugin แรกของคุณ

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

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

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

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

UltaHost WordPress โฮสติ้ง

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

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

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

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

เพิ่มฟังก์ชันพื้นฐานให้กับปลั๊กอิน

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

ในไฟล์หลักของปลั๊กอิน ให้เพิ่มโค้ดต่อไปนี้:

// 在网站页脚输出自定义信息
function my_first_plugin_footer_text() {
    echo '<p style="text-align: center;">ขอบคุณที่ใช้บริการจากปลั๊กอินแรกของฉัน</p>';
}
add_action( 'wp_footer', 'my_first_plugin_footer_text' );

ในที่นี้ เราได้กำหนดฟังก์ชันmy_first_plugin_footer_text()จากนั้นใช้ฟังก์ชันadd_action()เพื่อเชื่อมต่อมันเข้ากับwp_footerบน Hook เมื่อ WordPress ดำเนินการไปถึงส่วนท้ายของหน้า มันจะเรียกใช้ฟังก์ชันของเราอัตโนมัติและแสดงเนื้อหา HTML ที่กำหนดไว้ล่วงหน้า นี่เป็นการสาธิตการใช้งานพื้นฐานของกลไก “Hook และ Callback” ใน WordPress

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

เจาะลึกแกนกลาง: ฮุคและตัวกรอง

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

ทำความเข้าใจกับแอ็กชันฮุค

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

// 在初始化时执行一些操作
function my_plugin_init_action() {
    // 例如，在这里可以注册一个自定义文章类型
    // if ( ! post_type_exists( 'book' ) ) { ... }
}
add_action( 'init', '_plugin_init_action' );

เรียนรู้เกี่ยวกับฟิลเตอร์ฮุค

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

hosting.com 共享主机

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

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

// 在文章内容末尾自动添加一段提示文字
function my_plugin_content_filter( $content ) {
    if ( is_single() ) {
        $extra_text = '<div class="my-plugin-note">เนื้อหานี้ถูกสร้างขึ้นจากการคัดกรองของปลั๊กอินของฉัน</div>';
        $content .= $extra_text;
    }
    return $content;
}
add_filter( 'the_content', 'my_plugin_content_filter' );

ในตัวอย่างนี้ ฟังก์ชันmy_plugin_content_filter()รับต้นฉบับ$contentตรวจสอบว่าเป็นหน้าโพสต์เดี่ยวหรือไม่ จากนั้นเพิ่ม HTML ลงท้าย และสุดท้ายส่งคืนเนื้อหาที่ปรับเปลี่ยนแล้ว WordPress จะใช้ค่าที่ส่งคืนนี้แทนเนื้อหาดั้งเดิมในการแสดงผล

สร้างปลั๊กอินที่สามารถกำหนดค่าได้

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

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

ใช้add_menu_page()或add_options_page()ฟังก์ชันสามารถเพิ่มรายการเมนูและหน้าตั้งค่าในแอดมินสำหรับปลั๊กอินของคุณ ซึ่งมักเกิดขึ้นในadmin_menuฮุคแอ็กชัน

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

// 添加插件管理菜单
function my_plugin_add_admin_menu() {
    add_options_page(
        '我的插件设置',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',       // 所需权限
        'my-plugin-settings',   // 菜单slug
        'my_plugin_settings_page' // 显示页面的回调函数
    );
}
add_action( 'admin_menu', 'my_plugin_add_admin_menu' );

// 设置页面的HTML内容
function my_plugin_settings_page() {
    ?>
    <div class="wrap">
        <h1>การตั้งค่าปลั๊กอินของฉัน</h1>
        <form method="post" action="/th/options.php/" data-trp-original-action="options.php">
            <?php
            settings_fields( 'my_plugin_settings_group' );
            do_settings_sections( 'my-plugin-settings' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="th"/></form>
    </div>
    &lt;?php
}

การตั้งค่าการลงทะเบียน ฟิลด์ และการจัดการความปลอดภัย

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

// 初始化插件设置
function my_plugin_settings_init() {
    // 注册一个新的设置项到“my_plugin_settings_group”
    register_setting( 'my_plugin_settings_group', 'my_plugin_options' );

// 在设置页面添加一个区域
    add_settings_section(
        'my_plugin_section_id',
        '基础配置',
        null,
        'my-plugin-settings'
    );

// 向该区域添加一个字段
    add_settings_field(
        'my_plugin_text_field',
        '提示文本',
        'my_plugin_text_field_render',
        'my-plugin-settings',
        'my_plugin_section_id'
    );
}
add_action( 'admin_init', 'my_plugin_settings_init' );

// 渲染文本框字段
function my_plugin_text_field_render() {
    $options = get_option( 'my_plugin_options' );
    ?>
    <input type='text' name='my_plugin_options[text_field]' value='<?php echo esc_attr( $options['text_field'] ?? '' ); ?>'>
    <p class="description">ข้อความที่ป้อนที่นี่จะปรากฏบนเว็บไซต์ด้านหน้า</p>
    &lt;?php
}

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

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

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

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

ปฏิบัติตามแนวทางปฏิบัติที่ดีที่สุดและการเตรียมพร้อมสำหรับการเผยแพร่

การพัฒนาโปรแกรมเสริมที่มีคุณภาพสูง บำรุงรักษาได้ง่าย และปลอดภัย จำเป็นต้องปฏิบัติตามแนวทางปฏิบัติที่ดีที่สุดหลายประการ

การจัดระเบียบโค้ดและความปลอดภัย

อย่าเชื่อข้อมูลที่ผู้ใช้ป้อนเข้าเป็นอันขาด ใช้ฟังก์ชันที่ WordPress จัดให้เพื่อหลีกเลี่ยงหรือตรวจสอบข้อมูลทั้งหมดที่ได้รับจาก$_GET、$_POSTหรืออ่านจากฐานข้อมูลและเตรียมสำหรับการแสดงผล เช่นesc_html()、esc_attr()、sanitize_text_field()、wp_kses()เป็นต้น ใช้wp_enqueue_script()和wp_enqueue_style()เพื่อโหลดสคริปต์และสไตล์อย่างถูกต้อง และจัดการการพึ่งพาและการควบคุมเวอร์ชัน สำหรับปลั๊กอินที่ซับซ้อน ให้พิจารณาใช้การเขียนโปรแกรมเชิงวัตถุ (OOP) เพื่อจัดระเบียบโค้ด โดยห่อหุ้มฟังก์ชันการทำงานไว้ในคลาส เพื่อเพิ่มความสามารถในการแยกส่วนและการนำกลับมาใช้ใหม่ของโค้ด

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

เพื่อให้ปลั๊กอินของคุณสามารถใช้งานโดยผู้ใช้ทั่วโลก การทำให้เป็นสากล (i18n) เป็นสิ่งสำคัญ ซึ่งหมายความว่าคุณต้องใช้__()或_e()ฟังก์ชันห่อหุ้มสตริงทั้งหมดที่เผชิญหน้ากับผู้ใช้ โดเมนข้อความที่กำหนดในความคิดเห็นส่วนหัวของปลั๊กอินText Domain（เช่นmy-first-plugin) ต้องสอดคล้องกับโดเมนข้อความที่ใช้ที่นี่

// 错误示例
echo “Settings Saved”;

// 正确示例
echo esc_html__( 'Settings Saved', 'my-first-plugin' );

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

เตรียมพร้อมสำหรับการเผยแพร่ไปยังไดเรกทอรีทางการ

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

สรุป

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

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

การพัฒนา plugin ต้องมีความรู้พื้นฐานใดบ้างก่อน

คุณต้องมีความรู้พื้นฐานเกี่ยวกับการเขียนโปรแกรม PHP เข้าใจ HTML และ CSS และมีความเข้าใจพื้นฐานเกี่ยวกับการทำงานและแนวคิดของ WordPress (เช่น โพสต์ หน้า วิดเจ็ต) ความคุ้นเคยกับแนวคิดพื้นฐานของฐานข้อมูล MySQL ก็มีประโยชน์ แต่ไม่จำเป็น เพราะ WordPress มีฟังก์ชันการทำงานกับฐานข้อมูลที่สะดวก (เช่นWP_Query、wpdb)

ไฟล์ functions.php ของปลั๊กอินและธีมมีอะไรแตกต่างกัน

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

จะดีบั๊กโค้ดปลั๊กอินของฉันได้อย่างไร

WordPress มีเครื่องมือดีบักหลายอย่าง ประการแรก คุณสามารถเปิดใช้งานwp-config.phpเปิดในไฟล์WP_DEBUGโหมด และตั้งค่าdefine( 'WP_DEBUG', true );นี่จะแสดงข้อผิดพลาด คำเตือน และการแจ้งเตือนทั้งหมดของ PHP บนหน้าจอ วิธีที่ปลอดภัยกว่าคือการตั้งค่าในไฟล์WP_DEBUG_LOGเป็นtrueบันทึกข้อผิดพลาดลงใน/wp-content/debug.logนอกจากนี้ การใช้error_log()ฟังก์ชันหรือการติดตั้งปลั๊กอินดีบักมืออาชีพ เช่น Query Monitor สามารถช่วยติดตามตัวแปรและคำสั่งค้นหาฐานข้อมูลได้อย่างมีประสิทธิภาพมากขึ้น

ปลั๊กอินของฉันจะเข้ากันได้กับ PHP เวอร์ชันสูงได้อย่างไร

เพื่อให้แน่ใจว่าโปรแกรมเสริมจะทำงานได้อย่างถูกต้องในเวอร์ชัน PHP ในอนาคต คุณควรหลีกเลี่ยงการใช้ฟังก์ชันและไวยากรณ์ที่ถูกเลิกใช้หรือลบออกแล้ว ในสภาพแวดล้อมการพัฒนาในเครื่อง ให้ทดสอบด้วยสภาพแวดล้อมที่ตรงกับเวอร์ชันเป้าหมายในอนาคต (เช่น PHP 8.x) ติดตามประกาศอัปเดตจาก WordPress และ PHP อย่างต่อเนื่อง และระบุช่วงเวอร์ชัน PHP ที่รองรับในบันทึกการอัปเดตโปรแกรมเสริม เพื่อแจ้งเตือนผู้ใช้ให้เลือกสภาพแวดล้อมที่เหมาะสม