Init Manga Assistant — Danh sách câu hỏi hỗ trợ

1. Hướng dẫn sử dụng cơ bản

• Làm sao để theo dõi truyện? → Nhấn nút “Theo dõi” trên trang truyện. Có thể thêm vào Playlist.
• Đọc tiếp từ chương đang dở? → Assistant hiển thị chương gần nhất bạn đã đọc, kèm nút chuyển nhanh.
• Truyện nào mình theo dõi đã có chương mới? → Assistant liệt kê truyện đang theo dõi có chương mới, kèm số chương chưa đọc.
• Truyện gì mình vừa đọc gần đây? → Assistant hiển thị Chapter X ngay vị trí view (gọn), có link nhảy thẳng vào chương đó.
• Truyện gì mình vừa mở khóa gần đây? → Hiển thị y hệt “vừa đọc”: Chapter X ngay slot view, link vào chương vừa mở khóa.
• Tính năng khi bình luận? → Emoji, sticker đã mua, đánh dấu spoiler, mention người khác bằng @tên.
• Có cú pháp định dạng văn bản nào khi bình luận không? → Hỗ trợ *đậm*, `nghiêng`, ~gạch~, ^tô sáng^ nếu tính năng inlinefmt bật.
• Truyện gì được lên lịch phát hành hôm nay? → Assistant hiển thị danh sách truyện phát hành trong ngày (đúng múi giờ website).
• Truyện gì được lên lịch phát hành vào ngày mai? → Tự động tính ngày mai theo timezone của site, hiển thị danh sách truyện.
• Truyện gì đã được lên lịch? → Hiển thị tối đa 10 chương sắp phát hành (tự động lấy chap có lịch gần nhất).

2. Thông tin tài khoản

• Xem trạng thái điểm danh → Hiển thị streak điểm danh và phần thưởng hôm nay.
• Kiểm tra chuỗi đọc truyện → Đếm số ngày đọc liên tục.
• Tổng quan tài khoản → Tên người dùng, level + EXP, Coin, Cash, chuỗi điểm danh, chuỗi đọc, tin nhắn.
• Thông tin VIP → Ngày hết hạn, số lần mua, tổng số ngày VIP, lịch sử chi tiêu.
• Huy hiệu của tôi → Hiển thị huy hiệu đã mở.
• Huy hiệu sắp đạt → Thanh tiến trình và số liệu còn thiếu.
• Hộp thư → Xem tối đa 100 tin nhắn gần nhất.
• Mình đã theo dõi những ai? → Assistant hiển thị danh sách tác giả/nhóm bạn đang theo dõi dưới dạng các nút (bấm để mở trang tương ứng).
• Bình luận gần đây của mình → Assistant hiển thị danh sách các bình luận gần nhất của bạn.
• Đánh giá gần đây của mình → Assistant hiển thị các đánh giá gần đây của bạn đối với truyện.
• Làm thế nào để trở thành bạn bè? → Chỉ cần theo dõi lẫn nhau. Khi cả hai cùng follow, hệ thống tự động trở thành bạn và hiển thị trong tab “Bạn bè” trên hồ sơ.

3. Tích điểm – Level – Thành tích

• Cách tính EXP để lên level → Level 1 cần 1000 EXP, mỗi level tăng thêm 500 EXP.
  Công thức: required_exp(level) = 1000 + (level – 1) × 500
• Phần thưởng khi lên level → Nhận Coin theo công thức: 100 + (level × 10). VIP có bonus EXP.
• Coin dùng để làm gì? → Mua VIP, sticker, avatar frame, hiệu ứng tên, mở khóa chương trả phí…
• Power Stone dùng để làm gì? → Bình chọn đẩy thứ hạng truyện.
  Công thức nhận: floor(level / 5) + 1 (tự reset hàng tháng nếu bật).
• Phần thưởng chuỗi đọc truyện → Càng đọc đều, thưởng càng lớn (từ 3 → 1000 ngày).
• Thử thách đọc truyện → Hoàn thành số chương để nhận EXP / Coin / Cash.
• Phần thưởng điểm danh được tính như thế nào? → Điểm danh nhận thưởng lần 1 (EXP + Coin/Cash); online đủ thời gian nhận thưởng lần 2; giữ chuỗi ngày sẽ nhận bonus ở các mốc (Assistant hiển thị số liệu hiện tại và bảng mốc).

4. Tiền tệ & VIP (Economy)

• Làm sao để kiếm Coin / Cash?
  • Điểm danh mỗi ngày
  • Bình luận hợp lệ (tối đa mỗi ngày)
  • Online đủ thời gian
  • Giới thiệu bạn bè
  • Nhập mã quà tặng (Redeem Code)
  • Sự kiện đặc biệt
  • Có thể nạp tiền nếu website bật chức năng
• VIP có lợi ích gì?
  • Không quảng cáo
  • Bonus EXP và Coin
  • Xem trước chương VIP
  • Truy cập chương khóa mật khẩu không cần nhập
  • Mua bằng Coin: 7 / 30 / 90 / 180 / 360 ngày hoặc trọn đời
• Loot Box là gì? → Hộp quà ngẫu nhiên xuất hiện khi đọc truyện. Có thể nhận EXP, Coin, Cash, sticker, avatar frame, hiệu ứng đặc biệt.
• Mã quà tặng (Redeem Code) là gì? → Nhập để nhận Coin/Cash. Được phát khi có sự kiện.

5. Xếp hạng truyện (Ranking)

• Top truyện xem nhiều hôm nay
• Top tuần này / tháng này
• Top hôm qua / tuần trước / tháng trước
• Top mọi thời đại
• Truyện được tìm kiếm nhiều nhất

6. Xu hướng (Trending)

• Mọi người đang đọc gì ngay lúc này? → Live Pulse: hiển thị số người đang đọc theo thời gian thật.
• Truyện nào đang hot? → Dựa vào tốc độ tăng lượt xem và tương tác.

7. Gợi ý truyện (Recommendation)

• Đọc tiếp truyện nào? → Gợi ý theo lịch sử đọc + thể loại yêu thích.
• Truyện gần hoàn thành → Ưu tiên truyện bạn đang gần đọc hết.
• Truyện tương tự → Dựa theo thể loại, tác giả, hành vi người dùng.
• Truyện ngắn đọc nhanh → ≤ 20 chương.
• Truyện ngắn đã hoàn thành → ≤ 20 chương và hoàn thành 100%.
• Truyện dài tập → ≥ 100 chương.
• Truyện chưa từng đọc → Loại bỏ tất cả truyện bạn từng mở.
• Bạn bè mình đang đọc gì? → Gợi ý truyện dựa trên những bộ được nhiều bạn bè của bạn đọc nhất theo thời gian thực.

8. Phân tích & hồ sơ người dùng (Analytics / Profile)

• Tôi có nghiện manga không? → Phân tích số chương đọc trong 7 ngày và chấm mức độ.
• Tổng kết hoạt động đọc trong năm → Tổng số chương đọc, tháng đọc nhiều nhất, thể loại ưu thích…

9. Giao diện & phím tắt

• Phím mở Assistant: Alt + /
• Phím mở Tìm kiếm: Ctrl + /
• Chuyển chương: ← / →
• Các phím khác:
  Alt + U (Trang cá nhân),
  Alt + V (VIP),
  Alt + I (Hộp thư),
  Alt + C (Nhập mã quà tặng)…

10. Đi đến cửa hàng & trang đặc biệt (Assistant điều hướng)

• Mua Nhãn dán (Sticker): Assistant trả: “Bấm vào đây để chuyển trang: Nhãn dán” + hint để auto-redirect (chỉ khi trả lời mới).
• Mua Huy hiệu (Badge): Tương tự Sticker.
• Mua Khung avatar (Frame): Tương tự Sticker.
• Mua Hiệu ứng (Effect): Tương tự Sticker.
• Xem hoặc quản lý vật phẩm đã mua ở đâu? → Mở Kho vật phẩm (Inventory) để quản lý Sticker, Frame và Effect, áp dụng/gỡ bỏ ngay lập tức không cần tải lại trang.
• Mở Hộp quà (Loot Box): Tương tự Sticker.
• Vòng quay may mắn (Lucky Wheel): Nếu trang hợp lệ (đúng template + bật giá quay) → trả link + hint.
• Lưu ý: Tự động chuyển trang chỉ xảy ra khi câu trả lời vừa được tạo. Khi mở lại lịch sử chat, hệ thống KHÔNG chuyển hướng.

11. Thông tin chung

• Hôm nay là thứ mấy?
• Hôm nay ngày bao nhiêu?
• Bây giờ là mấy giờ? (đồng hồ chạy real-time)

12. Mở rộng câu hỏi (Developer / Filter Support)

Assistant không chỉ giới hạn trong danh sách câu hỏi có sẵn — bạn hoàn toàn có thể mở rộng thêm câu hỏi mới (thậm chí chỉnh sửa hoặc loại bỏ câu hỏi mặc định) mà không phải can thiệp vào core của theme.

Tính năng này được cung cấp thông qua filter:

init_manga_assistant_questions

Khi sử dụng filter này, bạn có thể thêm một phần tử mới vào danh sách câu hỏi của Assistant. Mỗi mục bao gồm các thuộc tính: key, desc (mô tả câu hỏi hiển thị), handler (tên hàm xử lý), category (nhóm phân loại) và type (định dạng trả về).

Assistant sẽ tự động nhận diện nếu handler tồn tại và có thể gọi được.

Nguyên tắc:

• Handler phải tồn tại và callable (is_callable() → true).
• Không cần sửa code core — filter sẽ tự hợp nhất nội dung mở rộng với danh sách câu hỏi hiện có.
• Nên khai báo theo thứ tự: define handler → add_filter.

Ví dụ hoàn chỉnh:

// 1) Tạo handler (câu trả lời hiển thị trên UI Assistant)
function init_manga_assistant_handle_say_hello( $payload ) {
    $title = esc_html__( 'Hello there! 👋', 'init-manga' );
    $msg   = esc_html__( 'This is a custom question injected via filter.', 'init-manga' );

    $html = sprintf(
        '<div class="ima-answer"><strong>%s</strong><p>%s</p></div>',
        $title,
        $msg
    );

    return ['type' => 'html', 'data' => $html];
}

// 2) Đăng ký câu hỏi vào Assistant bằng filter
add_filter( 'init_manga_assistant_questions', function( $items ) {
    $items[] = [
        'key'       => 'say_hello_demo',
        'desc'      => __( 'Say hello (demo via filter)', 'init-manga' ),
        'handler'   => 'init_manga_assistant_handle_say_hello',
        'category'  => 'developer',
        'type'      => 'html',
    ];
    return $items;
}, 10 );

Sau khi thêm đoạn code trên, Assistant sẽ hiểu câu hỏi mới và hiển thị trong danh sách gợi ý. Developer có thể tận dụng filter này để tạo tùy biến theo nhu cầu của riêng website, như: câu hỏi riêng cho event, logic phục vụ hệ thống VIP, câu hỏi dành cho mod/community…