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

1. Cài đặt

1. Tải file ZIP của Speed Pro từ tài khoản của bạn.
2. Trong back-office, vào Modules → Module Manager → Upload a module và chọn file ZIP.
3. Sau khi cài xong, mở menu Improve → Speed Pro (hoặc bấm Configure ở dòng module).
4. Module chạy trên cả PrestaShop 8 và 9, không cần cài thêm gì. Nếu muốn kiểm tra, mở tab Speed Doctor — nó sẽ báo ngay nếu môi trường thiếu thứ gì.

2. Bản quyền và bản dùng thử 30 ngày

1. Mở tab License.
2. Nếu bạn chưa mua, bấm Bắt đầu dùng thử — mở khoá mọi tính năng trong 30 ngày, không cần key.
3. Nếu đã có key, dán vào ô và bấm kích hoạt. Key gắn với một tên miền, hoạt động offline, không "gọi về nhà".
4. Trạng thái và ngày hết hạn hiển thị ngay trên thanh tiêu đề của dashboard.
5. Lưu ý: bản dùng thử chỉ dùng được một lần cho mỗi shop — gỡ cài rồi cài lại không reset được.

3. Bật cache toàn trang và chọn loại trang

1. Vào tab Optimisations, bật Full Page Cache (mặc định đã bật sau khi cài).
2. Sang tab Page cache, phần Pages to cache: tick những loại trang bạn muốn cache — Home page, Category pages, Product pages, CMS pages, Brand pages, Supplier pages, Best sellers, New products, Price drops, Sitemap, Store locator.
3. Bắt đầu với trang chủ, danh mục và sản phẩm. Đó là nơi có nhiều khách vãng lai nhất.
4. Bấm Save settings.
5. Bạn không cần lo về cart, checkout hay trang tài khoản: chúng nằm trong danh sách không bao giờ cache, không xuất hiện trong danh sách chọn.

4. URL không bao giờ cache và thời gian sống (TTL)

1. Vẫn ở tab Page cache, ô Never cache these URLs: mỗi dòng một mẫu URL.
2. Dùng * làm ký tự đại diện, ví dụ /*promo* hoặc /en/lien-he. Không có * thì hệ thống so khớp kiểu "chứa chuỗi này".
3. Dùng ô này cho các trang có nội dung thay đổi theo từng khách: trang đích chiến dịch có tham số riêng, trang có bộ đếm thời gian, trang tra cứu.
4. Ô Cache lifetime (sec) là TTL — mặc định 3600 giây (1 giờ). Shop có nội dung ổn định có thể để 7200–21600; shop hay đổi giá thì nên để 900–3600.
5. TTL không phải cách duy nhất làm mới: mọi thay đổi sản phẩm, danh mục, giá, tồn kho hay CMS đều tự xoá toàn bộ cache ngay lập tức.

5. Hâm nóng cache (warm-up)

1. Ngay sau khi bật cache hoặc sau khi xoá cache, bấm 🔥 Warm-up cache ở tab Page cache.
2. Module sẽ gọi trang chủ và một số danh mục hàng đầu để dựng sẵn bản cache, thay vì để khách thật gánh lần dựng đầu tiên.
3. Để Auto cache warm-up bật thì việc này tự lặp lại mỗi 15 phút và ngay sau mỗi lần cache bị xoá.
4. Bấm 🗑️ Clear all cache khi bạn vừa đổi theme, cài/gỡ module, hoặc sửa file template — những thay đổi này không tự sinh hook xoá cache.

6. Chuyển ảnh sang WebP

1. Mở tab Images. Biểu đồ vòng cho biết bao nhiêu phần trăm ảnh sản phẩm đã có bản WebP.
2. Bấm 🖼️ Optimise images now. Mỗi lần bấm xử lý tối đa 300 ảnh — shop lớn thì bấm lại vài lần cho tới khi phần còn lại về 0.
3. Ảnh gốc luôn được giữ; bản WebP nằm cạnh nó làm bản thay thế nhẹ hơn.
4. Bật Auto WebP ở tab Automation để mọi ảnh sản phẩm upload sau này tự được chuyển, không cần vào back-office.
5. Nếu tab báo thiếu hỗ trợ WebP, hãy yêu cầu hosting bật tiện ích PHP GD kèm WebP.

7. Các công tắc tối ưu front-office

Tab Optimisations, bật/tắt độc lập từng mục:

1. Combine & minify CSS và Combine & minify JS — ít file hơn, nhẹ hơn.
2. Minify HTML — bỏ chú thích và khoảng trắng thừa khỏi trang đã cache.
3. Lazy-load images — ảnh chỉ tải khi cuộn tới.
4. Template / SQL cache — cache template đã biên dịch.
5. Sau khi đổi, xem thử storefront ở chế độ ẩn danh. Nếu theme có lỗi hiển thị, tắt riêng công tắc CSS hoặc JS rồi thử lại — tắt là trả về hành vi PrestaShop chuẩn ngay lập tức.

8. Speed Doctor và sửa một chạm

1. Mở tab Speed Doctor và đọc điểm sức khoẻ cùng số mục critical / warnings.
2. Bấm 🩹 Fix all safe issues để module tự bật những thứ nó sửa được (cache template, gộp CSS…).
3. Những mục thuộc về máy chủ — điển hình là OPcache file limit thấp hơn ~40.000 file PHP của PrestaShop — không có nút Fix, mà có hướng dẫn.
4. Với các mục đó, kéo xuống phần Message for your hosting provider, bấm Copy message và gửi cho hosting.
5. Tuỳ chọn: dán API key của riêng bạn (Claude / OpenAI / Gemini) vào AI Doctor để nhận kế hoạch hành động bằng ngôn ngữ đời thường.

9. Dọn database

1. Mở tab Database. Bảng liệt kê số dòng sẽ bị xoá theo từng loại: log theo dõi khách, thống kê tìm kiếm, log admin, voucher hết hạn, giỏ hàng khách vãng lai bị bỏ.
2. Mặc định chỉ đụng tới dữ liệu cũ hơn 30 ngày và chưa từng gắn với đơn hàng.
3. Xem trước con số, rồi bấm 🧹 Clean database.
4. Đơn hàng, khách hàng và sản phẩm không bao giờ bị đụng tới.
5. Nếu muốn tự động, bật Monthly DB clean ở tab Automation — mặc định tắt vì đây là thao tác xoá.

10. Xử lý sự cố

Tôi vừa đổi giá mà trang vẫn hiện giá cũ. Sửa sản phẩm/giá/tồn kho là cache tự xoá, nên nguyên nhân thường là bộ nhớ đệm khác: bấm Clear all cache ở tab Page cache, rồi vào Advanced Parameters → Performance → Clear cache của PrestaShop. Nếu bạn dùng CDN hay cache của hosting, xoá thêm ở đó.

Tỉ lệ cache hit thấp. Bình thường ngay sau khi cài hoặc vừa xoá cache — cache cần thời gian để đầy. Bấm Warm-up, giữ Auto warm-up bật, và kiểm tra xem bạn có bỏ tick quá nhiều loại trang, hoặc đặt quá nhiều mẫu URL loại trừ không. Khách đã đăng nhập và khách có hàng trong giỏ không bao giờ tính vào cache hit — đó là đúng thiết kế.

Tôi không biết cache có chạy không. Mở storefront ở cửa sổ ẩn danh, bật DevTools → Network, tải lại trang chủ hai lần và tìm header X-SSPro-Cache: HIT ở lần thứ hai. Hoặc dùng nút Test speed now ở tab Overview.

Automation hiện "not yet". Auto-pilot dựa vào lượt truy cập thật và cần bản quyền/dùng thử còn hiệu lực. Shop mới hoặc rất ít khách thì có thể chưa chạy lần nào — cho nó một ít lưu lượng hoặc bấm Warm-up một lần.

Máy chủ vẫn thấy chậm dù cache hit cao. Phần lớn trường hợp là OPcache. Đặt opcache.max_accelerated_files từ 40000 trở lên và opcache.memory_consumption là 256, rồi khởi động lại PHP. Speed Doctor kiểm tra đúng mục này và soạn sẵn yêu cầu để gửi hosting.