Hướng dẫn nhập môn phát triển plugin WordPress: Xây dựng module tính năng tùy chỉnh của bạn từ con số 0

Tại sao cần phải phát triển các plugin cho WordPress?

Một trong những triết lý thiết kế cốt lõi của WordPress là khả năng mở rộng cao, và plugin chính là công cụ chính để thực hiện điều này. Mặc dù thư viện plugin chính thức cung cấp rất nhiều lựa chọn, việc tự phát triển plugin mang lại những lợi thế độc đáo. Khi các plugin hiện có không thể phù hợp hoàn hảo với logic kinh doanh của bạn, gặp phải các vấn đề về hiệu năng, hoặc chứa quá nhiều tính năng không cần thiết, việc phát triển plugin theo yêu cầu cá nhân chính là giải pháp tốt nhất. Điều này cho phép bạn xây dựng một giải pháp phù hợp hoàn toàn với nhu cầu của dự án, với mã nguồn gọn gàng và dễ bảo trì.

Thông qua việc phát triển plugin, bạn có thể tách các tính năng tùy chỉnh ra khỏi giao diện chính (theme) của trang web. Đây là một thực hành tốt cực kỳ quan trọng, vì nó đảm bảo rằng ngay cả khi bạn thay đổi theme, các tính năng cốt lõi vẫn sẽ được giữ nguyên. Ngoài ra, những plugin được thiết kế tốt có thể được sử dụng lại một cách dễ dàng giữa các dự án khác nhau, từ đó nâng cao đáng kể hiệu quả phát triển. Đối với những nhà phát triển muốn hiểu sâu hơn về cách thức hoạt động của WordPress, cải thiện kỹ năng lập trình PHP hoặc có kế hoạch phát hành các plugin thương mại, việc nắm vững kỹ thuật phát triển plugin là điều không thể thiếu.

Xây dựng cấu trúc cơ bản cho plugin đầu tiên của bạn

Hãy bắt đầu bằng cách tạo một thư mục đơn giản và tệp chính (main file) ở đúng vị trí trong WordPress. Đây chính là điểm khởi đầu cho mọi quá trình phát triển plugin.

Đọc thêm Từ cơ bản đến thực hành: Hướng dẫn toàn diện về phát triển plugin WordPress cùng các kỹ thuật nâng cao。

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

Tất cả các plugin đều phải có một tệp PHP chính, trong đó chứa các chú thích đầu (header comments) đặc biệt, dùng để thông báo với hệ thống WordPress về sự tồn tại của plugin đó. Tệp này thường được đặt tên theo tên của plugin. Ví dụ, chúng ta có thể tạo một tệp có tên… my-first-plugin.php tệ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%

Truy cập trang

<?php
/**
 * Plugin Name:       我的第一个定制插件
 * Plugin URI:        https://www.yourwebsite.com/my-first-plugin
 * Description:       这是一个用于学习WordPress插件开发的入门示例插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Đoạn chú thích này là yếu tố then chốt để WordPress nhận diện các plugin. Trong đó, “Tên Plugin” (Plugin Name) là mục bắt buộc phải điền, còn các thông tin khác thì tùy chọn. Sau khi tạo xong tệp này, hãy đặt nó vào đúng vị trí được yêu cầu. /wp-content/plugins/my-first-plugin/ Bạn có thể tìm thấy và kích hoạt tính năng này trên trang “Plugins” (Các tiện ích mở rộng) trong giao diện quản trị WordPress.

Hiểu rõ về an ninh của các tiện ích mở rộng (plugins) và các thực hành tốt nhất trong việc sử dụng chúng

Trước khi viết bất kỳ đoạn mã chức năng nào, bạn phải thiết lập các biện pháp bảo mật cần thiết. WordPress cung cấp rất nhiều biến và hàm toàn cục; việc truy cập trực tiếp vào các tệp cốt lõi là nguy hiểm và không được phép. Do đó, ở đầu mỗi tệp PHP của plugin, bạn nên thêm đoạn mã để bảo vệ chống truy cập trái phép.

Sau dòng chú thích ở đầu tệp chính của plugin của bạn, hãy thêm đoạn mã sau ngay lập tức:

// 防止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
    exit; // 如果ABSPATH未定义，则退出
}

Constant ABSPATH Đây là đường dẫn tuyệt đối đến thư mục gốc của WordPress, và nó được định nghĩa khi môi trường WordPress được khởi tạo. Bằng cách kiểm tra xem hằng số này có tồn tại hay không, bạn có thể ngăn chặn người khác truy cập trực tiếp vào các tệp plugin của mình thông qua URL, từ đó giảm thiểu các rủi ro bảo mật tiềm ẩn. Đây là thực hành bảo mật đầu tiên và quan trọng nhất trong quá trình phát triển plugin.

Đọc thêm Hướng dẫn nhập môn phát triển plugin WordPress。

Sử dụng các hook để mở rộng chức năng của WordPress

Cốt lõi của cấu trúc plugin trong WordPress là hệ thống “Hook” (Kẹp), cho phép bạn chèn mã tùy chỉnh vào những thời điểm nhất định để sửa đổi hoặc nâng cao các chức năng cơ bản của WordPress mà không cần phải thay đổi các tệp nguồn gốc của nó. Có hai loại Hook chính: Actions (Hành động) và Filters (Bộ lọc).

Sử dụng các hook hành động (action hooks) để thực hiện nhiệm vụ.

Các “hook hành động” (action hooks) cho phép bạn thực thi các hàm tùy chỉnh khi những sự kiện cụ thể xảy ra – chẳng hạn như khi một bài viết được đăng, người dùng đăng nhập, hoặc phần đầu trang web được tải. Để sử dụng một hook hành động, bạn cần… add_action() Hàm.

Giả sử chúng ta muốn thêm một thông điệp chào mừng tùy chỉnh ở phía trên giao diện quản trị của trang web. Chúng ta có thể thực hiện điều này bằng cách… admin_notices hook hành động nà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%.

Truy cập trang

function my_custom_admin_notice() {
    echo '<div class="notice notice-success is-dismissible"><p>Chào mừng bạn đến với giao diện quản trị trang web! Đây là thông báo được thêm vào bởi plugin của tôi.</p></div>';
}
add_action( 'admin_notices', 'my_custom_admin_notice' );

Hãy thêm đoạn mã này vào tệp plugin chính của bạn. Sau khi kích hoạt plugin, mỗi lần bạn truy cập vào giao diện quản trị, bạn sẽ thấy thông báo này. my_custom_admin_notice Đây là hàm gọi lại (callback function) mà chúng ta đã định nghĩa.add_action() Hãy kết hợp nó với… admin_notices Các “hook” được liên kết với nhau.

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

Các hook của bộ lọc (filter hooks) được sử dụng để thay đổi dữ liệu trước khi nó được lưu trữ, hiển thị hoặc sử dụng. Chúng nhận dữ liệu đầu vào, xử lý nó thông qua hàm của bạn, và sau đó phải trả về dữ liệu đã được sửa đổi. Điều này được thực hiện thông qua… add_filter() hàm.

Một ví dụ điển hình là việc thay đổi nội dung ở cuối tiêu đề của các bài viết. Ví dụ, chúng ta muốn thêm tên trang web vào cuối tiêu đề của tất cả các bài viết.

Đọc thêm Bắt đầu từ con số không: Hướng dẫn toàn diện về phát triển plugin WordPress và chia sẻ các thực hành tốt nhất。

function modify_post_title( $title ) {
    // 确保只在主循环的单篇文章页面修改
    if ( is_single() && in_the_loop() ) {
        $title .= ' | 我的网站';
    }
    return $title;
}
add_filter( 'the_title', 'modify_post_title' );

Ở đây,modify_post_title Hàm nhận văn bản tiêu đề gốc làm tham số, thêm tên trang web vào đó, sau đó trả về kết quả đã được sửa đổi. WordPress sẽ sử dụng giá trị này để hiển thị. Việc hiểu rõ sự khác biệt giữa các hành động (actions) và bộ lọc (filters) – một thực hiện nhiệm vụ cụ thể, còn cái khác chỉ sửa đổi và trả về dữ liệu – là yếu tố then chốt để sử dụng các hook một cách hiệu quả.

Tạo trang quản lý cho plugin

Nhiều plugin yêu cầu tương tác với quản trị viên, điều này đòi hỏi phải thêm các menu quản lý và trang cấu hình tùy chỉnh. WordPress cung cấp một loạt hàm để dễ dàng mở rộng menu nền sau.

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

thêm menu quản lý cấp cao nhất

Sử dụng add_menu_page() Bạn có thể sử dụng các hàm để thêm một mục menu cấp cao vào thanh bên cạnh dùng để quản lý plugin của mình. Đây thường là điểm truy cập chính để cấu hình plugin.

Hãy cùng tạo một trang đơn giản có tên “Cài đặt plugin của tôi” (My Plugin Settings).

function my_plugin_add_menu_page() {
    add_menu_page(
        '我的插件设置',          // 页面标题（浏览器标签）
        '我的插件',              // 菜单标题
        'manage_options',       // 所需权限
        'my-plugin-settings',   // 菜单slug（URL标识）
        'my_plugin_settings_page', // 用于渲染页面内容的回调函数
        'dashicons-admin-generic', // 图标（使用Dashicons）
        30                      // 菜单位置
    );
}
add_action( 'admin_menu', 'my_plugin_add_menu_page' );

Tiếp theo, bạn cần định nghĩa các hàm gọi lại (callback functions) đã được sử dụng ở trên. my_plugin_settings_page Vui lòng cung cấp nội dung HTML của trang web cần được hiển thị.

function my_plugin_settings_page() {
    ?>
    <div class="wrap">
        <h1>Cài đặt plugin của tôi</h1>
        <form method="post" action="/vi/options.php/" data-trp-original-action="options.php">
            <?php
            // 输出设置字段（后续可与设置API结合）
            settings_fields( 'my_plugin_options_group' );
            do_settings_sections( 'my-plugin-settings' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="vi"/></form>
    </div>
    &lt;?php
}

Tích hợp API cấu hình WordPress

Việc xử lý và xác thực các yêu cầu gửi biểu mẫu thủ công là một quá trình phức tạp và dễ gây sai sót. API Cài đặt (Settings API) của WordPress giúp bạn tự động hóa những công việc này, bao gồm việc xác thực các giá trị Nonce, kiểm tra quyền truy cập, và lưu trữ dữ liệu.

Trước tiên, bạn cần đăng ký để thiết lập các cài đặt, thêm các khối và trường thông tin cần thiết.

function my_plugin_settings_init() {
    // 注册一组设置
    register_setting( 'my_plugin_options_group', 'my_plugin_option_name' );

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

// 向区块中添加一个字段
    add_settings_field(
        'my_plugin_field_id',
        '示例文本字段',
        'my_plugin_field_callback',
        'my-plugin-settings',
        'my_plugin_section_id'
    );
}
add_action( 'admin_init', 'my_plugin_settings_init' );

// 字段的回调函数，用于输出HTML输入框
function my_plugin_field_callback() {
    $option = get_option( 'my_plugin_option_name' );
    echo '<input type="text" name="my_plugin_option_name" value="' . esc_attr( $option ) . '" />';
}

Bây giờ, trang cấu hình của bạn đã có một trường biểu mẫu được bảo vệ bởi API cấu hình; giá trị của trường này sẽ được lưu trữ một cách an toàn trong WordPress. options Trong bảng cơ sở dữ liệu. Thông qua… get_option( 'my_plugin_option_name' ) Bạn có thể truy cập giá trị này ở bất kỳ đâu, dù là ở phía trước (frontend) hay phía sau (backend) của ứng dụng.

Tóm lại

Việc phát triển plugin cho WordPress là quá trình biến những ý tưởng sáng tạo thành những tính năng mạnh mẽ và hữu ích. Chúng ta bắt đầu bằng việc tìm hiểu lý do tại sao cần phải tạo ra các plugin tùy chỉnh, sau đó xây dựng cấu trúc cơ bản của plugin đó, đồng thời nhấn mạnh tầm quan trọng của mã nguồn an toàn. Yếu tố then chốt nằm ở việc nắm vững hệ thống hook của WordPress, để có thể tương tác một cách trơn tru với phần cốt lõi của hệ thống thông qua các hành động (actions) và bộ lọc (filters). Cuối cùng, chúng ta tìm hiểu cách tạo ra giao diện quản lý chuyên nghiệp và sử dụng API Settings để xử lý cấu hình người dùng một cách an toàn. Bằng cách tuân theo những bước này và các thực hành tốt nhất, bạn sẽ có thể tạo ra những plugin có cấu trúc rõ ràng, an toàn, đáng tin cậy và dễ bảo trì, từ đó thực sự phát huy hết tiềm năng vô hạn của WordPress.

FAQ 常见问题

Phát triển plugin WordPress cần những kiến thức cơ bản nào?

Để phát triển các plugin cho WordPress, bạn cần có kiến thức cơ bản về ngôn ngữ lập trình PHP, vì mã nguồn của các plugin thường được viết bằng PHP. Ngoài ra, bạn cũng cần hiểu biết cơ bản về HTML, CSS và JavaScript để xây dựng giao diện người dùng (frontend) và các tương tác trên trang web. Việc nắm rõ các khái niệm cơ bản của WordPress như bài viết (articles), trang (pages), vai trò người dùng (user roles), và cấu trúc dữ liệu cơ bản (như The Loop) cũng rất hữu ích trong quá trình phát triển plugin.

Nên đặt các hàm liên quan đến plugin và theme ở đâu?

Đây là một vấn đề quan trọng liên quan đến các thực tiễn tốt nhất trong lập trình web. Tất cả các đoạn mã liên quan đến chức năng của trang web, logic nền tảng, và thao tác dữ liệu nên được đặt trong các plugin. Ngược lại, các đoạn mã có mối liên hệ mật thiết với giao diện trực quan, bố cục, và phong cách trang web (như các mẫu trang, CSS, JavaScript front-end) nên được đặt trong các theme. Lợi ích lớn nhất của cách làm này là đảm bảo rằng khi thay đổi theme, các chức năng cốt lõi của trang web vẫn được giữ nguyên. Ví dụ, mã liên quan đến việc đăng ký một loại bài viết tùy chỉnh nên được viết trong plugin, trong khi các tệp mẫu hiển thị loại bài viết đó có thể được đặt trong theme.

Làm thế nào để gỡ lỗi (debug) một plugin đang trong quá trình phát triển?

Bước đầu tiên là kích hoạt chế độ gỡ lỗi (debug mode) của WordPress. Trong trường hợp của bạn… wp-config.php tệp, đặt giá trị của hằng số WP_DEBUG Hằng số được thiết lập trueĐiều này sẽ hiển thị trực tiếp các lỗi PHP, cảnh báo và thông báo trên trang web. Đồng thời, bạn có thể sử dụng chúng một cách thuận tiện. error_log() Hàm này sẽ 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 công cụ gỡ lỗi PHP chuyên dụng như Xdebug, hoặc cài đặt các tiện ích theo dõi truy vấn (như Query Monitor) để xem các truy vấn cơ sở dữ liệu, quá trình thực thi các hàm hook và dữ liệu hiệu năng.

Làm thế nào để plugin của tôi hỗ trợ việc dịch thuật (quốc tế hóa)?

WordPress sử dụng framework GNU gettext để thực hiện các chức năng quốc tế hóa (i18n) và địa phương hóa (localization). Trong plugin của bạn, bạn cần bao bọc tất cả các chuỗi văn bản cần được dịch bằng các hàm cụ thể. Hàm được sử dụng phổ biến nhất là… __() Dùng để dịch và trả về các chuỗi ký tự trong mã nguồn, cũng như… _e() Dùng để dịch và hiển thị trực tiếp các chuỗi văn bản. Bạn cũng cần thiết lập đúng các thông số trong phần ghi chú của plugin. Text DomainVà hãy sử dụng nó khi plugin được tải vào hệ thống. load_plugin_textdomain() Có một hàm được sử dụng để tải các tệp dịch về. Sau đó, bạn có thể sử dụng phần mềm như Poedit để tạo ra bản dịch cuối cùng. .pot Các tệp mẫu (template files), và tạo ra phiên bản dành cho các ngôn ngữ khác nhau. .po 和 .mo tệp dịch.