Name: Khuyến mãi flash sale
Availability: InStock

ProductFlashSale — Tài liệu giới thiệu (VI)

Tổng quan

ProductFlashSale là plugin khuyến mãi chớp nhoáng (Flash Sale) cho hệ thống cửa hàng của GP247. Plugin giúp bạn:

Thiết lập mức giá khuyến mãi theo thời gian cho từng sản phẩm.
Quản lý tồn kho Flash Sale độc lập (stock/sold) và thứ tự hiển thị (sort).
Hiển thị danh sách sản phẩm đang Flash Sale ở trang riêng và block trên trang chủ.

Yêu cầu

Bắt buộc cài đặt: gp247/shop.

Tính năng chính

Quản trị:
- Trang quản trị riêng: thêm/sửa/xóa cấu hình Flash Sale cho sản phẩm.
- Trường cấu hình: product_id, stock, sold, sort, price_promotion, date_start, date_end, status_promotion.
- Tự tạo/đồng bộ bản ghi khuyến mãi (shop_product_promotion) khi thêm/sửa Flash Sale.
- Tạo bảng dữ liệu riêng shop_product_flash khi cài đặt plugin.
Front-end:
- Trang danh sách: route tên product_flash_sale.index (URL: /plugin/product_flash_sale/index, có hỗ trợ đa ngôn ngữ nếu bật GP247_SEO_LANG).
- Block hiển thị Flash Sale kèm bộ đếm thời gian, tiến độ bán (sold/stock), giá khuyến mãi.
- Chỉ hiển thị hàng còn trong khung thời gian, còn hàng và đang bật khuyến mãi.
Helper sẵn có:
- gp247_product_flash($limit = 8, $paginate = false) — lấy danh sách sản phẩm Flash Sale.
- gp247_product_flash_check_over($productId, $quantity) — kiểm tra vượt số lượng còn lại.
- gp247_product_flash_update_stock($productId, $quantity) — tăng số đã bán (sold).

Logic xử lý

Trước khi đơn hàng được tạo: hệ thống kiểm tra số lượng còn lại của sản phẩm Flash Sale dựa trên bảng shop_product_flash (trường stock và sold).
- Tham chiếu helper: gp247_product_flash_check_over($productId, $quantity).
Khi đơn hàng được tạo: hệ thống tăng giá trị sold tương ứng trong bảng shop_product_flash.
- Tham chiếu helper: gp247_product_flash_update_stock($productId, $quantity).

Hướng dẫn cài đặt

Tham khảo chi tiết theo tài liệu chính thức: Hướng dẫn cài đặt Extension.

Tóm tắt các bước:

Chuẩn bị mã nguồn plugin (đã có sẵn tại app/GP247/Plugins/ProductFlashSale).
Vào trang quản trị:
- Mở mục Extensions/Plugins (trình quản lý extension).
- Tìm "Product Flash Sale" và nhấn Install.
- Sau khi cài đặt, nhấn Enable để kích hoạt.
Hệ thống sẽ:
- Thêm menu quản trị dưới nhóm Catalog trỏ đến admin_product_flash_sale.index.
- Tự tạo bảng dữ liệu shop_product_flash.
Cấu hình Flash Sale cho sản phẩm tại trang quản trị:
- Chọn sản phẩm (không thuộc nhóm Group), nhập stock, sort.
- Thiết lập price_promotion, date_start, date_end, bật status_promotion.
- Lưu để tạo/đồng bộ thông tin khuyến mãi.
Xóa cache hệ thống (nếu bật cache) để đảm bảo nhận cấu hình mới.

Sử dụng giao diện (Front-end)

Trang danh sách Flash Sale: dùng route product_flash_sale.index để gắn link trong theme.

Ví dụ chèn link trong Blade:

{{-- Link to flash sale page --}}
Flash Sale

Chèn block Flash Sale vào trang chủ hoặc vị trí mong muốn:

{{-- Include Product Flash Sale block --}}
@include('Plugins/ProductFlashSale::blocks.flash_sale')

Tùy chọn (override theo template và quản lý qua admin):
1. Sao chép file view block từ plugin sang template hiện tại:
  - Nguồn: app/GP247/Plugins/ProductFlashSale/Views/blocks/flash_sale.blade.php
  - Đích: app/GP247/Templates/{TEMPLATE}/blocks/flash_sale.blade.php
2. Vào trang quản trị, mục layout_block, thêm block flash_sale vào vị trí mong muốn của giao diện.
Sử dụng helper để tự tùy biến danh sách:

{{-- Get 8 flash sale products (no paginate) --}}
@php($products = gp247_product_flash(8))

@foreach($products as $product)
    {{ $product->name }}
@endforeach

Ghi chú:

Block mẫu của plugin nằm tại app/GP247/Plugins/ProductFlashSale/Views/blocks/flash_sale.blade.php.
Bộ đếm thời gian dựa theo promotionPrice->date_end của sản phẩm và dùng jquery.countdown (CDN).
Điều kiện hiển thị: khuyến mãi đang bật, ngày hiện tại nằm trong khoảng date_start → date_end, và sold < stock.

Gỡ cài đặt / Bật tắt

Disable/Enable: thực hiện tại trang quản trị Extensions/Plugins.
Uninstall: xóa cấu hình, menu, home widget và bảng shop_product_flash do plugin tạo.

Khuyến mãi flash sale