Hướng dẫn cài đặt và kích hoạt mô-đun PolyCMS

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

Đảm bảo môi trường máy chủ của bạn đáp ứng các thông số tối thiểu sau:

Nếu bạn chưa rõ về phiên bản PHP hiện tại, bạn có thể kiểm tra tại mục Setup → System Info trong trang quản trị Perfex CRM.

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

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 ZIP này chứa toàn bộ các tệp nguồn cần thiết để vận hành hệ thống.

Bước 2: Tải lên máy chủ & Kích hoạt

Bạn có thể cài đặt PolyCMS thông qua một trong hai phương thức sau:

Phương án A: Thao tác trên giao diện quản trị Perfex CRM (Khuyên dùng)

1. Đăng nhập vào Perfex CRM bằng tài khoản Administrator.
2. Di chuyển đến mục Setup → Modules.
3. Nhấp chọn Upload Module và tìm chọn tệp tin polycms.zip từ máy tính của bạn.
4. Sau khi tệp được tải lên thành công, nhấn nút Activate (Kích hoạt) ngay cạnh mô-đun PolyCMS trong danh sách.

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

1. Giải nén tệp tin polycms.zip trên máy tính cá nhân.
2. Tải thư mục polycms/ vừa giải nén lên thư mục your-perfex-crm/modules/ trên máy chủ.
3. Truy cập mục Setup → Modules trong quản trị Perfex CRM và nhấn chọn Activate.

Quy trình hệ thống tự động chạy khi kích hoạt

Khi mô-đun PolyCMS được kích hoạt lần đầu tiên, hệ thống sẽ tự động thực thi các tác vụ:

• Tự động khởi tạo 16 bảng cơ sở dữ liệu (tất cả đều bắt đầu bằng tiền tố blog_) phục vụ việc lưu trữ thông tin bài viết, trang tĩnh, chuyên mục, thẻ tag, bình luận, cấu trúc menu, widget, plugin, theme và các cấu hình cài đặt.
• Cài đặt giao diện theme mặc định Head Random.
• Đăng ký và cài đặt sẵn 5 plugin mặc định: XML Sitemap, Google Analytics, Maintenance Mode, Banner Slider, và MTOptimize.
• Tạo và chèn menu quản trị Blog vào thanh điều hướng bên của Perfex CRM.
• Thiết lập cấu hình permalinks mặc định với tiền tố đường dẫn hiển thị blog là /blog.

Bước 3: Cấu hình phân quyền cho Nhân viên

Sau khi cài đặt, mặc định chỉ có tài khoản Administrator mới có toàn quyền quản lý PolyCMS. Để cấp quyền sử dụng cho các nhân sự khác trong công ty:

1. Di chuyển đến mục Setup → Staff → [Chọn Nhân viên] → Permissions.
2. Tìm đến khu vực phân quyền của mô-đun PolyCMS.
3. Tích chọn các cấp độ quyền hạn phù hợp:

Bước 4: Thiết lập các cấu hình cơ bản sau cài đặt

Sau khi kích hoạt thành công, bạn nên rà soát và cấu hình các mục quan trọng sau:

Thiết lập cấu hình Permalinks (Đường dẫn tĩnh)

Di chuyển đến mục Blog → Settings → Permalinks để cấu hình:

• Blog Prefix — Đường dẫn gốc truy cập trang blog ngoài trang chủ (mặc định: /blog). Bạn có thể đổi thành /news, /articles hoặc bất kỳ tiền tố nào khác phù hợp với doanh nghiệp.
• Category Base — Từ khóa hiển thị đường dẫn cho trang chuyên mục (mặc định: category).
• Tag Base — Từ khóa hiển thị đường dẫn cho trang thẻ tag (mặc định: tag).

Xem thêm hướng dẫn chi tiết tại Hướng dẫn cấu hình Permalinks & URLs.

Kích hoạt giao diện hiển thị (Theme)

Truy cập mục Blog → Themes và đảm bảo rằng theme mặc định Head Random (hoặc giao diện tùy biến của bạn) đang được đặt ở trạng thái hoạt động. Xem chi tiết tại Hướng dẫn quản lý giao diện Themes.

Kích hoạt các Plugin bổ trợ

Di chuyển đến mục Blog → Plugins và bật các plugin cần thiết cho hoạt động của trang:

• XML Sitemap — Tự động tạo tệp sitemap.xml phục vụ SEO. Xem chi tiết.
• Google Analytics — Nhúng mã đo lường lượng truy cập GA4. Xem chi tiết.
• Maintenance Mode — Hiển thị trang thông báo bảo trì hệ thống. Xem chi tiết.

Xem thêm hướng dẫn quản trị tại Hướng dẫn quản lý Plugins.

Thiết lập Menu điều hướng

Truy cập mục Blog → Menus để khởi tạo và sắp xếp danh mục các liên kết menu điều hướng ngoài trang chủ. Xem hướng dẫn từng bước tại Hướng dẫn xây dựng menu điều hướng.

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

Sau khi hoàn thành cấu hình, bạn tiến hành kiểm tra nhanh để đảm bảo hệ thống vận hành tốt:

• ✓ Trang Blog → Dashboard hiển thị đầy đủ các thông số thống kê tổng hợp.
• ✓ Mục Blog → Posts → New Post hiển thị mượt mà khung soạn thảo văn bản đa định dạng.
• ✓ Có thể truy cập duyệt xem trang blog ngoài trang chủ tại địa chỉ https://your-domain.com/blog (hoặc tiền tố do bạn cấu hình).
• ✓ Thanh công cụ Frontend Admin Bar hiển thị ở trên cùng khi bạn duyệt xem blog với quyền admin đã đăng nhập.

An toàn dữ liệu khi tạm dừng hoạt động mô-đun

Trong trường hợp bạn cần tạm tắt mô-đun PolyCMS, toàn bộ dữ liệu bài viết của bạn hoàn toàn được giữ lại an toàn:

• Các bảng dữ liệu trên database được bảo lưu nguyên vẹn, không bị xóa.
• Các bài viết, trang tĩnh, thẻ tag, tệp tin phương tiện và thiết lập cấu hình được giữ nguyên.
• Bạn có thể bật lại mô-đun bất kỳ lúc nào để tiếp tục vận hành bình thường mà không bị mất mát thông tin.

Các bước tiếp theo

Tiến trình cài đặt mô-đun PolyCMS đã hoàn tất thành công. Bạn có thể bắt đầu biên soạn bài viết của mình qua các tài liệu:

• Bắt đầu nhanh: Viết bài viết đầu tiên — Hướng dẫn tạo chuyên mục và xuất bản bài viết đầu tiên.
• Cấu hình tối ưu hóa SEO — Cách thiết lập các thẻ meta, Open Graph và kiểm tra xem trước hiển thị trên Google.
• Hướng dẫn Thư viện phương tiện — Hướng dẫn tải lên và quản lý hình ảnh trong bài viết.

Giải quyết các sự cố thường gặp

Để tìm hiểu thêm các giải pháp khác, xem bài viết Giải quyết các lỗi thường gặp.