Content Placement System — hướng dẫn admin

Mình gom phần quản lý nội dung theo vị trí vào cùng trang admin MoMo URL để không phải nhớ nhiều công cụ. Luồng chuẩn:

Placement Registry → Content Blocks → Render theo placement_id

Placement Registry là gì?

Mỗi placement ID là một điểm inject cố định trong template (vd post_after_intro, footer_above). Registry mô tả scope, template gợi ý và trạng thái hook — admin không gõ mô tả vị trí bằng tay khi tạo block.

Ví dụ placement đã gắn hook:

Placement ID	Vị trí
global_header_below	Dưới header toàn site
home_hero_after	Sau hero trang chủ
post_after_content	Sau nội dung bài viết
tools_momo_admin_notice	Banner trong trang admin

Danh sách đầy đủ xem tab Vị trí hiển thị tại Quản lý MoMo URL.

Content block

Một block gồm: id, placement_id, type, title, body, CTA (button_text + url), priority, pages / exclude_pages, enabled.

Type hỗ trợ: momo_cta, donate_box, notice, banner, link_card, html_safe (chỉ nội dung tin cậy).

Render trên site

Macro templates/macros/placement.html đọc data/content-placements.json lúc build:

• Không có block enabled → không render gì (an toàn).
• Nhiều block cùng placement → sort theo priority tăng dần.
• pages / exclude_pages lọc theo prefix page.path.

MoMo URL + placement

Tab MoMo URL vẫn audit link https://me.momo.vn/…. API bổ sung content_blocks, placement_ids, display_text để thấy block nào trỏ tới URL đó — không thay thế chức năng thay link thủ công.

QA & deploy

CI chạy python3 scripts/validate_content_placements.py trước zola build. Sửa registry/blocks qua admin → commit JSON → auto deploy GitHub Pages.

Bước tiếp theo

• Mở Quản lý MoMo URL → tab Content blocks → bật block mẫu nếu muốn thử CTA donate.
• Đọc thêm Giới thiệu và Insights để theo dõi deploy/QA.