🌐 Ngôn ngữ: 🇻🇳 Tiếng Việt (hiện tại) · 🇬🇧 English · 🇯🇵 日本語

ShopDiscount — Plugin mã giảm giá (Coupon) cho GP247 / S-Cart

Giới thiệu

ShopDiscount là plugin giúp bạn tạo và quản lý mã giảm giá (coupon) cho website bán hàng chạy trên GP247 / S-Cart 3.0. Người quản trị tạo các mã giảm giá; khách hàng nhập mã ở bước thanh toán để được giảm tiền cho đơn hàng. Tài liệu này dành cho chủ shop và người quản trị (không cần rành lập trình): đọc xong bạn sẽ biết cách cài, tạo mã giảm giá, và hiểu khách dùng mã như thế nào.

Tính năng chính

• Hai kiểu giảm giá:
  • Point — giảm một số tiền cố định (ví dụ giảm 50.000đ).
  • Percent (%) — giảm theo phần trăm giá trị đơn (ví dụ giảm 10%).
• Giới hạn số lần dùng cho mỗi mã (ví dụ chỉ dùng được 100 lần).
• Yêu cầu đăng nhập (tuỳ chọn): chỉ khách đã đăng nhập mới dùng được mã, và mỗi khách chỉ dùng 1 lần.
• Ngày hết hạn cho mã.
• Bật / tắt từng mã bất cứ lúc nào.
• Hỗ trợ nhiều cửa hàng (multi-store): chọn mã áp dụng cho cửa hàng nào.
• Áp mã ngay tại trang thanh toán: khách nhập mã → thấy dòng giảm giá và tổng tiền cập nhật ngay (không phải tải lại trang).

Yêu cầu hệ thống

Nếu website chưa cài gp247/shop, plugin sẽ không hoạt động đúng (nó phục vụ cho chức năng bán hàng).

Cài đặt

Bạn có 4 cách cài (giống mọi extension của GP247, gồm cả cài bằng dòng lệnh CLI). Cách nhanh nhất khi bạn đã có sẵn thư mục plugin:

1. Chép thư mục plugin vào đúng vị trí trên máy chủ:

   app/GP247/Plugins/ShopDiscount
   

2. Đăng nhập admin bằng tài khoản có quyền quản lý extension.

3. Vào menu Plugin, tìm ShopDiscount trong danh sách rồi bấm Cài đặt (Install). Nếu thành công, bạn sẽ thấy thông báo cài đặt thành công và một mục menu mới tên Discount (Coupon/Discount) xuất hiện trong admin.

4. (Nếu admin vẫn hiển thị cũ) mở Terminal tại thư mục gốc website, chạy đúng dòng sau rồi Enter để xoá cache:

   php artisan optimize:clear
   

Muốn cài theo cách Online (kho extension) hoặc Import file .zip? Xem hướng dẫn cài đặt chung: Hướng dẫn cài đặt Plugin & Template cho GP247.

Cài bằng dòng lệnh (CLI, gp247 3.x)

Từ gp247 3.x, bạn có thể tải ShopDiscount từ thư viện GP247 và cài ngay bằng dòng lệnh mà không cần mở admin. Mở Terminal tại thư mục gốc website rồi chạy:

# 1) Chỉ làm 1 lần cho mỗi website: đăng ký API License (miễn phí) để kết nối thư viện GP247
php artisan gp247:ext-register-license

# 2) Tải plugin từ thư viện và cài
php artisan gp247:ext-install --type=plugin --key=ShopDiscount

• Trước bước 1, kiểm tra APP_URL trong .env là domain thật của website (không để http://localhost), vì license được gắn với domain này.
• Cài xong, plugin được bật sẵn và cache tự làm mới, bạn không cần thao tác gì thêm trong admin.
• Lệnh tự kiểm tra điều kiện khai báo trong gp247.json (phiên bản core, gói composer, plugin phụ thuộc). Nếu thiếu, lệnh dừng lại và báo rõ thiếu gì.
• Plugin này cần gói gp247/shop đã được cài; nếu thiếu, lệnh sẽ dừng lại và báo.
• Nếu thư mục app/GP247/Plugins/ShopDiscount đã có sẵn trên máy (chép thủ công hoặc có sẵn theo bộ cài), lệnh sẽ cài tại chỗ, không tải lại.
• Nếu plugin đã được cài, lệnh sẽ từ chối. Để lên bản mới, chạy php artisan gp247:ext-update --type=plugin --key=ShopDiscount.
• Thêm --json vào cuối lệnh để nhận kết quả dạng máy đọc được (dùng cho script/CI).
• Lệnh thay cho các bước 1–3 ở trên. Bước 4 vẫn giữ nguyên: nếu admin vẫn hiển thị cũ (chưa thấy menu Discount), chạy php artisan optimize:clear.
• Chi tiết: Hướng dẫn cài đặt Plugin & Template · Tra cứu lệnh.

Cách dùng (1): Người quản trị tạo mã giảm giá

1. Trong admin, mở menu Discount (Coupon/Discount).
2. Bấm nút Thêm mới (Add new).
3. Điền các ô:
   • Code — mã khách sẽ nhập (ví dụ SALE10). Chỉ dùng chữ, số và các ký tự . - _.
   • Reward — giá trị giảm: nếu chọn Point thì đây là số tiền; nếu chọn Percent thì đây là số phần trăm.
   • Type — chọn Point (giảm số tiền) hoặc Percent (%) (giảm theo %).
   • Description — ghi chú cho mã (không bắt buộc).
   • Limit — số lần tối đa mã được dùng.
   • Login require — tích vào nếu bắt buộc khách phải đăng nhập mới dùng được.
   • Expires — ngày hết hạn (chọn từ lịch).
   • Status — tích để bật mã (bỏ tích là tắt).
   • (Chỉ khi chạy nhiều cửa hàng) chọn cửa hàng áp dụng mã.
4. Bấm Gửi (Submit) để lưu. Mã mới xuất hiện trong danh sách bên phải; cột Used cho biết mã đã được dùng bao nhiêu lần trên tổng số cho phép (ví dụ 3/100).

Cách dùng (2): Khách hàng áp mã khi thanh toán

1. Khách thêm sản phẩm vào giỏ và tiến hành Thanh toán (Checkout).
2. Ở bước xác nhận đơn, khách nhập mã vào ô coupon rồi bấm Áp dụng (Apply).
3. Nếu mã hợp lệ, một dòng giảm giá xuất hiện và tổng tiền cập nhật ngay. Muốn bỏ mã, bấm Gỡ (Remove).

Mã chỉ được chấp nhận khi: còn hiệu lực (đang bật, chưa hết hạn), còn lượt dùng, đúng cửa hàng áp dụng, và (nếu mã yêu cầu) khách đã đăng nhập và chưa dùng mã này trước đó.

Bật / tắt / gỡ plugin

• Vào admin → Plugin → ShopDiscount.
• Enable / Disable để bật hoặc tắt tạm thời (không mất dữ liệu mã đã tạo).
• Uninstall để gỡ hẳn — thao tác này xoá dữ liệu mã giảm giá của plugin, hãy cân nhắc trước khi làm.

Hỏi & Đáp (Q&A)

Câu 1: Khách nhập mã giảm giá ở đâu? Ở bước xác nhận trong trang thanh toán (checkout) có ô nhập mã coupon. Nhập mã rồi bấm Áp dụng.

Câu 2: "Point" và "Percent" khác nhau thế nào? Point giảm một số tiền cố định (ví dụ 50.000đ). Percent giảm theo phần trăm giá trị đơn (ví dụ 10%). Ô Reward là con số tương ứng cho kiểu bạn chọn.

Câu 3: Cài xong nhưng không thấy menu "Discount" trong admin? Chạy php artisan optimize:clear để xoá cache rồi tải lại trang admin. Cũng kiểm tra plugin đã ở trạng thái đã cài + đang bật (Enable) trong menu Plugin chưa.

Câu 4: Khách áp mã nhưng không thấy giảm tiền? Kiểm tra mã còn bật (Status), chưa hết hạn, còn lượt dùng (Used chưa đạt Limit), và đúng cửa hàng. Nếu mã bật "Login require" thì khách phải đăng nhập mới dùng được.

Câu 5: Một mã dùng được bao nhiêu lần? Bằng số bạn nhập ở ô Limit. Khi số lần dùng (Used) đạt tới Limit, mã báo hết lượt và không dùng được nữa.

Câu 6: Gỡ (Uninstall) plugin có làm mất các mã đã tạo không? Có. Uninstall sẽ xoá dữ liệu mã giảm giá. Nếu chỉ muốn tạm ngừng, hãy dùng Disable thay vì Uninstall.

Câu 7: Tôi chạy nhiều cửa hàng thì mã áp dụng thế nào? Khi website bật chế độ multi-store, lúc tạo mã bạn chọn cửa hàng áp dụng. Mã chỉ có hiệu lực ở cửa hàng đã chọn.

Câu 8: Plugin có cần gp247/shop không? Có. ShopDiscount phục vụ chức năng bán hàng nên bắt buộc website đã cài gp247/shop.

Câu 9: "Login require" nghĩa là gì? Nghĩa là chỉ khách đã đăng nhập mới dùng được mã đó, và mỗi tài khoản chỉ dùng mã đó một lần.

Câu 10: Nâng cấp lên bản 3.0 thế nào? Bản 3.0 này viết cho GP247 Core 3.0. Nếu bạn đang ở plugin 2.x, có thể cập nhật tại chỗ: vào admin → Plugin → From library, bấm Check update, rồi bấm Update 3.0 (plugin cho phép cập nhật trực tiếp từ 2.0 trở lên — xem requireUpdateFrom). Cấu trúc dữ liệu mã vẫn giữ nguyên nên các mã giảm giá cũ được bảo toàn. Nếu bạn còn ở bản 1.x cũ, hãy cài mới bản 3.0 trên nền Core 3.0 (không hỗ trợ nâng cấp trực tiếp 1.x → 3.0).

Lịch sử thay đổi

_{📅 Cập nhật lần cuối: 2026-10-22 · ✍️ Tác giả (Author): GP247}