Hướng dẫn đầy đủ về phát triển plugin cho WordPress: Từ con số không đến việc xây dựng plugin đầu tiên của bạn

Chuẩn bị môi trường phát triển plugin WordPress

Trước khi bắt đầu viết mã, việc thiết lập một môi trường phát triển địa phương ổn định và hiệu quả là điều vô cùng quan trọng. Điều này không chỉ giúp bạn thực hiện các bài kiểm thử một cách an toàn mà còn giúp mô phỏng được cấu hình của máy chủ thực tế. Đối với việc phát triển các plugin cho WordPress, chúng tôi khuyên bạn nên sử dụng các phần mềm máy chủ địa phương như XAMPP, MAMP hoặc Local by Flywheel. Những công cụ này cho phép bạn dễ dàng thiết lập một môi trường trên máy tính của mình, bao gồm Apache, PHP và MySQL.

Tiếp theo, bạn sẽ cần một trình soạn thảo mã nguồn. Visual Studio Code, PhpStorm hoặc Sublime Text đều là những lựa chọn tuyệt vời; chúng cung cấp các tính năng như tô điểm cú pháp, gợi ý mã nguồn và gỡ lỗi, giúp nâng cao đáng kể hiệu quả phát triển phần mềm. Sau khi cài đặt và cấu hình các công cụ này, hãy tải phiên bản mới nhất của mã nguồn WordPress và cài đặt nó lên máy chủ cá nhân của bạn.

Ngoài ra, khuyên bạn nên thiết lập một hệ thống quản lý phiên bản (version control system) tại thư mục gốc của dự án plugin của mình, chẳng hạn như Git. Hãy sử dụng nó để theo dõi những thay đổi trong mã nguồn, quản lý các phiên bản khác nhau của dự án, và đảm bảo rằng mọi ngườigit initLệnh này được sử dụng để tạo một kho lưu trữ (repository) mới, giúp bạn theo dõi các thay đổi trong mã nguồn, khôi phục các lỗi (rollback errors), và tăng cường sự phối hợp giữa các thành viên trong nhóm. Bạn nên cân nhắc bật chế độ gỡ lỗi (debug mode) của WordPress nữa.wp-config.phpThe file will contain…WP_DEBUGHằng số được thiết lậptrueĐiều này sẽ hiển thị các lỗi và cảnh báo của PHP trong quá trình phát triển, giúp bạn nhanh chóng xác định vấn đề.

Đọc thêm Hướng dẫn toàn diện về phát triển plugin WordPress: Từ con số không đến việc xây dựng plugin của riêng bạn。

Tạo cấu trúc cơ bản cho plugin đầu tiên của bạn

Một plugin chuẩn của WordPress có cấu trúc thư mục và tệp tin nhất định. Đầu tiên, hãy truy cập vào thư mục cài đặt của WordPress.wp-content/pluginsThư mục. Ở đây, hãy tạo một thư mục mới cho plugin sắp phát triển của bạn, tên nên ngắn gọn, duy nhất và có thể mô tả chức năng của plugin, ví dụ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

Viết tệp chính của plugin

Trong thư mục đó, hãy tạo một tệp có tên là….phpCác tệp có phần mở rộng được sử dụng làm tệp chính của plugin thường có cùng tên với thư mục chứa plugin đó. Ví dụ:my-first-plugin.phpĐây là tệp tin chứa thông tin về plugin; phần ghi chú ở đầu tệp (plugin header) là bắt buộc, vì nó cung cấp cho WordPress những thông tin cơ bản về plugin đó.

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

Trong đoạn chú thích này,Plugin NameĐây là thông tin bắt buộc duy nhất cần điền; các thông tin khác sẽ giúp người dùng nhận diện plugin của bạn trong hệ thống nền. Sau khi hoàn tất bước này, bạn thực chất đã tạo ra một plugin có thể được kích hoạt. Hãy đăng nhập vào trang quản trị WordPress, chọn mục “Plugins” (Các plugin), và bạn sẽ thấy tên plugin của mình – “My First Plugin”. Tuy nhiên, plugin này hiện vẫn chưa có bất kỳ chức năng nào.

Xây dựng chức năng plugin và việc đóng gói các lớp (class encapsulation)

Để đảm bảo mã nguồn được trình bày một cách rõ ràng và dễ bảo trì, bạn nên sử dụng phương pháp lập trình hướng đối tượng. Trong tệp chính, hoặc trong một tệp riêng biệt, hãy định nghĩa một lớp (class) để bao gồm tất cả các chức năng của plugin.

if ( ! class_exists( 'My_First_Plugin' ) ) {
    class My_First_Plugin {
        public function __construct() {
            // 构造函数，用于初始化动作和过滤器
            add_action( 'init', array( $this, 'init' ) );
        }

public function init() {
            // 插件初始化时执行的操作
            // 例如：注册短代码、自定义文章类型等
        }
    }

// 实例化插件类
    new My_First_Plugin();
}

Cấu trúc này tổ chức các chức năng của bạn trong một không gian tên (namespace) độc lập, giúp tránh xung đột tên hàm với các plugin hoặc theme khác.

Đọc thêm Phát triển plugin WordPress: Xây dựng mô-đun chức năng tùy chỉnh từ không đến có。

Thực hiện các chức năng cốt lõi: Hành động (Actions) và Bộ lọc (Filters).

Điểm mạnh của các plugin WordPress nằm ở hệ thống Hook, bao gồm Action và Filter. Việc hiểu rõ và sử dụng chúng là yếu tố then chốt trong quá trình phát triển plugin.

Sử dụng action hook để thêm tính năng

Các “hook hành động” (action hooks) cho phép bạn chèn mã của riêng mình vào những thời điểm cụ thể trong quá trình thực thi của WordPress. Ví dụ, nếu bạn muốn tự động thêm một đoạn văn bản sau nội dung bài viết, bạn có thể sử dụng các hook phù hợp.the_content“Filter” (đây là một loại “hành động” đặc biệt). Những hành động điển hình hơn là…wp_footerDùng để thêm nội dung ở phía dưới trang.

public function __construct() {
    add_action( 'wp_footer', array( $this, 'add_custom_footer_text' ) );
}

public function add_custom_footer_text() {
    echo '<p style="text-align: center;">Cảm ơn bạn đã đọc! Nội dung này được tạo ra bởi plugin đầu tiên của tôi.</p>';
}

Trong ví dụ này,add_custom_footer_textPhương thức này sẽ được gọi ở phần chân trang (footer) của mỗi trang, và sẽ in ra một đoạn văn bản tùy chỉnh.

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

Sử dụng hook bộ lọc để sửa đổi dữ liệu

Các hook của bộ lọc được sử dụng để thay đổi dữ liệu trước khi chúng được gửi đến cơ sở dữ liệu hoặc trình duyệt. Một ví dụ phổ biến là việc thay đổi tiêu đề của một bài viết. Chúng ta có thể sử dụng chúng để thực hiện điều này.the_titleBộ lọc.

public function __construct() {
    add_filter( 'the_title', array( $this, 'customize_title' ) );
}

public function customize_title( $title ) {
    // 只在主循环中且不是后台管理界面时修改
    if ( ! is_admin() && in_the_loop() ) {
        return '📖 ' . $title;
    }
    return $title;
}

Hàm lọc này nhận tiêu đề gốc làm tham số và trả về tiêu đề đã được sửa đổi. Logic ở đây là thêm một biểu tượng sách trước tiêu đề bài viết được hiển thị trên giao diện người dùng.

Quốc tế hóa và tùy chọn cấu hình plugin

Để plugin có thể được sử dụng bởi người dùng trên toàn thế giới, việc hỗ trợ đa ngôn ngữ (i18n – Internationalization) là bước không thể thiếu. Đồng thời, cung cấp cho người dùng một trang cấu hình nền để điều chỉnh hành vi của plugin sẽ giúp nâng cao đáng kể mức độ chuyên nghiệp của plugin đó.

Đọ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。

Triển khai hỗ trợ dịch thuật văn bản

WordPress sử dụng công nghệ GNU gettext để hỗ trợ việc đa ngôn ngữ hóa. Bạn cần bao bọc tất cả các chuỗi ký tự được hiển thị cho người dùng, dù là ở phía trước (frontend) hay phía sau (backend) của plugin, bằng các hàm chuyên dụng.

Trước hết, trong phần tiêu đề của plugin (plugin header) của tệp chính (main file), chúng ta đã định nghĩa các thông tin cần thiết rồi.Text Domain和Domain PathTiếp theo, hãy tải dữ liệu vào trường văn bản trong hàm khởi tạo (initialization function).

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 init() {
    load_plugin_textdomain(
        'my-first-plugin',
        false,
        dirname( plugin_basename( __FILE__ ) ) . '/languages/'
    );
}

Sau đó, trong mã nguồn, hãy sử dụng hàm dịch ở những nơi cần hiển thị văn bản đã được dịch. Ví dụ, trong đoạn văn bản ở phần chân trang trước đó:

echo '<p style="text-align: center;">' . esc_html__( '感谢阅读！本内容由我的第一个插件生成。', 'my-first-plugin' ) . '</p>';

esc_html__()Chức năng này sẽ dịch văn bản và thực hiện các thao tác mã hóa (HTML escaping) để đảm bảo an toàn. Người dịch có thể sử dụng nó..po和.moCác tệp tin này được sử dụng để cung cấp các phiên bản ngôn ngữ khác nhau cho plugin của bạn.

Tạo trang cài đặt nền tảng (Backend Settings Page)

Việc sử dụng API Settings của WordPress cho phép bạn tạo ra những trang cài đặt chuẩn mực và an toàn cho các plugin của mình. Quá trình này thường bao gồm một số bước chính sau: đăng ký các tùy chọn cài đặt, thêm các khu vực và trường dữ liệu cần thiết, và tạo trang menu để hiển thị các tùy chọn đó cho người dùng.

public function __construct() {
    add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
    add_action( 'admin_init', array( $this, 'settings_init' ) );
}

public function add_admin_menu() {
    add_options_page(
        '我的第一个插件设置', // 页面标题
        '我的插件', // 菜单标题
        'manage_options', // 权限
        'my-first-plugin', // 菜单slug
        array( $this, 'settings_page_html' ) // 回调函数，用于输出页面HTML
    );
}

public function settings_init() {
    register_setting( 'my_first_plugin_settings', 'my_first_plugin_options' ); // 注册一组设置

add_settings_section(
        'my_first_plugin_section',
        __( '基本设置', 'my-first-plugin' ),
        null,
        'my-first-plugin'
    );

add_settings_field(
        'footer_text',
        __( '自定义页脚文本', 'my-first-plugin' ),
        array( $this, 'footer_text_field_html' ),
        'my-first-plugin',
        'my_first_plugin_section'
    );
}

public function footer_text_field_html() {
    $options = get_option( 'my_first_plugin_options' );
    ?>
    <input type='text' name='my_first_plugin_options[footer_text]' value='<?php echo esc_attr( $options['footer_text'] ?? '' ); ?>'>
    <?php
}

public function settings_page_html() {
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <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
            settings_fields( 'my_first_plugin_settings' );
            do_settings_sections( 'my-first-plugin' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="vi"/></form>
    </div>
    &lt;?php
}

Bây giờ, người dùng có thể cấu hình văn bản phần chân trang (footer text) trên trang “Cài đặt” -> “Các tiện ích mở rộng của tôi” (Settings -> My Plugins).add_custom_footer_textPhương thức có thể được sửa đổi để lấy giá trị từ tùy chọn này, giúp plugin trở nên có thể cấu hình được.

Tóm lại

Thông qua hướng dẫn này, chúng ta đã trải qua quy trình phát triển plugin cho WordPress từ các bước cơ bản như thiết lập môi trường cục bộ, tạo cấu trúc tệp tin, đến việc sử dụng các phương pháp lập trình hướng đối tượng để tổ chức mã nguồn. Chúng ta đã tìm hiểu sâu về cơ chế mở rộng cốt lõi của WordPress – các hook (điểm kết nối giữa các thành phần của hệ thống) như actions và filters – và đã triển khai các chức năng hữu ích như thêm nội dung vào phần chân trang (footer) và thay đổi tiêu đề bài viết. Cuối cùng, chúng ta đã nâng cao mức độ chuyên nghiệp và tính sử dụng dễ dàng của plugin bằng cách hỗ trợ ngôn ngữ quốc tế (internationalization) để phục vụ người dùng trên toàn thế giới, đồng thời sử dụng API Settings để tạo giao diện cấu hình an toàn cho phía backend. Việc phát triển plugin là một quá trình liên tục học hỏi và cải thiện; sau khi nắm vững những kiến thức cơ bản này, bạn có thể tiếp tục khám phá các chủ đề nâng cao hơn như tùy chỉnh loại bài viết (custom post types), tương tác AJAX, tích hợp REST API, v.v., để xây dựng những plugin WordPress mạnh mẽ và có mã nguồn đẹp mắt.

FAQ 常见问题

Phải chăng việc phát triển plugin luôn yêu cầu sử dụng lập trình hướng đối tượng?

Đây không phải là một yêu cầu bắt buộc, nhưng chúng tôi khuyến nghị mạnh mẽ bạn nên sử dụng phương pháp lập trình hướng quy trình (sử dụng nhiều hàm). Mặc dù phương pháp này có thể giúp bạn triển khai chức năng một cách nhanh chóng, nhưng khi số lượng các tiện ích mở rộng (plugin) tăng lên, mã nguồn sẽ trở nên khó quản lý và bảo trì hơn, đồng thời cũng dễ xảy ra xung đột tên hàm với các tiện ích khác. Phương pháp$thisViệc sử dụng biến và không gian tên (namespace) để tổ chức mã nguồn một cách hiệu quả hơn, đặc biệt trong các phiên bản PHP mới hơn, được coi là thực hành tốt nhất trong ngành công nghiệp khi xây dựng các plugin có quy mô vừa và lớn.

Làm thế nào để xử lý an toàn dữ liệu do người dùng nhập vào hoặc dữ liệu từ cơ sở dữ liệu?

Bất kỳ lúc nào bạn muốn hiển thị giá trị của một biến trên trang web, bạn đều phải thực hiện việc “đánh dấu đặc biệt” (escape) cho các ký tự đó. WordPress cung cấp một loạt hàm hỗ trợ để thực hiện công việc này. Tùy vào ngữ cảnh sử dụng (đang hiển thị giá trị biến bên trong thẻ HTML hay trong thuộc tính của thẻ HTML), bạn cần chọn hàm phù hợp.esc_html()或esc_attr(); trong biến JavaScript, sử dụngwp_json_encode()或esc_js()Để hiển thị nội dung trong URL, hãy sử dụng cú pháp sau: `{{content}}`. Ví dụ: `https://example.com/page.php?content=%s`.esc_url()Đừng bao giờ tin tưởng vào dữ liệu do người dùng nhập vào hoặc dữ liệu chưa được xử lý. Việc tiến hành “đánh dấu ký tự đặc biệt” (escaping) là yếu tố then chốt để ngăn chặn các cuộc tấn công kiểu Cross-Site Scripting (XSS).

Các plugin được gửi đến danh mục chính thức của WordPress cần phải đáp ứng những điều kiện sau:

Các plugin được nộp vào danh mục plugin của WordPress.org phải tuân thủ một loạt quy định nghiêm ngặt. Những quy định chính bao gồm: mã nguồn của plugin phải tương thích với giấy phép GPL; không được chứa bất kỳ hệ thống bảo vệ truy cập có phí (paywall), mã được mã hóa hoặc bị độc hóa (obfuscated code); phải hỗ trợ đa ngôn ngữ (internationalization) một cách đầy đủ; phải tuân theo các tiêu chuẩn mã hóa và quy định về tài liệu của WordPress; không được thực hiện các hành vi xấu như xác định nguồn gốc cuộc gọi điện thoại (phone number spoofing) hoặc khai thác tiền mã hóa (cryptocurrency mining). Ngoài ra, tệp chính của plugin phải chứa thông tin tiêu chuẩn về plugin (plugin header information), và cần cung cấp tài liệu hướng dẫn sử dụng đầy đủ.readme.txtTệp.

Làm thế nào để tôi gỡ lỗi mã plugin của mình?

Trước hết, hãy đảm bảo rằng tính năng này đã được kích hoạt trong môi trường phát triển.WP_DEBUGĐối với các trường hợp gỡ lỗi phức tạp hơn, bạn có thể sử dụng các công cụ hoặc phương pháp phù hợp.error_log()Hàm sẽ ghi thông tin vào nhật ký lỗi của máy chủ, hoặc sử dụng (các phương thức khác để xử lý thông tin đó).var_dump()和wp_die()Hãy kiểm tra giá trị của biến (chỉ nên thực hiện trong môi trường phát triển). Một cách hiệu quả hơn là sử dụng công cụ Xdebug tích hợp trong môi trường phát triển (chẳng hạn như PhpStorm) để thực hiện việc gỡ lỗi từng bước. Ngoài ra, đối với WordPress…WP_DEBUG_LOG和WP_DEBUG_DISPLAYCác hằng số (constants) có thể được sử dụng để kiểm soát việc liệu lỗi có được ghi vào tệp nhật ký (log file) hay hiển thị trên màn hình hay không.