Back to Main Site

Hướng dẫn Widgets và Sidebars trong PolyCMS cho RISE CRM

Last updated on Nov 22, 2026 7:37 AM 7:37 AM 2,130.39 ms

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:

  1. Truy cập Appearance > Widgets (/polycms/widgets) trên thanh bên trái của RISE CRM.
  2. 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).
  3. 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.
  4. 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.
  5. 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.
  6. 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