Hướng dẫn toàn diện phát triển plugin WordPress: Xây dựng chức năng tùy chỉnh từ con số không

Môi trường phát triển plugin WordPress và các bước chuẩn bị cơ bản

Trước khi bắt đầu viết mã, một môi trường phát triển ổn định và được cô lập là bước đầu tiên quan trọng để đạt được thành công. Điều này không chỉ giúp bảo vệ trang web sản xuất của bạn khỏi ảnh hưởng của mã thử nghiệm, mà còn giúp quá trình gỡ lỗi diễn ra thuận lợi hơn nữa.

Xây dựng môi trường phát triển cục bộ

Chúng tôi khuyên bạn nên sử dụng các gói phần mềm máy chủ địa phương như Local by Flywheel, XAMPP hoặc MAMP. Những công cụ này cho phép bạn cài đặt một môi trường hoàn chỉnh bao gồm PHP, MySQL và Apache/Nginx chỉ với một cú nhấp chuột. Hãy đảm bảo rằng phiên bản PHP bạn sử dụng phù hợp với yêu cầu của phiên bản WordPress mà bạn muốn cài đặt; thường thì PHP 7.4 hoặc các phiên bản mới hơn được khuyến nghị để đạt được hiệu suất và khả năng bảo mật tốt hơn.

Tạo tệp chính cho plugin

Mọi plugin WordPress đều phải có một tệp chính (main file), đó là điểm truy cập vào plugin đó. Tệp này cần được đặt ở đâu? wp-content/plugins Hãy lưu tệp plugin vào một thư mục độc lập bên trong thư mục chính, và đặt cho nó một tên độc đáo. Ví dụ, nếu bạn muốn tạo một plugin có tên “Greeting”, bạn có thể tạo một thư mục với tên “Greeting” và đặt tệp plugin bên trong thư mục đó. my-first-plugin Mở thư mục đó, và tạo tập tin chính (main file) bên trong nó. my-first-plugin.php。

Đọc thêm Hướng dẫn Tối thượng Phát triển Plugin WordPress: Xây dựng Plugin Cấp Thương mại từ Không đến Có。

Đầu tiên của tệp tin này phải chứa một ghi chú đặc biệt dành cho phần tiêu đề của plugin, nhằm cung cấp thông tin cơ bản về plugin cho WordPress. Dưới đây là một ví dụ cơ bản nhất:

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://example.com/my-first-plugin
 * Description:       这是一个用于学习插件开发的简单插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Cấu trúc cốt lõi của plugin và cơ chế hook

Trọng tâm của việc phát triển plugin cho WordPress là hiểu rõ và sử dụng hệ thống “Hook” của nó. Hệ thống Hook cho phép bạn đưa đoạn mã của mình vào các điểm cụ thể trong quá trình xử lý của WordPress, nhằm thay đổi hoặc thêm chức năng mới mà không cần phải sửa đổi các tệp nguồn gốc của WordPress.

Hiểu về Hook hành động (Action Hook) và Hook bộ lọc (Filter Hook)

Các “hook” chủ yếu được chia thành hai loại: Actions (Hành động) và Filters (Bộ lọc). Các hook loại Action sẽ thực thi đoạn mã của bạn khi một sự kiện cụ thể xảy ra, chẳng hạn như khi bạn đăng một bài viết hoặc khi bạn truy cập giao diện quản trị. Bạn có thể sử dụng chúng để tự động thực hiện các tác vụ theo yêu cầu. add_action() Các hàm được sử dụng để thực hiện việc “gắn” (mounting) dữ liệu vào hệ thống. Trong khi đó, các hook (câu lệnh được thực thi tự động) của bộ lọc được dùng để chỉnh sửa dữ liệu; chúng cho phép bạn thay đổi giá trị của dữ liệu trước khi nó được gửi đến cơ sở dữ liệu hoặc trình duyệt. add_filter() Hàm được sử dụng để thực hiện việc gắn (mount) các tài nguyên.

Ví dụ, để thêm văn bản tùy chỉnh vào phần chân trang của trang web, bạn có thể sử dụng… wp_footer This action hook:

function myplugin_add_footer_text() {
    echo '<p style="text-align:center;">Cảm ơn bạn đã sử dụng trang web này!</p>';
}
add_action( 'wp_footer', 'myplugin_add_footer_text' );

tạo trang quản lý plugin

Nhiều plugin yêu cầu có trang cài đặt trong giao diện quản trị của WordPress. Điều này thường được thực hiện bằng cách gắn (mount) các plugin đó vào hệ thống quản trị của WordPress. admin_menu Bạn có thể sử dụng các “action hook” để thực hiện điều này. Bạn cần định nghĩa một hàm, và trong hàm đó, hãy sử dụng các công cụ hoặc logic cần thiết. add_menu_page() 或 add_options_page() Hãy sử dụng các hàm như `register_page` để đăng ký trang, và định nghĩa một hàm khác để hiển thị nội dung HTML của trang đó.

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

function myplugin_add_admin_menu() {
    add_options_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 权限
        'myplugin-settings', // 菜单别名
        'myplugin_render_settings_page' // 用于显示页面内容的函数
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

function myplugin_render_settings_page() {
    ?>
    <div class="wrap">
        <h2>Cài đặt plugin của tôi</h2>
        <form method="post" action="/vi/options.php/" data-trp-original-action="options.php">
            <?php
            settings_fields( 'myplugin_settings_group' );
            do_settings_sections( 'myplugin-settings' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="vi"/></form>
    </div>
    &lt;?php
}

Thực hiện chức năng của plugin và xử lý dữ liệu

Một plugin hoàn chỉnh thường cần xử lý dữ liệu đầu vào từ người dùng, lưu trữ các thiết lập, và tương tác với cơ sở dữ liệu. WordPress cung cấp những API mạnh mẽ để đơn giản hóa các thao tác này.

Sử dụng API cấu hình để lưu các tùy chọn.

Việc xử lý thủ công các thao tác gửi biểu mẫu và thao tác trên cơ sở dữ liệu vừa phức tạp vừa không an toàn. WordPress cung cấp API để thực hiện các thao tác đăng ký, xác thực và lưu trữ cài đặt một cách tiêu chuẩn hóa và an toàn. Quá trình này bao gồm ba hàm chính:register_setting()、add_settings_section() 和 add_settings_field()。

Ví dụ dưới đây minh họa cách thiết lập một trường văn bản:

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 myplugin_settings_init() {
    register_setting( 'myplugin_settings_group', 'myplugin_greeting_text' );

add_settings_section(
        'myplugin_section',
        '基础设置',
        null,
        'myplugin-settings'
    );

add_settings_field(
        'myplugin_field_greeting',
        '问候语',
        'myplugin_field_greeting_render',
        'myplugin-settings',
        'myplugin_section'
    );
}
add_action( ‘admin_init’， ‘myplugin_settings_init’ );

function myplugin_field_greeting_render() {
    $value = get_option( ‘myplugin_greeting_text’， ‘你好，世界！’ );
    echo ‘<input type=“text” name=“myplugin_greeting_text” value=“’ . esc_attr( $value ) . ‘” />’;
}

tạo bảng cơ sở dữ liệu tùy chỉnh

Đối với các plugin cần lưu trữ dữ liệu có cấu trúc phức tạp (dữ liệu quan hệ), bạn có thể cần tạo các bảng cơ sở dữ liệu tùy chỉnh. Quá trình này thường được thực hiện khi plugin được kích hoạt. Bạn sẽ cần viết một hàm và gắn nó vào các hook liên quan đến quá trình đăng ký và kích hoạt của WordPress. dbDelta() Đây là một hàm được thiết kế để thực hiện các câu lệnh SQL nhằm tạo hoặc cập nhật bảng dữ liệu, và nó có khả năng xử lý một cách thông minh những thay đổi trong cấu trúc của bảng đó.

Trước hết, hãy đăng ký các hook kích hoạt trong tệp plugin chính của bạn:

register_activation_hook( __FILE__， ‘myplugin_create_database_table’ );

Sau đó, hãy định nghĩa hàm để tạo bảng:

Đọc thêm Hướng dẫn nhập môn phát triển plugin WordPress: Tạo plugin đầu tiên của bạn từ con số 0。

function myplugin_create_database_table() {
    global $wpdb;
    $table_name = $wpdb->prefix . ‘myplugin_data’;
    $charset_collate = $wpdb->get_charset_collate();

$sql = “CREATE TABLE $table_name (
        id mediumint(9) NOT NULL AUTO_INCREMENT，
        name varchar(100) NOT NULL，
        email varchar(100) NOT NULL，
        created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL，
        PRIMARY KEY (id)
    ) $charset_collate;”;

require_once( ABSPATH . ‘wp-admin/includes/upgrade.php’ );
    dbDelta( $sql );
}

Bảo mật plugin, hỗ trợ đa ngôn ngữ (internationalization), và chuẩn bị cho việc phát hành (release preparation)

Các plugin đã được phát triển cần phải trải qua các bước tăng cường bảo mật, dịch thuật theo ngôn ngữ cụ thể, và đóng gói theo tiêu chuẩn nhất định trước khi có thể được cung cấp an toàn cho người dùng hoặc gửi lên danh mục chính thức.

Thực hiện các phương pháp bảo mật tốt nhất

An toàn là yếu tố quan trọng nhất trong quá trình phát triển các plugin. Hãy luôn kiểm tra định dạng và làm sạch dữ liệu do người dùng nhập vào (loại bỏ các phần có hại). Hãy sử dụng các hàm được cung cấp bởi WordPress để thực hiện điều này. esc_html()、esc_attr()、sanitize_text_field() Để xuất hoặc xử lý dữ liệu, hãy sử dụng các công cụ phù hợp khi thực hiện truy vấn cơ sở dữ liệu. $wpdb->prepare() Các phương pháp để ngăn chặn các cuộc tấn công SQL injection. Đồng thời, hãy sử dụng… current_user_can() Kiểm tra quyền hạn của người dùng để đảm bảo chỉ những người được ủy quyền mới có thể thực hiện các thao tác nhạy cảm.

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ực hiện quốc tế hóa cho plugin

Để plugin của bạn có thể được sử dụng bởi người dùng trên toàn thế giới, bạn cần phải thực hiện các bước chuẩn bị cho việc hỗ trợ đa ngôn ngữ (internationalization – i18n). Điều này có nghĩa là tất cả các chuỗi văn bản dùng để hiển thị cho người dùng không được viết trực tiếp trong mã nguồn, mà phải được bao bọc bằng các hàm dịch của WordPress. Hàm được sử dụng phổ biến nhất là… () Dùng để hiển thị bản dịch,() Dùng để lấy chuỗi đã được dịch, cũng như… _e() Dùng để hiển thị kết quả dịch trực tiếp.

Trong đoạn mã của bạn, bạn nên viết như sau:

$greeting = __( ‘你好，世界！’， ‘my-first-plugin’ );
echo esc_html( $greeting );

_e( ‘设置已保存。’， ‘my-first-plugin’ );

Lưu ý rằng tham số thứ hai trong hàm dịch (“Text Domain”) phải trùng khớp với giá trị được định nghĩa trong phần chú thích ở đầu plugin. Text Domain Hoàn toàn nhất quán. Sau đó, bạn có thể sử dụng các công cụ như Poedit để tạo ra sản phẩm cần thiết. .pot tệp mẫu, để người dịch tạo .po 和 .mo tệp dịch.

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 chức năng thực tế, và điều này đòi hỏi sự hiểu biết sâu sắc về cấu trúc cốt lõi của WordPress, đặc biệt là hệ thống các hook (những điểm kết nối trong mã nguồn). Từ việc thiết lập môi trường phát triển, viết các tệp chính của plugin, sử dụng các hook liên quan đến các hành động (actions) và bộ lọc (filters), cho đến việc xử lý dữ liệu thông qua API cấu hình và API cơ sở dữ liệu, mọi bước đều tuân theo những quy trình nhất định. Cuối cùng, chỉ khi áp dụng các biện pháp bảo mật nghiêm ngặt và hỗ trợ đầy đủ cho việc đa ngôn ngữ, plugin của bạn mới có thể trở thành sản phẩm sẵn sàng được phát hành. 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á những lĩnh vực phức tạp hơn như tùy chỉnh các loại bài viết (article types), tích hợp với REST API, hoặc phát triển các block (blocks) theo công nghệ Gutenberg, từ đó tạo ra những tiện ích mở rộng (extensions) cho WordPress mạnh mẽ và hiện đại hơn.

FAQ 常见问题

Có phải để phát triển plugin cho WordPress, bạn phải am hiểu sâu rộng về PHP không?

Đúng vậy, PHP là ngôn ngữ lập trình chính được sử dụng để phát triển WordPress cùng với các plugin của nó. Bạn cần nắm vững ngữ pháp cơ bản của PHP, các hàm, mảng dữ liệu, cũng như các khái niệm về lập trình hướng đối tượng. Ngoài ra, việc có kiến thức cơ bản về HTML, CSS và JavaScript cũng rất quan trọng, vì bạn sẽ phải xử lý phần hiển thị và tương tác trên trang web (phần front-end).

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

Bạn nên bật chế độ gỡ lỗi (debug mode) của WordPress. 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ị 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 để… (The text seems incomplete here; please provide the rest of the sentence for a complete translation.) error_log() Hàm này 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ông cụ phát triển trình duyệt để gỡ lỗi JavaScript ở phía trước (frontend).

Làm thế nào để tránh xung đột tên hàm trong các plugin?

Để tránh xung đột giữa tên hàm, tên lớp hoặc tên hằng số, bạn nên luôn sử dụng một tiền tố duy nhất. Thực hành tốt nhất là sử dụng tên của plugin hoặc các từ viết tắt làm tiền tố. Ví dụ, nếu plugin của bạn có tên là “Awesome Slider”, bạn có thể sử dụng tiền tố như “AwesomeSlider-” để đặt tên các thành phần liên quan đến plugin đó. as_ 或 awesome_slider_ Được sử dụng làm tiền tố cho tất cả các hàm tùy chỉnh. Đối với tên lớp (class names), cũng nên tuân theo nguyên tắc tương tự.

Có thể gửi các plugin được mua về (plugin đã được thanh toán) lên danh mục plugin chính thức của WordPress không?

Không được. Danh mục plugin chính thức của WordPress chỉ chấp nhận những plugin tuân thủ giấy phép GPL và hoàn toàn miễn phí. Nếu bạn phát triển plugin có phí (cao cấp), bạn cần tự phân phối và bán chúng trên trang web của mình. Tuy nhiên, nhiều plugin có phí cung cấp một phiên bản miễn phí bao gồm các tính năng cơ bản để có thể được gửi lên danh mục chính thức, nhằm mục đích quảng bá và cho người dùng trải nghiệm trước phiên bản cao cấp.