Back to Main Site

Hướng dẫn cài đặt và kích hoạt PolyCMS cho RISE CRM

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

Quá trình cài đặt PolyCMS cho RISE CRM chỉ mất chưa đầy năm phút thông qua trình cài plugin có sẵn tại Settings > Plugins hoặc tải lên thủ công qua FTP. Ngay khi kích hoạt, PolyCMS tự động tạo 19 bảng InnoDB độc lập, thiết lập giao diện Head Random, đăng ký 7 plugin đi kèm và bảo vệ an toàn các đường dẫn nội bộ /dashboard và /signin của RISE CRM.

Chuẩn bị trước khi bắt đầu

Kiểm tra để đảm bảo máy chủ và hệ thống RISE CRM của bạn đáp ứng các yêu cầu tối thiểu sau:

Yêu cầu hệ thống Cấu hình tối thiểu
RISE CRM Phiên bản 3.9+ (đã kiểm thử toàn diện trên 4.1+, CodeIgniter 4 và Bootstrap 5)
PHP Phiên bản 8.1 trở lên
Cơ sở dữ liệu MySQL 5.7+ hoặc MariaDB 10.3+
Máy chủ Web Apache (đã bật mod_rewrite) hoặc Nginx (đã cấu hình try_files)
Thư mục có quyền ghi files/polycms/ và writable/polycms/

Để kiểm tra phiên bản PHP hiện tại, bạn có thể xem trong bảng điều khiển hosting hoặc chạy lệnh php -v qua SSH/CLI trên máy chủ.

Bước 1: Tải xuống gói cài đặt Plugin

Mua và tải gói cài đặt polycms.zip chính thức từ gian hàng PolyXGO trên CodeCanyon. Tệp nén này đã đóng gói đầy đủ mã nguồn cốt lõi, các thư viện tự lưu trữ (TinyMCE, Select2, SweetAlert2, HTMLPurifier trong vendor/ezyang/htmlpurifier), 16 gói ngôn ngữ, giao diện Head Random và 7 plugin con sẵn sàng vận hành.

Bước 2: Cài đặt và Kích hoạt trên RISE CRM

Bạn có thể cài đặt PolyCMS bằng trình tải lên trong trang quản trị hoặc tải thủ công qua FTP/File Manager.

Phương án A: Cài đặt qua giao diện quản trị RISE CRM (Khuyên dùng)

  1. Đăng nhập RISE CRM bằng tài khoản Administrator.
  2. Truy cập mục Settings > Plugins.
  3. Nhấn nút Install Plugin và chọn tệp polycms.zip từ máy tính của bạn.
  4. Tìm PolyCMS trong danh sách plugin và nhấn Activate.

Phương án B: Tải lên thủ công qua FTP hoặc Trình quản lý tệp

  1. Giải nén tệp polycms.zip trên máy tính cá nhân.
  2. Tải thư mục polycms/ lên đường dẫn {rise_crm_root}/plugins/polycms/ sao cho tệp khởi chạy nằm đúng tại plugins/polycms/index.php.
  3. Truy cập Settings > Plugins trong RISE CRM và nhấn Activate bên cạnh PolyCMS.

Hệ thống tự động thực hiện gì khi kích hoạt lần đầu?

PolyCMS sử dụng các lifecycle hook chuẩn của RISE CRM (register_installation_hook và register_activation_hook trong plugins/polycms/index.php) để khởi tạo toàn bộ hệ thống:

  • Tạo 19 bảng cơ sở dữ liệu: Thực thi plugins/polycms/install/database.sql theo tiền tố bảng động của RISE ($db->getPrefix(), mặc định rise_blog_*) để lưu nội dung, phân loại, bình luận, media, menu, widget, plugin, theme và cấu hình.
  • Khởi tạo thư mục lưu trữ: Tạo thư mục files/polycms/ (bảo mật bằng .htaccess) cho media và bộ nhớ đệm tiền tố permalink, cùng các thư mục con trong writable/polycms/ (cache/, rate_limit/, backups/, htmlpurifier/).
  • Thiết lập giao diện mặc định: Đăng ký giao diện Bootstrap 5 Head Random từ plugins/polycms/themes/head-random/.
  • Đăng ký 7 plugin đi kèm: Đưa MTBuilder, MTOptimize, XML Sitemap, Google Analytics GA4, Maintenance Mode, Banner Slider và API Explorer vào màn hình PolyCMS > Plugins.
  • Tạo dữ liệu mẫu ban đầu: Ở lần cài đặt mới khi bảng blog_posts còn trống, Polycms_Demo_Seeder tự động tạo bài viết, trang tĩnh, chuyên mục, thẻ tag, menu, widget và các bố cục mẫu MTBuilder.
  • Chèn menu vào thanh điều hướng: Thêm 2 nhóm PolyCMS và Appearance vào Staff Left Sidebar (app_filter_staff_left_menu), đồng thời tùy chọn hiển thị mục Blog trên Client Portal (polycms_show_in_client_menu).
  • Bảo toàn đường dẫn CRM: Giữ tùy chọn chuyển hướng trang chủ ở trạng thái TẮT (0) theo mặc định để /dashboard và /signin hoạt động ổn định.

Bước 3: Cấu hình phân quyền vai trò (RBAC)

Tài khoản Administrator của RISE và các vai trò có quyền can_manage_all_kinds_of_settings mặc định có toàn quyền truy cập PolyCMS. Để cấp quyền phù hợp cho biên tập viên hoặc nhân viên nội dung:

  1. Truy cập Settings > Access Permission > Roles > [Role].
  2. Cuộn xuống mục phân quyền PolyCMS (được đăng ký qua app_hook_role_permissions_extension).
  3. Chọn các quyền cần thiết và lưu thay đổi:
Khóa quyền hạn Nhãn hiển thị Phạm vi cho phép
polycms_view PolyCMS: View Xem Dashboard và duyệt danh sách bài viết, trang tĩnh, chuyên mục, thẻ tag, bình luận và media
polycms_create PolyCMS: Create Tạo mới bài viết, trang tĩnh, chuyên mục, thẻ tag và tải tệp media lên
polycms_edit PolyCMS: Edit Chỉnh sửa nội dung hiện có, xuất bản hoặc ẩn bài viết và kiểm duyệt bình luận
polycms_delete PolyCMS: Delete Xóa bài viết, trang tĩnh, phân loại, bình luận và tệp media
polycms_settings PolyCMS: Settings Quản trị Settings, Permalinks, Themes, Theme Options, Menus, Widgets, Plugins và Tools

Bước 4: Thiết lập các cấu hình quan trọng sau cài đặt

Sau khi kích hoạt thành công, hãy kiểm tra nhanh bốn khu vực cấu hình trọng yếu sau.

Cấu hình Permalinks (Đường dẫn tĩnh)

Mở PolyCMS > Permalinks (/polycms/permalink-settings) để thiết lập cấu trúc URL:

  • Blog Prefix: Đường dẫn gốc của blog công khai (mặc định /blog, có thể đổi thành /news, /articles hoặc để trống cho chế độ trang gốc).
  • Category Base: Phân đoạn URL cho chuyên mục (mặc định category).
  • Tag Base: Phân đoạn URL cho thẻ tag (mặc định tag).

Mỗi khi lưu, hệ thống tự động cập nhật files/polycms/.blog_prefix_cache.php. Xem hướng dẫn chi tiết tại Cấu hình Permalink và URL cho RISE CRM.

Kiểm tra các tab Cài đặt hệ thống

Truy cập PolyCMS > Settings (/polycms/settings) để rà soát 5 tab cấu hình hỗ trợ liên kết sâu (#tab-reading, #tab-general, #tab-performance, #tab-localization, #tab-api):

  • Reading: Chọn trang chủ hiển thị bài viết mới nhất hay trang tĩnh, số bài viết mỗi trang và ảnh đại diện mặc định.
  • General: Bật/tắt bình luận, breadcrumb, yêu cầu đăng nhập khách hàng, hiển thị thương hiệu và tùy chọn chuyển hướng trang chủ (chỉ bật nếu muốn tên miền gốc hiển thị trực tiếp giao diện PolyCMS).
  • Performance: Kích hoạt bộ nhớ đệm HTML trang công khai (writable/polycms/cache/) và cài đặt thời gian lưu cache.
  • Localization: Kiểm tra ngôn ngữ trang, múi giờ, định dạng ngày và giờ (mặc định kế thừa từ bảng settings của RISE CRM).
  • REST API: Bật endpoint /cms/api/v1/* và tạo API key pcms_* nếu bạn cần kết nối ứng dụng bên ngoài.

Kiểm tra Giao diện và Menu điều hướng

  1. Mở Appearance > Themes (/polycms/themes) và xác nhận Head Random đang được kích hoạt. Tùy chỉnh logo, màu sắc và kiểu chữ tại Appearance > Theme Options. Xem thêm tại Quản lý Giao diện (Themes).
  2. Truy cập Appearance > Menus (/polycms/menus) để xây dựng thanh điều hướng dẫn tới các trang tĩnh, chuyên mục hoặc liên kết tùy biến. Xem chi tiết tại Hướng dẫn Trình dựng Menu.

Kích hoạt các Plugin đi kèm

Truy cập PolyCMS > Plugins (/polycms/plugins) và bật những plugin cần thiết cho website của bạn:

  • MTBuilder: Trình dựng trang kéo thả trực quan với 17 khối và 6 mẫu trang sẵn có. Xem chi tiết.
  • MTOptimize: Bộ công cụ SEO bổ sung Google Search Preview, phân tích Focus Keyword, Open Graph, Twitter Cards và Schema.org JSON-LD. Xem chi tiết.
  • XML Sitemap: Phục vụ /sitemap.xml, sitemap con chia gói và /robots.txt. Xem chi tiết.
  • Google Analytics: Chèn mã theo dõi GA4 và hiển thị bài viết nổi bật trên Dashboard. Xem chi tiết.
  • Maintenance Mode: Hiển thị trang thông báo bảo trì chuẩn HTTP 503 trong khi nhân viên vẫn truy cập bình thường. Xem chi tiết.

Xem toàn bộ hướng dẫn quản trị tại Quản lý Plugin trong PolyCMS.

Bước 5: Kiểm tra xác thực hoạt động

Đối chiếu các điểm kiểm tra sau để đảm bảo hệ thống vận hành trơn tru:

  • Trang PolyCMS > Dashboard (/polycms/dashboard) hiển thị đầy đủ thống kê tổng quan và hoạt động gần đây không có lỗi.
  • Mục PolyCMS > Posts mở danh sách bài viết và nút New Post tải đầy đủ trình soạn thảo TinyMCE.
  • Truy cập https://ten-mien-cua-ban.com/blog (hoặc tiền tố blog bạn đã thiết lập) hiển thị giao diện công khai với theme Head Random.
  • Các đường dẫn nội bộ của RISE CRM (/dashboard và /signin) vẫn hoạt động bình thường.

An toàn dữ liệu khi tạm dừng hoặc gỡ cài đặt

PolyCMS tuân thủ nguyên tắc bảo vệ dữ liệu không phá hủy trong plugins/polycms/index.php:

  • Cả thao tác Deactivate (register_deactivation_hook) và Uninstall (register_uninstallation_hook) đều giữ nguyên toàn bộ 19 bảng dữ liệu CMS theo mặc định.
  • Mọi bài viết, trang tĩnh, chuyên mục, thẻ tag, bản ghi media, menu và thiết lập vẫn còn nguyên vẹn để bạn có thể kích hoạt lại bất cứ lúc nào.

Nếu bạn chủ động muốn xóa sạch dữ liệu mẫu hoặc bài viết blog, hãy tạo bản sao lưu trước tại tab Backup / Restore rồi dùng công cụ Clear All Blog Data trong PolyCMS > Tools.

Xử lý nhanh các sự cố thường gặp

Sự cố Cách khắc phục
Không thấy menu PolyCMS hoặc Appearance Xóa cache trình duyệt, kiểm tra plugin đã kích hoạt tại Settings > Plugins và kiểm tra phân quyền tại Settings > Access Permission > Roles
Lỗi 404 khi mở đường dẫn blog công khai Lưu lại cài đặt tại PolyCMS > Permalinks để tạo lại files/polycms/.blog_prefix_cache.php và kiểm tra mod_rewrite (Apache) hoặc try_files (Nginx)
Báo lỗi không đủ quyền trong quản trị Gán các quyền polycms_view, polycms_create, polycms_edit, polycms_delete hoặc polycms_settings cho vai trò của nhân viên
Lỗi tải tệp hoặc ghi bộ nhớ đệm Đảm bảo thư mục files/polycms/ và writable/polycms/ tồn tại và có quyền ghi cho máy chủ web (chmod 775)

Để xem danh sách chẩn đoán chi tiết hơn, tham khảo Khắc phục sự cố và các lỗi thường gặp.

Các bước tiếp theo

Hệ thống PolyCMS trên RISE CRM của bạn đã sẵn sàng hoạt động. Hãy tiếp tục với: