Trang chủ/Kiến thức/WordPress/Chi tiết nội dung

Hướng dẫn đầy đủ phát triển plugin WordPress: Từ cơ bản đến thực hành chuyên sâu

Đọc trong 3 phút
2026-03-15
2026-06-03
2,822
Tôi kiếm được hoa hồng khi bạn mua sắm thông qua các liên kết dưới đây, mà không phát sinh thêm chi phí nào cho bạn.

Tại sao nên học cách 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ơ chế plugin. Việc học cách phát triển plugin giúp bạn thoát khỏi những hạn chế về chức năng của các plugin có sẵn, từ đó tạo ra những giải pháp tùy chỉnh phù hợp với nhu cầu cụ thể của dự án – dù là mang đến những tính năng độc đáo cho khách hàng hay biến những ý tưởng sáng tạo thành sản phẩm thực tế và chia sẻ chúng với cộng đồng. Việc nắm vững kỹ năng này sẽ nâng cao đáng kể hiệu quả phát triển và sức cạnh tranh trên thị trường của bạn.

Một plugin chuẩn của WordPress là một tệp PHP độc lập hoặc một thư mục chứa nhiều tệp, và nó tương tác với phần cốt lõi của WordPress thông qua một loạt các giao diện được định nghĩa trước. Quá trình phát triển chủ yếu tập trung vào việc hiểu rõ cách thức hoạt động của WordPress.Hooks(Hook) The system complies with its coding standards and security practices.

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 một môi trường phát triển cục bộ. Chúng tôi khuyên bạn nên sử dụng XAMPP, MAMP hoặc Local by Flywheel. Sau khi môi trường đã được thiết lập xong, bạn có thể bắt đầu công việc lập trình của mình.wp-content/pluginsBạn đã tạo ra plugin đầu tiên của mình trong thư mục này.

Đọc thêm Thành thạo phát triển plugin WordPress từ đầu: Hướng dẫn hoàn chỉnh và thực hành thực tế。

Tạo tệp plugin chính

Mỗi plugin đều phải có một tệp PHP chính, và ở đầu tệp đó phải chứa các ghi chú thông tin tiêu chuẩn về plugin. Tệp này là điểm vào (entry point) của plugin, và tên của nó thường trùng với tên thư mục chứa plugin. Ví dụ, để tạo một plugin có tên…my-first-pluginThư mục đó, và tạo một tệp có cùng tên bên trong nó.my-first-plugin.phpTệp.

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%
Logo UltaHost Truy cập trang

Các ghi chú ở đầu tệp rất quan trọng; WordPress sử dụng chúng để nhận diện thông tin cơ bản về plugin.

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

Sau khi lưu file, hãy đăng nhập vào trang quản trị WordPress của bạn, truy cập trang “Plugins” (Các tiện ích mở rộng), và bạn sẽ thấy tiện ích mới này xuất hiện trong danh sách các tiện ích có sẵn. Bạn có thể kích hoạt nó. Hiện tại, tiện ích này vẫn chưa có bất kỳ chức năng nào.

Thêm chức năng đầu tiên.

Bây giờ, hãy cùng thêm một tính năng đơn giản cho plugin này: tự động thêm một đoạn văn bản tùy chỉnh vào cuối nội dung bài viết. Điều này yêu cầu sử dụng các công cụ có sẵn trong WordPress.the_contentFilter hook.

Trong tệp chính của plugin, hãy thêm đoạn mã sau ngay dưới phần thông tin chú thích:

Đọc thêm Hướng dẫn toàn diện phát triển plugin WordPress: Xây dựng plugin chức năng đầu tiên của bạn từ con số không。

// 在文章内容后添加自定义文本
function myfp_add_footer_text($content) {
    // 确保只在主循环的单篇文章中显示
    if (is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query()) {
        $custom_text = '<p><em>Cảm ơn bạn đã đọc! Bài viết này được hỗ trợ bởi “My First Plugin”.</em></p>';
        $content .= $custom_text;
    }
    return $content;
}
// 将函数挂载到‘the_content’过滤器
add_filter('the_content', 'myfp_add_footer_text');

Đoạn mã này định nghĩa một hàm.myfp_add_footer_textNó nhận dữ liệu nội dung của bài viết.$contentLàm tham số, bên trong hàm sẽ thực hiện các điều kiện kiểm tra để đảm bảo rằng chỉ khi đang ở trang bài viết riêng lẻ và trong vòng lặp chính của truy vấn chính thì nội dung mới được thực hiện. Sau đó, một đoạn văn bản HTML tùy chỉnh sẽ được nối vào. Cuối cùng, sử dụng…add_filter()Hàm này sẽ gắn (mount) hàm tùy chỉnh đó vào hệ thống WordPress.the_contentNó nằm trên bộ lọc (filter). Sau khi kích hoạt tiện ích mở rộng (plugin), hãy xem bất kỳ bài viết nào; bạn sẽ thấy đoạn văn bản được thêm vào ở phía cuối nội dung bài viết đó.

Tìm hiểu sâu về cốt lõi: Các hook và API

Trọng tâm của việc phát triển plugin cho WordPress nằm ở việc hiểu rõ và sử dụng thành thạo hệ thống Hook cũng như API phong phú của nó. Đây chính là cầu nối giúp các plugin giao tiếp một cách an toàn và theo tiêu chuẩn với phần cốt lõi của hệ thống WordPress.

Hiểu về Action Hooks và Filter Hooks

Có hai loại hình hook chính: Action (Hành động) và Filter (Bộ lọc). Hook loại Action cho phép bạn “thực thi” mã tự định vào những thời điểm cụ thể. Ví dụ,wp_footerHành động này được kích hoạt trước các thẻ ở phía dưới trang; bạn có thể thực hiện điều đó bằng cách…add_action('wp_footer', 'your_function')Hãy chèn đoạn mã theo dõi hoặc HTML tùy chỉnh vào đây.

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%.
Logo của Hosting.com Truy cập trang

Các hook của bộ lọc cho phép bạn “thay đổi” dữ liệu. Chúng nhận dữ liệu vào, xử lý nó thông qua hàm của bạn, sau đó trả về kết quả đã được sửa đổi. Ví dụ về việc thêm văn bản chân trang ở phía trên là một ứng dụng điển hình của bộ lọc. Một ví dụ khác phổ biến là…excerpt_lengthBộ lọc này được sử dụng để điều chỉnh độ dài của phần tóm tắt bài viết.

// 修改摘要长度为20个单词
function myfp_custom_excerpt_length($length) {
    return 20;
}
add_filter('excerpt_length', 'myfp_custom_excerpt_length');

Sử dụng API cơ sở dữ liệu của WordPress

Các plugin thường xuyên cần lưu trữ và truy xuất dữ liệu. WordPress cung cấp các công cụ để thực hiện điều này.wpdbCác lớp được thiết kế để tương tác một cách an toàn với cơ sở dữ liệu. Đối với dữ liệu đơn giản dưới dạng cặp khóa-giá trị, việc sử dụng API Options được khuyến nghị mạnh mẽ.

Ví dụ, để người dùng có thể tự định hình nội dung văn bản ở phần chân trang (footer) mà chúng ta đã thêm trước đó, chúng ta có thể tạo ra một tùy chọn (option) cho phép họ thực hiện điều đó.

Đọc thêm Hướng dẫn hoàn chỉnh phát triển plugin WordPress: Từ nhập môn đến xây dựng tiện ích mở rộng cấp chuyên nghiệp。

// 1. 创建可配置的页脚文本
function myfp_add_footer_text_v2($content) {
    if (is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query()) {
        // 从数据库获取选项值，如果不存在则使用默认值
        $footer_text = get_option('myfp_footer_text', '感谢阅读！本文由“我的第一个插件”提供支持。');
        $custom_text = '<p><em>'`. esc_html($footer_text)`.'</em></p>';
        $content .= $custom_text;
    }
    return $content;
}
add_filter('the_content', 'myfp_add_footer_text_v2');

Bây giờ, nội dung văn bản có thể được truy cập thông qua…get_option()Hàm này trích dữ liệu từ cơ sở dữ liệu. Tiếp theo, chúng ta cần một trang quản lý để người dùng có thể thay đổi giá trị đó.

tạo trang quản lý plugin

Để làm cho plugin trở nên chuyên nghiệp và dễ sử dụng hơn, việc thêm một trang cấu hình là điều cần thiết. Điều này thường được thực hiện thông qua API của menu quản trị WordPress.

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.
Logo của InterServer Truy cập trang

Thêm menu quản lý và các trang con.

Chúng ta có thể thêm một menu chính (top-level menu) độc lập cho plugin, hoặc đặt nó như một menu con trong menu “Cài đặt” (Settings) hoặc “Công cụ” (Tools). Trong trường hợp này, chúng ta sẽ thêm nó vào menu “Cài đặt”.

Trước hết, hãy sử dụng…add_action()Mount a function toadmin_menuHook: Thêm các mục menu vào bên trong hàm này.

// 添加管理菜单
function myfp_add_admin_menu() {
    add_options_page(
        '我的第一个插件设置', // 页面标题
        '我的插件设置',       // 菜单标题
        'manage_options',     // 所需权限
        'my-first-plugin',    // 菜单slug
        'myfp_options_page_html' // 用于渲染页面的回调函数
    );
}
add_action('admin_menu', 'myfp_add_admin_menu');

add_options_page()Hàm sẽ tạo ra một trang con trong menu “Cài đặt”. Khi người dùng nhấp vào menu này, WordPress sẽ gọi hàm phản hồi (callback function) mà chúng ta đã chỉ định.myfp_options_page_htmlHãy hiển thị nội dung trang web.

Xây dựng biểu mẫu trang cấu hình

Tiếp theo, hãy định nghĩa một hàm gọi lại (callback function) để hiển thị một biểu mẫu cấu hình đơn giản. Biểu mẫu này sẽ được gửi đi (submitted) đến…options.phpĐây là cách tiêu chuẩn mà WordPress sử dụng để xử lý các thiết lập.

// 渲染设置页面
function myfp_options_page_html() {
    // 检查用户权限
    if (!current_user_can('manage_options')) {
        return;
    }
    ?&gt;
    <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('myfp_settings');
            // 输出设置章节和字段
            do_settings_sections('my-first-plugin');
            // 提交按钮
            submit_button('保存设置');
            ?>
        <input type="hidden" name="trp-form-language" value="vi"/></form>
    </div>
    &lt;?php
}

Cài đặt đăng ký, chương và trường (Registration settings, chapters, and fields)

Chỉ có biểu mẫu thôi là chưa đủ; chúng ta cần phải sử dụng thêm các công cụ khác nữa.register_setting(), add_settings_section()和add_settings_field()Các hàm như vậy được sử dụng để thông báo cho WordPress biết chúng ta có những tùy chọn cài đặt nào.

// 初始化插件设置
function myfp_settings_init() {
    // 注册一个设置项‘myfp_settings’，它包含一个字段‘myfp_footer_text’
    register_setting('myfp_settings', 'myfp_footer_text');

// 在页面‘my-first-plugin’上添加一个设置章节
    add_settings_section(
        'myfp_section',
        '页脚文本设置',
        null, // 章节描述回调函数，这里不需要
        'my-first-plugin'
    );

// 在上述章节中添加一个字段
    add_settings_field(
        'myfp_field_footer_text',
        '自定义页脚文本',
        'myfp_field_footer_text_html', // 渲染字段HTML的回调函数
        'my-first-plugin',
        'myfp_section',
        ['label_for' =&gt; 'myfp_footer_text']
    );
}
add_action('admin_init', 'myfp_settings_init');

// 渲染文本输入字段
function myfp_field_footer_text_html() {
    // 获取数据库中保存的值
    $value = get_option('myfp_footer_text');
    ?&gt;
    <input type="text" id="myfp_footer_text" name="myfp_footer_text" value="<?php echo esc_attr($value); ?>" class="regular-text">
    <p class="description">Nội dung này sẽ được hiển thị ở cuối mỗi bài viết.</p>
    &lt;?php
}

Bây giờ, hãy làm mới trang quản trị WordPress của bạn. Bạn sẽ thấy mục “Cài đặt” (Settings) và bên trong đó có tùy chọn “Cài đặt plugin của tôi” (My Plugin Settings). Khi truy cập vào trang này, bạn có thể sửa đổi và lưu nội dung văn bản phần chân trang (footer) tùy chỉnh; nội dung bài viết trên giao diện người dùng sẽ được cập nhật tự động theo đó.

Tóm lại

Hướng dẫn này sẽ đưa bạn qua những bước cơ bản trong quá trình phát triển plugin cho WordPress: từ việc tạo ra một tệp plugin cơ bản chứa thông tin tiêu đề chuẩn, đến việc sử dụng các hàm hành động (actions) và hook để bổ sung chức năng cho WordPress, tiếp theo là lưu trữ dữ liệu bằng API tùy chọn (options API), và cuối cùng là xây dựng giao diện quản trị nền (backend administration interface) hoàn chỉnh. Toàn bộ quá trình này thể hiện triết lý phát triển plugin dựa trên nguyên tắc mô-đun hóa và sử dụng các hook. 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), sử dụng các mã ngắn (shortcodes), tích hợp REST API, xử lý AJAX, và quốc tế hóa plugin (plugin localization). Hãy nhớ rằng, cấu trúc mã nguồn tốt, quy trình xử lý dữ liệu an toàn, và giao diện người dùng rõ ràng là những yếu tố then chốt để tạo ra những plugin chất lượng cao.

FAQ 常见问题

Để phát triển các plugin, bạn cần có những kiến thức cơ bản sau:

Bạn cần nắm vững kiến thức cơ bản về ngôn ngữ lập trình PHP, bao gồm các khái niệm như biến, hàm, điều kiện và vòng lặp. Ngoài ra, bạn cũng cần có hiểu biết cơ bản về HTML và CSS để có thể xử lý việc hiển thị nội dung trên trang web và thiết lập giao diện. Việc quen thuộc với các thao tác cơ bản của MySQL sẽ hữu ích trong việc quản lý dữ liệu, mặc dù API của WordPress đã đóng gói phần lớn các thao tác tương tác với cơ sở dữ liệu.

Làm thế nào để gỡ lỗi (debug) một plugin đang được phát triển?

Cách hiệu quả nhất là bật chế độ gỡ lỗi (debug mode) của WordPress.wp-config.phptệp, đặt giá trị của hằng sốWP_DEBUGConstant definition is:trueĐiều này sẽ hiển thị tất cả các lỗi, cảnh báo và thông báo của PHP trên màn hình. Đồng thời, bạn có thể sử dụng chúng để theo dõi và xử lý các vấn đề phát sinh trong ứng dụng PHP của mình.error_log()Hàm sẽ ghi thông tin gỡ lỗi vào nhật ký lỗi của máy chủ, hoặc sử dụng các công cụ trong giao diện phát triển trình duyệt (Console và Network) để thực hiện gỡ lỗi ở phía trước (frontend).

Cách plugin hỗ trợ đa ngôn ngữ

WordPress sử dụng các quy trình “quốc tế hóa (i18n)” và “địa phương hóa (l10n)” để hỗ trợ nhiều ngôn ngữ. Trong mã nguồn của các plugin, tất cả các chuỗi văn bản cần được dịch đều phải được đánh dấu một cách rõ ràng.__()或_e()Hãy bọc các hàm dịch lại thành một lớp (class) hoặc module riêng biệt. Sau đó, sử dụng công cụ như Poedit để trích xuất các chuỗi văn bản từ mã nguồn và tạo ra tài liệu dịch cần thiết..potCác tệp mẫu (template files), và dựa vào đó để tạo ra các phiên bản ngôn ngữ khác nhau (ví dụ: tiếng Anh, tiếng Trung, tiếng Pháp, v.v.)zh_CN.poCuối cùng, hãy khai báo miền văn bản (text domain) của bạn trong phần “Text Domain” ở đầu tệp chính của plugin, và sử dụng nó khi thực hiện việc khởi tạo (initialization).load_plugin_textdomain().

Làm thế nào để phát hành các plugin đã được phát triển thành danh mục chính thức?

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 tiêu chuẩn lập trình chính thức của WordPress, chính sách bảo mật dữ liệu, và yêu cầu về tính tương thích với giấy phép GPL (GNU General Public License). 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 của plugin (bao gồm các tệp chính, tệp tài nguyên, và tệp dịch) lên kho lưu trữ SVN này./trunkMục lục: Các phiên bản mới được phát hành thông qua các thẻ (tags) trong hệ thống SVN. Danh mục chính thức sẽ tự động đồng bộ mã nguồn từ kho lưu trữ SVN của bạn và sau đó được xem xét bởi nhân viên để được hiển thị công khai.

Bước tiếp theo, chúng ta nên làm gì tiếp theo?

Nếu bạn đang xây dựng hoặc tối ưu hóa trang web WordPress của mình, bước tiếp theo là tiếp tục đọc về tối ưu hóa hiệu năng, cấu hình plugin và tùy chỉnh chủ đề.

Đọc thêm và kiến thức thực tế

Những nội dung sau đây liên quan đến chủ đề của bài viết này, thích hợp để tiếp tục đọc sâu hơn. Ưu tiên bắt đầu với bài viết gần nhất với vấn đề hiện tại của bạn, rồi dần dần mở rộng sang các chủ đề xung quanh, hiệu quả thường sẽ tốt hơn.

Thẻ: