Xây trang web riêng trên CMS của i-Catholic
Phần này dành cho đội làm web của một giáo phận, giáo xứ hay cơ sở Công giáo muốn dựng trang web công khai của riêng mình (tên miền riêng, giao diện riêng), còn nội dung thì do nhân sự của đơn vị soạn ngay trong trang quản trị i-Catholic.
Hai nửa của hệ thống
| Ai | Làm gì | Ở đâu |
|---|---|---|
| Nhân sự của đơn vị | Viết bài, trang, sắp danh mục, thẻ, menu, thông tin liên hệ, bản dịch | Trang quản trị i-Catholic, mục «Trang web» |
| Đội làm web (bạn) | Dựng giao diện, đọc nội dung và hiển thị | Trang web của bạn, gọi API công khai |
API công khai chỉ đọc, không cần đăng nhập, không cần khóa API, và trả về đúng những gì đã được xuất bản. Bản nháp, bài chờ duyệt, bài hẹn giờ chưa tới giờ, bài trong thùng rác đều không bao giờ đi ra qua API này. Bạn không cần (và không thể) xử lý quyền hay tài khoản.
Địa chỉ gốc:
https://api.i-catholic.org/v2/public/cms/{siteSlug}
{siteSlug} là mã trang web của đơn vị bạn, ví dụ giao-xu-cua-ban (chữ thường, số và dấu gạch ngang, tối đa 64 ký tự).
Bắt đầu: xin một trang web
Mỗi đơn vị có tối đa một trang web trên CMS. Trang web do đội ngũ i-Catholic tạo (quản trị nền tảng, mục «Hệ thống CMS»); nhân sự đơn vị không tự tạo được. Khi đã tạo, bạn nhận mã trang web (siteSlug) và danh sách ngôn ngữ đã bật.
Để đề nghị tạo trang web, hãy gửi email tới support@i-catholic.org (hoặc dùng mục «Liên hệ» trong ứng dụng, chủ đề «Hợp tác»; xem Liên hệ hỗ trợ). Ghi rõ tên đơn vị, tên miền dự kiến và các ngôn ngữ cần dùng.
Sau đó nhân sự đơn vị (người quản trị của đơn vị, hoặc người được giao quyền quản lý trang web) vào mục «Trang web» trong trang quản trị để soạn nội dung.
Bạn xây được gì
- Trang chủ với bài nổi bật và bài mới nhất.
- Trang tin theo danh mục (hai cấp) và theo thẻ.
- Trang bài viết và trang tĩnh (Giới thiệu, Liên hệ, ...).
- Menu đầu trang và chân trang do nhân sự tự sắp.
- Tìm kiếm bài viết (không phân biệt dấu) và khối «Đọc nhiều».
- Trang web nhiều ngôn ngữ (tối đa sáu:
vi,en,es,pt,fr,it). - Khối thông tin liên hệ: tên, địa chỉ, điện thoại, giờ làm việc, bản đồ nhúng.
- Loại nội dung riêng với trường tùy chỉnh (ví dụ «Sự kiện» có ngày, địa điểm).
Thuật ngữ
| Thuật ngữ | Nghĩa |
|---|---|
| Site (trang web) | Trang web của một đơn vị, định danh bằng siteSlug. Có một ngôn ngữ chính (primaryLocale) và danh sách ngôn ngữ đã bật (locales). |
| Entry | Một mục nội dung. Có hai loại (type): post (bài viết, có ngày đăng, nằm trong danh sách) và page (trang tĩnh, không bao giờ nằm trong danh sách, không có danh mục hay thẻ). |
| Slug | Phần đường dẫn của entry, ví dụ le-bon-mang. Dùng chung cho mọi ngôn ngữ. |
| Category (danh mục) | Cây tối đa hai cấp. Mỗi bài có một danh mục chính (category) và có thể có thêm danh mục khác (categories). |
| Tag (thẻ) | Nhãn phẳng, không có cấp. |
| Menu | Hai vị trí cố định: primary (đầu trang) và footer (chân trang), mỗi menu tối đa hai cấp. |
| Locale | Mã ngôn ngữ: vi, en, es, pt, fr, it. |
| Featured (nổi bật) | Bài được ghim lên đầu một danh sách (danh sách chung hoặc của một danh mục), tối đa 10 bài, có thể có hạn. |
| Content type (loại nội dung) | Nhóm bài có cùng bộ trường tùy chỉnh; mỗi bài thuộc một loại có contentType là slug của loại đó. |
| Meta | Giá trị của các trường tùy chỉnh trên một entry. |
Đọc theo thứ tự nào
- Bắt đầu nhanh: yêu cầu đầu tiên, hiện danh sách bài và một bài.
- Tham chiếu API: từng đường dẫn, tham số, phản hồi, lỗi.
- Đa ngôn ngữ và đường dẫn: ngôn ngữ dự phòng, slug cũ, SEO.
- Tìm kiếm, lượt xem và «Đọc nhiều».
- Trường tùy chỉnh và loại nội dung.
- Hiệu năng, cache, giới hạn và lỗi: đọc trước khi đưa trang web lên chạy thật.
API là đúng. Mọi trường và giới hạn trên các trang này được lấy từ mã nguồn đang chạy; nếu bạn thấy khác biệt, hãy báo cho chúng tôi.