Thực hành tốt: SEO, nội dung, bảo mật, hiệu năng

Thực hành tốt với KDIGI CMS xoay quanh năm nhóm việc: dựng cấu trúc nội dung đúng, cấu hình SEO on-page một lần cho cả site, phân quyền và bảo mật, giữ site nhanh nhờ cache và revalidate, và sao lưu trước mỗi lần nâng cấp. Mỗi bài dưới đây có checklist và lệnh thật.

Tóm tắt nhanh

• 5 bài hướng dẫn, mỗi bài đối chiếu với tài liệu và CHANGELOG của KDIGI CMS 1.1.0.
• Thứ tự đề xuất: cấu trúc nội dung → SEO on-page → bảo mật → hiệu năng → sao lưu và nâng cấp.
• KDIGI CMS là headless: giao diện công khai, cache và CDN do frontend và hạ tầng của bạn đảm nhiệm.
• Quyết định khó đảo ngược nhất: slug, quy ước URL, vai trò người dùng, PAYLOAD_PUBLIC_SERVER_URL.

Chọn bài theo mục tiêu

Lộ trình 5 bước cho một site mới

1. Cấu trúc — chốt loại nội dung, cây chuyên mục (≤ 2 cấp), quy ước slug và tiền tố URL; tạo menu và tác giả. Xem cấu trúc nội dung.
2. Cấu hình site — domain, defaultLanguage, seoTitles, knowledgeGraph, socialProfiles, ảnh OG mặc định. Xem quản lý nhiều website.
3. Phân quyền — tạo người dùng theo vai trò tối thiểu và gán đúng site; cộng tác viên là author. Xem phân quyền người dùng.
4. Tích hợp frontend — lọc tenant ở mọi truy vấn, nối webhook revalidate, bật ENABLE_JOBS_AUTORUN=true trên một instance. Xem API headless.
5. Vận hành — sao lưu hằng đêm, khôi phục thử mỗi tháng, đọc CHANGELOG trước nâng cấp.

Nguyên tắc chung

Cấu hình ở site, không ở từng bài

Tiêu đề SEO, mẫu mô tả, danh tính tổ chức và ảnh OG mặc định thuộc về Sites. Ghi đè ở từng tài liệu chỉ khi cần. Nhờ đó đổi một lần, cả site cập nhật mà không phải lưu lại hàng trăm bài.

Quyền tối thiểu, ranh giới là access predicate

Bộ chọn site trong admin chỉ là tiện ích giao diện; ranh giới thật là các predicate truy cập ở từng collection. Và vì đọc ẩn danh không tự lọc theo site, frontend phải thêm where[tenant][equals]=<id> ở mọi truy vấn.

Mọi thứ thay đổi schema đều đi qua migration

Schema không bao giờ đồng bộ tự động. Vì vậy mỗi lần nâng cấp có một điểm kiểm soát rõ ràng: sao lưu → migrate → kiểm tra.

Đừng tin vào một tín hiệu duy nhất

GET /api/health chỉ báo tiến trình còn sống, không báo schema đã cập nhật hay job đã chạy. Điểm SEO chỉ là checklist, không phải thứ hạng. Hãy kết hợp kiểm tra thủ công sau mỗi thay đổi lớn.

Dành cho người đang chuyển từ WordPress

Pipeline di chuyển giữ nội dung, media, menu, SEO Yoast/Rank Math và tạo redirect 301 từ permalink cũ. Hãy làm theo trang chuyển từ WordPress, rồi quay lại đây để rà SEO on-page và sao lưu trước khi chuyển DNS.

Thực hành trên bản demo hoặc bản tự host

• Bản demo để thử editor, SEO, media với tài khoản editor.
• Tự host để làm bảo mật, cache, sao lưu trên hạ tầng của bạn.
• Chọn mô hình triển khai theo nhu cầu ở giải pháp cho agency hoặc doanh nghiệp.