Back to Main Site

Giao diện Head Random trong PolyCMS cho RISE CRM

Last updated on Nov 22, 2026 10:47 AM 10:47 AM 2,361.65 ms

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 Columns hoặc 4 Columns.
  • Menu Alignment: Căn chỉnh vị trí thanh menu chính theo kiểu Left, Center, Right (mặc định) hoặc Space 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 đến 15, mặc định 8).
  • 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 đến 500, mặc định 150).

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 đến 80 px, mặc định 40).

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_options khi 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 trong plugins/polycms/themes/ với slug và Theme Name riêng trong style.css.

Tài liệu liên quan