Back to Main Site

Hướng dẫn Quản lý Plugin PolyCMS cho RISE CRM

Last updated on Nov 22, 2026 7:12 AM 7:12 AM 271.22 ms

PolyCMS cho RISE CRM sở hữu hệ sinh thái plugin mở rộng độc lập giúp bạn bổ sung công cụ SEO, phân tích truy cập, trình dựng trang kéo thả và tiện ích giao diện mà không cần sửa mã nguồn lõi của CMS hay RISE CRM. Quản trị viên quản lý toàn bộ các plugin con của CMS tại PolyCMS > Plugins (/polycms/plugins), tách biệt hoàn toàn với trình quản lý plugin chung của RISE CRM tại Settings > Plugins.

Tổng quan về hệ thống Plugin

Mọi plugin con của PolyCMS được đặt trong thư mục plugins/polycms/plugins/ và kết nối với nhân CMS thông qua hệ thống action, filter, shortcode và widget dashboard. Cách tách biệt này giúp các tính năng mở rộng cho website luôn gọn gàng, dễ di chuyển giữa các máy chủ và có thể bật hoặc tắt linh hoạt theo nhu cầu vận hành.

Quyền thao tác trên màn hình plugin tuân thủ hệ thống phân quyền vai trò tại Settings > Access Permission > Roles trong RISE CRM:

  • Xem danh sách Plugin: Yêu cầu quyền polycms_view.
  • Kích hoạt / Hủy kích hoạt Plugin: Yêu cầu quyền polycms_edit.
  • Tải lên gói cài đặt ZIP: Chỉ dành cho Quản trị viên RISE CRM (polycms_is_admin()).

Quản lý danh sách Plugin

Di chuyển đến mục PolyCMS > Plugins để xem toàn bộ các plugin được hệ thống nhận diện. Mỗi mục hiển thị đầy đủ thông tin:

  • Tên plugin, phiên bản và thông tin tác giả được đọc tự động từ khối PHP docblock header
  • Mô tả ngắn về chức năng chính
  • Trạng thái hiện tại (Active, Inactive, hoặc Not Installed đối với thư mục tải lên thủ công chưa kích hoạt)
  • Nút Activate hoặc Deactivate chỉ với một lần nhấp
  • Liên kết Settings hiển thị trực tiếp khi plugin đang hoạt động có trang cấu hình riêng
  • Chế độ chuyển đổi giao diện dạng lưới (Grid) hoặc danh sách (List)

Khi kích hoạt lần đầu một plugin vừa chép vào thư mục, PolyCMS sẽ tự động đăng ký thông tin vào bảng {db_prefix}blog_plugins (mặc định là rise_blog_plugins) và gọi hook kích hoạt để khởi tạo bảng dữ liệu hoặc tùy chọn mặc định nếu cần.

Cài đặt Plugin mới

Cài đặt bằng tệp ZIP (ZIP Upload)

  1. Mở PolyCMS > Plugins và nhấn Upload Plugin (/polycms/plugins/upload).
  2. Chọn tệp .zip chứa thư mục plugin cùng tệp PHP khởi chạy chính.
  3. Nhấn tải lên để hệ thống giải nén, kiểm duyệt bảo mật và đưa plugin vào plugins/polycms/plugins/.
  4. Quay lại PolyCMS > Plugins và nhấn Activate để bật plugin hoạt động.

Cài đặt thủ công qua FTP hoặc Trình quản lý tệp

  1. Giải nén gói plugin trên máy tính để toàn bộ tệp nằm trong một thư mục slug duy nhất (ví dụ: my-custom-plugin/).
  2. Tải thư mục này lên đường dẫn {rise_crm_root}/plugins/polycms/plugins/ trên máy chủ.
  3. Mở PolyCMS > Plugins trong RISE CRM; plugin mới sẽ tự động xuất hiện để bạn nhấn kích hoạt.

Cơ chế nhận diện và kiểm duyệt bảo mật

PolyCMS quét các thư mục con trong plugins/polycms/plugins/ và tìm tệp chính {slug}/{slug}.php (hoặc tệp .php đầu tiên chứa khai báo Plugin Name:). Các trường docblock header được hỗ trợ bao gồm Plugin Name:, Description:, Version:, Author: và Plugin URI:. Plugin đang bật có thể đăng ký thêm mục menu vào thanh bên PolyCMS hoặc Appearance thông qua tệp khai báo tùy chọn menu.json hoặc hook polycms_register_plugin_menus.

Mọi tệp .zip tải lên đều đi qua quy trình kiểm duyệt bảo mật trước khi cài đặt:

  • Bảo vệ giải nén lưu trữ: Sử dụng polycms_safe_extract_zip() để ngăn chặn tấn công Zip Slip, liên kết tượng trưng (symlink) và Zip Bomb trong bước giải nén tạm.
  • Kiểm tra đường dẫn và định danh slug: Chuẩn hóa tên thư mục plugin và kiểm soát đường dẫn tuyệt đối thông qua polycms_validate_file_path().
  • Xác thực header plugin: Tự động từ chối gói nén thiếu tệp PHP chính hoặc thiếu khai báo Plugin Name:.
  • Hoàn tác tự động (Rollback): Xóa sạch thư mục tạm và thu hồi thư mục giải nén ngay nếu bước đăng ký vào cơ sở dữ liệu gặp lỗi.

Danh sách 7 Plugin tích hợp sẵn

PolyCMS cho RISE CRM đi kèm sẵn 7 plugin hoàn chỉnh nằm trong plugins/polycms/plugins/:

Tên Plugin Phạm vi / Phiên bản Mô tả chi tiết
MTBuilder Trình dựng trang Công cụ kéo thả trực quan để thiết kế landing page với 17 khối nội dung, Template Parts, 6 mẫu trang đầy đủ và tính năng xem trước đa thiết bị trực tiếp.
MTOptimize Bộ công cụ SEO v1.3.0 Mở rộng khung Core SEO với Google Search Preview, bộ đếm ký tự trực tiếp, phân tích Focus Keyword, Open Graph, Twitter Card, Schema.org JSON-LD và kiểm soát robots/canonical thông qua các hook polycms_seo_box_before_fields và polycms_seo_box_content.
XML Sitemap Sơ đồ trang SEO v1.1.0 Tự động xuất các route SEO ở thư mục gốc (/sitemap.xml, /sitemap_index.xml, /post-sitemap.xml, /page-sitemap.xml, /category-sitemap.xml, /sitemap.xsl, /robots.txt), chia nhỏ sitemap theo ngưỡng 1.000 URL và hỗ trợ quy tắc loại trừ linh hoạt.
Google Analytics Đo lường & Lượt xem Nhúng mã theo dõi GA4 cho khách truy cập công khai, đếm lượt xem bài viết nội bộ chống trùng lặp theo phiên và bổ sung widget Top Performing Posts trên PolyCMS Dashboard.
Maintenance Mode Vận hành hệ thống Hiển thị màn hình bảo trì tùy biến trả về mã HTTP 503 kèm header Retry-After, đồng thời cho phép nhân sự và quản trị viên RISE CRM đăng nhập xem trước bình thường.
Banner Slider Trình trượt quảng cáo Tạo thanh trượt banner responsive hỗ trợ hẹn lịch hiển thị, ảnh riêng cho desktop/mobile và nút CTA tại PolyCMS > Banner Slider.
API Explorer Sandbox lập trình Môi trường thử nghiệm REST API trực quan tại PolyCMS > API Explorer hỗ trợ gọi thử endpoint trực tiếp, kiểm thử Media DB và sinh mã mẫu cURL, PHP, JavaScript, Python.

Cấu hình và lưu trữ dữ liệu Plugin

Mỗi plugin lưu trữ tùy chọn cấu hình độc lập trong bảng {db_prefix}blog_plugin_options (mặc định là rise_blog_plugin_options) để không xung đột với bảng cấu hình chung của RISE CRM, còn danh mục và trạng thái plugin được quản lý trong {db_prefix}blog_plugins. Các plugin cần lưu trữ dữ liệu có cấu trúc riêng (như slide của Banner Slider, mẫu giao diện MTBuilder, dữ liệu SEO mở rộng của MTOptimize hoặc bộ đếm lượt xem của Google Analytics) sẽ tự động tạo bảng khi bạn kích hoạt.

Cấu trúc thư mục Plugin

Một plugin con tiêu chuẩn trong PolyCMS cho RISE CRM có cấu trúc thư mục như sau:

plugins/polycms/plugins/
|-- xml-sitemap/
|   |-- xml-sitemap.php       (Tệp chính chứa PHP docblock header)
|   |-- menu.json             (Tệp khai báo menu thanh bên tùy chọn)
|   |-- languages/            (Các tệp ngôn ngữ dịch thuật)
|   \-- assets/               (Tài nguyên CSS/JS của plugin)
|-- mtoptimize/
|   \-- mtoptimize.php
|-- mtbuilder/
|-- google-analytics/
|-- maintenance-mode/
|-- banner-slider/
\-- api-explorer/

Các plugin tương tác với lõi PolyCMS thông qua Hệ thống Hooks & Filters và các hàm trợ giúp tương thích RISE CRM chống xung đột như polycms_ci(), polycms_admin_url(), polycms_get_option() và polycms_staff_can().

Tài liệu liên quan