Hướng dẫn Widgets và Sidebars trong PolyCMS cho RISE CRM
Widgets là các khối nội dung mô-đun giúp bạn bố trí thông tin vào những Khu vực Widget (Widget Areas) do theme định nghĩa như thanh bên blog và vùng chân trang mà không cần chỉnh sửa mã giao diện. Được quản lý tại Appearance > Widgets (/polycms/widgets) và lưu trong bảng {db_prefix}blog_widgets, PolyCMS cho RISE CRM tích hợp sẵn 9 lớp widget trong plugins/polycms/widgets/ cùng 3 mã shortcode động để nhúng lưới bài viết trực tiếp vào thân bài viết và trang tĩnh.
9 Widget tích hợp sẵn
Cả 9 lớp widget tiêu chuẩn đều đặt tại plugins/polycms/widgets/ và sẵn sàng kéo thả vào mọi khu vực widget của theme:
| Tên Widget | Tệp lớp PHP | Mô tả chức năng |
|---|---|---|
| Latest Posts | Latest_Posts_Widget.php |
Hiển thị danh sách bài viết mới xuất bản kèm ảnh thu nhỏ, ngày đăng và số lượng tùy chọn (1 đến 20) |
| Popular Posts | Popular_Posts_Widget.php |
Xếp hạng và hiển thị các bài viết được xem nhiều nhất theo tổng lượt xem ghi nhận |
| Categories | Categories_Widget.php |
Liệt kê chuyên mục theo dạng cây phân cấp hoặc danh sách phẳng kèm số lượng bài viết |
| Tags Cloud | Tags_Cloud_Widget.php |
Hiển thị đám mây thẻ tag trực quan với cỡ chữ tỷ lệ thuận theo tần suất sử dụng |
| Archive | Archive_Widget.php |
Tổng hợp bài viết theo tháng hoặc năm dưới dạng danh sách hoặc hộp chọn thả xuống |
| Author Bio | Author_Widget.php |
Hiển thị ảnh đại diện, tiểu sử ngắn và liên kết mạng xã hội của tác giả |
| Live Search | Search_Widget.php |
Khung tìm kiếm trực tiếp bằng AJAX trả về danh sách kết quả tức thì ngay khi gõ |
| Custom HTML | Custom_HTML_Widget.php |
Nhúng mã HTML thuần, CSS tùy chỉnh, biểu mẫu nhận tin hoặc mã nhúng bên thứ ba (bản đồ, banner) |
| Menu Widget | Menu_Widget.php |
Kết xuất bất kỳ menu điều hướng nào đã tạo trong Appearance > Menus |
Các bước cấu hình Widget
Để thêm mới, tùy chỉnh hoặc sắp xếp lại widget trên giao diện công khai:
- Truy cập Appearance > Widgets (
/polycms/widgets) trên thanh bên trái của RISE CRM. - Chọn khu vực Widget (Widget Area) - Lựa chọn vùng hiển thị do giao diện đang kích hoạt hỗ trợ (như Blog Sidebar hoặc Footer Widgets).
- Thêm Widget - Kéo widget cần dùng từ danh sách bên cạnh thả vào khu vực mục tiêu.
- Thiết lập thông số - Nhấp vào widget vừa thêm để mở khung cấu hình:
- Nhập Tiêu đề Widget (Widget Title) hiển thị phía trên khối nội dung.
- Tùy chỉnh thông số riêng của từng loại widget như số bài hiển thị, chuyên mục lọc, kiểu trình bày hoặc menu cần gọi.
- Sắp xếp thứ tự - Kéo thả widget lên hoặc xuống bên trong cùng khu vực để thay đổi thứ tự xuất hiện.
- Lưu cấu hình - Nhấn Save để ghi lại thay đổi vào bảng
{db_prefix}blog_widgets.
Các khu vực Widget của Theme
Danh sách khu vực đặt widget phụ thuộc vào giao diện đang kích hoạt. Theme mặc định Head Random (plugins/polycms/themes/head-random/) đăng ký sẵn hai khu vực chính:
sidebar(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 viết.footer(Footer Widgets) - Khu vực nhiều cột ở chân trang xuất hiện đồng nhất trên toàn bộ các trang CMS công khai.
Các theme tự phát triển có thể đăng ký thêm nhiều khu vực widget khác nhau phục vụ trang đích, tài liệu hướng dẫn hoặc đầu trang.
3 Shortcode tích hợp sẵn
Bên cạnh widget ở thanh bên và chân trang, PolyCMS cung cấp 3 trình xử lý shortcode lõi trong plugins/polycms/shortcodes/. Được đăng ký qua polycms_register_shortcode($tag, $callback) và phân tích tự động bằng polycms_do_shortcode($content), shortcode cho phép bạn nhúng danh sách bài viết động ngay bên trong nội dung bài viết hoặc trang tĩnh.
| Shortcode | Tham số hỗ trợ | Chức năng hiển thị |
|---|---|---|
[polycms_post] |
id, slug, layout (card, list, compact), show_thumbnail, show_excerpt |
Nhúng một hoặc nhiều bài viết cụ thể vào bài viết hay trang tĩnh |
[polycms_category] |
slug, count, columns (2, 3, 4), order (DESC, ASC), orderby (date, views) |
Hiển thị lưới bài viết chuẩn Bootstrap 5 lọc theo chuyên mục |
[polycms_tag] |
slug, count, columns |
Hiển thị lưới bài viết khớp với một slug thẻ tag cụ thể |
Ví dụ cách chèn Shortcode
Gõ trực tiếp cú pháp shortcode vào bất kỳ đoạn nào trong trình soạn thảo TinyMCE khi viết bài hoặc tạo trang:
[polycms_category slug="tutorials" count="6" columns="3" orderby="date" order="DESC"]
Khi độc giả mở trang ngoài giao diện, PolyCMS sẽ tự động biên dịch shortcode và hiển thị danh sách bài viết mới nhất theo đúng tiêu chí đã khai báo.
Tài liệu liên quan
- Quản lý Giao diện Theme trong PolyCMS cho RISE CRM - Kích hoạt và quản lý các giao diện định nghĩa Widget Areas.
- Giao diện mặc định Head Random trong PolyCMS cho RISE CRM - Chi tiết bố cục khu vực
sidebarvàfootercủa Head Random. - Xây dựng Theme tùy biến cho PolyCMS trên RISE CRM - Hướng dẫn đăng ký khu vực widget mới trong theme riêng.
- Hướng dẫn tạo Shortcode tùy biến trong PolyCMS cho RISE CRM - Dành cho lập trình viên đăng ký shortcode mới bằng
polycms_register_shortcode().