Áp dụng cho PrestaShop 8 và 9.
1. Cài đặt
- Back office → Modules → Module Manager → Upload a module → chọn file zip của Image Pro.
- Sau khi cài xong, mở Improve → Image Pro by HabaChat trên menu trái. Đây là trang duy nhất gộp cả bảng điều khiển, bản quyền, cài đặt và trợ giúp.
- Nếu thấy cảnh báo cơ sở dữ liệu chưa cập nhật, module sẽ tự sửa (SchemaGuard) — chỉ tạo phần còn thiếu, không đụng dữ liệu cũ.
2. Kích hoạt bản quyền (hoặc dùng thử)
- Trong panel Licence, trang hiện đúng domain của shop. Dán key nhận được vào ô và bấm Activate.
- Chưa mua? Bấm Start 90-day free trial để dùng thử đầy đủ chức năng.
- Bản quyền hoạt động offline. Nếu hết hạn, chỉ công cụ thiết kế trong admin bị khoá — mọi ảnh đã tạo vẫn nằm trên sản phẩm và storefront không bị ảnh hưởng.
3. Thiết kế một ảnh cho một sản phẩm
- Mở một sản phẩm, vào khu Hình ảnh (hoặc tab Modules).
- Bấm ô "thêm ảnh" hoặc nút Create an image with Image Pro. Trình chỉnh sửa mở ra trong một cửa sổ, đã điền sẵn tiêu đề của sản phẩm đó.
4. Chọn nền và thêm lớp chữ với token {tieu_de}
- Ở cột trái, chọn một hộp phần mềm 3D có sẵn, hoặc Upload your own background để dùng ảnh nghệ thuật của bạn (khớp theo Cover/Contain).
- Thêm lớp chữ. Trong nội dung lớp, gõ token `{tieu_de}` ở chỗ bạn muốn tên sản phẩm hiện ra (có thể dùng thêm `{ref}` cho mã tham chiếu).
- Kéo lớp chữ tới đúng vị trí trên ảnh. Chọn phông (15+ lựa chọn), màu, canh lề, in đậm/nghiêng, và bật hiệu ứng chữ kim loại 3D nếu muốn. Tiêu đề dài sẽ tự thu nhỏ và xuống dòng để vừa khung.
- Cần logo? Bấm Add logo / image để thêm một lớp ảnh và kéo vào chỗ mong muốn.
5. Gắn ảnh vào sản phẩm
- Bấm Finish & attach image. Ảnh được đưa vào thư viện ảnh của sản phẩm và đặt làm ảnh bìa; các thumbnail (và WebP nếu host hỗ trợ) được sinh tự động.
- Module không tự tải lại trang. Bạn sẽ thấy một dòng thông báo nhỏ kèm nút Refresh thủ công — bấm khi bạn muốn xem ảnh mới. (Đây là chủ đích: trang sản phẩm nặng không bị nạp lại và không có gì bị lưu ngoài ý muốn.)
6. Lưu template mặc định và phủ cả catalog
- Trong studio, khi lưu thiết kế hãy tick make default để đặt nó làm template mặc định.
- Về trang Image Pro by HabaChat → panel Batch fill → bấm Build images for all.
- Editor nhận danh sách sản phẩm chưa có ảnh và dán template mặc định — kèm tiêu đề riêng của từng cái — lên từng sản phẩm, xử lý lần lượt. Giữ cửa sổ mở cho tới khi xong.
7. Banner mạng xã hội / blog / quảng cáo
- Trên trang chính, bấm Open image & banner studio.
- Chọn kích thước dựng sẵn (FB post, FB cover, Instagram, IG story, blog 16:9, leaderboard, 728×90, 300×250, 336×280) hoặc tự nhập rộng × cao và chọn hướng.
- Thiết kế như bình thường, rồi bấm Download PNG.
- Muốn chèn thẳng vào bài viết? Sửa một trang ở Design → Pages, bấm nút chèn ảnh của trình soạn thảo — Image Pro mở ra; thiết kế xong bấm Insert into the article.
8. Tuỳ chọn: nền do AI vẽ
- Trong panel Settings, chọn nhà cung cấp (Gemini / OpenAI) và dán API key của riêng bạn. Key nằm ở server; để trống thì nút AI ẩn đi.
- AI chỉ vẽ nền — chữ (kể cả {tieu_de}) luôn do canvas dán, nên tên sản phẩm luôn sắc nét và đúng.
9. Xử lý sự cố
Không thấy nút trên trang sản phẩm. Kiểm tra module đã bật và bản quyền/dùng thử đang hoạt động. Thiết kế thì luôn được, nhưng gắn ảnh cần licence.
Bấm Build images for all mà không có gì xảy ra. Bạn cần một template mặc định trước (tick "make default" khi lưu). Nếu mọi sản phẩm đã có ảnh, danh sách sẽ trống.
Ảnh mới chưa hiện. Đúng như thiết kế — module không tự reload. Bấm nút Refresh trong dòng thông báo, hoặc tải lại trang sản phẩm.