Đến nội dung chính
CafeJS Docs

Giới thiệu

Mỗi mẫu CafeJS là một website Astro + TinaCMS song ngữ, dựng trên cùng một bộ khung. Trang này nói mẫu gồm những gì và nên đọc tài liệu theo thứ tự nào.

Mẫu gồm những gì

  • Website song ngữ: tiếng Việt ở /, tiếng Anh ở /en/. Mỗi trang có đủ hai bản.
  • Nội dung (chữ, ảnh, menu, màu, SEO) sửa trong admin TinaCMS có giao diện tiếng Việt, xem trước ngay bên cạnh form.
  • Không có database: mọi nội dung là file JSON trong content/, nằm trong Git cùng với code.
  • Trang công khai là HTML tĩnh, không tải React, nên nhanh và chạy được trên hosting tĩnh bất kỳ.

Trang dựng từ section

Mỗi trang là một danh sách section xếp từ trên xuống: banner, cột, hàng ảnh và chữ, bảng giá, câu hỏi thường gặp, form… Section nào cũng có độ rộng, khoảng cách và bộ màu riêng, nên một trang đổi nhịp được mà không cần sửa code. Danh sách đủ ở 2.2 Trang và section.

Mẹo

Mở /design trên site đang chạy để xem mọi section cùng các kiểu của nó, kèm bảng màu và cỡ chữ.

Có sẵn trong mọi mẫu

  • SEO: canonical, Open Graph, hreflang, dữ liệu có cấu trúc, sitemap.xml, robots.txt; trong admin có khung xem trước trên Google và phân tích từ khoá.
  • Tracker: Google Analytics 4, Tag Manager, Meta Pixel, TikTok Pixel, Microsoft Clarity. Điền ID trong admin; tracker chạy sau khi khách đồng ý.
  • Blog: bài viết, chuyên mục, danh sách bài chia trang, nguồn RSS cho từng ngôn ngữ.
  • Bán hàng (tắt sẵn): sản phẩm, danh mục và giỏ hàng gửi đơn qua Zalo, Messenger hoặc điện thoại.
  • Admin xem thử: một bản admin cho khách mở không cần đăng nhập, sửa thử và thấy preview đổi, nhưng không lưu được gì.

Lưu ý

Ví dụ trong tài liệu lấy từ bộ khung chung của các mẫu. Tên trang, section và menu của mẫu bạn mua có thể khác; cách làm thì giống nhau.

Đọc theo thứ tự nào

Bạn làĐọc
Chủ site, người viết nội dungPhần 2, bắt đầu ở 2.1 Mở admin
Developer1.5 Chạy trên máy, rồi phần 3
Người nhờ AI làm giúp4 Làm việc với AI