08 — Quản lý Blog & bài viết

Hệ thống Blog dùng Blog Post và Blog Category — DocType chuẩn của Frappe, nhưng trang /blog ở Mantis Tech được dựng lại bằng block blog_posts_filterable bên trong Mantis Web Page blog, hỗ trợ filter theo category.

1. Các DocType liên quan

DocType	Desk path	Mục đích
Blog Post	`/app/blog-post`	Bài viết.
Blog Category	`/app/blog-category`	Danh mục (AI, IoT, ERP, Hardware, Case Study).
Blogger	`/app/blogger`	Tác giả. Mặc định: "Mantis Tech".

2. Viết bài mới

Vào /app/blog-post/new.
Điền các trường chính:

Trường	Ý nghĩa
Title	Tiêu đề bài viết (đồng thời là H1).
Blog Category	Chọn 1 trong danh mục có sẵn. Cần thêm danh mục mới? Vào `/app/blog-category/new` 🛡️.
Blogger	Tác giả. Nếu viết với tư cách công ty, chọn "Mantis Tech".
Route	Tự sinh từ tiêu đề. Có thể chỉnh tay để tối ưu URL.
Blog Intro	Đoạn mở ngắn (≤ 200 ký tự). Dùng làm preview trên danh sách `/blog` và `<meta description>`.
Content	Rich text editor. Nội dung chính.
Meta Image	Ảnh Open Graph 1200×630 — dùng khi share mạng xã hội.
Published	Tick để bài xuất hiện trên `/blog`.
Published On	Ngày xuất bản (mặc định = hôm nay). Có thể đặt lùi/quá khứ để sắp xếp.

Save.

2.1. Viết nội dung bằng Rich Text

Paste từ Notepad (không dán trực tiếp từ Word/Google Docs → kéo theo style ẩn).
Sử dụng H2/H3 cho cấu trúc nội dung — Google thích điều này.
Chèn ảnh: nút ảnh trên toolbar → upload → alt text tiếng Việt.
Chèn link: bôi đen chữ → nút link → dán URL.
Hạn chế dùng màu chữ/nền lòe loẹt.

2.2. Cấu trúc bài viết khuyến nghị

Đoạn mở (1–2 câu) — lặp lại trong Blog Intro.
H2 section chính (3–5 section).
Mỗi H2 có 1–2 đoạn + (tùy chọn) bullet list.
Case study bắt buộc có phần Kết quả đo lường được (KPI, % cải thiện).
Kết bài + CTA (link đến /products/... hoặc /request-demo).

3. Blog Category

Vào /app/blog-category. Mỗi category có:

Category — tên (vd AI, Case Study).
Route (tự sinh) — URL dạng /blog?category=<slug>.
Published — tick để xuất hiện trong filter.

Danh mục sẽ hiện dưới dạng tab lọc trên /blog nhờ block blog_posts_filterable.

4. Sắp xếp & hiển thị

/blog lọc theo Published = 1, sắp xếp giảm dần theo Published On.
Block blog_posts_filterable có thể cấu hình số bài / trang (mặc định 9) qua Mantis Web Page blog.
Block Featured Blog Posts (nếu có trên trang Home) tự pick bài được tick "Featured" — hiện tại dùng cờ trong Mantis Web Page blocks, không phải cờ trên Blog Post.

5. Preview trước khi Publish

Tạo bài với Published = 0.
Vào /app/blog-post/<name> → Menu ⋮ → Preview (nếu có) hoặc mở /<route> kèm query ?allow_guest_view=1 (chỉ khi login).
Khi đã hài lòng, tick Published → Save.

Blog Post chưa publish vẫn có thể xem được bởi user đã đăng nhập với role Editor — khác với Mantis Product (trả 404 khi draft).

6. Cập nhật bài đã publish

Sửa trực tiếp trong form Blog Post → Save.
Trang /blog/<slug> cập nhật ngay (có thể mất ≤ 60 giây do website cache).

7. Xoá / unpublish bài

Unpublish: bỏ tick Published → Save. Bài ẩn khỏi /blog.
Xoá vĩnh viễn 🛡️: menu ⋮ → Delete. Lưu ý URL cũ sẽ thành 404.

8. Checklist xuất bản

Title ≤ 60 ký tự.
Blog Intro 140–200 ký tự.
Ít nhất 1 ảnh trong content + 1 Meta Image (1200×630).
Có ≥ 2 internal link sang trang sản phẩm/solution.
Blog Category đã chọn đúng.
Tick Published, Save, kiểm tra /blog và /blog/<slug>.

MantisTech Web — Hướng dẫn sử dụng