Quản lý Giao diện Theme trong PolyCMS cho RISE CRM
Hệ thống giao diện (Themes) quyết định toàn bộ nhận diện thương hiệu, bố cục Bootstrap 5, khu vực đặt widget và vị trí menu cho website công khai chạy bằng PolyCMS trên RISE CRM. Được quản trị tại Appearance > Themes (/polycms/themes) và tinh chỉnh qua Appearance > Theme Options (/polycms/theme-options), mọi gói theme đều nằm trong {rise_crm_root}/plugins/polycms/themes/ với cơ chế quét bảo mật tệp ZIP, chế độ xem trước theo phiên làm việc và hỗ trợ Child Themes an toàn khi cập nhật.
Làm quen màn hình quản lý Themes
Truy cập Appearance > Themes từ thanh bên trái của RISE CRM để xem danh sách các giao diện đã cài đặt ở chế độ lưới (Grid View) hoặc danh sách (List View). Mỗi thẻ theme cung cấp đầy đủ thông tin và thao tác:
- Tên giao diện, số phiên bản và thông tin tác giả
- Ảnh xem trước và mô tả ngắn về phong cách thiết kế
- Nhãn trạng thái đang kích hoạt (Active) hoặc chưa kích hoạt (Inactive)
- Nút Activate / Deactivate để bật tắt nhanh
- Nút Preview cho phép xem thử riêng trong phiên quản trị
- Nút Download (xuất gói ZIP) và Delete cho các theme không hoạt động
- Liên kết mở nhanh Theme Options cho giao diện đang dùng
Thông tin theme và các giá trị tùy chỉnh được lưu trữ riêng trong bảng {db_prefix}blog_themes và {db_prefix}blog_theme_options (mặc định rise_blog_themes và rise_blog_theme_options).
Cài đặt giao diện Theme mới
Bạn có thể cài theme trực tiếp từ trang quản trị hoặc tải lên thủ công qua trình quản lý tệp máy chủ.
Tải lên gói nén ZIP (Khuyến nghị)
- Mở Appearance > Themes (
/polycms/themes). - Nhấp vào nút Upload Theme.
- Chọn tệp nén
.zipchứa mã nguồn giao diện của bạn. - PolyCMS tự động kiểm tra cấu trúc tệp nén, quét bảo mật và giải nén vào thư mục
{rise_crm_root}/plugins/polycms/themes/. - Nhấn Activate trên thẻ giao diện vừa cài để áp dụng ra website công khai.
Cài đặt thủ công
Giải nén thư mục theme và tải lên trực tiếp qua SFTP hoặc File Manager vào đường dẫn:
{rise_crm_root}/plugins/polycms/themes/ten-thu-muc-theme/
Tải lại trang Appearance > Themes, hệ thống sẽ tự động nhận diện giao diện mới.
Cơ chế quét bảo mật khi tải Theme
Mỗi tệp ZIP giao diện tải lên tại Appearance > Themes đều trải qua quy trình kiểm định bảo mật phía máy chủ trước khi giải nén:
- Quét mã nguồn PHP để phát hiện và ngăn chặn các hàm thực thi nguy hiểm.
- Xác thực các định dạng tệp hợp lệ bên trong gói nén.
- Áp dụng hàm
polycms_validate_file_pathđể chống tấn công vượt cấp thư mục (ZIP slip / directory traversal).
Tùy biến giao diện bằng Theme Options
Mở Appearance > Theme Options (/polycms/theme-options) để tùy chỉnh giao diện đang kích hoạt mà không cần động đến mã nguồn. Các thẻ cài đặt (hỗ trợ lưu đường dẫn theo URL hash để truy cập nhanh từng mục) thường bao gồm:
- Tải lên logo thương hiệu và biểu tượng favicon của website
- Tùy chỉnh bảng màu chủ đạo, kiểu chữ và bố cục trang
- Thiết lập nội dung khu vực đầu trang (Header) và chân trang (Footer)
- Nhập danh sách đường dẫn mạng xã hội
- Chèn đoạn mã CSS tùy chỉnh (Custom CSS) để tinh chỉnh chi tiết giao diện
Lập trình viên phát triển giao diện có thể khai báo thêm các trường cấu hình riêng thông qua Theme Options API của PolyCMS.
Giao diện mặc định đi kèm: Head Random
PolyCMS cho RISE CRM tích hợp sẵn giao diện Head Random đặt tại plugins/polycms/themes/head-random/ với đầy đủ tính năng sử dụng ngay:
- Thiết kế hiện đại, tương thích hoàn toàn với màn hình di động trên nền tảng Bootstrap 5
- Thanh điều hướng đầu trang tối màu tích hợp logo và tìm kiếm
- Menu hamburger gọn nhẹ trên điện thoại và máy tính bảng
- Hai khu vực Widget tích hợp sẵn (
sidebarvàfooter) - Hỗ trợ sẵn gói ngôn ngữ giao diện tiếng Anh (EN) và tiếng Việt (VI)
- Trang cấu hình Theme Options đầy đủ cùng mã đánh dấu tối ưu SEO
Xem chi tiết hướng dẫn thiết lập tại bài viết Giao diện mặc định Head Random trong PolyCMS cho RISE CRM.
Chế độ xem trước giao diện (Theme Preview Mode)
Bạn có thể thử nghiệm thiết kế mới hoàn toàn an toàn trước khi chuyển đổi giao diện chính thức nhờ Theme Preview Mode:
- Trong Appearance > Themes, nhấn Preview trên bất kỳ theme chưa kích hoạt nào.
- Hệ thống bật trạng thái xem trước theo phiên làm việc (session-based), chỉ hiển thị với đúng tài khoản nhân sự đang thao tác.
- Toàn bộ khách truy cập bên ngoài vẫn nhìn thấy giao diện đang hoạt động mà không bị gián đoạn.
- Một thanh thông báo nổi xuất hiện trên giao diện xem trước cùng nút thoát nhanh chế độ xem thử (
clear_preview) hoặc chuyển sang kích hoạt chính thức.
Hỗ trợ Child Themes (Theme con)
PolyCMS hỗ trợ cấu trúc Child Themes, cho phép lập trình viên mở rộng hoặc ghi đè tệp giao diện và CSS mà không lo mất chỉnh sửa mỗi khi nâng cấp theme cha:
- Tạo một thư mục mới bên trong
plugins/polycms/themes/(ví dụ:plugins/polycms/themes/head-random-child/). - Tạo tệp
style.cssbên trong thư mục đó với tiêu đềTemplatetrỏ tới tên thư mục của theme cha:
/*
Theme Name: Head Random Child
Template: head-random
Version: 1.0.0
*/
- Kích hoạt child theme tại Appearance > Themes. PolyCMS sẽ tìm tệp template trong thư mục child theme trước, sau đó tự động quay về dùng tệp tương ứng ở theme cha nếu tệp đó không bị ghi đè.
Hệ thống phân cấp Template (Template Hierarchy)
Khi xử lý một đường dẫn công khai, PolyCMS tra cứu các tệp mẫu PHP của giao diện theo thứ tự ưu tiên sau:
single.php -> Trang chi tiết bài viết
category.php -> Trang lưu trữ chuyên mục
tag.php -> Trang lưu trữ thẻ tag
page.php -> Trang tĩnh tiêu chuẩn
archive.php -> Trang lưu trữ theo thời gian hoặc tác giả
search.php -> Trang kết quả tìm kiếm
index.php -> Tệp mẫu dự phòng cho mọi trang
Ngoài ra, giao diện có thể đi kèm các trang mẫu đặt tên riêng (như page-contact.php hoặc page-landing.php), tự động hiển thị thành lựa chọn bố cục bên trong khung biên tập Trang tĩnh.
Tài liệu liên quan
- Xây dựng Theme tùy biến cho PolyCMS trên RISE CRM - Tài liệu lập trình tạo theme mới và khai báo Theme Options từ đầu.
- Giao diện mặc định Head Random trong PolyCMS cho RISE CRM - Hướng dẫn tinh chỉnh chi tiết giao diện mặc định đi kèm.
- Hướng dẫn Widgets và Sidebars trong PolyCMS cho RISE CRM - Cấu hình widget vào các vùng hiển thị của theme.
- Hướng dẫn Trình dựng Menu PolyCMS cho RISE CRM - Gắn menu điều hướng vào các vị trí hiển thị do theme cung cấp.