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

Áp dụng cho PrestaShop 8 và 9.

1. Cài đặt

1. Tải file zip phù hợp: ps_seo.zip cho PrestaShop 9, ps_seo_PS8.zip cho PrestaShop 8. Cài nhầm bản, PrestaShop sẽ từ chối vì khai báo tương thích phiên bản.
2. Back office → Modules → Module Manager → Upload a module → chọn file zip.
3. Sau khi cài xong, mở Improve → SEO Pro trên menu trái.
4. Nếu bạn thấy cảnh báo "Your database is out of date" kèm nút 🔧 Repair now, hãy bấm nút đó. Nó chỉ tạo phần còn thiếu và đăng ký lại hook, không đụng dữ liệu sẵn có.

2. Kích hoạt bản quyền

1. Bạn sẽ vào thẳng tab 🪪 License. Trước khi kích hoạt, chỉ có tab License và Help hiển thị.
2. Trang hiện domain chính xác của shop (gồm cả cổng nếu có, ví dụ localhost:8000). Gửi đúng chuỗi đó cho chúng tôi.
3. Dán key nhận được vào ô và bấm Activate. Toàn bộ 14 tab mở khoá ngay.

Bản quyền hoạt động offline, không gọi về máy chủ nào. Nếu hết hạn, chỉ phần công cụ trong back office bị khoá — storefront vẫn giữ nguyên redirect, canonical, thẻ xác minh, sitemap và IndexNow.

3. Chạy audit đầu tiên và đọc điểm

1. Vào tab 📊 Dashboard, bấm Run a full audit now.
2. Sau vài giây, vòng tròn điểm hiện điểm trên 100 và xếp hạng chữ. Shop demo mặc định thường ra khoảng 48/D — điểm thấp lúc đầu là bình thường.
3. Đọc phần Quick wins ngay dưới: các lỗi nặng nhất xếp trước, mỗi mục có một câu giải thích và gợi ý sửa.
4. Xem dải thẻ At a glance: số URL trong sitemap, số redirect đang hoạt động, số URL 404 chưa xử lý, và số trang không thể lên hạng (nếu bạn đã chạy crawl).
5. Muốn xem chi tiết từng lỗi, sang tab 🔍 SEO audit và lọc theo loại đối tượng hoặc mã lỗi.

4. Sửa các lỗi dễ trước

Bắt đầu từ trên xuống trong Quick wins. Thứ tự đáng làm nhất thường là:

1. Meta title rỗng (mức critical) — sửa hàng loạt ở bước 6.
2. Meta description rỗng (high).
3. Title hoặc description trùng lặp — thêm một thẻ phân biệt như {reference} hoặc {category} vào mẫu.
4. URL thiếu hoặc trùng — sửa trong chính trang sản phẩm/danh mục.
5. Thiếu alt ảnh — bulk apply cũng làm được.

Chạy lại audit sau mỗi đợt sửa để thấy điểm dịch chuyển.

5. Cấu hình AI (tuỳ chọn)

1. Vào tab 🤖 AI writing.
2. Chọn nhà cung cấp: Claude, GPT hoặc Gemini.
3. Dán API key bạn tự tạo trong console của họ và chọn model. Model rẻ nhất là đủ cho meta text ngắn.
4. Tích Enable AI writing, bấm Save, rồi bấm Test connection. Kết quả OK nghĩa là key hợp lệ.

Sau đó, một nút AI nhỏ xuất hiện cạnh các ô nhập chữ trong trang sản phẩm, và tab 📈 SEO analysis có thêm nút 🤖 Fix all with AI. Nút này viết lại meta title, meta description và mô tả cùng một lượt; bạn duyệt từng thay đổi rồi bấm Save của sản phẩm.

Trước khi dùng AI cho một trang, hãy đặt Focus keyphrase trong tab SEO của trang đó — AI bám theo cụm từ này.

6. Sinh meta hàng loạt: preview rồi undo

1. Vào tab ✍️ Meta & templates.
2. Viết mẫu cho từng trường, ví dụ tiêu đề: {product_name} - {category} | {shop_name}. Danh sách thẻ dùng được nằm ngay dưới mỗi ô.
3. Kéo xuống phần Apply to the catalog. Chọn đối tượng (sản phẩm, danh mục, CMS, thương hiệu, alt ảnh) và tick các trường.
4. Chọn chế độ: Only fill in empty fields (safe) cho lần đầu, hoặc Overwrite everything khi bạn thật sự muốn viết lại tất cả.
5. Bấm Preview. Không có gì bị thay đổi — bạn xem chính xác nội dung sẽ ghi và độ dài của nó. Nếu mẫu chưa ưng, sửa rồi preview lại.
6. Bấm Apply now và giữ tab mở cho tới khi thanh tiến trình đạt 100%. Công việc được chia thành đợt nhỏ nên không bao giờ timeout.
7. Nếu không hài lòng, kéo xuống bảng History & undo, tìm lần chạy vừa rồi và bấm hoàn tác. Nội dung cũ được khôi phục nguyên văn.

7. Sitemap và cron

1. Tab 🗺️ Sitemap → Generate sitemap now. Giữ tab mở tới khi xong.
2. Copy URL hiển thị, mở Google Search Console → Sitemaps → Add a new sitemap và dán vào.
3. Ở cuối tab (và trên Dashboard) có sẵn hai dòng cron. Thêm vào crontab của hosting (cPanel/Plesk) để sitemap và audit tự chạy mỗi đêm:

`

0 2 * curl -s "…&task=sitemap&token=…"

0 5 * curl -s "…&task=audit&token=…"

`

Chỉ trang đang bật và hiển thị được đưa vào sitemap; ảnh sản phẩm được kèm theo; đa ngôn ngữ và đa cửa hàng tự động tách file rồi nối bằng index.

8. Redirect và giám sát 404

1. Tab ↪️ Redirects & 404. Kéo xuống mục 404 monitor.
2. Danh sách URL chết được xếp theo số lượt truy cập, nhiều nhất lên đầu. Rác từ bot và request ảnh đã bị lọc.
3. Gõ địa chỉ mới vào ô bên cạnh và bấm 301. Mục đó được đánh dấu đã xử lý và traffic được cứu.
4. Muốn thêm rule thủ công, dùng bảng Your redirects: chọn 301 khi đổi tên vĩnh viễn, 302 khi thật sự tạm thời, 410 khi trang đã bỏ hẳn.
5. Với mẫu hàng loạt, tích ô regular expression và dùng $1, $2 trong địa chỉ đích.

9. Xử lý sự cố

Điểm không thay đổi. Điểm Dashboard chỉ cập nhật khi audit chạy. Điểm từng trang và cột SEO trong danh sách sản phẩm cập nhật khi trang đó được chấm — tự động lúc bạn lưu sản phẩm, hoặc tất cả cùng lúc qua 🎯 Page scores → Re-score all.

Không thấy nút AI. Vào tab AI writing, tích Enable AI writing, dán key và Save. Nút chỉ hiện khi AI đã bật và có key hợp lệ.

Báo "Add your AI API key first." Bạn đã bật AI nhưng key trống hoặc bị từ chối. Dán key đúng rồi bấm Test connection.

Cột SEO trống ở một sản phẩm. Cột chỉ hiện với sản phẩm đã đặt focus keyphrase. Vào tab SEO của sản phẩm đó và đặt một cụm từ.

URL sitemap báo 404. Bạn chưa tạo sitemap, hoặc friendly URL đang tắt. Tạo sitemap trước; nếu tắt friendly URL, dùng đúng URL mà tab hiển thị.

Bulk apply hoặc sitemap chạy rất lâu. Đó là thiết kế: từng bước nhỏ để không chết giữa chừng trên hosting yếu. Giữ tab mở, nó sẽ xong.

Chuyển sang domain mới và mọi thứ bị khoá. Bản quyền gắn theo domain. Liên hệ để được cấp key mới.