Hướng dẫn tối thượng phát triển plugin WordPress: Tạo plugin tùy chỉnh đầu tiên từ con số 0

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ấu trúc plugin của mình. Nhờ vào các plugin, các nhà phát triển có thể bổ sung bất kỳ tính năng nào cho nền tảng chính – từ những biểu mẫu liên hệ đơn giản đến các hệ thống thương mại điện tử phức tạp. Việc học cách phát triển plugin tùy chỉnh giúp bạn thoát khỏi sự hạn chế của bộ sưu tập plugin có sẵn, có thể xây dựng chính xác các tính năng theo nhu cầu của dự án, tối ưu hóa hiệu suất trang web, và thậm chí có thể biến nó thành một nguồn doanh thu bền vững.

Lợi thế chính của việc phát triển các plugin tùy chỉnh nằm ở tính linh hoạt và khả năng kiểm soát cao. Bạn có thể đảm bảo rằng mã nguồn chỉ chứa những chức năng thực sự cần thiết, tránh tình trạng phức tạp và nặng nề, từ đó giúp tăng tốc độ truy cập trang web. Đồng thời, bạn có thể tích hợp sâu các logic kinh doanh cụ thể, bảo vệ an ninh dữ liệu và tuân thủ các tiêu chuẩn lập trình tốt nhất. Từ góc độ kinh doanh, một plugin thành công có thể được đăng lên danh mục chính thức của WordPress, tiếp cận hàng triệu người dùng và tạo ra doanh thu đáng kể.

Công tác chuẩn bị và thiết lập môi trường

Trước khi viết dòng mã đầu tiên, bạn cần đảm bảo rằng môi trường phát triển của mình đã được chuẩn bị sẵn sàng. Một môi trường phát triển địa phương ổn định có thể nâng cao đáng kể hiệu suất làm việc và cho phép bạn thử nghiệm mã trong một môi trường an toàn, mà không ảnh hưởng đến trang web trực tuyến.

Đọc thêm Nắm vững phát triển plugin WordPress: Xây dựng chức năng tùy chỉnh từ con số 0。

Set up a local development server.

Chúng tôi khuyên bạn nên sử dụng các công cụ như MAMP, XAMPP hoặc Local by Flywheel để nhanh chóng thiết lập một máy chủ cục bộ chứa PHP và MySQL. Sau khi cài đặt và cấu hình WordPress xong, bạn sẽ có một môi trường thử nghiệm (sandbox) lý tưởng để phát triển và kiểm thử các ứng dụng web. Hãy đảm bảo rằng phiên bản PHP bạn đang sử dụng phù hợp với môi trường lưu trữ trên máy chủ thực tế, và hãy bật chức năng ghi lỗi (error logging) để dễ dàng phát hiện và khắc phục sự cố.wp-config.phpTrong tệp tin, bạn có thể thực hiện các thiết lập cần thiết.WP_DEBUGvìtrueĐiều này sẽ giúp bạn nhanh chóng xác định vấn đề trong quá trình phát triển.

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

Hiểu về cấu trúc thư mục cơ bản

WordPress plugins are located in the “Plugins” folder by default./wp-content/plugins/Các plugin đều nằm trong thư mục này; mỗi plugin là một thư mục riêng biệt, và phần cốt lõi của chúng là một tệp PHP chính. Bạn có thể tạo thư mục mới trực tiếp trong thư mục này bằng cách sử dụng FTP, SSH hoặc trình quản lý tệp trên máy tính của mình. Ví dụ, để tạo thư mục cho plugin đầu tiên của bạn, hãy đặt tên nó là…my-first-pluginMở thư mục đó, và tạo tệp chính (main file) bên trong thư mục đó.my-first-plugin.phpĐây là điểm nhập vào (entry point) của plugin; WordPress sẽ nhận diện plugin bằng cách đọc thông tin chú thích cụ thể nằm ở phần đầu của tệp này.

Tạo tệp cơ sở cho plugin đầu tiên

Trong phần này, chúng tôi sẽ hướng dẫn bạn từng bước tạo ra khung cơ bản của một plugin – đây chính là nền tảng quan trọng để plugin được WordPress nhận diện và quản lý.

Viết thông tin tiêu đề plugin

Mọi plugin WordPress đều phải chứa các ghi chú tiêu đề (header comments) được tiêu chuẩn hóa ở đầu tệp PHP chính của mình. Những thông tin này sẽ được hiển thị trên trang quản lý plugin ở phía sau hậu trường (backend). Hãy tạo một tệp mới và đặt tên nó là…my-first-plugin.phpVà nhập đoạn mã sau:

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

Đoạn chú thích này là bắt buộc.Plugin NameTên hiển thị của plugin trong giao diện nền đã được định nghĩa rõ ràng.Text DomainDùng để thực hiện công việc dịch thuật quốc tế. Sau khi lưu file, hãy đặt nó vào thư mục mà bạn đã chỉ định./wp-content/plugins/my-first-plugin/Nó đã được đặt vào thư mục được tạo ra. Bây giờ, hãy đăng nhập vào trang “Plugins” (Các tiện ích mở rộng) trong giao diện quản trị WordPress, và bạn sẽ thấy tiện ích mới này ở trạng thái “Chưa kích hoạt” (Not activated).

Đọc thêm Phân tích phát triển plugin WordPress: Hướng dẫn toàn diện xây dựng module chức năng tùy chỉnh từ đầu。

Thêm một hàm chức năng đơn giản.

Những plugin không có chức năng gì cả thì vô nghĩa. Hãy thêm một chức năng cơ bản nhất: 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. Đặt đoạn mã PHP sau đây ngay dưới phần chú thích ở đầu trang:

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

function myfp_add_footer_text( $content ) {
    // 检查是否在单个文章页面
    if ( is_single() ) {
        $custom_text = '<p><em>Cảm ơn bạn đã đọc bài viết này! Thông điệp này được tạo ra bởi “My First Custom Plugin”.</em></p>';
        $content .= $custom_text;
    }
    return $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ó thực hiện điều đó thông qua…add_filterHook được gắn vào WordPress.the_contentTrên bộ lọc (filter). Được sử dụng bên trong hàm (function).is_single()Chúng ta sử dụng các điều kiện để đảm bảo rằng văn bản chỉ được thêm vào trang của từng bài viết cụ thể, nhằm tránh ảnh hưởng đến trang chủ hoặc trang lưu trữ. Tên hàm được đặt với một tiền tố ngắn gọn.myfp(Đây là viết tắt của “My First Plugin”), đây là một thực hành tốt để tránh xung đột với tên các hàm của các plugin khác.

Tìm hiểu sâu về các công nghệ phát triển cốt lõi của plugin

Để các plugin của bạn trở nên mạnh mẽ và chuyên nghiệp hơn, bạn cần nắm vững một loạt API cốt lõi cũng như các mô hình phát triển mà WordPress cung cấp.

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 các hook hành động (action hooks) và bộ lọc (filters)

Action Hooks và Filter Hooks là những thành phần quan trọng trong quá trình phát triển plugin cho WordPress. Action Hooks cho phép bạn thực thi đoạn mã vào những thời điểm cụ thể, chẳng hạn như khi một bài viết được đăng lên trang web.publish_post) Hoặc khi trang quản trị nền (backend management page) được tải.admin_initCác bộ lọc (filters) cho phép bạn “thay đổi” dữ liệu, giống như ví dụ chúng ta đã thấy trước đó về việc sửa đổi nội dung bài viết.

Tạo một trang menu quản lý là một trường hợp điển hình cho việc sử dụng các hook hành động (action hooks). Bạn có thể gắn đoạn mã cần thiết vào các điểm thích hợp trong ứng dụng để thực hiện các thao tác liên quan đến menu.admin_menuTrên cây móc đó. Dưới đây là một ví dụ về cách tạo trang cài đặt đơn giản:

function myfp_create_admin_menu() {
    add_menu_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 权限能力
        'myfp-settings-page', // 菜单slug
        'myfp_settings_page_html', // 回调函数，用于输出页面HTML
        'dashicons-admin-generic', // 图标
        80 // 菜单位置
    );
}
add_action( 'admin_menu', 'myfp_create_admin_menu' );

function myfp_settings_page_html() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
        <p>Đây là trang cấu hình cho plugin đầu tiên của tôi.</p>
    </div>
    &lt;?php
}

Thực hiện các tùy chọn của plugin và lưu trữ dữ liệu

Hầu hết các plugin đều cần lưu trữ một số thiết lập của người dùng. WordPress đã cung cấp công cụ để thực hiện điều này.Options APIĐể lưu trữ và truy xuất dữ liệu một cách an toàn, bạn có thể sử dụng…add_option()、get_option()和update_option()Để tạo ra một biểu mẫu cài đặt tương tác, bạn cần kết hợp sử dụng các biểu mẫu HTML với các hàm bảo mật của WordPress.wp_nonce_field()Dùng để tạo ra và xác thực các số ngẫu nhiên an toàn, cũng như…sanitize_text_field()Dùng để làm sạch dữ liệu đầu vào từ người dùng.

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

Dưới đây là một đoạn ví dụ về quy trình đơn giản để xử lý và lưu trữ dữ liệu:

if ( isset( $_POST['myfp_submit'] ) ) {
    // 验证安全随机数
    if ( ! wp_verify_nonce( $_POST['myfp_nonce'], 'myfp_save_settings' ) ) {
        wp_die( '安全校验失败！' );
    }

// 清理并保存数据
    $user_text = sanitize_text_field( $_POST['custom_text'] );
    update_option( 'myfp_custom_text', $user_text );

echo '<div class="notice notice-success"><p>Cài đặt đã được lưu!</p></div>';
}

Nhập các tập tin script và style sheet.

Để không ảnh hưởng đến hiệu suất trang web, các tệp JavaScript và CSS được đưa vào thông qua plugin phải được sử dụng một cách chính xác.wp_enqueue_script()和wp_enqueue_style()Đây là một hàm trong WordPress, cho phép hệ thống quản lý các thành phần phụ thuộc (dependencies) và tránh xung đột giữa chúng. Hook (khớp nối) được sử dụng một cách chính xác sẽ giúp quá trình hoạt động của WordPress diễn ra trơn tru hơn.wp_enqueue_scripts(Dùng cho phía trước) Vàadmin_enqueue_scripts(Dùng cho phần backend.)

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

function myfp_enqueue_frontend_assets() {
    wp_enqueue_style(
        'myfp-frontend-style',
        plugins_url( 'assets/css/frontend-style.css', __FILE__ ),
        array(),
        '1.0.0'
    );
}
add_action( 'wp_enqueue_scripts', 'myfp_enqueue_frontend_assets' );

Thực hành tốt nhất cho việc phát hành và bảo trì plugin

Sau khi hoàn thành quá trình phát triển, bạn cần xem xét cách thức bảo trì và phân phối plugin của mình một cách bền vững.

Bảo mật và Kiểm thử Mã (Security and Code Review)

An ninh là yếu tố quan trọng nhất trong quá trình phát triển các tiện ích mở rộng (plugin). Mọi dữ liệu do người dùng nhập vào đều phải được coi là không đáng tin cậy; do đó, cần sử dụng các biện pháp bảo mật thích hợp để xử lý chúng.esc_html()、esc_url()、sanitize_text_field()Các hàm như này được sử dụng để tiến hành việc “đánh dấu ký tự đặc biệt” (escape) hoặc “làm sạch” dữ liệu trước khi truyền chúng đến trình duyệt hoặc lưu vào cơ sở dữ liệu. Khi thực hiện truy vấn SQL trực tiếp, việc sử dụng những hàm này là bắt bu$wpdbLớp và các thành viên của nó (The class and its members)prepare()Các phương pháp để ngăn chặn các cuộc tấn công SQL injection: Việc sử dụng thường xuyên các công cụ kiểm tra mã nguồn của WordPress (code sniffing tools) để kiểm tra mã nguồn có thể giúp bạn tuân thủ các tiêu chuẩn lập trình và phát hiện những lỗ hổng tiềm ẩn.

Chuẩn bị quốc tế hóa và bản địa hóa

Nếu bạn muốn plugin của mình đượ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ữ (internationalization – i18n) là điều cực kỳ cần thiết. Điều này có nghĩa là bạn cần thay thế tất cả các chuỗi văn bản dành cho người dùng bằng phiên bản dịch tương ứng của chúng sang các()或_e()Hãy bọc các hàm dịch vào một lớp bao bọc (wrapper). Ví dụ:echo (‘Hello World!‘， ‘my-first-plugin‘);Được định nghĩa ở phần đầu của plugin.Text Domain（my-first-pluginNó phải hoàn toàn trùng khớp với các vùng văn bản được sử dụng trong hàm dịch. Sau đó, bạn có thể sử dụng các công cụ như Poedit để tạo ra những tài liệu cần thiết..pottệp mẫu, để người dịch tạo ra các ngôn ngữ khác nhau.moTệp.

Cập nhật phiên bản và Tính tương thích

Khi bạn thêm chức năng mới cho plugin hoặc sửa lỗi, bạn cần phải phát hành phiên bản mới. Hãy đảm bảo cập nhật phần đầu của tệp chính (main file) một cách thích hợp.VersionThông tin: Đề xuất cung cấp một lộ trình nâng cấp, trong đó hệ thống sẽ kiểm tra số phiên bản khi plugin được kích hoạt, và thực hiện các thao tác cần thiết tùy theo kết quả kiểm tra đó.register_activation_hookThực hiện các thao tác cập nhật cần thiết trên cơ sở dữ liệu hoặc di chuyển dữ liệu. Đồng thời, trong quá trình đó…readme.txtTrong tệp tin, các nhật ký cập nhật, phiên bản WordPress tương thích và hướng dẫn cài đặt được ghi chép một cách rõ ràng. Điều này đặc biệt quan trọng nếu bạn dự định nộp plugin của mình vào danh mục chính thức của WordPress.

Tóm lại

Từ việc hiểu rõ các khái niệm cơ bản về plugin cho đến việc thực sự tạo ra những plugin hoàn chỉnh – bao gồm các hàm chức năng, trang quản lý, và cơ chế tải các tài nguyên cần thiết – bạn đã bước vào lĩnh vực phát triển plugin cho WordPress. Những yếu tố then chốt trong quá trình này bao gồm việc nắm vững cách sử dụng các hook (điểm kết nối giữa các thành phần của hệ thống), xử lý dữ liệu và cài đặt một cách an toàn, cũng như tuân thủ các chuẩn quốc tế hóa và bảo mật. Việc phát triển plugin là một quá trình học hỏi không ngừng; việc liên tục kiểm thử, đọc mã nguồn của hệ thống WordPress và các plugin chất lượng cao khác sẽ giúp bạn xây dựng những công cụ mạnh mẽ và chuyên nghiệp hơn. Bây giờ, dựa trên nền tảng này, bạn có thể bắt đầu suy nghĩ và thực hiện những tính năng độc đáo theo ý tưởng của mình.

FAQ 常见问题

Để phát triển một plugin cho WordPress với tên ###, bạn cần có những kiến thức lập trình cơ bản sau:
Để 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ì hầu hết các plugin đều được viết bằng PHP. Ngoài ra, việc am hiểu cơ bản về HTML, CSS và JavaScript là điều cần thiết để xây dựng giao diện người dùng và các tính năng tương tác. Việc quen thuộc với các khái niệm cơ bản của cơ sở dữ liệu MySQL sẽ giúp bạn hiểu rõ hơn về cách WordPress lưu trữ dữ liệu.

Liệu tên tệp PHP chính của plugin có thể được đặt tùy ý không?

Được, nhưng thường thì bạn nên sử dụng những tên tương ứng với tên thư mục chứa plugin hoặc những tên có ý nghĩa mô tả rõ ràng. Điều quan trọng nhất là, dù tệp tin có tên gì đi nữa, phần ghi chú ở đầu tệp (chứa thông tin về plugin) vẫn phải được giữ nguyPlugin NameĐoạn chú thích đó phải chính xác tuyệt đối, bởi vì WordPress chính xác là dựa vào thông tin này để nhận diện các plugin.

Làm thế nào để tránh tình trạng tên hàm mà tôi viết xung đột với các plugin khác?

Thực hành tốt nhất là sử dụng một tiền tố duy nhất để đặt tên cho tất cả các hàm, lớp, biến và hằng số của bạn. Tiền tố này cần đủ đặc trưng, thường liên quan đến viết tắt của plugin hoặc thương hiệu của bạn. Ví dụ, nếu plugin của bạn có tên là “Super SEO Tools”, bạn có thể sử dụng tiền tố “SuperSEO_” để đặt tên cho các thành phần trong plugin đó.sset_或sst_Làm tiền tố, ví dụ như…sst_generate_meta_descriptionSử dụng không gian tên trong PHP (trong những môi trường hỗ trợ) là một giải pháp hiện đại và hiệu quả hơn.

Tôi có thể tạo bảng cơ sở dữ liệu trong một plugin không?

Được, nhưng bạn cần phải rất thận trọng. Hãy chỉ tạo các bảng cơ sở dữ liệu tùy chỉnh khi thực sự cần thiết, vì API Options của WordPress cùng với các bảng Posts/Post Meta có sẵn thường đã đủ linh hoạt để đáp ứng hầu hết nhu cầu lưu trữ dữ liệu. Nếu bạn vẫn phải tạo các bảng mới, hãy sử dụng chúng một cách có chọn lọc và cẩn thận.$wpdbĐối tượng, và đảm bảo rằng hook được kích hoạt trong plugin (sử dụng…)register_activation_hookTrong quá trình tạo bảng, cần xem xét việc cung cấp tùy chọn để dọn dẹp bảng khi người dùng quyết định gỡ cài đặt phần mềm.

Sau khi hoàn thành việc phát triển, bạn có thể chia sẻ plugin của mình với người khác để họ có thể sử dụng như sau:

Đối với các dự án cá nhân hoặc của khách hàng, hãy tiến hành đóng gói sản phẩm trực tiếp.zipChỉ cần tệp tin là đủ. Nếu bạn muốn công bố nó một cách chính thức, cách hiệu quả nhất là nộp nó vào danh mục plugin chính thức của WordPress. Điều này đòi hỏi bạn phải tạo một tệp tin plugin đáp ứng đầy đủ các yêu cầu của danh mục đó.readme.txtHãy đảm bảo rằng tệp tin được gửi đi đáp ứng đầy đủ yêu cầu, và mã nguồn tuân thủ các thỏa thuận mã nguồn mở (chẳng hạn như GPL). Trước khi nộp, hãy kiểm tra kỹ lưỡng tính tương thích và độ an toàn của plugin trong nhiều môi trường khác nhau.