Hướng dẫn Thư viện Phương tiện PolyCMS cho RISE CRM
Thư viện Phương tiện (Media Library) của PolyCMS tập trung toàn bộ quy trình quản lý hình ảnh và tài liệu cho bài viết, trang tĩnh, banner và giao diện trên RISE CRM. Truy cập qua mục PolyCMS > Media, hệ thống lưu trữ độc lập mọi tệp tải lên tại {rise_crm_root}/files/polycms/ (được bảo vệ bằng .htaccess), lập chỉ mục metadata trong bảng blog_media và áp dụng quy trình kiểm duyệt bảo mật máy chủ 6 lớp mà không ảnh hưởng đến tệp dự án hay tệp khách hàng của RISE CRM.
Các phương thức tải lên tệp tin
PolyCMS cung cấp ba cách tải hình ảnh và tài liệu lên thư viện tùy theo thao tác của bạn.
Tải lên kéo và thả (Drag-and-Drop)
Mở PolyCMS > Media (/polycms/media) và kéo trực tiếp một hoặc nhiều tệp từ máy tính thả vào vùng Thư viện Phương tiện. Hệ thống xử lý tải lên đồng thời nhiều tệp vào thư mục đang chọn.
Tải lên qua hộp thoại chọn tệp (Browse)
Nhấp vào nút Upload trên thanh công cụ để mở trình duyệt tệp tiêu chuẩn của hệ điều hành, sau đó chọn một hoặc nhiều tệp cần tải lên cùng lúc.
Tải lên trực tiếp trong trình soạn thảo
Khi biên soạn bài viết, trang tĩnh hoặc bố cục MTBuilder, bạn có thể chèn ảnh ngay từ trình soạn thảo TinyMCE tích hợp sẵn hoặc mục chọn ảnh đại diện. Cửa sổ Thư viện Phương tiện sẽ mở trực tiếp tại chỗ để bạn chọn tệp có sẵn hoặc tải lên tệp mới mà không phải rời khỏi màn hình chỉnh sửa.
Cấu trúc thư mục và đường dẫn lưu trữ
Mọi tệp phương tiện CMS được lưu trong thư mục chuyên biệt có cấu hình .htaccess bảo vệ:
{rise_crm_root}/files/polycms/
Theo mặc định, PolyCMS tự động phân loại tệp tải lên theo cấu trúc thư mục Năm/Tháng/Ngày:
files/polycms/
|-- 2026/
| |-- 05/
| | |-- 15/
| | | |-- hero-banner.jpg
| | | `-- hero-banner-thumb.jpg
| | `-- 16/
| `-- 06/
`-- .htaccess
Cơ chế phân tách này giúp tránh trùng lặp tên tệp, giữ tốc độ duyệt thư mục nhanh kể cả khi lưu hàng nghìn tệp và tách biệt hoàn toàn dữ liệu CMS khỏi hóa đơn, báo giá, phiếu hỗ trợ hay tệp cổng khách hàng của RISE CRM. Bạn cũng có thể tạo thêm các thư mục con tùy chọn ngay trong thanh bên của thư viện.
Chế độ hiển thị và tính năng quản lý
Bạn có thể chuyển đổi linh hoạt giữa hai chế độ xem trên thanh công cụ:
| Chế độ hiển thị | Mô tả hoạt động |
|---|---|
| Grid View (Dạng lưới) | Hiển thị ảnh thu nhỏ trực quan giúp duyệt và chọn hình ảnh nhanh chóng |
| List View (Dạng danh sách) | Bảng chi tiết gồm tên tệp, dung lượng, kích thước pixel và ngày tải lên |
Các tính năng nổi bật có sẵn tại PolyCMS > Media:
- Duyệt cây thư mục (Directory Tree Browser) - Điều hướng nhanh qua các thư mục theo ngày và thư mục con tự tạo từ thanh bên.
- Lọc theo định dạng tệp - Lọc riêng Hình ảnh (Images), Tài liệu (Documents) hoặc hiển thị Tất cả tệp (All Files).
- Xem trước Lightbox - Nhấp vào bất kỳ hình ảnh nào để xem phóng to toàn màn hình ngay trên lớp phủ mà không cần rời khỏi thư viện.
- Tự động tạo ảnh thu nhỏ (Thumbnails) - Tạo bản thu nhỏ cho hình ảnh tải lên nhằm tăng tốc độ duyệt trong trang quản trị và hiển thị ngoài giao diện.
- Kiểm tra thông tin tệp tin - Xem tên tệp, kích thước ảnh, dung lượng, ngày tải lên và sao chép nhanh đường dẫn URL trực tiếp.
Cơ chế bảo mật tải lên 6 lớp
Mọi tệp gửi lên từ khu vực quản trị hoặc REST API đều đi qua 6 lớp kiểm định phía máy chủ:
- Kiểm tra phần mở rộng (File Extension Validation) - Chỉ cho phép các định dạng trong danh sách trắng (
jpg,jpeg,png,gif,webp,svg,pdfvà định dạng tài liệu hợp lệ). Các tệp thực thi nguy hiểm (.php,.exe,.sh,.phtml) bị chặn tuyệt đối. - Xác thực MIME-Type - Phân tích nội dung thực tế của tệp trên máy chủ để đảm bảo MIME type khớp với đuôi tệp khai báo, ngăn chặn hành vi giả mạo định dạng.
- Kiểm tra Magic Bytes - Đọc chữ ký nhị phân ở phần đầu tệp tin để xác nhận đúng cấu trúc định dạng thực.
- Quét mã độc nội dung (Content Scanning) - Quét mã nguồn nhúng ẩn như thẻ PHP, khối
<script>và các chỉ thị nguy hiểm để phòng chống thực thi mã từ xa (RCE). - Chặn tệp đuôi kép (Double-Extension Blocking) - Từ chối các tên tệp đánh lừa định dạng như
image.php.jpghoặcshell.phtml.png. - Tái xử lý ảnh qua thư viện PHP GD (GD Image Reprocessing) - Xử lý lại ảnh raster bằng thư viện GD để loại bỏ hoàn toàn dữ liệu độc hại ẩn trong metadata mà vẫn giữ nguyên chất lượng hiển thị.
Kết hợp cùng tệp .htaccess đặt trong files/polycms/, máy chủ web cũng vô hiệu hóa việc thực thi mã PHP trực tiếp trong thư mục chứa media.
Theo dõi phương tiện qua cơ sở dữ liệu
Mọi tệp tải lên trong PolyCMS đều được ghi nhận vào bảng {db_prefix}blog_media (mặc định là rise_blog_media). Mỗi bản ghi lưu trữ đầy đủ thông tin phục vụ tra cứu nhanh, tối ưu SEO hình ảnh và đồng bộ qua REST API:
| Trường dữ liệu | Ý nghĩa lưu trữ |
|---|---|
filename |
Tên tệp gốc đã chuẩn hóa |
path |
Đường dẫn tương đối bên trong files/polycms/ (ví dụ: 2026/05/17/image.jpg) |
url |
Đường dẫn URL công khai để hiển thị trực tiếp |
alt_text |
Văn bản thay thế phục vụ trợ năng và tối ưu SEO hình ảnh |
title / caption |
Tiêu đề mô tả và chú thích hiển thị tùy chọn |
mime_type |
Định dạng MIME-type đã được máy chủ xác thực |
file_size |
Dung lượng tệp tính theo byte |
width / height |
Chiều rộng và chiều cao ảnh theo pixel |
author_id |
ID nhân sự RISE CRM thực hiện tải tệp lên |
Các bài viết và trang tĩnh liên kết tới ảnh đại diện thông qua trường feature_image_id (trỏ tới bảng blog_media), đồng thời lưu giữ chuỗi đường dẫn feature_image để tăng tốc độ kết xuất giao diện công khai.
Cơ chế xóa tệp an toàn
Trước khi xóa vĩnh viễn một tệp từ PolyCMS > Media, hệ thống sẽ kiểm tra xem tệp đó có đang được tham chiếu trong bài viết hoặc trang tĩnh nào hay không. Nếu tệp đang được sử dụng, PolyCMS sẽ hiển thị cảnh báo xác nhận để tránh làm lỗi ảnh trên website. Khi bạn xác nhận xóa, mọi liên kết feature_image_id trỏ tới tệp đó sẽ tự động được dọn sạch.
Tài liệu liên quan
- Quản lý bài viết trong PolyCMS cho RISE CRM - Chèn hình ảnh vào bài viết và chọn ảnh đại diện.
- Quản lý trang tĩnh trong PolyCMS cho RISE CRM - Thêm hình ảnh vào trang giới thiệu và trang đích.
- Xây dựng Theme tùy biến cho PolyCMS trên RISE CRM - Hiển thị ảnh đại diện và đường dẫn media trong tệp template.
- Hướng dẫn REST API PolyCMS cho RISE CRM - Tải lên, liệt kê và xóa media tự động qua
/cms/api/v1/media. - API Explorer Interactive Sandbox trong PolyCMS cho RISE CRM - Kiểm thử trực tiếp các endpoint media ngay trên RISE CRM.