Hướng dẫn Tùy chỉnh Phát triển Plugin WooCommerce: Xây dựng Cửa hàng Trực tuyến Độc quyền

Trong môi trường thương mại điện tử cạnh tranh khốc liệt ngày nay, một cửa hàng WooCommerce tiêu chuẩn thường khó có thể đáp ứng hết mọi nhu cầu kinh doanh. Dù là quy trình thanh toán được tùy chỉnh, các quy tắc tính phí vận chuyển đặc biệt, hay sự tích hợp sâu rộng với các hệ thống bên thứ ba, tất cả đều đòi hỏi phải mở rộng các chức năng cốt lõi của cửa hàng. Đây chính là giá trị của việc phát triển các plugin tùy chỉnh. Bằng cách tự mình viết các plugin, bạn có thể tạo ra những giải pháp phù hợp với nhu cầu cụ thể của doanh nghiệp mình. WooCommerce Với các plugin này, bạn có thể nắm toàn quyền kiểm soát, tạo ra trải nghiệm mua sắm độc đáo và xây dựng những rào cản kinh doanh khó bị sao chép.

Cấu hình môi trường phát triển plugin WooCommerce

Trước khi bắt đầu bất kỳ quá trình phát triển nào, một môi trường phát triển cục bộ ổn định và được cô lập là điều cần thiết. Điều này không chỉ giúp bảo vệ dữ liệu trên hệ thống trực tuyến của bạn mà còn thuận tiện cho việc gỡ lỗi và thử nghiệm.

Set up a local WordPress environment

Chúng tôi khuyên bạn nên sử dụng các công cụ như Local by Flywheel, XAMPP hoặc MAMP để thiết lập môi trường phát triển trên máy tính cá nhân một cách nhanh chóng. Hãy đảm bảo rằng môi trường của bạn đáp ứng đầy đủ các yêu cầu cần thiết cho việc phát triển ứng dụng. WooCommerce Yêu cầu tối thiểu: PHP 7.2 hoặc phiên bản mới hơn, MySQL 5.6 hoặc phiên bản mới hơn, cùng với phiên bản mới nhất của WordPress. Sau khi cài đặt WordPress xong, hãy cài đặt và kích hoạt các plugin từ thư mục plugin chính thức của WordPress. WooCommerce Việc cài đặt các plugin và hoàn tất hướng dẫn thiết lập ban đầu sẽ rất hữu ích cho quá trình phát triển. Việc nhập dữ liệu mẫu cũng sẽ giúp ích nhiều trong công việc này.

Đọc thêm Hướng dẫn hoàn chỉnh về phát triển và tối ưu hiệu suất website WooCommerce。

Tạo cấu trúc cơ bản cho một plugin

Một WooCommerce Đầu tiên, đây là một plugin chuẩn của WordPress. wp-content/plugins/ của bạn, ví dụ my-custom-woocommerceTrong thư mục đó, hãy tạo tập tin plugin chính, thường được đặt tên theo tên của plugin đó, ví dụ như: my-custom-woocommerce.php。

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

Tệp chính này cần chứa các thông tin tiêu chuẩn của tiện ích mở rộng (plugin) WordPress. Dưới đây là một ví dụ cơ bản:

<?php
/**
 * Plugin Name: My Custom WooCommerce
 * Plugin URI:  https://yourwebsite.com/
 * Description: 为 WooCommerce 商店添加自定义功能。
 * Version:     1.0.0
 * Author:      您的名字
 * Author URI:  https://yourwebsite.com/
 * License:     GPL v2 or later
 * Text Domain: my-custom-woocommerce
 * Domain Path: /languages
 * WC requires at least: 5.0.0
 * WC tested up to: 8.0.0
 */

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

// 检查 WooCommerce 是否已激活
if ( ! in_array( 'woocommerce/woocommerce.php', apply_filters( 'active_plugins', get_option( 'active_plugins' ) ) ) ) {
    add_action( 'admin_notices', function() {
        ?>
        <div class="notice notice-error">
            <p>“Plugin ”My Custom WooCommerce” yêu cầu WooCommerce đã được cài đặt và kích hoạt.</p>
        </div>
        &lt;?php
    } );
    return;
}

Điểm then chốt nằm ở việc đã sử dụng… WC requires at least 和 WC tested up to Header information is used to declare and specify certain details. WooCommerce Xem xét tính tương thích, và kiểm tra điều đó trong mã nguồn. WooCommerce Đã được kích hoạt chưa?

Core Extension Method: Action and Filter Hooks

WooCommerce Điểm mạnh của nó nằm ở hệ thống hook có khả năng mở rộng cao. Việc hiểu rõ và sử dụng thành thạo các hook hành động (Actions) và hook bộ lọc (Filters) là yếu tố then chốt trong quá trình phát triển tùy chỉnh.

Sử dụng các “action hook” để can thiệp vào quá trình xử lý.

Hook hành động cho phép bạn WooCommerce Bạn có thể chèn đoạn mã của mình vào một thời điểm cụ thể trong quá trình thực thi chương trình. Ví dụ, bạn muốn thực hiện một thao tác tùy chỉnh (như gọi một API bên ngoài) sau khi người dùng đặt hàng.

Đọc thêm Hướng dẫn thực hành 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。

Bạn có thể sử dụng woocommerce_thankyou “Hook” – nó được kích hoạt trên trang cảm ơn khách hàng sau khi đặt hàng. Hoặc bạn có thể sử dụng một phương pháp phổ biến hơn… woocommerce_checkout_order_processedNó được kích hoạt khi quá trình xử lý đơn hàng hoàn tất.

add_action( 'woocommerce_checkout_order_processed', 'my_custom_order_action', 10, 3 );

function my_custom_order_action( $order_id, $posted_data, $order ) {
    // 获取订单对象（如果未提供）
    if ( ! $order instanceof WC_Order ) {
        $order = wc_get_order( $order_id );
    }

// 执行您的自定义逻辑，例如记录日志或发送请求
    $logger = wc_get_logger();
    $logger->info( '订单 #' . $order_id . ' 已创建，开始执行自定义任务。', array( 'source' => 'my-custom-plugin' ) );

// 调用外部 API 示例（伪代码）
    // $response = wp_remote_post( 'https://api.example.com/notify', $args );
}

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

Các hook của bộ lọc cho phép bạn thực hiện việc chỉnh sửa (thay đổi cài đặt hoặc chức năng của chúng). WooCommerce Dữ liệu được truyền đi. Ví dụ, bạn muốn cộng một khoản phí xử lý cố định vào giá của tất cả các sản phẩm.

Bạn có thể sử dụng woocommerce_product_get_price “Filter” (Bộ lọc): Hook này rất mạnh mẽ, nhưng cần được sử dụng thận trọng vì nó sẽ ảnh hưởng đến toàn bộ cách các giá trị được hiển thị.

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

add_filter( 'woocommerce_product_get_price', 'my_custom_price_adjustment', 10, 2 );

function my_custom_price_adjustment( $price, $product ) {
    // 只在前端购物车和商品页面应用，避免影响后台
    if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
        return $price;
    }

// 假设增加 5 元手续费
    $fee = 5;
    $new_price = $price + $fee;

return $new_price;
}

Tùy chỉnh loại sản phẩm và cơ chế lưu trữ dữ liệu

WooCommerce Mặc định, hệ thống hỗ trợ các loại sản phẩm đơn giản và sản phẩm có thể thay đổi thông tin (sản phẩm có thể được điều chỉnh sau khi được bán). Tuy nhiên, đôi khi bạn cần tạo ra các loại sản phẩm mới, chẳng hạn như “sản phẩm cần đặt trước” hoặc “sản phẩm dịch vụ”.

Đăng ký loại sản phẩm mới

Việc tạo một loại sản phẩm mới đòi hỏi nhiều bước. Trước hết, bạn cần đăng ký loại sản phẩm đó. Thông thường, quá trình này được thực hiện thông qua hệ thống quản lý sản phẩm của công ty. init Hoạt động hoặc tiện ích được thực hiện khi nó được tải vào hệ thống.

add_action( 'init', 'register_my_custom_product_type' );

function register_my_custom_product_type() {
    class WC_Product_Custom extends WC_Product {
        public function __construct( $product ) {
            parent::__construct( $product );
            $this->product_type = 'custom';
        }

// 您可以在这里重写父类方法，或添加新方法
        public function get_type() {
            return 'custom';
        }

// 示例：自定义“添加到购物车”按钮文本
        public function add_to_cart_text() {
            return __( '预约服务', 'my-custom-woocommerce' );
        }
    }
}

Sau đó, bạn cần sử dụng bộ lọc (filter) để thêm loại sản phẩm này vào danh sách các loại sản phẩm có sẵn để người dùng lựa chọn.

Đọc thêm Xây dựng dễ dàng các trang sản phẩm tùy chỉnh cho WooCommerce: Từ cơ bản đến nâng cao。

add_filter( 'product_type_selector', 'add_custom_product_type_to_dropdown' );

function add_custom_product_type_to_dropdown( $types ) {
    $types['custom'] = __( '自定义服务', 'my-custom-woocommerce' );
    return $types;
}

Thêm trường tùy chỉnh cho sản phẩm

Đối với các loại sản phẩm mới, thường cần có thêm các trường dữ liệu. Điều này có thể được thực hiện bằng cách… WooCommerce Dữ liệu sản phẩm được hiển thị thông qua một khung dữ liệu chuyên dụng (Metabox). woocommerce_product_options_general_product_data Thêm trường cho hành động (action) và sử dụng nó. woocommerce_process_product_meta Hãy lưu lại những hành động đó.

add_action( 'woocommerce_product_options_general_product_data', 'add_custom_product_fields' );

function add_custom_product_fields() {
    global $product_object;

echo '<div class="options_group show_if_custom">'; // `show_if_custom` 仅对“custom”类型显示

woocommerce_wp_text_input( array(
        'id'          =&gt; '_service_duration',
        'label'       =&gt; __( '服务时长 (小时)', 'my-custom-woocommerce' ),
        'desc_tip'    =&gt; true,
        'description' =&gt; __( '请输入完成此服务预计需要的小时数。', 'my-custom-woocommerce' ),
        'type'        =&gt; 'number',
        'custom_attributes' =&gt; array(
            'step' =&gt; '0.5',
            'min'  =&gt; '0.5'
        )
    ) );

echo '</div>';
}

// 保存字段
add_action( 'woocommerce_process_product_meta', 'save_custom_product_fields' );

function save_custom_product_fields( $post_id ) {
    $product = wc_get_product( $post_id );
    if ( $product-&gt;get_type() === 'custom' ) {
        $duration = isset( $_POST['_service_duration'] ) ? sanitize_text_field( $_POST['_service_duration'] ) : '';
        $product-&gt;update_meta_data( '_service_duration', $duration );
        $product-&gt;save_meta_data();
    }
}

Tương tác với giỏ hàng và quy trình thanh toán

Giỏ hàng và quá trình thanh toán là những khâu cốt lõi trong hoạt động thương mại điện tử.WooCommerce Đây có rất nhiều “hook” (công cụ hỗ trợ lập trình) được cung cấp để bạn có thể tự tùy chỉnh hệ thống theo nhu cầu.

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

Thay đổi hành vi của các mục trong giỏ hàng

Bạn có thể thực hiện điều đó thông qua… woocommerce_add_cart_item_data Bộ lọc thêm dữ liệu tùy chỉnh khi sản phẩm được thêm vào giỏ hàng. Ví dụ, thêm ngày hẹn đặt lịch cho sản phẩm thuộc danh mục “Dịch vụ tùy chỉnh”.

add_filter( 'woocommerce_add_cart_item_data', 'add_custom_data_to_cart_item', 10, 3 );

function add_custom_data_to_cart_item( $cart_item_data, $product_id, $variation_id ) {
    $product = wc_get_product( $product_id );
    if ( $product->get_type() === 'custom' && isset( $_POST['appointment_date'] ) ) {
        $cart_item_data['appointment_date'] = sanitize_text_field( $_POST['appointment_date'] );
        // 确保每个有不同预约日期的商品都被视为独立项目
        $cart_item_data['unique_key'] = md5( microtime() . rand() );
    }
    return $cart_item_data;
}

Sau đó, bạn có thể sử dụng… woocommerce_get_item_data Các bộ lọc (filters) hiển thị dữ liệu tùy chỉnh này trên trang giỏ hàng và trang thanh toán.

(Custom checkout fields)

Việc thêm hoặc sửa đổi các trường thông tin liên quan đến quá trình thanh toán là điều rất phổ biến. woocommerce_checkout_fields Việc triển khai các bộ lọc (filters) là điều khá dễ dàng.

add_filter( 'woocommerce_checkout_fields', 'add_custom_checkout_field' );

function add_custom_checkout_field( $fields ) {
    $fields['billing']['billing_custom_vat'] = array(
        'label'       => __( '增值税号', 'my-custom-woocommerce' ),
        'placeholder' => _x( '请输入您的公司税号', 'placeholder', 'my-custom-woocommerce' ),
        'required'    => false, // 根据业务需求调整
        'class'       => array( 'form-row-wide' ),
        'clear'       => true,
        'priority'    => 35, // 控制字段顺序
    );
    return $fields;
}

Để lưu giá trị của trường này vào đơn hàng, bạn cần sử dụng… woocommerce_checkout_update_order_meta Hành động.

add_action( 'woocommerce_checkout_update_order_meta', 'save_custom_checkout_field' );

function save_custom_checkout_field( $order_id ) {
    if ( ! empty( $_POST['billing_custom_vat'] ) ) {
        update_post_meta( $order_id, '_billing_custom_vat', sanitize_text_field( $_POST['billing_custom_vat'] ) );
    }
}

Tóm lại

WooCommerce Việc phát triển các plugin tùy chỉnh là một quá trình có hệ thống, bắt đầu từ việc hiểu rõ cấu trúc của chúng. Từ việc thiết lập môi trường phát triển đúng đắn, tạo ra khung giao diện plugin tuân thủ các tiêu chuẩn, cho đến việc tìm hiểu sâu về hệ thống các hook (hành động và bộ lọc) để can thiệp hoặc sửa đổi các quy trình cốt lõi – mỗi bước đều là nền tảng để xây dựng những tính năng độc đáo. Bằng cách tạo ra các loại sản phẩm và trường dữ liệu tùy chỉnh, bạn có thể mở rộng mô hình dữ liệu để đáp ứng các nhu cầu kinh doanh phức tạp. Cuối cùng, việc bổ sung các tương tác và dữ liệu một cách khéo léo vào quá trình giỏ hàng và thanh toán sẽ giúp cải thiện trải nghiệm người dùng cũng như nâng cao hiệu quả vận hành. Hãy luôn tuân theo các thực tiễn tốt nhất, chẳng hạn như thực hiện các bài kiểm thử kỹ lưỡng, đảm bảo an ninh mã nguồn, duy trì tài liệu đầy đủ, và chú ý đến các yếu tố quan trọng khác. WooCommerce Các bản cập nhật liên quan đến nền tảng WordPress cốt lõi là rất quan trọng, vì chúng giúp đảm bảo rằng các plugin mà bạn phát triển hoạt động một cách ổn định, hiệu quả và có khả năng tồn tại lâu dài trong môi trường web.

FAQ 常见问题

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

Việc phát triển các plugin cho WooCommerce đòi hỏi bạn có nền tảng lập trình PHP vững chắc và am hiểu rõ các khái niệm về lập trình hướng đối tượng (OOP – Object-Oriented Programming). Bạn cũng cần nắm vững cơ chế hoạt động cơ bản của WordPress, bao gồm hệ thống hook (actions và filters), các loại bài viết tùy chỉnh (custom post types), metadata, cũng như cấu trúc tiêu chuẩn của plugin và theme. Kiến thức về HTML, CSS và JavaScript cơ bản sẽ rất hữu ích cho việc tạo ra các giao diện người dùng tương tác trên trang web.

Làm thế nào để gỡ lỗi các vấn đề trong plugin WooCommerce tùy chỉnh?

Trước hết, hãy đảm bảo rằng… wp-config.php Tệp đã được mở. WP_DEBUG 和 WP_DEBUG_LOGHãy ghi lại các lỗi vào tệp nhật ký. Thứ hai, hãy tận dụng tối đa những thông tin đó. WooCommerce Hệ thống nhật ký tích hợp sẵn, thông qua… wc_get_logger() Hàm ghi lại thông tin tại các điểm then chốt trong quá trình thực thi. Đối với các vấn đề liên quan đến phía trước (frontend), hãy sử dụng công cụ phát triển của trình duyệt (gồm console và mục Network) để kiểm tra. Ngoài ra, bạn có thể tạm thời vô hiệu hóa các tiện ích bổ sung (plugin) và chuyển sang chủ đề mặc định của trình duyệt để loại trừ khả năng xảy ra xung đột.

Tôi đã sửa đổi bộ lọc giá, nhưng tại sao giá của các sản phẩm trong danh sách sản phẩm ở phía sau hệ thống cũng thay đổi?

Đây là một vấn đề phổ biến. Nhiều bộ lọc liên quan đến giá sẽ ảnh hưởng đồng thời đến cả phần trước (frontend) và phần sau (backend) của ứng dụng. Để tránh tình trạng này, bạn cần sử dụng các điều kiện trong hàm xử lý bộ lọc để giới hạn phạm vi tác động của chúng. Điều này thường được thực hiện bằng cách is_admin() && ! defined( 'DOING_AJAX' ) Hãy kiểm tra xem liệu hiện tại có đang ở giao diện quản trị nền (backend management interface) hay không, và đảm bảo rằng không có yêu cầu AJAX nào đang được thực hiện (vì các thao tác như cập nhật giỏ hàng được thực hiện thông qua AJAX, và việc này đòi hỏi phải có tính toán giá cả). Trong các ví dụ trước đây, chúng ta đã trình bày cách xử lý tình huống này rồi.

自定义的商品类型在订单中显示为“简单商品”，怎么办？

Đây là lý do tại sao… WooCommerce Khi lưu trữ hình ảnh sản phẩm trong đơn hàng, có thể sẽ xảy ra tình trạng không thể nhận diện đúng loại sản phẩm tùy chỉnh của bạn theo mặc định. Bạn cần đảm bảo rằng thông tin về loại sản phẩm được truyền đạt chính xác khi thêm sản phẩm vào giỏ hàng. Hãy kiểm tra lại các bước thực hiện này. WC_Product_Custom Liệu lớp có kế thừa đúng cách không? WC_Product Và cũng đã thiết lập các thông số cần thiết. $this->product_typeNgoài ra, khi lấy sản phẩm từ đơn hàng,WooCommerce Có thể sẽ được tạo ra một đối tượng (instance) của kiểu cơ bản (basic type). WC_Product Đối tượng. Để đảm bảo việc khởi tạo (instantiation) đúng cách, bạn có thể cần sử dụng… woocommerce_order_get_items Sử dụng các bộ lọc (filters) để tương ứng với các loại dữ liệu tùy chỉnh của bạn.

Làm thế nào để đảm bảo rằng plugin tùy chỉnh của tôi tương thích với các bản cập nhật sắp tới của WooCommerce?

Chìa khóa để duy trì tính tương thích là phải luôn theo kịp các thực tiễn phát triển chính thức. Hãy sử dụng những công cụ hoặc phương pháp được khuyến nghị bởi nhà phát triển. WooCommerce Hãy sử dụng các API và công cụ hook được công khai; tránh việc trực tiếp sửa đổi các tệp cốt lõi hoặc sử dụng các lớp/phương thức chưa được công bố. Hãy khai báo rõ ràng các phiên bản hỗ trợ (compatibility versions) trong phần thông tin đầu của plugin (plugin header information). WooCommerce Phiên bản (Version)WC tested up toĐịnh kỳ… WooCommerce Hãy thử nghiệm trên phiên bản thử nghiệm hoặc phiên bản mới nhất. Hãy theo dõi những thông tin mới nhất. WooCommerce Truy cập blog phát triển chính thức và nhật ký cập nhật của họ để biết thông tin về các tính năng sắp bị loại bỏ cũng như các API mới.