Giao diện Head Random trong PolyCMS cho RISE CRM
Head Random là giao diện mặc định xây dựng trên Bootstrap 5 đi kèm PolyCMS cho RISE CRM tại thư mục plugins/polycms/themes/head-random/. Theme được cài đặt và kích hoạt tự động ngay khi cài đặt plugin, mang lại bố cục blog đa cột chuẩn responsive, khối Hero tùy biến, bộ lọc chuyên mục, hai khu vực widget sidebar và footer, gói ngôn ngữ Anh - Việt tích hợp sẵn và bảng tùy chỉnh đầy đủ tại Appearance > Theme Options.
Các tính năng nổi bật của Head Random
- Hệ thống lưới Bootstrap 5 Responsive: Hiển thị sắc nét trên máy tính, máy tính bảng và điện thoại cùng menu thu gọn tối ưu cho di động.
- Khối Hero đầu trang linh hoạt: Hỗ trợ biến
{company}tự động lấy tên doanh nghiệp trong RISE CRM và nút kêu gọi hành động CTA tùy chọn. - Bố cục lưới bài viết và bộ lọc chuyên mục: Cho phép chọn hiển thị 1, 2, 3 hoặc 4 cột bài viết trên mỗi hàng và bật thanh lọc theo chuyên mục ngay tại trang chủ blog.
- Kiểm soát chi tiết thành phần bài viết: Bật hoặc tắt ảnh đại diện, đoạn trích, độ dài đoạn trích, nhãn chuyên mục trên ảnh, thẻ tag và thông tin meta ở cả trang danh sách lẫn trang chi tiết.
- Tiện ích cuộn trang thông minh: Hỗ trợ nút cuộn lên đầu trang (cấu hình riêng cho frontend và admin) cùng cơ chế tự động cuộn mượt khi chuyển trang phân trang.
- Hỗ trợ đa ngôn ngữ sẵn có: Tự động nạp chuỗi dịch tiếng Anh và tiếng Việt từ
plugins/polycms/themes/head-random/languages/thông qua hàm trợ giúp_tl().
Thiết lập Giao diện tại Appearance > Theme Options
Đảm bảo theme Head Random đang ở trạng thái kích hoạt tại Appearance > Themes (/polycms/themes), sau đó truy cập Appearance > Theme Options (/polycms/theme-options). Toàn bộ thiết lập của Head Random được lưu trong {db_prefix}blog_theme_options và đọc trong template bằng hàm headrandom_option($key, $default).
Thương hiệu (Branding)
- Site Logo: Tải lên logo thương hiệu (khuyến nghị kích thước
40x40px). Nếu để trống, phần đầu trang sẽ hiển thị chữ cái viết tắt tên công ty từ RISE CRM. - Blog Title: Tiêu đề hiển thị trên header, hỗ trợ biến
{company}để tự động chèn tên doanh nghiệp.
Khối đầu trang (Hero Section)
- Show Hero Section: Bật hoặc tắt khối banner Hero trên trang chủ blog.
- Hero Title: Tiêu đề lớn hỗ trợ biến
{company}(mặc định hiển thị"Welcome to {Company}"khi bỏ trống). - Hero Subtitle: Đoạn mô tả ngắn nằm ngay dưới tiêu đề chính.
- CTA Button Text & URL: Văn bản và liên kết cho nút kêu gọi hành động (để trống văn bản để ẩn nút).
Bố cục & Hiển thị (Layout & Appearance)
- Posts per Row: Lựa chọn số cột hiển thị cho lưới bài viết:
1 Column,2 Columns(mặc định),3 Columnshoặc4 Columns. - Menu Alignment: Căn chỉnh vị trí thanh menu chính theo kiểu
Left,Center,Right(mặc định) hoặcSpace Between. - Show Category Filter & Max Categories in Filter: Bật thanh tab lọc chuyên mục trên trang chủ và giới hạn số lượng hiển thị (từ
3đến15, mặc định8). - Show Excerpt & Excerpt Length: Bật đoạn tóm tắt trên thẻ bài viết và đặt số ký tự tối đa (từ
50đến500, mặc định150).
Thành phần Danh sách (Archive & List Elements)
- Show Featured Image: Bật hoặc tắt ảnh đại diện ở danh sách bài viết, trang chuyên mục, thẻ tag, tác giả và kết quả tìm kiếm.
- Show Post Meta: Hiển thị thông tin ngày đăng, tác giả và chuyên mục trên thẻ bài viết.
- Show Category Label on Featured Image: Hiển thị nhãn chuyên mục nổi trực tiếp trên góc ảnh đại diện của thẻ bài.
- Show Tags: Hiển thị danh sách thẻ tag trên thẻ bài viết.
Thành phần Trang chi tiết (Single Detail Elements)
- Show Single Post Meta: Bật hoặc tắt hiển thị siêu dữ liệu trên trang chi tiết bài viết (có thể ghi đè riêng trên từng bài).
- Show Single Page Meta: Bật hoặc tắt hiển thị siêu dữ liệu trên trang chi tiết trang tĩnh (có thể ghi đè riêng trên từng trang).
Liên kết mạng xã hội (Social Links)
- Social Media Links (Repeater): Thêm, chỉnh sửa, xóa và kéo thả thay đổi thứ tự các hồ sơ mạng xã hội gồm Facebook, Twitter / X, Instagram, Pinterest, YouTube, TikTok, LinkedIn, GitHub hoặc Other kèm nhãn hiển thị tùy chọn.
Chân trang (Footer)
- Footer Description: Đoạn giới thiệu ngắn hiển thị phía dưới logo ở chân trang.
Cuộn trang & Điều hướng (Scroll & Navigation)
- Scroll to Top Button (Frontend / Admin): Bật hoặc tắt độc lập nút cuộn về đầu trang ở giao diện blog công khai và trong trang quản trị.
- Auto Scroll on Pagination: Tự động cuộn mượt lên đầu danh sách bài viết khi độc giả nhấn nút chuyển trang.
- Icon Color, Background Color & Button Size (px): Tùy chỉnh mã màu biểu tượng (mặc định
#ffffff), màu nền (mặc định dùng màu thương hiệu chính) và kích thước nút (từ20đến80px, mặc định40).
Cấu trúc tệp Template của Head Random
Toàn bộ tệp nguồn của theme nằm tại plugins/polycms/themes/head-random/:
| Tệp / Thư mục | Vai trò hiển thị |
|---|---|
style.css |
Khai báo siêu dữ liệu theme (Theme Name, Version, Author, Text Domain, Requires PolyCMS). |
functions.php |
Khởi tạo theme: nạp tệp dịch ngôn ngữ (_tl()), cung cấp hàm headrandom_option() và nhúng script cuộn trang ngoài frontend. |
theme-options.php |
Định nghĩa cấu trúc các trường tùy chọn hiển thị tại Appearance > Theme Options. |
blog-homepage.php |
Template chuyên biệt cho trang chủ blog kèm Hero Section, bộ lọc chuyên mục và lưới bài viết. |
index.php |
Template dự phòng mặc định cho trang danh sách bài viết. |
single.php |
Giao diện chi tiết bài viết gồm ảnh đại diện, thông tin tác giả, thẻ tag và bình luận phân cấp. |
page.php |
Giao diện trang tĩnh tương thích cả trình soạn thảo TinyMCE lẫn bố cục toàn chiều rộng từ MTBuilder. |
category.php, tag.php, author.php |
Các template lưu trữ theo chuyên mục, thẻ tag và tác giả nhân sự. |
search.php |
Trang hiển thị kết quả tìm kiếm từ khóa ngoài frontend. |
404.php |
Trang thông báo không tìm thấy nội dung đồng bộ với giao diện chính. |
header.php, footer.php |
Phần đầu trang (logo, menu, tìm kiếm) và chân trang dùng chung cho mọi template. |
partials/ |
Các đoạn giao diện dùng lại giữa trang danh sách và trang chi tiết. |
languages/ |
Thư mục chứa gói ngôn ngữ english và vietnamese (headrandom_lang.php). |
assets/, dist/ |
Mã nguồn CSS/JS và tài nguyên đã biên dịch sẵn cho môi trường vận hành. |
Khu vực Widget và Menu điều hướng
Head Random hiển thị đầy đủ 2 khu vực widget được lõi PolyCMS đăng ký sẵn:
- Sidebar (
sidebar): Hiển thị các widget blog (Search, Latest Posts, Popular Posts, Categories, Tags Cloud, Archive, Author, Custom HTML hoặc Menu) cạnh khung nội dung chính. - Footer (
footer): Hiển thị các cột tiện ích dưới chân trang đồng bộ trên toàn website.
Bạn có thể cấu hình widget tại Appearance > Widgets (/polycms/widgets) và gắn các thanh điều hướng đầu/chân trang tại Appearance > Menus (/polycms/menus).
Khuyến nghị tùy biến an toàn
- Ưu tiên dùng Theme Options: Chỉnh sửa logo, nội dung Hero, số cột bài viết, thẻ mạng xã hội và nút cuộn trang tại Appearance > Theme Options để cấu hình được lưu an toàn trong
{db_prefix}blog_theme_optionskhi nâng cấp PolyCMS. - Kết hợp MTBuilder cho trang đích: Giữ Head Random làm vỏ giao diện header/footer chuẩn và thiết kế các trang chiến dịch bằng PolyCMS > Pages -> Edit with MTBuilder.
- Nhân bản thư mục khi cần sửa sâu mã nguồn: Không nên chỉnh trực tiếp các tệp trong
plugins/polycms/themes/head-random/nếu bạn dự định nâng cấp plugin sau này. Hãy sao chép sang một thư mục mới trongplugins/polycms/themes/với slug vàTheme Nameriêng trongstyle.css.
Tài liệu liên quan
- Quản lý Giao diện Theme trong PolyCMS - Tải lên, kích hoạt, xem trước và chuyển đổi theme tại Appearance > Themes.
- Quản lý Widget và Sidebar trong PolyCMS - Cấu hình 9 widget mặc định trong vùng
sidebarvàfooter. - Hướng dẫn trình dựng Menu trong PolyCMS - Tạo menu điều hướng cho phần header và footer của Head Random.
- Xây dựng Theme tùy biến cho PolyCMS - Hướng dẫn lập trình phát triển theme riêng cho PolyCMS trên RISE CRM.