Hướng dẫn sử dụng Downloads Pro by HabaChat

Hướng dẫn này đi từ lúc cài module đến lúc xử lý sự cố. Mọi tên panel và nút đều đúng như trong module.

1. Cài đặt

1. Tải file ps_downloads.zip từ tài khoản của bạn trên habachat.com.
2. Vào back office → Modules → Module Manager → Upload a module, chọn file zip.
3. Bấm Install. Module tạo ba bảng dữ liệu, đăng ký các hook và tạo thư mục lưu file private_files/ kèm .htaccess chặn truy cập.
4. Sau khi cài, menu Improve có thêm mục Downloads Pro. Một bộ zip chạy được cho cả PrestaShop 8 và 9.

2. Kích hoạt giấy phép

1. Vào Module Manager, tìm Downloads Pro, bấm Configure.
2. Panel đầu tiên là Licence & Trial, hiển thị tên miền đang được cấp phép.
3. Chưa mua? Bấm Start 90-day free trial để dùng thử đủ tính năng trong 90 ngày.
4. Đã mua? Dán khoá (bắt đầu bằng v2...) vào ô Enter licence key rồi bấm Activate. Khoá gắn với đúng tên miền, chuyển shop sang tên miền khác cần khoá mới.
5. Giấy phép chỉ khoá thao tác trong back office. Khi hết hạn, bạn không gắn file mới được nữa, nhưng khách đã mua vẫn tải bình thường.

3. Gắn file vào sản phẩm

1. Vào Catalog → Products, mở sản phẩm cần bán file.
2. Chuyển sang tab Modules, tìm panel Downloadable files.
3. Ô Shown name (optional): tên khách nhìn thấy trong email và trang tài khoản. Bỏ trống thì dùng tên file gốc.
4. Bấm Choose file, chọn file trên máy, rồi bấm Attach file. File được tải lên bằng AJAX, trang tự tải lại và file xuất hiện trong bảng kèm tên gốc và dung lượng.
5. Muốn bán bộ nhiều file (ví dụ PDF + file nguồn + font)? Lặp lại bước 4, một sản phẩm gắn được nhiều file và khách sẽ nhận một link cho mỗi file.
6. Gỡ file bằng nút Remove trên dòng tương ứng.
7. Sản phẩm không cần đặt là "virtual product"; module chạy độc lập với tính năng đó.

4. Cấu hình cách giao file

Trong trang Configure, panel Downloads Pro settings có bốn tuỳ chọn:

1. Link expiry (days, 0 = never) — số ngày link còn sống tính từ lúc đơn được thanh toán. Mặc định 30. File cập nhật thường xuyên (phần mềm, bảng tính) nên để 0 hoặc số lớn.
2. Max downloads per purchase (0 = unlimited) — số lượt tải cho mỗi lần mua. Mặc định 5. Đừng đặt 1: khách rớt mạng giữa chừng là mất lượt, vì lượt được đếm trước khi truyền file.
3. Require customer login to download — bật nếu bạn muốn chỉ tài khoản đã mua tải được. Lưu ý khách mua theo chế độ khách vãng lai sẽ không đăng nhập được, hãy cân nhắc.
4. Email the download link when paid — để bật trong hầu hết trường hợp. Tắt đi nếu bạn chỉ muốn khách lấy file trong tài khoản.

Bấm Save. Cấu hình áp dụng cho các grant tạo sau đó; grant cũ giữ nguyên hạn và hạn mức đã cấp.

5. Chọn trạng thái đơn được tính là đã thanh toán

Module không có danh sách trạng thái riêng — nó dùng đúng cờ của PrestaShop.

1. Vào Orders → Statuses.
2. Trạng thái nào có cờ Consider the associated order as validated / paid thì khi đơn chuyển sang đó, file sẽ được giao.
3. Nếu bạn dùng trạng thái tự tạo (ví dụ "Đã nhận chuyển khoản"), hãy bật cờ đó cho nó.
4. Đổi trạng thái qua lại nhiều lần không sao: grant chỉ được tạo một lần cho mỗi cặp dòng đơn hàng × file, và email cũng chỉ gửi một lần.

6. Khách nhìn thấy gì

• Email: tiêu đề "Your download links for order ...", có logo và tên shop của bạn, danh sách link theo từng file, và câu ghi rõ còn bao nhiêu ngày hạn dùng. Có sẵn mẫu tiếng Việt và tiếng Anh, chọn theo ngôn ngữ của đơn hàng.
• Tài khoản → File của tôi (My downloads): bảng liệt kê mọi file đã mua, mã đơn, số lượt đã dùng trên tổng, nút Download và nút Resend email. File hết hạn hoặc hết lượt hiện chữ Expired / Limit reached.
• Chi tiết đơn hàng: khối Your downloads với nút tải cho từng file và nút Resend the links to my email.

7. Đọc nhật ký tải

1. Vào Improve → Downloads Pro.
2. Ba ô số liệu ở trên: Download grants (tổng số link đã cấp), Active now (số link còn tải được), Total downloads (tổng lượt tải).
3. Bảng Customer downloads liệt kê 300 grant gần nhất: mã đơn, tên và email khách, tên file, cột Used dạng "đã dùng / hạn mức" (dấu ∞ nếu không giới hạn), ngày hết hạn và trạng thái Active / Expired / Limit reached / Revoked.
4. Mỗi lần bấm tải, kể cả lần thất bại, đều được ghi kèm IP, trình duyệt và thời điểm vào bảng nhật ký của module.

8. Hoàn tiền và thu hồi

1. Chuyển đơn sang Refunded hoặc Canceled: mọi grant của đơn tự động bị thu hồi, link chết ngay.
2. Trường hợp khác: vào Improve → Downloads Pro, tìm dòng cần chặn, bấm Revoke và xác nhận.
3. Thu hồi nhầm thì bấm Restore trên chính dòng đó.
4. Muốn gửi lại link cho khách: bấm Resend trên dòng của đơn — chỉ những link còn hiệu lực được gửi.

9. Xử lý sự cố

Khách nói không nhận được email. Kiểm tra Advanced Parameters → E-mail xem shop gửi mail được chưa (bấm Test). Kiểm tra tuỳ chọn Email the download link when paid có đang bật. Kiểm tra đơn đã thực sự vào trạng thái có cờ "paid". Nếu mọi thứ đúng, mở Improve → Downloads Pro và bấm Resend; nếu bảng không có dòng nào cho đơn đó thì nguyên nhân là sản phẩm chưa được gắn file lúc khách mua.

Bấm tải thì báo "This download link is not valid". Token sai hoặc grant đã bị xoá. Thường do khách sao chép link bị cắt trong ứng dụng email. Bảo khách vào File của tôi để tải bằng link mới, hoặc bạn bấm Resend.

Tải về báo lỗi file thiếu. Thông báo "The file is missing" nghĩa là bản ghi còn nhưng file trên đĩa đã biến mất — thường do đồng bộ FTP hoặc khôi phục backup không kèm thư mục private_files/. Gắn lại file vào sản phẩm; grant cũ trỏ tới file cũ nên hãy tạo lại bằng cách bấm Revoke dòng hỏng và giao lại thủ công.

Tải file lên báo "No file was uploaded, or it exceeded the server upload limit". File vượt quá upload_max_filesize hoặc post_max_size của hosting. Nhờ nhà cung cấp nâng hai giá trị này, và nâng cả max_execution_time nếu file lớn.

Báo "Could not store the uploaded file". Thư mục modules/ps_downloads/private_files/ không ghi được. Đặt quyền 755 cho thư mục và bảo đảm user của web server là chủ sở hữu.

Panel Downloadable files báo chưa có giấy phép. Bạn đang hết hạn dùng thử hoặc hết hạn giấy phép. Vào Configure, kích hoạt lại khoá. Việc giao file cho khách cũ vẫn chạy bình thường trong lúc đó.