[GP]247
🌐 Ngôn ngữ: 🇻🇳 Tiếng Việt (hiện tại) · 🇬🇧 English
Tài liệu này hướng dẫn cài đặt và sử dụng plugin Product Flash Sale — công cụ bán hàng theo khung giờ, có giới hạn số suất ("chỉ 20 suất, trong 3 tiếng"). Tài liệu dành cho chủ cửa hàng và người quản trị site GP247, không yêu cầu biết lập trình. Đọc xong, bạn tự tạo được một đợt Flash Sale, gắn nó lên trang chủ và hiểu vì sao hệ thống đôi khi từ chối một thao tác.
Cửa hàng GP247 vốn đã có khuyến mãi: một mức giá áp dụng trong một khoảng ngày, thường kéo dài hàng tuần. Vì thế khối "Promotion products" mặc định của cửa hàng không có đồng hồ đếm ngược — đếm ngược cho một chương trình dài hai tháng là tín hiệu khan hiếm giả.
Flash Sale là một lời hứa đếm được: chỉ N suất, trong khung giờ này. Plugin thêm đúng hai thứ vào khuyến mãi có sẵn: số suất của đợt và thứ tự hiển thị. Nhờ vậy đồng hồ đếm ngược và thanh "đã bán / còn lại" ở đây là thật.
gp247/shop (phần bán hàng). Plugin không chạy nếu thiếu gói này.Đặt thư mục mã nguồn plugin vào đúng vị trí trên site của bạn:
app/GP247/Plugins/ProductFlashSale
Đăng nhập trang quản trị, vào menu Extensions / Plugins (Quản lý Plugin).
Tìm dòng Product Flash Sale, nhấn Install, sau đó nhấn Enable.
Nếu thành công, hệ thống hiện thông báo cài đặt thành công. Nếu báo không tương thích, gần như chắc chắn site đang chạy core cũ hơn 3.0 — hãy cập nhật core trước.
Hệ thống tự làm ba việc: tạo bảng dữ liệu shop_product_flash (nếu chưa có), thêm mục menu dưới nhóm Catalog (Danh mục), và đặt sẵn dải Flash Sale xuống cuối trang chủ của các cửa hàng chưa có khối này (một dòng trong màn Layout block, đang bật). Khối product_flash_sale cũng xuất hiện sẵn trong ô chọn của màn Layout block — plugin cung cấp thẳng từ thư mục của nó, không copy file nào vào template.
Nếu bạn xoá hoặc chuyển dải đi chỗ khác, cập nhật plugin sau này sẽ không đặt lại — vị trí hiển thị là quyết định của bạn, plugin chỉ gợi ý một lần lúc cài.
Nếu site của bạn bật cache, xoá cache một lần:
php artisan optimize:clear
Vào menu Product Flash Sale vừa xuất hiện. Nếu thấy màn hình hai cột (bên trái là biểu mẫu, bên phải là danh sách trống) thì plugin đã sẵn sàng.
Cài lại hoặc cập nhật plugin không làm mất dữ liệu. Bảng chỉ được tạo khi chưa có, mục menu chỉ thêm khi còn thiếu. Chỉ khi bạn bấm Uninstall thì bảng mới bị xoá.
Vào menu Product Flash Sale.
Ở cột trái, ô Chọn sản phẩm: gõ vài chữ trong tên sản phẩm rồi chọn từ danh sách gợi ý.
Nhập Số lượng bán — đây là số suất tối đa của đợt, ví dụ 20.
Nhập Giá khuyến mãi. Giá nhập theo tiền cơ sở của site (dòng chữ nhỏ dưới ô sẽ nhắc bạn đang nhập theo đơn vị nào).
Chọn Bắt đầu và Kết thúc. Lịch có cả giờ và phút — đây là điểm khác với khuyến mãi thường, bạn đặt được đợt chạy từ 20:00 tới 23:00 cùng ngày.
Nhập Sắp xếp (số nhỏ hiển thị trước trên trang bán hàng) và bật công tắc Trạng thái.
Nhấn Lưu. Nếu thành công, đợt bán hiện ngay ở danh sách bên phải với thanh tiến độ 0 / 20.
Mở trang Flash Sale trên site để kiểm tra (xem địa chỉ ở mục dưới). Nếu đang trong khung giờ, bạn sẽ thấy sản phẩm kèm đồng hồ đếm ngược.
Muốn sửa: nhấn biểu tượng bút chì ở dòng tương ứng, sửa rồi Lưu. Muốn dừng đợt sớm: tắt công tắc Trạng thái, hoặc xoá hẳn dòng đó bằng biểu tượng thùng rác (xoá dòng cũng gỡ luôn mức giá khuyến mãi khỏi sản phẩm).
Địa chỉ trang danh sách:
https://<tên-miền-của-bạn>/plugin/product_flash_sale/index
Nếu site bật đường dẫn đa ngôn ngữ (GP247_SEO_LANG), địa chỉ có thêm mã ngôn ngữ, ví dụ /vi/plugin/product_flash_sale/index.
Trang này cũng là một loại trang trong màn Layout block của quản trị, nên bạn gắn thêm banner, khối HTML hay trang tĩnh vào đó như mọi trang khác. Khi đang có đợt chạy, trang được khai báo vào sitemap.xml để công cụ tìm kiếm biết tới.
Cách dễ nhất là dùng màn Layout block trong quản trị, không cần sửa file nào:
Vào Layout block → Add block layout.
Chọn Type = View.
Ở ô Position, chọn vị trí muốn hiển thị (ví dụ Position Bottom); ở ô Page, chọn front_home — Home page.
Ở ô Text, chọn khối tên product_flash_sale.
Đây là khối của plugin, có sẵn ngay khi plugin được bật. (Khối shop_product_promotion ngay cạnh là khối "sản phẩm khuyến mãi" có sẵn của cửa hàng — khối khác, không có đồng hồ đếm ngược.)
Tick Active rồi Submit, sau đó tải lại trang chủ. Nếu đang có đợt chạy, bạn sẽ thấy dải sản phẩm cuộn ngang, mỗi thẻ có phần trăm giảm giá, số đã bán / còn lại và đồng hồ đếm ngược. Nếu không có đợt nào, dải này tự ẩn — trang chủ không bị khoảng trống.
Không thấy
product_flash_saletrong ô Text? Kiểm tra plugin đang Enable (khối chỉ xuất hiện khi plugin bật), rồi chạyphp artisan optimize:clearvà tải lại màn Layout block. Site đang dùng template riêng (không phải GP247Front) thì xem mục ngay dưới.
Nếu site dùng template riêng (tên khác GP247Front): plugin cung cấp khối theo tên template, nên với template riêng bạn tạo một file một dòng:
app/GP247/Templates/{TÊN_TEMPLATE}/blocks/product_flash_sale.blade.php
với nội dung:
@include('Plugins/ProductFlashSale::blocks.product_flash_sale')
Sau đó khối product_flash_sale xuất hiện trong ô Text như trên. (Khối có sẵn của cửa hàng cũng hoạt động đúng như vậy.)
Cách chèn tay (khi bạn muốn ghim cứng vị trí trong giao diện, không qua Layout block): mở file trang chủ của template, ví dụ
app/GP247/Templates/{TÊN_TEMPLATE}/screen/home.blade.php
rồi chèn đúng một dòng sau vào chỗ muốn hiển thị:
@include('Plugins/ProductFlashSale::blocks.product_flash_sale')
Đặt một liên kết tới trang Flash Sale ở menu hay bất cứ đâu trong giao diện:
<a href="{{ gp247_route_front('product_flash_sale.index') }}">Flash Sale</a>
Dùng gp247_route_front(...) chứ không phải route(...), để đường dẫn giữ đúng mã ngôn ngữ khi site bật đa ngôn ngữ.
Muốn đổi giao diện trang danh sách mà không sửa mã plugin: tạo file
app/GP247/Templates/{TÊN_TEMPLATE}/Plugins/ProductFlashSale/front_flash_sale.blade.php
Bản của template sẽ được dùng thay cho bản mặc định của plugin.
Bạn sửa được giao diện của dải mà không đụng vào mã plugin, và bản sửa vẫn còn nguyên sau khi cập nhật plugin. Có ba cách, chọn cách nhẹ nhất đủ dùng.
Cách 1 — Bọc dải (khuyên dùng khi chỉ muốn thêm thắt). Giữ nguyên dải của plugin, thêm markup của bạn ở quanh nó. Tạo file:
app/GP247/Templates/{TÊN_TEMPLATE}/blocks/product_flash_sale.blade.php
với nội dung:
<div class="container-x pt-6">
<h2 class="section-title">Giờ vàng hôm nay</h2>
</div>
@includeIf('Plugins/ProductFlashSale::blocks.product_flash_sale')
Dùng @includeIf chứ không phải @include: nếu sau này bạn gỡ plugin, @includeIf chỉ đơn giản không hiện gì, còn @include sẽ làm trang báo lỗi "View not found".
Cách 2 — Viết lại hẳn dải. Cũng là file ở đường dẫn trên, nhưng bạn tự viết toàn bộ markup và tự lấy dữ liệu:
@php
$products = gp247_product_flash(10);
@endphp
@foreach ($products as $product)
{{-- markup của riêng bạn --}}
@endforeach
Cách 3 — Ghi đè một view bên trong plugin. Khi chỉ muốn đổi một mảnh nhỏ (ví dụ thẻ sản phẩm, hoặc trang danh sách) mà giữ nguyên phần còn lại, tạo file cùng tên dưới:
resources/views/vendor/Plugins/ProductFlashSale/
Ví dụ resources/views/vendor/Plugins/ProductFlashSale/partials/flash_card.blade.php sẽ thay thế thẻ sản phẩm của plugin ở mọi nơi nó xuất hiện. Cách này áp dụng cho mọi view của plugin.
Lưu ý chung: cách 2 và cách 3 tạo ra một bản sao đóng băng — plugin cập nhật giao diện về sau thì phần bạn đã ghi đè không nhận thay đổi đó. Cách 1 không có nhược điểm này. Muốn quay về bản gốc, chỉ cần xoá file bạn đã tạo.
Suất của đợt bán được trừ và hoàn tự động theo vòng đời đơn hàng — bạn không phải chỉnh tay:
Một đợt Flash Sale thuộc về cửa hàng sở hữu sản phẩm, nên phạm vi hiển thị đi theo đúng luật chung của site:
Lưu ý: màn tạo đợt Flash Sale nằm ở khu quản trị gốc. Trong mô hình sàn, người của gian hàng không tự tạo đợt Flash Sale ở khu vendor được — đợt bán do quản trị sàn tạo.
Khi tạo hoặc sửa một đợt bán
Khi sản phẩm hiển thị trên trang bán hàng
đã bán = số lượng) tự rời khỏi dải Flash Sale.Khi khách mua hàng
shop_product_flash của plugin. Các mức giá khuyến mãi đã tạo cho sản phẩm không bị xoá theo. Khối product_flash_sale biến mất khỏi danh sách chọn cùng với plugin (plugin không để lại file nào trong template), và vị trí đã gắn khối đó chỉ đơn giản không hiển thị gì.Đường dẫn trang bán hàng: GET /plugin/product_flash_sale/index (tên route product_flash_sale.index).
Đường dẫn quản trị: {GP247_ADMIN_PREFIX}/product_flash_sale, /create, /edit/{id}.
Bảng dữ liệu: shop_product_flash gồm id, product_id, stock (số suất), sold (đã bán), sort.
Giá và khung giờ lưu ở bảng khuyến mãi có sẵn của cửa hàng: shop_product_promotion.
Namespace view/ngôn ngữ: Plugins/ProductFlashSale.
Các hàm dùng lại được trong giao diện:
gp247_product_flash($limit = 8, $paginate = false); // danh sách sản phẩm đang Flash Sale
gp247_product_flash_check_over($productId, $quantity); // còn đủ suất không (true = còn)
gp247_product_flash_update_stock($productId, $quantity); // trừ suất, trả false khi không đủ
gp247_product_flash_release_stock($productId, $quantity); // trả suất về đợt bán
Ví dụ tự dựng danh sách trong giao diện:
@php
$products = gp247_product_flash(8);
@endphp
@foreach ($products as $product)
<div>{{ $product->getName() }} — đã bán {{ $product->pf_sold }}/{{ $product->pf_stock }}</div>
@endforeach
Câu 1: Tôi tạo đợt xong nhưng trang Flash Sale trống, vì sao?
→ Thường là do một trong ba lý do: chưa tới giờ bắt đầu hoặc đã quá giờ kết thúc; công tắc Trạng thái đang tắt; hoặc sản phẩm chưa đạt điều kiện hiển thị chung (chưa bật bán, chưa được duyệt, hoặc thiếu mô tả ở ngôn ngữ đang xem).
Câu 2: Đồng hồ đếm ngược lấy mốc thời gian ở đâu?
→ Lấy từ thời điểm Kết thúc của chính đợt bán đó. Mỗi thẻ sản phẩm có đồng hồ riêng theo đợt của nó.
Câu 3: Khách huỷ đơn thì số suất có được trả lại không?
→ Có, tự động. Huỷ đơn, xoá đơn hoặc xoá một dòng hàng trong đơn đều trả suất về cho đợt bán.
Câu 4: Hai khách cùng bấm mua suất cuối cùng thì sao?
→ Chỉ một người mua được. Người còn lại nhận thông báo vượt số lượng và đơn không được tạo — hệ thống trừ suất theo cách chống tranh chấp, không phải "ai cũng qua rồi tính sau".
Câu 5: Tôi muốn dừng đợt ngay lập tức?
→ Tắt công tắc Trạng thái của dòng đó, hoặc sửa thời điểm Kết thúc về quá khứ. Xoá dòng cũng được, nhưng khi đó mức giá khuyến mãi của sản phẩm cũng bị gỡ.
Câu 6: Cập nhật plugin lên bản mới có mất các đợt đã tạo không?
→ Không. Cài lại và cập nhật đều giữ nguyên dữ liệu; chỉ thao tác Uninstall mới xoá bảng.
Câu 7: Sản phẩm vừa có Flash Sale vừa có giá theo nhóm khách hàng thì khách trả giá nào?
→ Trả mức thấp hơn. Giá Flash Sale là giá nền, mức giá theo nhóm chỉ có thể kéo xuống thấp hơn. Dù trả giá nào, khách vẫn tiêu một suất của đợt.
Câu 8: Trên sàn nhiều gian hàng, gian hàng có tự tạo đợt Flash Sale được không?
→ Không. Màn tạo đợt nằm ở khu quản trị gốc, nên đợt bán do quản trị sàn tạo.
Câu 9: Tôi tắt plugin cho riêng một cửa hàng được không?
→ Không. Bật/tắt plugin áp dụng cho toàn site. Tuy nhiên cửa hàng nào không tạo đợt nào thì cũng không có gì hiển thị, nên thực tế không ảnh hưởng tới các cửa hàng khác.
Câu 10: Dải Flash Sale không hiện trên trang chủ dù đã có đợt đang chạy?
→ Plugin không tự đặt dải lên trang chủ — bạn chọn vị trí. Kiểm tra đã thêm khối product_flash_sale ở màn Layout block cho trang front_home chưa, hoặc template đã có dòng @include('Plugins/ProductFlashSale::blocks.product_flash_sale') chưa. Lưu ý đừng nhầm với khối shop_product_promotion — đó là khối khuyến mãi có sẵn của cửa hàng.
📅 Cập nhật lần cuối: 2026-09-22 · ✍️ Tác giả (Author): GP247
Vui lòng đăng nhập để viết đánh giá.
Đăng nhậpChưa có đánh giá nào. Hãy là người đầu tiên đánh giá sản phẩm này.
Plugin
Plugin
Plugin
Plugin