Hook action và filter

Cần hiểu luồng Open API v3 phía sau (token, sản phẩm, đơn hàng, giới hạn gọi)? Xem bài tích hợp API Nhanh.vn.

Đặt code ở đâu

Đặt trong functions.php của child theme, hoặc tốt hơn là một plugin nhỏ riêng để đổi giao diện không mất code. Đừng sửa file trong thư mục plugin — mọi thay đổi mất khi cập nhật.

Hai filter view_nhanhvn_depot_priority và nhanhvn_option được đọc ngay lúc plugin khởi động, trước khi theme nạp — muốn chúng có tác dụng thì đặt trong một file ở wp-content/mu-plugins/.

Chỗ ghi "v2" hay "v3" trong bảng là hook chỉ chạy khi website kết nối bằng API phiên bản đó.

Action

Filter — phí vận chuyển và kho

Filter — dữ liệu đơn gửi lên Nhanh.vn

Filter — đăng đơn tự động, hàng loạt và hộp thoại

Filter — webhook và trạng thái đơn

Filter — đồng bộ sản phẩm và khách hàng

Filter — xem cửa hàng còn hàng và template

Filter — kết nối API, giới hạn gọi và gỡ lỗi

Ví dụ hay dùng

Cộng phí đóng gói vào phí ship Nhanh.vn

add_filter( 'devvn_nhanhvn_rate', function ( $rate ) {
    if ( $rate['cost'] > 0 ) {
        $rate['cost'] += 5000;
    }
    return $rate;
} );

Điều kiện cost > 0 để không cộng vào dòng "Phí vận chuyển sẽ báo sau.".

Đổi chữ "Phí vận chuyển sẽ báo sau."

add_filter( 'devvn_title_shipping_fee_failed', function () {
    return 'Shop sẽ gọi báo phí ship khi xác nhận đơn';
} );

Không tự đăng đơn chuyển khoản chưa thanh toán

add_filter( 'skip_auto_create_order', function ( $skip, $order_id ) {
    $order = wc_get_order( $order_id );
    if ( $order && 'bacs' === $order->get_payment_method() && ! $order->is_paid() ) {
        return true;
    }
    return $skip;
}, 10, 2 );

Ghi ID đơn Nhanh.vn vào ghi chú đơn sau khi đăng

add_action( 'devvn_after_nhanhvn_create_order', function ( $order_id ) {
    $order = wc_get_order( $order_id );
    if ( ! $order ) {
        return;
    }
    $order->add_order_note( 'Đã đăng lên Nhanh.vn, ID đơn: ' . $order->get_meta( 'nhanhvn_orderid' ) );
} );

Cộng khối lượng bao bì vào kiện hàng (API v3)

add_filter( 'nhanhvn_order_package_weight', function ( $weight, $order, $products ) {
    return $weight + 200; // gram
}, 10, 3 );

Ghi chú nội bộ cho đơn trên Nhanh.vn (API v3)

add_filter( 'nhanhvn_order_private_description', function ( $note, $order ) {
    return 'Đơn website #' . $order->get_order_number();
}, 10, 2 );

Không chép thông tin đăng đơn Nhanh.vn khi tách đơn

Filter devvn_split_order_exclude_meta thuộc module trang thanh toán dùng chung (tính năng tách đơn). Thêm các khoá của plugin Nhanh.vn để đơn mới tách ra không mang theo ID đơn Nhanh.vn của đơn gốc:

add_filter( 'devvn_split_order_exclude_meta', function ( $keys ) {
    return array_merge( $keys, array(
        'nhanhvn_create_order_data',
        'nhanhvn_create_order_respon',
        'nhanhvn_orderid',
        'nhanhvn_webhook_data',
        'nhanhvn_order_cancel',
        'nhanhvn_auto_status',
        'nhanhvn_auto_info',
    ) );
} );

Bật log gỡ lỗi tạm thời

add_filter( 'nhanhvn_debug', '__return_true' );

Còn vướng chỗ nào thì xem Giải đáp thắc mắc.