Back to Main Site

Hướng gian Quản lý Giao diện Theme trong PolyCMS

Last updated on Jul 9, 2026 5:32 PM

Tổng quan về hệ thống Giao diện (Themes)

Hệ thống Themes kiểm soát toàn bộ phong cách thiết kế, bố cục hiển thị ngoài trang chủ của trang blog PolyCMS của bạn. Di chuyển đến mục Blog > Themes để bắt đầu quản trị các giao diện.

Danh sách giao diện hiển thị

Trang quản trị Themes hiển thị toàn bộ các theme được cài đặt theo bố cục ô lưới trực quan:

  • Tên theme, phiên bản hiện tại và thông tin nhà phát triển
  • Hình ảnh minh họa và mô tả ngắn về phong cách theme
  • Trạng thái hoạt động (Đang kích hoạt / Chưa kích hoạt)
  • Nút Kích hoạt nhanh
  • Liên kết Tùy chỉnh giao diện (Theme Options) dành cho theme đang hoạt động

Các bước cài đặt Theme mới

Tải lên tệp tin ZIP (ZIP Upload)

  1. Di chuyển đến mục Blog > Themes.
  2. Nhấp chọn Upload Theme.
  3. Lựa chọn tệp tin nén định dạng .zip chứa mã nguồn theme của bạn.
  4. Hệ thống sẽ giải nén, thực hiện quét kiểm duyệt bảo mật và tự động đưa các tệp tin vào thư mục modules/polycms/themes/.
  5. Sau khi cài đặt xong, nhấn nút Activate để đổi giao diện mới.

Cài đặt thủ công

Tải thư mục theme giải nén trực tiếp lên máy chủ tại đường dẫn modules/polycms/themes/ thông qua FTP hoặc trình quản lý tệp tin.

Bảo mật hệ thống Theme

Khi bạn thực hiện cài đặt theme thông qua tệp ZIP, PolyCMS áp dụng các lớp kiểm duyệt bảo mật nghiêm ngặt:

  • Phát hiện và bóc tách các hàm PHP nguy hiểm có khả năng đe dọa hệ thống.
  • Kiểm tra tính hợp lệ của các tệp tin trong gói cài đặt.
  • Sử dụng hàm polycms_validate_file_path để ngăn chặn triệt để tấn công dò tìm thư mục chéo.

Thiết lập cấu hình giao diện (Theme Options)

Mỗi theme khi hoạt động có hỗ trợ trang cấu hình riêng sẽ hiển thị nút **Theme Options**. Trang cấu hình cho phép quản trị viên tùy biến nhanh:

  • Tải lên logo và biểu tượng favicon tùy chọn của trang
  • Thiết lập bảng màu chủ đạo và các tùy chọn bố cục hiển thị
  • Cấu hình thông tin khu vực Header và Footer
  • Nhập liên kết các trang mạng xã hội hiển thị trên các icon điều hướng
  • Nhúng các đoạn mã CSS tùy chỉnh (Custom CSS)

Các lập trình viên theme có thể đăng ký các tùy chọn cấu hình này thông qua API Theme Options. Xem chi tiết tại bài viết Tự tạo một Theme tùy biến.

Theme mặc định đi kèm: Head Random

PolyCMS đi kèm sẵn giao diện theme **Head Random** chuyên nghiệp với:

  • Bố cục blog thiết kế hiện đại, tương thích responsive hoàn hảo bằng Bootstrap 5
  • Thanh đầu trang tối màu tích hợp thanh tìm kiếm bài viết
  • Menu hamburger thu gọn tối ưu cho trải nghiệm di động
  • Thanh bên hỗ trợ chèn các tiện ích widget linh hoạt
  • Mã nguồn tối ưu SEO
  • Các tệp template hiển thị bài viết và trang tĩnh sạch sẽ, dễ đọc

Xem hướng dẫn cấu hình chi tiết tại Cấu hình Theme Head Random.

Chế độ xem trước giao diện (Theme Preview Mode)

Thử nghiệm giao diện thiết kế mới một cách an toàn thông qua **Chế độ xem trước (Preview Mode)**.

  • Quản trị viên có thể nhấn chọn Preview trên bất kỳ theme nào trong danh sách để xem thử giao diện blog hiển thị thực tế ngoài trang chủ.
  • Trạng thái xem trước chỉ áp dụng dựa trên phiên làm việc (session-based) và chỉ hiển thị đối với duy nhất nhân sự thực hiện.
  • Khách truy cập công cộng ngoài trang chủ hoàn toàn không bị ảnh hưởng, vẫn tiếp tục xem blog bằng theme đang hoạt động bình thường.
  • Hệ thống hiển thị một thanh thông báo nhỏ ở trang ngoài blog trong suốt quá trình preview kèm nút thoát nhanh chế độ xem trước.

Child Themes (Theme con)

PolyCMS hỗ trợ cấu trúc **Child Themes**, giúp các nhà phát triển dễ dàng sửa đổi hoặc ghi đè giao diện của theme cha mà không lo bị mất dữ liệu chỉnh sửa khi theme cha cập nhật phiên bản mới.

Các bước khởi tạo child theme:

  1. Tạo một thư mục theme mới trên máy chủ (ví dụ: head-random-child).
  2. Tạo tệp style.css bên trong thư mục và khai báo tiêu đề Template trỏ đến tên thư mục của theme cha:
   /*
   Theme Name: Head Random Child
   Template: head-random
   */
  1. Hệ thống PolyCMS sẽ tự động áp dụng quy tắc tải giao diện: tìm kiếm và nạp các tệp template ở child theme trước, nếu không tìm thấy sẽ tự động sử dụng tệp tương ứng ở theme cha.

Hệ thống phân cấp Template (Template Hierarchy)

Giao diện theme được hiển thị theo thứ tự ưu tiên phân cấp tệp tin mẫu như 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 hiển thị trang tĩnh
archive.php     → Trang danh sách lưu trữ bài viết theo thời gian
search.php      → Trang hiển thị kết quả tìm kiếm
index.php       → Tệp tin mẫu dự phòng cuối cùng của theme

Ngoài ra, theme có thể tự định nghĩa thêm các trang mẫu tùy biến (ví dụ: page-contact.php) để quản trị viên chọn chèn nhanh khi soạn thảo trang tĩnh.

Tài liệu hướng dẫn liên quan