Đến nội dung chính
CafeJS Docs
Trên trang này 3 mục
  1. 5.1 Chạy và build
  2. 5.2 Admin và nội dung
  3. 5.3 Đưa lên mạng

Câu hỏi thường gặp

Những lỗi hay gặp khi chạy, sửa nội dung và đưa site lên mạng, kèm cách xử lý.

Chạy và build

Cổng 4321 (hoặc 4001, 9000) đã bị dùng?

Một chương trình khác đang chạy trên cổng đó. Chạy với bộ cổng riêng: xem 1.5 Chạy trên máy.

Build đứng mãi ở "Indexing local files"?

Thường do một lệnh dev hay build khác đang dùng cùng cổng. Dừng lệnh, chắc không còn lệnh nào khác của site đang chạy, rồi build lại một lần.

Trang hiện dòng chữ “object Object” trong ngoặc vuông?

Một ô rich text trong content/ bị lưu dạng object thay vì chữ markdown; sửa lại ô đó trong admin hoặc báo developer.

Admin và nội dung

Vì sao nút đổi ngôn ngữ đưa về trang chủ thay vì trang tương ứng?

Hai bản của trang chưa cùng tên file, ví dụ vi/gioi-thieu.json và en/gioi-thieu.json.

Không thấy nút gọi, Zalo, Messenger?

Chưa điền số trong Theme → Contact.

Bật bán hàng mà admin chưa có Products?

Chưa chạy lại pnpm dev sau khi lưu Theme. Bản đã đưa lên mạng thì phải build lại.

Đưa lên mạng

Bấm gửi form chỉ thấy "Đây là trang mẫu…"?

Chưa đặt PUBLIC_FORM_ENDPOINT khi build (xem 3.4 Biến môi trường).

Vì sao không có /sitemap.xml?

Bản build chưa đặt SITE_URL, hoặc đang bật Hide the whole site from search engines.

Không thấy banner đồng ý?

Chưa điền tracker nào (và chưa có mã tuỳ chỉnh), Ask before tracking đang tắt, hoặc chưa build lại sau khi sửa SEO & Tracking. Đã trả lời rồi thì banner không hiện lại; dùng nút Tuỳ chọn cookie ở cuối trang hoặc thử bằng cửa sổ ẩn danh.

Admin trên bản đã deploy báo lỗi?

Bản build bằng pnpm build:local có admin gọi về server Tina trên máy, nên không dùng được trên mạng. Muốn sửa trên mạng thì dùng TinaCloud (pnpm build); muốn cho khách xem admin thì build bằng pnpm build:review.