Hướng dẫn cài đặt và kích hoạt PolyCMS cho RISE CRM
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)
- Đăng nhập RISE CRM bằng tài khoản Administrator.
- Truy cập mục Settings > Plugins.
- Nhấn nút Install Plugin và chọn tệp
polycms.ziptừ máy tính của bạn. - 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
- Giải nén tệp
polycms.ziptrên máy tính cá nhân. - 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ạiplugins/polycms/index.php. - 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.sqltheo tiền tố bảng động của RISE ($db->getPrefix(), mặc địnhrise_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 trongwritable/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_postscòn trống,Polycms_Demo_Seedertự độ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 để/dashboardvà/signinhoạ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:
- Truy cập Settings > Access Permission > Roles > [Role].
- Cuộn xuống mục phân quyền PolyCMS (được đăng ký qua
app_hook_role_permissions_extension). - 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,/articleshoặ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
settingscủa RISE CRM). - REST API: Bật endpoint
/cms/api/v1/*và tạo API keypcms_*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
- 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). - 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 (
/dashboardvà/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:
- Bắt đầu nhanh: Bài viết đầu tiên trong PolyCMS cho RISE CRM - Tạo chuyên mục và xuất bản bài viết đầu tiên trong 3 phút.
- Hướng dẫn Thư viện phương tiện - Tải lên và tổ chức hình ảnh trong
files/polycms/. - Hướng dẫn cấu hình SEO - Thiết lập thẻ meta MTOptimize, thẻ chia sẻ mạng xã hội và dữ liệu có cấu trúc.