Viết bài

Blog nằm ở Quản lý → Blog (en: Manage → Blog). Chuyên mục nằm riêng ở Danh mục Blog (en: Blog Categories).

Danh sách hiện Tiêu đề, Slug, Trạng thái, Danh mục, Ngày đăng; tìm theo tiêu đề hoặc slug, lọc theo trạng thái.

Tạo một bài

Bài viết mới (en: New article). Biểu mẫu có bốn tab: Nội dung, Meta, SEO, Danh mục.

Nội dung

Tiêu đề — bắt buộc.

Slug — tự sinh từ tiêu đề nếu để trống, và là địa chỉ bài viết. Chỉ chữ thường, số và gạch ngang. Trùng bài khác thì bạn nhận "Đã có bài viết dùng slug này."

Slug bài viết tự sinh và tự khử trùng. Slug chuyên mục thì không — nó bắt buộc và bạn tự đặt, vì đó là một đoạn URL do người viết chọn.

Tóm tắt — một dòng, dùng cho danh sách bài và cho SEO.

Loại nội dung — Văn bản có định dạng (en: Rich text) là lựa chọn duy nhất chọn được hôm nay. Lựa chọn thứ hai, Trang (trình soạn giao diện), hiện mờ với chữ "sắp ra mắt": trang đã xuất bản chưa hiển thị được thân bài dựng bằng trình dựng trang, nên ô chọn không cho bạn tạo ra một bài không có nội dung.

Bài nào đã được lưu ở loại đó từ trước thì vẫn mở được, kèm cảnh báo "bài viết sẽ lên site mà không có nội dung nào. Hãy chuyển lại về Văn bản có định dạng", và danh sách gắn nhãn Chưa có nội dung cho nó. Qua API, ghi một bài như vậy trả 409 unsupported_body_type thay vì lặng lẽ xoá thân bài — xem API công khai.

Meta

URL ảnh bìa, Tác giả, Trạng thái, Thẻ (gõ rồi Enter).

SEO

Meta title, Meta description, Từ khóa — thứ công cụ tìm kiếm đọc. Xem SEO.

Danh mục

Chọn các chuyên mục cho bài. Chưa có chuyên mục nào thì tab nói rõ: "Không tìm thấy danh mục blog. Hãy tạo danh mục trong Danh mục Blog trước."

Chuyên mục quản lý ở Danh mục Blog, xếp được thành cây. Một chuyên mục không chuyển được vào bên dưới chính hậu duệ của nó — thử làm vậy nhận lỗi cycle_detected.

Nội dung được làm sạch khi lưu

Thân bài được làm sạch lúc ghi: thẻ script và trình xử lý sự kiện bị tước bỏ, vì nội dung này render nguyên văn vào trang storefront khách tải về.

Hệ quả: đọc lại nội dung sau khi lưu thay vì cho rằng thứ bạn dán vào là thứ sẽ được phục vụ. Dán HTML từ nơi khác thì một phần có thể đã bị bỏ.

Bài viết hiển thị ở đâu

Bài viết không có trang riêng do bạn dựng. Chúng dùng trang mẫu loại Bài viết (en: Post) của site; danh sách bài dùng trang loại Blog. Dựng hai trang đó một lần, mọi bài dùng chung. Site chưa có trang loại Bài viết thì địa chỉ bài viết không hiển thị được gì. Xem Trang và canvas.

Muốn đổ danh sách bài lên một trang bất kỳ, dùng phần tử danh sách — xem Danh sách tự đổ dữ liệu.

Xoá

Xoá một bài viết là vĩnh viễn và không hoàn tác được.

Qua API

GET, POST, PUT, DELETE cho /api/v1/articles và /api/v1/blog-categories, cùng cặp quyền blog.read / blog.write. Các categoryIds không nhận ra bị bỏ đi chứ không làm hỏng cả lần nhập — so với phản hồi để biết cái nào đã dính.