Back to Main Site

Cấu hình Permalinks và Đường dẫn tĩnh PolyCMS RISE CRM

Last updated on Nov 22, 2026 7:38 AM 7:38 AM 2,728.88 ms

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 /blog hoặ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 /signin và /dashboard vẫ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ành topics sẽ cho yourdomain.com/blog/topics/huong-dan.
  • Tag Base - Mặc định tag -> yourdomain.com/blog/tag/rise-crm. Đổi thành label sẽ cho yourdomain.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:

  1. 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 prefix mới, old_prefix cũ và mã chuyển hướng vào files/polycms/.blog_prefix_cache.php, đồng thời tự động xóa bộ nhớ đệm HTML giao diện công khai trong writable/polycms/cache/.
  2. Đị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.
  3. 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 callback set404Override() 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 /dashboard ngay sau khi đổi cấu hình.

Tài liệu liên quan