Chuyển tới nội dung chính

1. Admin Hooks: Dữ Liệu Sản Phẩm (Products)

Sicommerce khai báo nhiều Hook liên quan đến CRUD sản phẩm trong Giao diện CMS Quản Trị. Các hooks được đăng ký trong bootstrap/products.php.

1.1 Hooks Form Thêm/Sửa Sản Phẩm​

Filter manage_products_input – Thêm Field​

add_filter('manage_products_input', function($fields) {
    // $fields là mảng các nhóm field (left, right, bottom...)
    
    // Thêm field vào cột trái
    $fields['left']['lo_hang_code'] = [
        'field' => 'lo_hang_code',
        'label' => 'Mã Lô Hàng',
        'type'  => 'text',
    ];
    
    return $fields;
});

Lưu ý: Dùng cùng tên filter manage_products_input nhưng với $buttons (tham số thứ 2 của callback) để thêm nút action tùy chỉnh.

Action admin_products_controller_save_init – Đăng Ký Metabox​

Được gọi trong quá trình init của ProductController. Dùng để đăng ký các Metabox tùy chỉnh:

add_action('admin_products_controller_save_init', function() {
    // Đăng ký Metabox tab Thông tin bổ sung
});

1.2 Hooks Lưu Dữ Liệu Sản Phẩm​

Hook TypeHook NamePriorityTham SốMô Tả
Filtercheck_save_products_before10($error, $data, $id)Validate trước khi INSERT/UPDATE. Return $error (SkdError hoặc null)
Filtersave_products_object_add10($id, $pType, $args)Sau khi INSERT sản phẩm mới
Filtersave_products_object_edit10($id, $pType, $args)Sau khi UPDATE sản phẩm
Filtersave_products_object10($id, $pType, $args)Sau cả Add và Update
// Validate tùy chỉnh trước khi lưu
add_filter('check_save_products_before', function($error, $data, $id) {
    if(empty($data['custom_barcode'])) {
        return skd_error('Vui lòng nhập mã barcode!');
    }
    return $error;
}, 10, 3);

// Lưu metadata sau khi thêm sản phẩm
add_filter('save_products_object_add', function($id, $pType, $args) {
    $barcode = request()->input('custom_barcode');
    if(!empty($barcode)) {
        Product::updateMeta($id, 'barcode', $barcode);
    }
    return $id;
}, 10, 3);

// Chạy cho cả Add và Edit
add_filter('save_products_object', function($id, $pType, $args) {
    // Sync sản phẩm lên Shopee...
    return $id;
}, 20, 3);

Tham số $pType: Loại sản phẩm ('product' hoặc 'variations').
Tham số $args: Mảng data đầy đủ của request.

1.3 Hooks Giao Diện Danh Sách (Table View)​

Hook TypeHook NameMô Tả
Filtermanage_products_inputThêm/sửa field trong form Add/Edit
Actionadmin_after_products_table_viewThêm Popup/Modal ẩn trong trang Danh sách SP
Actionadmin_page_after_products_saveThêm Popup/Modal trong trang Add/Edit SP (VD: Variations Modal)
// Thêm modal "Cập nhật giá hàng loạt" vào trang danh sách
add_action('admin_after_products_table_view', function() {
    echo '<div id="modal-bulk-price" class="modal">';
    echo '<!-- Form cập nhật giá -->';
    echo '</div>';
});

1.4 Hooks Ajax Trash/Restore/Delete​

Hook TypeHook NamePriorityTham SốMô Tả
Actionajax_trash_products_success2($response, $idList)Sau khi chuyển SP vào Thùng Rác
Actionajax_restore_products_success2($response, $idList)Sau khi phục hồi SP từ Thùng Rác
Actionajax_delete_products_after_success2($response, $idList)Sau khi xóa vĩnh viễn SP
// Ghi log khi xóa sản phẩm
add_action('ajax_trash_products_success', function($response, $idList) {
    foreach ($idList as $id) {
        \Log::info('Product trashed', ['id' => $id]);
    }
}, 5, 2);

// Xóa dữ liệu plugin liên quan khi SP bị xóa vĩnh viễn
add_action('ajax_delete_products_after_success', function($response, $idList) {
    DB::table('your_plugin_stock')->whereIn('product_id', $idList)->delete();
}, 10, 2);

1.5 Hook Xóa Sản Phẩm (Model Event)​

// Chạy sau khi xóa vĩnh viễn 1 sản phẩm (từ Model event)
add_action('delete_product_success', function($productId) {
    DB::table('your_plugin_data')->where('product_id', $productId)->delete();
});

1.6 Hooks Collection (Gắn Flag Bán Chạy / Hot / Yêu Thích)​

Khi Admin click icon flag (yêu thích/bán chạy/hot) trong bảng danh sách, ajax Ecommerce\Ajax\Admin\ProductAjax::saveCollection đảo giá trị cột status1 / status2 / status3 và lưu bằng Product::insert().

Hook ajax_save_products_collection_success không tồn tại. Handler này không phát hook riêng — muốn chạy tác vụ sau khi flag đổi, hãy bám vào hook lưu sản phẩm chung:

add_action('save_products_object_edit', function($id, $request) {

    $product = Product::find($id);

    if(!empty($product) && $product->status2 == 1) {
        // Sản phẩm đang được đánh dấu "Bán chạy"
        // Sync lên Elasticsearch index...
    }

}, 10, 2);

Nhãn, icon và khoá tìm kiếm của từng flag đổi được qua các filter động:

Hook NameLoạiMô Tả
products_collections_status{1,2,3}_namefilterTên hiển thị của flag
products_collections_status{1,2,3}_iconfilterIcon của flag
products_collections_status{1,2,3}_search_activefilterBật/tắt flag trong form tìm kiếm
products_collections_status{1,2,3}_search_keyfilterKhoá tìm kiếm của flag