Hướng dẫn sử dụng Widgets và Sidebars trong PolyCMS
Tổng quan về hệ thống Widget
Các Widget là các khối nội dung dạng mô-đun được kéo thả vào các khu vực hiển thị do theme định nghĩa được gọi là **Widget Areas** (như thanh bên sidebars, khu vực chân trang footer...). PolyCMS đi kèm sẵn 9 widget hữu ích để bạn sử dụng ngay.
Các Widget tích hợp sẵn
| Tên Widget | Mô tả hoạt động |
|---|---|
| Latest Posts | Hiển thị danh sách các bài viết mới nhất với số lượng tùy chỉnh |
| Popular Posts | Hiển thị danh sách các bài viết được xem nhiều nhất nhờ cơ chế tracking lượt xem |
| Categories | Liệt kê danh sách chuyên mục kèm số lượng bài viết tương ứng |
| Tags Cloud | Hiển thị đám mây thẻ tag trực quan với kích thước chữ tương ứng độ phổ biến |
| Search | Khung tìm kiếm nội dung bài viết ngoài frontend |
| Recent Comments | Hiển thị danh sách các bình luận mới được phê duyệt đi kèm trích dẫn ngắn |
| Archives | Lưu trữ bài viết theo từng tháng, từng năm |
| Custom HTML | Khối chèn mã nguồn HTML tự do tiện lợi |
| Social Links | Các nút liên kết mạng xã hội đi kèm biểu tượng icon trực quan |
Các bước cấu hình Widget
Di chuyển đến mục Blog > Widgets để quản lý vị trí các widget:
- Chọn Widget Area: Lựa chọn khu vực hiển thị do theme đang hoạt động hỗ trợ (ví dụ: "Blog Sidebar - Thanh bên tin tức", "Footer Column 1 - Cột chân trang 1").
- Thêm Widget: Kéo các widget mong muốn từ danh sách có sẵn thả vào khu vực hiển thị chỉ định.
- Cấu hình thông số: Nhấp chọn vào widget trong danh sách để mở rộng cấu hình chi tiết:
- Tiêu đề của widget hiển thị ra ngoài giao diện.
- Các thông số đặc thù của widget (ví dụ: số lượng bài viết cần hiển thị, chọn chuyên mục cần lọc...).
- Sắp xếp thứ tự: Kéo di chuyển các widget lên hoặc xuống để thay đổi thứ tự xuất hiện của chúng trên sidebar.
- Lưu cấu hình: Bấm Save để hoàn tất cập nhật.
Các khu vực Widget (Widget Areas)
Các khu vực đặt widget được định nghĩa bởi theme đang hoạt động. Đối với theme mặc định **Head Random** cung cấp sẵn:
- Blog Sidebar — Thanh bên phải hiển thị trên trang danh sách bài viết và trang chi tiết bài đăng.
- Footer Widgets — Khu vực chân trang xuất hiện trên toàn bộ các trang ngoài blog.
Các theme tùy biến có thể tự đăng ký thêm các khu vực đặt widget khác. Xem thêm thông tin chi tiết tại bài viết Tự viết một giao diện Theme cho PolyCMS.
Sử dụng Shortcodes
Mã Shortcode cung cấp giải pháp nhanh giúp bạn nhúng trực tiếp các nội dung động vào bên trong bài viết hoặc trang tĩnh bằng cú pháp ngoặc vuông đơn giản.
Các mã Shortcode hỗ trợ sẵn
| Cú pháp Shortcode | Chức năng hiển thị |
|---|---|
[recent_posts count="5"] | Nhúng danh sách bài viết mới nhất ngay trong nội dung |
[post id="42"] | Nhúng hiển thị một bài viết chỉ định theo mã ID |
[categories] | Kết xuất danh sách các chuyên mục phân loại |
Cách thức sử dụng
Bạn chỉ cần gõ đúng cú pháp shortcode vào bất kỳ vị trí nào trong khu vực biên tập TinyMCE. Hệ thống PolyCMS sẽ tự động biên dịch và hiển thị nội dung động tương ứng khi độc giả truy cập trang ngoài blog.
Để học cách tự viết các mã shortcode tùy biến riêng, hãy xem bài viết Hướng dẫn lập trình Shortcode tùy biến.
Tài liệu hướng dẫn liên quan
- Quản lý Giao diện Themes — Tìm hiểu các Widget Areas do theme định nghĩa.
- Tự phát triển Giao diện Themes — Cách đăng ký thêm các khu vực đặt widget mới.
- Viết Shortcode tùy biến — Hướng dẫn đăng ký shortcode mới cho nhà phát triển.