Nắm vững phát triển plugin WordPress: Xây dựng plugin tùy chỉnh đầu tiên của bạn từ con số không

Tại sao nên chọn phát triển plugin cho WordPress?

WordPress, với tư cách là hệ thống quản lý nội dung (CMS) phổ biến nhất trên thế giới, sở hữu khả năng mở rộng mạnh mẽ nhờ vào các plugin. Bằng cách phát triển các plugin tùy chỉnh, bạn có thể bổ sung những tính năng độc đáo cho nền tảng chính, đáp ứng nhu cầu kinh doanh cụ thể mà không cần phải thay đổi các tệp thuộc gói giao diện (theme). Điều này giúp đảm bảo rằng mã nguồn của các tính năng bạn tạo ra sẽ không bị mất đi khi gói giao diện được cập nhật, đồng thời giúp các tính năng được tổ chức theo dạng module hóa, thuận tiện cho việc tái sử dụng trên nhiều trang web khác nhau.

Học cách phát triển các plugin không chỉ giúp bạn tạo ra những sản phẩm có thể được người khác sử dụng, mà còn giúp bạn hiểu sâu hơn về cách thức hoạt động của WordPress – bao gồm hệ thống các hook (các điểm kết nối giữa các thành phần của hệ thống), cách thức tương tác với cơ sở dữ liệu, và các thực tiễn tốt nhất về bảo mật. Đây là bước quan trọng để bạn từ một người dùng bình thường trở thành một nhà phát triển chuyên nghiệp.

Xây dựng plugin đầu tiên của bạn

Trước khi bắt đầu viết mã, bạn cần thiết lập một môi trường WordPress chuẩn trên máy tính cá nhân hoặc trên máy chủ thử nghiệm. Đây là nền tảng cơ bản cho tất cả các công việc phát triển phần mềm.

Đọc thêm Học cách phát triển plugin cho WordPress từ đầu: Xây dựng chức năng tùy chỉnh đầu tiên của bạn。

Tạo tệp chính của plugin

Mọi plugin WordPress đều phải có một tệp chính, thường được đặt tên theo tên của plugin đó. Chúng ta sẽ tạo một tệp có tên là…my-first-pluginPlugin. Đầu tiên, hãy tìm đến thư mục cài đặt WordPress của bạn./wp-content/plugins/Trong thư mục đó, hãy tạo một thư mục mới và đặt tên cho nó là…my-first-plugin。

UltaHost – Nhà cung cấp dịch vụ máy chủ WordPress chuyên nghiệp

Bảo đảm hoàn tiền trong 30 ngày, băng thông và cơ sở dữ liệu không giới hạn, bảo vệ DDoS miễn phí, mua 3 năm ưu đãi 50%

Truy cập trang

Trong thư mục đó, hãy tạo một tệp có tên làmy-first-plugin.phpĐây là tệp PHP chứa điểm vào (entry point) của plugin. Hãy mở tệp này và thêm các ghi chú ở đầu plugin như sau; những thông tin này rất quan trọng để WordPress nhận diện plugin của bạn.

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://yourwebsite.com/my-first-plugin
 * Description:       这是一个学习WordPress插件开发的示例插件，用于在文章底部添加自定义内容。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://yourwebsite.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Thực hiện chức năng đơn giản đầu tiên

Một tính năng kinh điển dành cho người mới bắt đầu là tự động thêm một đoạn văn bản ở cuối mỗi bài viết trên trang web. Chúng ta sẽ sử dụng công cụ của WordPress để thực hiện điều này. the_content Bạn có thể thực hiện điều này bằng cách sử dụng các “filter hooks”. Dưới dòng chú thích ở đầu tệp chính của bạn, hãy thêm hàm sau:

// 防止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

/**
 * 在文章内容末尾添加自定义文本
 *
 * @param string $content 原始的文章内容。
 * @return string 修改后的文章内容。
 */
function mfp_add_footer_text( $content ) {
    // 判断是否是主循环且在单篇文章页面
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $custom_text = '<div class="mfp-footer-note"><p><em>Cảm ơn bạn đã đọc! Bài viết này được cung cấp bởi “My First Plugin”.</em></p></div>';
        return $content . $custom_text;
    }
    return $content;
}
// 将函数挂载到 `the_content` 过滤器上
add_filter( 'the_content', 'mfp_add_footer_text' );

Đoạn mã này định nghĩa một hàm. mfp_add_footer_textNó nhận dữ liệu nội dung của bài viết. $content Được sử dụng như một tham số, hàm sẽ kiểm tra trước xem môi trường hiện tại có đang ở trang bài viết đơn lẻ, vòng lặp chính, hay truy vấn chính hay không; điều này nhằm tránh việc thêm văn bản vào phần tóm tắt, các tiện ích khác, hoặc các nơi khác. Nếu điều kiện được đáp ứng, hàm sẽ tạo ra một đoạn văn bản HTML tùy chỉnh và thêm nó vào sau nội dung gốc.

Thâm nhập vào kiến trúc plugin và các vấn đề liên quan đến bảo mật

Khi số lượng tính năng của các plugin tăng lên, việc tổ chức mã nguồn một cách khoa học trở nên vô cùng quan trọng. Đồng thời, bảo mật là yếu tố then chốt trong mọi quá trình phát triển ứng dụng dựa trên nền tảng WordPress.

Đọc thêm Thành thạo phát triển plugin WordPress: Xây dựng mô-đun mở rộng đầu tiên của bạn từ con số 0 đến 1。

Restructure the code using object-oriented programming.

Để nâng cao khả năng bảo trì và mở rộng của mã nguồn, việc sử dụng phương pháp lập trình hướng đối tượng (Object-Oriented Programming – OOP) để tổ chức các plugin là được khuyến nghị. Chúng ta sẽ tái cấu trúc các chức năng đã nêu ở trên thành một lớp (class).

// 防止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

class My_First_Plugin {
    /**
     * 构造函数，初始化插件钩子。
     */
    public function __construct() {
        // 在构造方法中将方法挂载到钩子上
        add_action( 'init', array( $this, 'load_textdomain' ) );
        add_filter( 'the_content', array( $this, 'add_footer_to_content' ) );
        add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_styles' ) );
    }

/**
     * 加载插件的文本翻译域。
     */
    public function load_textdomain() {
        load_plugin_textdomain( 'my-first-plugin', false, dirname( plugin_basename( __FILE__ ) ) . '/languages' );
    }

/**
     * 在文章内容末尾添加自定义文本。
     */
    public function add_footer_to_content( $content ) {
        if ( is_single() && in_the_loop() && is_main_query() ) {
            $custom_text = '<div class="mfp-footer-note"><p><em>' . esc_html__( '感谢阅读！本文由“我的第一个插件”为您呈现。', 'my-first-plugin' ) . '</em></p></div>';
            return $content . $custom_text;
        }
        return $content;
    }

/**
     * 为插件添加样式。
     */
    public function enqueue_styles() {
        wp_enqueue_style( 'mfp-style', plugins_url( 'assets/css/style.css', __FILE__ ), array(), '1.0.0' );
    }
}

// 实例化插件类
$my_first_plugin_instance = new My_First_Plugin();

Lưu ý rằng, chúng tôi đang… add_footer_to_content Phương thức này đã sử dụng (The method has utilized certain components or techniques.) esc_html__() Chúng tôi đã tạo ra một hàm để bao bọc nội dung văn bản. Đây là một hàm dịch, đồng thời nó cũng thực hiện việc mã hóa (escape) nội dung đầu ra một cách thích hợp – đây là thực hành tốt nhất để đảm bảo an toàn khi hiển thị văn bản trên trang web. Chúng tôi cũng đã bổ sung phương thức để tải các bảng định dạng (style sheets) và hỗ trợ các trường văn bản (text fields), nhằm chuẩn bị cho việc hóa đa ngôn ngữ (

Hiểu và thực hiện xác thực và thoát dữ liệu

Đừng bao giờ tin tưởng vào dữ liệu do người dùng nhập vào hoặc bất kỳ dữ liệu bên ngoài nào. Khi nhận, xử lý, và hiển thị dữ liệu, bạn cần phải kiểm tra, làm sạch, và xử lý chúng một cách thích hợp (như việc “đánh dấu ký tự đặc biệt” – escape). Ví dụ, nếu bạn muốn tạo một trang quản lý có biểu mẫu đầu vào, hãy nhất định sử dụng các hàm do WordPress cung cấp để kiểm tra quyền truy cập và xác thực dữ liệu.

Hosting.com - lưu trữ chia sẻ

Hiệu năng cao, được trang bị CPU AMD EPYC, lưu trữ SSD NVMe và LiteSpeed, hỗ trợ chuyên gia nội bộ 24 giờ/ngày, các biện pháp bảo mật tiên tiến bao gồm SSL, chống brute force, phần mềm độc hại và bảo vệ DDoS, tiết kiệm tới 73%.

Truy cập trang

Chức năng của plugin này khá đơn giản, nhưng chúng tôi đã sử dụng nó khi tạo ra mã HTML. esc_html__() Cần thực hiện việc “đánh dấu ký tự đặc biệt” (escape) cho các dữ liệu được người dùng gửi đi. Nếu plugin cần xử lý dữ liệu đó (chẳng hạn thông qua biểu mẫu), thì việc sử dụng các kỹ thuật đánh dấu ký tự đặc biệt là bắt buộc. sanitize_text_field(), wp_kses_post() Dùng các hàm như… để dọn dẹp dữ liệu, và sau đó sử dụng chúng. wp_verify_nonce() Để xác minh tính hợp lệ của yêu cầu.

tạo trang quản lý plugin

Một plugin chuyên nghiệp thường cần một trang cấu hình nền (backend configuration page). Chúng ta sẽ học cách sử dụng API cấu hình của WordPress để tạo ra một trang quản lý đơn giản và chuẩn mực.

Thêm menu cài đặt plugin

Trước tiên, chúng ta cần thêm một trang menu con trong menu “Cài đặt” (Settings) ở phía sau trang web WordPress. Hãy thêm một phương thức mới vào lớp của bạn, và trong hàm khởi tạo (constructor), hãy sử dụng phương thức đó để thực hiện các thao tác cần thiết. add_action('admin_menu', ...) Hook function calls it.

Đọc thêm Hướng dẫn bắt đầu phát triển plugin WordPress: Xây dựng plugin chức năng đầu tiên của bạn từ đầu。

/**
 * 注册插件管理页面。
 */
public function register_admin_menu() {
    add_options_page(
        __( '我的插件设置', 'my-first-plugin' ), // 页面标题
        __( '我的第一个插件', 'my-first-plugin' ), // 菜单标题
        'manage_options', // 所需权限
        'mfp-settings', // 菜单slug
        array( $this, 'display_settings_page' ) // 显示页面的回调函数
    );
}

Sau đó, hãy thêm đoạn mã sau vào hàm khởi tạo (constructor):add_action( 'admin_menu', array( $this, 'register_admin_menu' ) );。

Xây dựng trang cấu hình và các trường dữ liệu

Tiếp theo, chúng ta cần định nghĩa… display_settings_page Phương thức này được sử dụng để hiển thị nội dung HTML của trang cấu hình, đồng thời sử dụng API cấu hình để đăng ký một trường cấu hình mới.

Máy chủ chia sẻ của InterServer

Lưu trữ chia sẻ với mức phí $2,50 USD mỗi tháng, giảm giá $0,1 USD trong tháng đầu tiên, mã giảm giá tryinterserver, với 461 ứng dụng đám mây và cài đặt chỉ bằng một cú nhấp chuột.

Truy cập trang

/**
 * 显示插件设置页面。
 */
public function display_settings_page() {
    ?>
    <div class="wrap">
        <h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
        <form action="/vi/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出设置字段、非ce等安全字段
            settings_fields( 'mfp_settings_group' );
            do_settings_sections( 'mfp-settings' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="vi"/></form>
    </div>
    <?php
}

/**
 * 初始化插件设置。
 */
public function initialize_settings() {
    // 注册一个设置
    register_setting(
        'mfp_settings_group', // 设置组名
        'mfp_footer_text', // 选项名
        array(
            'type' => 'string',
            'sanitize_callback' =&gt; 'sanitize_text_field', // 清理回调函数
            'default' =&gt; __( '感谢阅读！本文由“我的第一个插件”为您呈现。', 'my-first-plugin' ),
        )
    );

// 添加一个设置区域
    add_settings_section(
        'mfp_main_section',
        __( '主要设置', 'my-first-plugin' ),
        null, // 可选的区域描述回调函数
        'mfp-settings'
    );

// 向区域中添加字段
    add_settings_field(
        'mfp_footer_field',
        __( '页脚文本', 'my-first-plugin' ),
        array( $this, 'render_footer_field' ), // 渲染字段的回调函数
        'mfp-settings',
        'mfp_main_section',
        array( 'label_for' =&gt; 'mfp_footer_text' )
    );
}

Bạn cần định nghĩa (define) các khái niệm hoặc biến cần sử dụng trong chương trình. render_footer_field Các phương pháp để hiển thị các ô nhập (input fields) thực tế trên trang web, đồng thời cập nhật nội dung trong các ô đó so với trạng thái trước đó. add_footer_to_content Phương pháp để nó được lấy từ các tùy chọn cơ sở dữ liệu get_option('mfp_footer_text') Đọc văn bản từ tập tin thay vì sử dụng các chuỗi được khai báo cứng (hard-coded strings). Cuối cùng, hãy thêm đoạn mã này vào hàm khởi tạo (constructor):add_action( 'admin_init', array( $this, 'initialize_settings' ) );。

Tóm lại

Trong hành trình này, bạn đã tự mình xây dựng một plugin WordPress hoàn chỉnh, bắt đầu từ con số không. Bạn đã học được cách tạo cấu trúc cơ bản của một plugin, cách sử dụng các hook (action và filter) để mở rộng chức năng của WordPress, cách tổ chức mã nguồn theo phương pháp hướng đối tượng nhằm nâng cao chất lượng, cách tuân thủ các thực hành bảo mật tốt nhất để xác thực và mã hóa dữ liệu, và cách sử dụng API cấu hình của WordPress để tạo ra giao diện quản trị nền tảng chuyên nghiệp.

Trọng tâm của việc phát triển plugin nằm ở việc hiểu rõ hệ thống hook và dòng dữ liệu (data flow) của WordPress. Hãy liên tục thực hành, bắt đầu với những tính năng đơn giản, sau đó tăng dần độ phức tạp, và luôn đặt an ninh, hiệu suất cũng như khả năng bảo trì lên hàng đầu. Khi kinh nghiệm ngày càng tích lũy, bạn sẽ có thể tạo ra những plugin mạnh mẽ, chuyên nghiệp và được nhiều người ưa chuộng cho WordPress.

FAQ 常见问题

Để phát triển một plugin cho WordPress, bạn cần nắm vững một số kiến thức cơ bản sau:

Bạn cần có kiến thức lập trình PHP vững vàng, vì các plugin chủ yếu được viết bằng PHP. Ngoài ra, việc am hiểu cơ bản về HTML, CSS và JavaScript cũng là điều cần thiết, vì bạn sẽ phải xử lý phần hiển thị và tương tác trên trang web. Điều quan trọng nhất là bạn phải làm quen với các khái niệm cốt lõi của WordPress, chẳng hạn như các hook (hành động và bộ lọc), vòng lặp, cấu trúc của các template, cũng như các thao tác trên cơ sở dữ liệu (sử dụng các lớp như WP_Query và WP_User_Query).

Làm thế nào để gỡ lỗi và kiểm thử plugin của tôi?

Trước hết, tôi rất khuyên bạn nên thực hiện quá trình phát triển trên môi trường phát triển cục bộ (chẳng hạn như Local by Flywheel, XAMPP) hoặc trên các trang web thử nghiệm trực tuyến, để tránh ảnh hưởng đến trang web chính thức. Hãy bật chế độ gỡ lỗi (debug mode) của WordPress trên hệ thống phát triển của bạn.wp-config.phptệpdefine( 'WP_DEBUG', true );Điều này sẽ hiển thị các lỗi và cảnh báo của PHP trên màn hình. Hãy sử dụng nó.error_log()Hàm này ghi thông tin gỡ lỗi tùy chỉnh vào nhật ký lỗi của máy chủ. Đối với các trường hợp gỡ lỗi phức tạp hơn, bạn có thể xem xét sử dụng các tiện ích gỡ lỗi chuyên nghiệp như Query Monitor hoặc Debug Bar.

Làm thế nào để plugin của tôi tương thích với các phiên bản WordPress khác nhau?

Trong quá trình phát triển, bạn nên chú ý đến các thông báo về việc các hàm trong tài liệu chính thức của WordPress bị loại bỏ (deprecation). Hãy tránh sử dụng những hàm đã được đánh dấu là “đã bị loại bỏ” (deprecated). Trong tệp chính của plugin, bạn có thể thực hiện điều này bằng cách…Requires at least和Tested up toThông tin ở phần đầu trang được sử dụng để chỉ định phiên bản WordPress mà plugin của bạn tương thích với nó. Hãy thường xuyên kiểm thử plugin của bạn trên các phiên bản WordPress mới hơn, đồng thời theo dõi nhật ký cập nhật của phiên bản WordPress cốt lõi để có thể điều chỉnh mã nguồn kịp thời khi cần thiết.

Làm thế nào để đăng ký plugin của tôi vào danh mục plugin chính thức của WordPress?

Trước hết, bạn cần đảm bảo rằng plugin của mình hoàn toàn tuân thủ các quy định và hướng dẫn phát triển plugin chính thức của WordPress. Điều này bao gồm chất lượng mã nguồn, tính bảo mật, và thỏa thuận cấp phép (phải là GPLv2 hoặc phiên bản mới hơn). Sau đó, hãy đăng ký một kho lưu trữ SVN (Subversion Repository) trên trang web WordPress.org. Hãy gửi mã nguồn plugin của bạn lên kho lưu trữ SVN đó.trunkNó đã được thêm vào danh mục, và các tài liệu tương ứng cũng đã được tạo ra.readme.txtTệp tin (được định dạng theo quy định cụ thể). Sau khi được phê duyệt, plugin của bạn sẽ được đăng vào danh mục chính thức.