Hướng dẫn Quản lý Plugin trong PolyCMS
Tổng quan về hệ thống Plugin
Các plugin giúp mở rộng tính năng của PolyCMS mà không cần thay đổi bất kỳ dòng mã nguồn gốc nào của hệ thống. Di chuyển đến mục Blog > Plugins để quản lý toàn bộ các plugin đang được cài đặt.
Danh sách Plugin
Trang quản trị Plugins hiển thị đầy đủ thông tin các plugin bao gồm:
- Tên plugin, phiên bản đang chạy và thông tin tác giả
- Mô tả ngắn về chức năng
- Trạng thái hoạt động (Đang bật / Đang tắt)
- Nút Bật/Tắt nhanh
- Liên kết cấu hình (đối với các plugin có trang cài đặt riêng)
- Hỗ trợ hiển thị giao diện dạng lưới hoặc danh sách
Các bước cài đặt Plugin
Tải lên tệp ZIP (ZIP Upload)
- Di chuyển đến mục Blog > Plugins.
- Nhấp chọn Upload Plugin.
- Lựa chọn tệp tin
.zipchứa gói cài đặt plugin của bạn. - Hệ thống PolyCMS sẽ tự động giải nén, quét kiểm duyệt bảo mật và đưa các tệp tin vào đường dẫn
modules/polycms/plugins/. - Sau khi tải lên thành công, nhấn Kích hoạt (Activate) để bật plugin hoạt động.
Cài đặt thủ công
Tải thư mục plugin giải nén trực tiếp lên đường dẫn modules/polycms/plugins/ trên máy chủ thông qua kết nối FTP hoặc trình quản lý tệp tin.
Bảo mật hệ thống Plugin
Các tệp ZIP tải lên được hệ thống kiểm duyệt nghiêm ngặt:
- Phát hiện và loại bỏ các hàm PHP nguy hiểm có nguy cơ gây mất an toàn hệ thống.
- Kiểm tra định dạng tệp tin hợp lệ.
- Chống tấn công dò tìm thư mục chéo thông qua hàm
polycms_validate_file_path.
Danh sách các Plugin đi kèm mặc định
PolyCMS tích hợp sẵn 7 plugin chuyên nghiệp hỗ trợ hoạt động của trang:
| Tên Plugin | Mô tả chi tiết |
|---|---|
| MTBuilder | Trình dựng trang landing page và khối mẫu kéo thả trực quan |
| XML Sitemap | Tự động tạo tệp tin sitemap.xml động phục vụ SEO |
| Google Analytics | Nhúng mã đo lường truy cập GA4/UA |
| Maintenance Mode | Hiển thị trang thông báo bảo trì hệ thống cho độc giả |
| Banner Slider | Trình trượt biểu ngữ hình ảnh responsive |
| API Explorer | Môi trường sandbox thử nghiệm gọi REST API trực quan |
| MTOptimize | Tối ưu hóa hình ảnh và tài nguyên tải trang ngoài frontend |
Trang thiết lập cấu hình của Plugin
Các plugin đang hoạt động có hỗ trợ trang cấu hình riêng sẽ hiển thị liên kết Settings trong danh sách. Mỗi plugin quản lý các giá trị cấu hình của mình độc lập trong bảng cơ sở dữ liệu blog_plugin_options.
Cấu trúc thư mục Plugin
Mỗi plugin được lưu trữ trong một thư mục riêng biệt:
modules/polycms/plugins/
├── xml-sitemap/
│ ├── plugin.json ← Khai báo siêu dữ liệu plugin
│ ├── xml-sitemap.php ← Tệp tin mã nguồn chính
│ ├── language/ ← Các tệp dịch ngôn ngữ
│ └── assets/ ← Thư mục chứa CSS/JS
├── google-analytics/
└── maintenance-mode/
Các plugin tương tác với nhân PolyCMS thông qua Hệ thống Hook & Filter, đăng ký các action và filter tương ứng để xử lý logic.
Tài liệu hướng dẫn liên quan
- Trình dựng trang MTBuilder — Hướng dẫn thiết kế landing page kéo thả.
- Tự viết một Plugin tùy biến — Hướng dẫn cho nhà phát triển viết plugin mới.
- Tài liệu Hooks & Filters — Hướng dẫn chi tiết về API hooks có sẵn.