Init Manga v1.9.8 – Giới thiệu & hướng dẫn bật Init Manga Sync

Bài viết này sẽ giúp bạn hiểu rõ Init Manga Sync là gì, nó giải quyết bài toán nào, và quan trọng nhất: cách bật và sử dụng tính năng này đúng chuẩn trong Init Manga v1.9.8.

Init Manga Sync là gì?

Init Manga Sync là cơ chế đồng bộ dữ liệu truyện và chương truyện giữa các site Init Manga thông qua REST API được bảo vệ bằng API Key. Điểm cốt lõi của Sync nằm ở triết lý incremental sync:

• Chỉ lấy truyện mới hoặc đã thay đổi
• Chỉ kéo các chương mới nhất, không re-import toàn bộ thư viện
• Không tạo bản sao trùng lặp
• An toàn khi chạy lặp lại nhiều lần (idempotent)

Mô hình này đặc biệt phù hợp cho các hệ thống như:

• Site chính → site mirror
• Site biên tập → site đọc public
• Site cũ → site mới trong quá trình chuyển đổi dần

Điểm mới trong Init Manga v1.9.8

Ở phiên bản 1.9.8, Init Manga không tự đồng bộ mà đóng vai trò là nguồn phát dữ liệu an toàn. Các cải tiến chính bao gồm:

• Tích hợp native Init Manga Sync, không cần chỉnh code
• Hai REST API endpoint được bảo vệ bằng API Key:
  • Danh sách truyện
  • Danh sách chương mới nhất
• Chỉ kích hoạt endpoint khi có Sync API Key
• Tự động hiển thị URL endpoint để copy nhanh
• Hỗ trợ cài Init Manga Sync plugin trực tiếp trong Setup Wizard
• Hỗ trợ filter phân trang linh hoạt (per_page)
• Không phát sinh bất kỳ overhead nào nếu không bật Sync

Lưu ý quan trọng về kiến trúc

Trong Init Manga v1.9.8:

• Theme chỉ có nhiệm vụ bật tính năng Sync
• Việc kéo dữ liệu, cron job, logic đồng bộ nằm hoàn toàn trong plugin Init Manga Sync
• Nếu bạn chỉ chạy một site duy nhất, hãy để trống Sync API Key để đảm bảo hiệu suất tối đa

Hướng dẫn bật Init Manga Sync (chuẩn 2 site)

Bước 1: Bật Sync ở site nguồn (site A)

Truy cập:

Init Manga → Tích hợp → Init Manga Sync

Tại đây, bạn chỉ cần:

1. Nhập một Sync API Key bất kỳ (nên đủ dài và khó đoán)
2. Lưu lại cài đặt

Sau khi lưu, Init Manga sẽ tự động:

• Kích hoạt 2 endpoint REST API bảo mật
• Hiển thị sẵn 2 URL endpoint để bạn copy:
  • Endpoint danh sách truyện
  • Endpoint danh sách chương

Nếu không có API Key, toàn bộ Sync API sẽ không tồn tại.

Bước 2: Cài Init Manga Sync ở site đích (site B)

Tại site nhận dữ liệu, bạn cần cài plugin Init Manga Sync. Có hai cách:

• Cài thủ công như plugin WordPress thông thường
• Hoặc cài tự động ngay trong Setup Wizard (giống luồng Migrator)

Sau khi kích hoạt plugin, truy cập:

Init Manga → Sync

Bước 3: Kết nối hai site

Tại trang cấu hình Init Manga Sync, bạn nhập:

• Sync API Key (đã tạo ở site A)
• Stories endpoint URL
• Chapters endpoint URL

Lưu lại là hoàn tất.

Cách Sync hoạt động phía sau

Sau khi kết nối:

• Plugin sẽ gọi endpoint kèm header X-Init-Manga-Key
• Truyện được đối chiếu bằng slug
• Chương được đối chiếu bằng manga + chapter_slug
• Dữ liệu cũ được cập nhật, dữ liệu mới được tạo

Ngoài thao tác thủ công, hệ thống còn hỗ trợ:

• Sync tự động bằng WP-Cron mỗi 15 phút
• Có thể điều chỉnh số lượng item mỗi lần sync qua filter cho developer

So sánh nhanh: Sync vs Migrator

• Init Manga Migrator: dùng cho backup, xuất/nhập, di chuyển dữ liệu một lần
• Init Manga Sync: dùng cho đồng bộ liên tục, cập nhật theo thời gian

Hai công cụ này bổ trợ cho nhau, không thay thế nhau.

Kết luận

Với Init Manga v1.9.8, Sync không còn là một giải pháp rời rạc mà đã trở thành một phần chính thức trong hệ sinh thái. Việc bật Sync chỉ mất vài phút, không đụng code, không ảnh hưởng hiệu suất, nhưng mở ra khả năng vận hành nhiều site truyện một cách chuyên nghiệp và an toàn.

Nếu bạn đang xây dựng hệ thống main site – mirror site, hoặc chuẩn bị chuyển đổi hạ tầng mà không muốn downtime, Init Manga Sync chính là mảnh ghép còn thiếu.