Init Manga v1.7.2 – Server ZIP Ingest: Nhập chương trực tiếp, nhanh và không giới hạn Cloudflare

Server ZIP Ingest là gì?

Server ZIP Ingest là một metabox mới trong trang chỉnh sửa manga, cho phép quét, xác thực và xử lý các tệp .zip được đặt trong thư mục ingest của từng truyện. Mỗi tệp ZIP chứa các thư mục chương (mỗi thư mục tương ứng với một chương). Toàn bộ quá trình xử lý diễn ra hoàn toàn trên server để đảm bảo hiệu năng và độ tin cậy cao.

Lý do nên sử dụng

• Bỏ qua giới hạn upload: Không bị ràng buộc bởi giới hạn 100MB của Cloudflare hay giới hạn trình duyệt.
• Xử lý khối lượng lớn: Có thể import hàng chục đến hàng trăm chương trong một lần thao tác.
• Kiểm soát chính xác: Quy tắc đặt tên và parse thư mục nghiêm ngặt giúp giữ nguyên thứ tự và slug chính xác.
• Theo dõi dễ dàng: Có thanh tiến trình realtime và log chi tiết từng chương.

Cách hoạt động

1. Đặt các tệp .zip vào thư mục wp-content/uploads/init-manga-ingest/{manga_id}/incoming/.
2. Mở truyện trong admin và tìm metabox Ingest ZIP from Server.
3. Nhấn Scan ZIPs để quét, sau đó chọn Process Selected hoặc Process All.
4. Hệ thống tự động giải nén, xác thực tên thư mục, sắp xếp ảnh và tạo chương mới.
5. Tệp ZIP sau khi xử lý sẽ được chuyển sang thư mục archive/ hoặc failed/ để lưu lại log.

Yêu cầu

• Tài khoản có quyền quản trị manga.
• Truyện đã được publish và license hợp lệ.
• Thư mục ingest có quyền ghi: wp-content/uploads/init-manga-ingest/{manga_id}/incoming/.

Cách thiết lập nhanh

1. Bật tính năng Server ZIP Ingest trong phần Integrations.
2. Mở một manga đã publish và cuộn xuống metabox Ingest ZIP from Server.
3. Nếu chưa có thư mục ingest, nhấn nút Create now để tạo tự động các thư mục incoming/, archive/ và failed/ với quyền ghi chuẩn PHP.
4. Kiểm tra trạng thái hiển thị “✅ writable”.

Cấu trúc tệp ZIP hợp lệ

• Thư mục gốc trong ZIP chỉ chứa các thư mục chương, không có ảnh rời ở ngoài.
• Tên thư mục nên ở dạng 12 hoặc 12.5 - Tiêu đề chương; tránh ký tự đặc biệt.
• Định dạng ảnh hỗ trợ: JPG, PNG, WebP, AVIF, GIF.
• Ảnh trong thư mục chương sẽ được sắp xếp và đánh số tự động theo thứ tự tên file.

Sử dụng metabox

• Scan ZIPs: Quét và liệt kê các tệp ZIP có sẵn cùng thông tin tên, dung lượng, thời gian sửa đổi.
• Process Selected / Process All: Chạy xử lý ngay trên server, hiển thị tiến trình realtime.
• Logs: Ghi chi tiết từng chương được import, lỗi (nếu có), và báo cáo tổng kết; log sẽ không mất sau khi xử lý xong.
• Tự động làm mới chương: Danh sách chương tự động reload sau khi ingest hoàn tất.

Quyền thư mục và nút “Create now”

Metabox hiển thị đường dẫn ingest rút gọn từ wp-content/ kèm trạng thái “writable”. Nếu thư mục chưa tồn tại, bạn có thể nhấn Create now để hệ thống tự động tạo đầy đủ thư mục cần thiết. Sau khi tạo thành công, nút sẽ tự ẩn để tránh thao tác lặp.

Bảo mật và xác thực

• Giải nén an toàn: Ngăn path traversal, symlink và đường dẫn tuyệt đối; giới hạn số lượng và dung lượng file.
• Parse nghiêm ngặt: Kiểm tra kỹ tên thư mục, loại bỏ slug trùng hoặc ký tự không hợp lệ.
• Lưu trữ sạch: Ảnh được lưu trực tiếp vào uploads/init-manga/{manga_id}/{chapter}/ mà không tạo attachment trong Media Library.

Khuyến nghị sử dụng

• Chỉ chạy ingest trên các truyện đã publish để đảm bảo URL cố định.
• Mỗi batch ZIP chỉ nên chứa một bộ truyện để dễ quản lý và tra log.
• Đặt tên chương thống nhất để tránh trùng lặp hoặc sai thứ tự.
• Đảm bảo giới hạn PHP (time/memory) đủ lớn cho các batch lớn.

Câu hỏi thường gặp

Tính năng này có thay thế upload qua trình duyệt không? Không. Đây là phương án bổ trợ, giúp import số lượng lớn nhanh hơn, không bị giới hạn bởi Cloudflare.

Các tệp ZIP sau khi xử lý sẽ đi đâu? Hệ thống sẽ tự động di chuyển sang thư mục archive/ hoặc failed/ để dễ kiểm tra lại.

Có thể trộn định dạng ảnh trong một chương không? Có. Hệ thống tự động sắp xếp và chuẩn hóa định dạng khi import.

Kết luận

Tính năng Server ZIP Ingest trong Init Manga v1.7.2 mang đến một quy trình nhập chương nhanh, an toàn và chuyên nghiệp. Với khả năng xử lý hàng loạt trên server, log chi tiết, và tự động làm mới danh sách chương, đây là công cụ tối ưu cho các nhóm dịch hoặc site có khối lượng nội dung lớn, giúp tiết kiệm thời gian và loại bỏ mọi giới hạn upload truyền thống.