Hook action và filter

Đặ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 sẽ mất khi cập nhật, và phần lớn mã nguồn đã được mã hoá nên cũng không sửa được.

Hook riêng của SuperShip

Ngoài ra plugin phát action vn_checkout_setting_general để dựng tab Cài đặt chung — đây là hook của module dùng chung, không phải của riêng SuperShip.

Hook của module trang thanh toán

Tab Cài đặt chung của SuperShip là module dùng chung của mọi plugin vận chuyển DevVN, nên nó mang theo cả bộ hook riêng: trường checkout, cách tải dữ liệu địa chỉ, định dạng giá, tính cân nặng giỏ hàng, sổ địa chỉ, tách đơn. Danh sách đầy đủ nằm ở bài hook của plugin GHTK, mục Filter — trang thanh toán và địa chỉ — dùng được y hệt khi website chạy SuperShip.

Ví dụ hay dùng

Đổi câu báo phí sang tiếng Việt

add_filter( 'dssw_title_shipping_fee_failed', function ( $text ) {
    return 'Phí vận chuyển sẽ báo sau khi xác nhận đơn.';
} );

Không hiện phương thức nào khi SuperShip không tính được cước

Mặc định plugin vẫn đưa ra một phương thức "báo phí sau". Muốn giấu hẳn để khách không đặt được đơn không rõ phí:

add_filter( 'dssw_notify_later_rate', '__return_empty_array' );

Cộng thêm phụ phí đóng gói vào phí ship

SuperShip không có filter riêng cho số tiền, nên dùng hook chuẩn của WooCommerce:

add_filter( 'woocommerce_package_rates', function ( $rates, $package ) {
    foreach ( $rates as $rate ) {
        if ( 'devvn_supership' === $rate->get_method_id() ) {
            $rate->set_cost( $rate->get_cost() + 5000 );
        }
    }
    return $rates;
}, 20, 2 );

Miễn phí ship cho một hạng khách hàng

add_filter( 'woocommerce_package_rates', function ( $rates, $package ) {
    $user = wp_get_current_user();
    if ( ! in_array( 'vip_customer', (array) $user->roles, true ) ) {
        return $rates;
    }
    foreach ( $rates as $rate ) {
        if ( 'devvn_supership' === $rate->get_method_id() ) {
            $rate->set_cost( 0 );
        }
    }
    return $rates;
}, 20, 2 );

Đọc dữ liệu vận đơn từ đơn hàng

Plugin lưu mọi thứ vào meta của đơn với tiền tố _supership_:

$order = wc_get_order( $order_id );
$code   = $order->get_meta( '_supership_code' );    // Mã vận đơn
$status = $order->get_meta( '_supership_status' );  // Trạng thái
$fee    = $order->get_meta( '_supership_fee' );     // Phí vận chuyển
$weight = $order->get_meta( '_supership_weight' );  // Cân nặng SuperShip cân lại

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