s_skaidocsTài liệu

Công khai nội dung và lịch xuất bản

Trạng thái có cờ is_public, độc lập với key và màu sắc. Trạng thái mới mặc định nội bộ. Published mặc định công khai trong bộ trạng thái xuất bản.

Truy vấn mặc định

Theme engine lấy entries thuộc content type được cấp cho ứng dụng, có trạng thái active và is_public trong đúng nhóm của content type, và published_at rỗng hoặc không lớn hơn giờ hiện tại. Trạng thái không tồn tại hoặc thiếu nhóm không trả dữ liệu.

{% set items = entries.get(type="post") %}
{% set approved = entries.get(type="post", status="approved") %}
{% set item = entries.find(type="post", slug=slug) %}
{% if not item %}{% abort 404 %}{% endif %}

Approved chỉ trả kết quả nếu được đánh dấu công khai. Truy vấn draft không vượt qua quyền công khai. Find trả null khi không tìm thấy; theme cần abort 404 để trang chi tiết trả HTTP 404.

List, find, count, paginate, model API và tham chiếu section dùng chung bộ lọc. Bộ lọc công khai chạy tại SQL trước khi hydrate và phân trang trong bộ nhớ. Sitemap post/custom cũng dùng cùng chính sách.

Lịch xuất bản post

Chọn Scheduled cùng ngày tương lai, hoặc Published cùng ngày tương lai, để đặt lịch. Worker chạy theo chu kỳ mặc định 30 giây, xử lý cả lịch quá hạn sau khi khởi động lại. Đích hiện tại cố định Published và phải còn active, công khai. Không tự chọn trạng thái công khai khác.

Đổi giờ, chuyển về Draft hoặc xóa bài làm lịch cũ mất hiệu lực. Lịch lỗi lưu ở post_publication_jobs để quản trị viên kiểm tra; bài không được công khai nếu việc xuất bản thất bại.

Preview và cache

Preview giao diện vẫn chỉ đọc nội dung công khai. Chưa cung cấp cơ chế cấp quyền preview nội dung nháp. Không thể mở quyền bằng domain preview, query preview=true hoặc tham số status.

Trang runtime trả Cache-Control: private, no-store; dữ liệu entries đọc trực tiếp. File ảnh đã public có URL riêng không tự chuyển private khi bài bị ẩn.

Quay lại tài liệu entries