Cấu hình Permalinks và Đường dẫn tĩnh PolyCMS RISE CRM
PolyCMS cho RISE CRM mang lại hệ thống định tuyến URL chuẩn SEO linh hoạt được quản lý tại PolyCMS > Permalinks (/polycms/permalink-settings) và lưu trong bảng {db_prefix}blog_permalink_settings (mặc định là rise_blog_permalink_settings). Nhờ bộ định tuyến động của CodeIgniter 4, tệp đệm tiền tố files/polycms/.blog_prefix_cache.php và cơ chế set404Override() an toàn, bạn có thể tùy chỉnh tiền tố blog, cấu trúc bài viết, tiền tố chuyên mục/thẻ tag cùng chuyển hướng 301 tự động mà vẫn bảo vệ trọn vẹn các đường dẫn cốt lõi của RISE CRM như /dashboard và /signin.
Tiền tố Blog (Blog Prefix) và chế độ Root CMS
Blog Prefix quy định phân đoạn đường dẫn gốc cho toàn bộ trang bài viết, lưu trữ và tìm kiếm của blog:
| Giá trị tiền tố | Ví dụ URL bài viết | Mục đích sử dụng |
|---|---|---|
blog (mặc định) |
yourdomain.com/blog/bai-viet-mau/ |
Blog doanh nghiệp chạy song song cùng RISE CRM |
news |
yourdomain.com/news/bai-viet-mau/ |
Cổng tin tức hoặc bản tin thông báo nội bộ và đối ngoại |
articles |
yourdomain.com/articles/bai-viet-mau/ |
Thư viện kiến thức và bài viết chuyên môn |
"" (Trống / Root Mode) |
yourdomain.com/bai-viet-mau/ |
Chế độ Root CMS toàn phần với đường dẫn ngắn ngay gốc tên miền |
Để tránh xung đột với hệ thống lõi RISE CRM và CodeIgniter 4, PolyCMS tự động chặn các tiền tố dành riêng: admin, api, assets, uploads, system và application.
Bảo vệ /dashboard và /signin trên RISE CRM
Trên RISE CRM, tùy chọn Homepage Redirect (polycms_enable_homepage_redirect trong PolyCMS > Settings > General) mặc định ở trạng thái TẮT (0). Cơ chế bảo vệ có chủ đích này đảm bảo việc kích hoạt PolyCMS không bao giờ chiếm quyền hoặc làm gián đoạn đường dẫn /signin và /dashboard của nhân sự CRM ngoài ý muốn.
- Giữ Homepage Redirect ở trạng thái TẮT nếu bạn muốn gốc tên miền tiếp tục mở màn hình đăng nhập/bảng điều khiển RISE CRM chuẩn trong khi website CMS hoạt động tại
/bloghoặc/home. - Chỉ bật Homepage Redirect khi bạn chủ động muốn đưa trang chủ CMS (đã cấu hình tại PolyCMS > Settings > Reading) làm trang mặt tiền tại
yourdomain.com/. Ngay cả khi bật, nhân sự truy cập trực tiếp/signinvà/dashboardvẫn làm việc bình thường.
Các cấu trúc Permalink hỗ trợ
Tại PolyCMS > Permalinks, bạn có thể chọn một trong năm mẫu cấu trúc phổ biến hoặc tự lắp ghép mẫu tùy chỉnh:
| Mẫu cấu trúc | Định dạng | Đường dẫn mẫu |
|---|---|---|
| Post Name (Mặc định) | %postname% |
yourdomain.com/blog/bai-viet-mau/ |
| Month and Name | %year%/%monthnum%/%postname% |
yourdomain.com/blog/2026/05/bai-viet-mau/ |
| Day and Name | %year%/%monthnum%/%day%/%postname% |
yourdomain.com/blog/2026/05/15/bai-viet-mau/ |
| Numeric | archives/%post_id% |
yourdomain.com/blog/archives/123/ |
| Plain | "" (tham số truy vấn) |
yourdomain.com/blog?p=123 |
Khi tự định nghĩa mẫu đường dẫn, bạn có thể kết hợp 10 thẻ biến hỗ trợ sẵn: %year%, %monthnum%, %day%, %hour%, %minute%, %second%, %post_id%, %postname%, %category% và %author%. Ngoài ra, bạn còn có thể bật hoặc tắt tùy chọn Use Trailing Slash để đồng nhất dấu / ở cuối đường dẫn.
Đường dẫn Chuyên mục (Category Base) và Thẻ tag (Tag Base)
Bạn có thể tùy chỉnh từ khóa phân đoạn cho trang lưu trữ phân loại (chỉ nhập một phân đoạn đơn không chứa dấu /):
- Category Base - Mặc định
category->yourdomain.com/blog/category/huong-dan. Đổi thànhtopicssẽ choyourdomain.com/blog/topics/huong-dan. - Tag Base - Mặc định
tag->yourdomain.com/blog/tag/rise-crm. Đổi thànhlabelsẽ choyourdomain.com/blog/label/rise-crm.
Định tuyến động CodeIgniter 4 và bộ nhớ đệm tiền tố
Thay vì bắt buộc quản trị viên chỉnh sửa thủ công .htaccess của Apache hay khối cấu hình Nginx sau mỗi thay đổi, PolyCMS xử lý định tuyến động trong plugins/polycms/config/Routes.php:
- Tệp đệm tiền tố (Prefix Cache) - Mỗi lần bạn nhấn lưu tại PolyCMS > Permalinks, hệ thống ghi lại
prefixmới,old_prefixcũ và mã chuyển hướng vàofiles/polycms/.blog_prefix_cache.php, đồng thời tự động xóa bộ nhớ đệm HTML giao diện công khai trongwritable/polycms/cache/. - Định tuyến tiền tố động -
Routes.phpđọc trực tiếp.blog_prefix_cache.phpở mỗi truy vấn mà không tốn truy vấn cơ sở dữ liệu để đăng ký các tuyến/search,/comment/submit,/author/{id}, phân trang, chuyên mục, thẻ tag và bài viết dưới tiền tố đã chọn. - Cơ chế dự phòng
set404Override()an toàn - Đối với các trang tĩnh nằm ngay gốc tên miền (như/gioi-thieu) và chế độ Root CMS không tiền tố (""), PolyCMS sử dụng hàm callbackset404Override()của CodeIgniter 4 chuyển vềFrontend::catch_all(). Toàn bộ đường dẫn gốc của RISE CRM luôn được ưu tiên xử lý trước; nếu đường dẫn khớp với trang tĩnh hoặc bài viết CMS đã xuất bản, hệ thống trả về HTTP 200 và hiển thị nội dung; ngược lại hệ thống khôi phục đúng mã lỗi HTTP 404.
Nếu bạn gặp lỗi 404 ngoài giao diện sau khi chuyển máy chủ hoặc thay đổi thư mục thủ công, chỉ cần vào PolyCMS > Permalinks và nhấn Save Settings để tạo mới tệp files/polycms/.blog_prefix_cache.php.
Bộ chuyển hướng tự động (301 / 302 / 307 / 308)
Khi bạn đổi tiền tố blog hoặc cập nhật cấu trúc đường dẫn, PolyCMS lưu lại tiền tố cũ trong .blog_prefix_cache.php và định tuyến các liên kết cũ qua Frontend::redirect_old_prefix theo đúng mã trạng thái HTTP đã chọn trong PolyCMS > Permalinks:
301(Moved Permanently) - Lựa chọn mặc định được khuyến nghị để bảo toàn điểm xếp hạng SEO và chuyển giao giá trị liên kết sang đường dẫn mới.302(Found) - Chuyển hướng tạm thời khi thử nghiệm ngắn hạn.307(Temporary Redirect) - Chuyển hướng tạm thời nhưng giữ nguyên phương thức HTTP.308(Permanent Redirect) - Chuyển hướng vĩnh viễn và giữ nguyên phương thức HTTP.
Khuyến nghị vận hành Permalinks
- Thống nhất tiền tố blog và cấu trúc URL ngay từ giai đoạn đầu, hạn chế thay đổi sau khi bài viết đã được Google lập chỉ mục.
- Ưu tiên cấu trúc
%postname%(Post Name) để URL ngắn gọn, dễ đọc và giàu từ khóa. - Đảm bảo thư mục
files/polycms/luôn có quyền ghi để tệp.blog_prefix_cache.phpđược cập nhật kịp thời khi lưu cấu hình. - Nếu chuyển dữ liệu từ một nền tảng CMS khác sang RISE CRM, hãy kiểm tra kỹ ánh xạ chuyển hướng 301 và duyệt thử cả trang công khai lẫn
/dashboardngay sau khi đổi cấu hình.
Tài liệu liên quan
- Hướng dẫn Cấu hình SEO trong PolyCMS cho RISE CRM - Kết hợp đường dẫn chuẩn SEO với MTOptimize và XML Sitemap.
- Khắc phục sự cố thường gặp trong PolyCMS cho RISE CRM - Khắc phục lỗi 404, quy tắc rewrite và quyền ghi tệp cache.
- Tổng quan Kiến trúc PolyCMS cho RISE CRM - Tìm hiểu chi tiết cơ chế định tuyến CodeIgniter 4 và
set404Override().