Plugin Maintenance Mode trong PolyCMS cho RISE CRM
Plugin Maintenance Mode tích hợp sẵn cho phép bạn hiển thị trang thông báo "Đang bảo trì" hoặc "Sắp ra mắt" mang dấu ấn thương hiệu riêng với toàn bộ khách truy cập công khai, trong khi nhân sự và quản trị viên RISE CRM đã đăng nhập vẫn truy cập trang quản trị và xem trước giao diện CMS hoàn toàn bình thường. Plugin tự động phản hồi mã trạng thái HTTP 503 Service Unavailable kèm header Retry-After để bảo vệ thứ hạng SEO trong thời gian bảo trì tạm thời.
Kích hoạt plugin
- Trong RISE CRM, đi tới PolyCMS > Plugins.
- Tìm plugin Maintenance Mode và nhấn Activate.
- Sau khi kích hoạt, nhấn Settings trên thẻ plugin hoặc mở lối tắt Appearance > Maintenance Mode (
/polycms/plugins/settings/maintenance-mode) ở thanh bên trái.
Việc kích hoạt plugin không lập tức chặn khách truy cập. Bạn có thể thoải mái thiết kế nội dung, chọn hình nền và xem trước giao diện bảo trì rồi mới bật công tắc khi sẵn sàng.
Các tùy chọn cấu hình
Màn hình cấu hình Maintenance Mode được chia làm hai cột gồm bảng thiết lập bên trái và khung Preview cập nhật tức thì theo thời gian thực bên phải:
| Tùy chọn | Giá trị mặc định | Mô tả |
|---|---|---|
| Enable Maintenance Mode | Tắt (0) |
Bật hoặc tắt nhanh chế độ bảo trì mà không cần hủy kích hoạt plugin. |
| Page Title | Under Maintenance |
Tiêu đề chính trên màn hình bảo trì và tiêu đề thẻ trình duyệt. |
| Message | Thông báo bảo trì định kỳ | Nội dung chi tiết soạn bằng trình soạn thảo TinyMCE, hỗ trợ định dạng HTML. |
| Retry After (s) | 3600 |
Số giây gửi kèm trong HTTP header Retry-After (tối thiểu 60, bước nhảy 60). |
| Colors (BG / Text) | #1a1a2e / #ffffff |
Bộ chọn màu nền và màu chữ cho giao diện trang bảo trì. |
| Background Image | Trống | Ảnh nền toàn màn hình chọn trực tiếp từ Thư viện Media PolyCMS (files/polycms/). |
| Overlay (Opacity / Blur) | 100% / 0px |
Thanh trượt điều chỉnh độ mờ trong suốt (0% đến 100%) và độ nhòe nền (0px đến 20px). |
Ví dụ thông điệp bảo trì
Vì ô Message tích hợp sẵn trình soạn thảo TinyMCE tự lưu trữ và cho phép HTML sạch, bạn có thể trình bày rõ khung giờ nâng cấp và thông tin liên hệ hỗ trợ:
<h2>Chúng tôi sẽ sớm quay trở lại!</h2>
<p>Website hiện đang trong quá trình nâng cấp hệ thống định kỳ nhằm mang lại trải nghiệm nhanh và ổn định hơn.</p>
<p>Vui lòng quay lại sau 1 giờ hoặc liên hệ đội ngũ hỗ trợ nếu bạn cần trợ giúp khẩn cấp.</p>
Trang bảo trì cũng tự động hiển thị logo website (ưu tiên logo từ theme Head Random, dự phòng sang logo công ty của RISE CRM) và favicon để giữ nhận diện thương hiệu đồng nhất.
Cơ chế tự động bỏ qua và thông báo quản trị
Maintenance Mode chặn các yêu cầu giao diện công khai ở mức ưu tiên 1 trên hook polycms_frontend_init nhưng vẫn đảm bảo quy trình làm việc nội bộ và bot kỹ thuật hoạt động suôn sẻ:
- Nhân sự và Quản trị viên đã đăng nhập: Mọi tài khoản nhân sự hoặc quản trị viên RISE CRM đang đăng nhập sẽ tự động bỏ qua màn hình bảo trì để xem trước bài viết, giao diện theme và bố cục MTBuilder như bình thường.
- Trang quản trị RISE CRM: Toàn bộ các đường dẫn
/polycms/*và phân hệ lõi của RISE CRM luôn hoạt động không gián đoạn. - Thanh cảnh báo quản trị: Khi chế độ bảo trì đang bật, PolyCMS hiển thị biểu ngữ cảnh báo nổi bật trên các trang quản trị PolyCMS để nhắc đội ngũ rằng khách truy cập bên ngoài đang thấy màn hình bảo trì.
- Tệp kỹ thuật thiết yếu: Các đường dẫn
sitemap.xml,robots.txtvàfavicon.icođược bỏ qua tự động để công cụ tìm kiếm và trình duyệt không gặp lỗi siêu dữ liệu.
Để kiểm tra chính xác giao diện khách truy cập nhìn thấy, hãy mở đường dẫn blog trong cửa sổ ẩn danh (chưa đăng nhập RISE CRM).
Mã trạng thái HTTP 503 chuẩn SEO
Khi chế độ bảo trì được bật, máy chủ trả về bộ header và thẻ meta chuẩn cho khách truy cập công khai và trình thu thập dữ liệu:
HTTP/1.1 503 Service Unavailable
Retry-After: 3600
Content-Type: text/html; charset=UTF-8
Đồng thời, vùng <head> của trang bảo trì chèn chỉ thị robots noindex, nofollow. Phản hồi mã 503 thay vì 200 hay 404 giúp Google và Bing hiểu rằng website chỉ tạm ngừng ngắn hạn, giữ nguyên chỉ mục hiện có và quay lại thu thập sau thời gian khai báo trong Retry-After.
Các tình huống sử dụng phổ biến
| Tình huống | Quy trình khuyến nghị |
|---|---|
| Xây dựng website trước ngày ra mắt | Đổi tiêu đề thành "Sắp ra mắt", tùy chỉnh logo/màu sắc và bật Maintenance Mode trong lúc dựng trang bằng MTBuilder. |
| Chuyển đổi hoặc thiết kế lại Theme | Bật chế độ bảo trì trong lúc kích hoạt theme mới, tinh chỉnh menu và widget, đồng thời xem trước bằng tài khoản nhân sự. |
| Di chuyển hoặc khôi phục dữ liệu lớn | Tránh để độc giả thấy nội dung thiếu đồng bộ trong quá trình nhập JSON hoặc khôi phục bản sao lưu SQL. |
| Rà soát nội dung định kỳ | Tạm đóng truy cập công khai trong khi kiểm duyệt và cập nhật hàng loạt tài liệu hoặc thông báo quan trọng. |
Tài liệu liên quan
- Quản lý Plugins trong PolyCMS - Kích hoạt và cấu hình các plugin đi kèm.
- Quản lý Giao diện Theme - Chuyển đổi và tinh chỉnh giao diện an toàn trong thời gian bảo trì.
- Sao lưu và Khôi phục Cơ sở dữ liệu - Tạo bản sao lưu SQL trước khi tiến hành nâng cấp lớn.