Blog Module

Nhóm Node Blogs - Module

Tổng Quan

Nhóm node Blogs - Module (thuộc danh sách Built-in nodes) cung cấp các công cụ để quản lý và tương tác với các bài viết (Blogs) trên hệ thống RedAI, bao gồm việc cập nhật thông tin bài viết và thay đổi trạng thái hiển thị của bài viết trên marketplace.

Các node này giúp tự động hóa quy trình quản lý nội dung bài viết một cách linh hoạt trong các kịch bản (workflow).

Chi tiết các Node trong Blogs - Module

1. Quản Lý Trạng Thái Bài Viết

Blogs - Toggle Blog Visibility

Chức năng: Ẩn hoặc hiện bài viết đã duyệt trên marketplace.
Cấu hình Input:
- ID bài viết (Bắt buộc): Mã định danh tham chiếu đến bài viết cần thay đổi trạng thái.
- Hiển thị (Bắt buộc): Tùy chọn trạng thái hiển thị bằng Checkbox (true: hiện, false: ẩn).

Blogs - Gửi bài viết để duyệt (Submit Blog for Review)

Chức năng: Gửi bài viết lên hệ thống để chờ phê duyệt.
Cấu hình Input:
- ID bài viết (Bắt buộc): Mã định danh ID của bài viết cần gửi để duyệt.

Blogs - Hủy gửi bài viết (Cancel Submit Blog)

Chức năng: Hủy bỏ yêu cầu gửi bài viết đang chờ phê duyệt duyệt.
Cấu hình Input:
- ID bài viết (Bắt buộc): Mã định danh ID của bài viết cần hủy gửi.

2. Quản Lý Nội Dung Bài Viết

Blogs - Tạo bài viết (Create Blog)

Chức năng: Khởi tạo và đăng tải một bài viết mới lên hệ thống.
Cấu hình Input:
- Tiêu đề (Bắt buộc): Tên bài viết.
- Mô tả (Bắt buộc): Đoạn giới thiệu tóm tắt nội dung.
- Điểm (Bắt buộc): Mức điểm yêu cầu để người khác có thể mua bài.
- Thẻ tag (Bắt buộc): Các nhãn phân loại bài viết.
- Chế độ nội dung: Tùy chọn cách truyền nội dung thật (Text, URL, Upload). Mặc định là Text.
- Nội dung: Khung soạn thảo văn bản. Cần cung cấp nếu Chế độ nội dung là Text.
- URL nội dung: Đường dẫn URL nếu Chế độ nội dung là URL.
- Loại media nội dung: Định dạng MIME nếu Chế độ là Upload.
- Chế độ thumbnail: Tùy chọn cách truyền ảnh đại diện (Media ID, URL, Upload). Mặc định là Media ID.
- ID media thumbnail: Cung cấp ID ảnh nếu chọn chế độ Media ID.
- URL thumbnail: Cung cấp đường dẫn ảnh nếu chọn URL.
- Loại media thumbnail: Định dạng MIME nếu chọn Upload.
- Trạng thái: Lưu bài dưới dạng Draft (Bản nháp) hoặc Pending (Chờ duyệt).

Blogs - Tạo bình luận (Create Blog Comment)

Chức năng: Đăng một bình luận mới vào bài viết cụ thể trên nền tảng.
Cấu hình Input:
- ID bài viết (Bắt buộc): ID của bài viết được nhận bình luận.
- Nội dung (Bắt buộc): Dòng text bình luận.
- ID bình luận cha: Cung cấp ID nếu đây là bình luận có tính chất phản hồi (reply) cho một bình luận khác trước đó.

Blogs - Update Blog Complete

Chức năng: Cập nhật toàn bộ thông tin của một bài viết cụ thể trên hệ thống.
Cấu hình Input:
- ID bài viết (Bắt buộc): Mã định danh của bài viết cần sửa đổi.
- Tiêu đề: Nhập tiêu đề mới cho bài viết.
- Mô tả: Nhập đoạn mô tả ngắn về nội dung bài viết.
- Điểm: Cấu hình điểm số hoặc giá trị ưu tiên cho bài viết.
- Thẻ tag: Thêm các nhãn (tags) để phân loại nội dung bài viết.
- Chế độ nội dung: Chọn hình thức cung cấp nội dung (Text, None, Media ID, URL, Upload).
- Nội dung: Khung nhập văn bản hoặc truyền biến chứa nội dung chi tiết.
- Chế độ thumbnail: Tùy chọn loại hình ảnh đại diện cho bài viết (Ví dụ: Media ID).
- ID media thumbnail: ID của Media nếu sử dụng chế độ Media ID cho thumbnail.

Blogs - Cập nhật media bài viết (Update Blog Media Operations)

Chức năng: Thêm hoặc xóa media khỏi bài viết.
Cấu hình Input:
- ID bài viết (Bắt buộc): ID bài viết cần cập nhật media.
- Thao tác (Operations): Danh sách các thao tác cấu hình truyền vào dưới dạng mảng (array). Mỗi Item bên trong chứa:
  - Thao tác (Bắt buộc): Chọn hành động ADD (thêm) hoặc DELETE (xóa).
  - Loại media (Bắt buộc): Vị trí áp dụng media, tùy chọn Content (nội dung) hoặc Thumbnail (ảnh đại diện).
  - Loại MIME: (Bắt buộc nếu chọn thao tác ADD Upload) Định dạng file MIME.
  - Tên file: (Bắt buộc nếu chọn thao tác ADD Upload) Tên của file tải lên.
  - URL: Cung cấp đường dẫn trực tiếp (Link URL) tùy chọn cho hành động ADD.
  - Key: (Bắt buộc nếu thao tác là DELETE) Khóa định danh của file media cần xóa.

3. Tương Tác / Giao Dịch Bài Viết

Blogs - Mua bài viết (Purchase Blog)

Chức năng: Thực hiện giao dịch mua một bài viết bằng điểm tích lũy trên hệ thống.
Cấu hình Input:
- ID bài viết (Bắt buộc): Mã định danh tham chiếu đến bài viết cần thanh toán giao dịch.

Blogs - Xóa bình luận (Delete Blog Comment)

Chức năng: Xóa một bình luận cụ thể khỏi bài viết trên hệ thống.
Cấu hình Input:
- ID bình luận (Bắt buộc): Mã định danh của bình luận cần xóa.

Blogs - Xóa nhiều bài viết (Bulk Delete Blogs)

Chức năng: Xóa hàng loạt nhiều bài viết cùng lúc thông qua danh sách ID.
Cấu hình Input:
- ID bài viết (Bắt buộc): Danh sách (mảng số nguyên) chứa các ID bài viết cần xóa. Mỗi item là một số nguyên tương ứng với ID bài viết.

4. Trích Xuất Dữ Liệu Bài Viết

Blogs - Tìm kiếm theo thẻ tag (Search Blogs by Tags)

Chức năng: Tìm kiếm các bài viết theo hệ thống thẻ tag đi kèm hỗ trợ phân trang và từ khóa.
Cấu hình Input:
- Thẻ tag (Bắt buộc): Một mảng cấu hình (array) chứa các tag cần tìm kiến chuyên sâu.
- Trang: Số trang yêu cầu (bắt đầu từ 1).
- Số bản ghi: Giới hạn danh sách trả về mỗi trang.
- Từ khóa: Cung cấp thêm từ khóa (Keyword) tìm kiếm phụ đính kèm trong tiêu đề hoặc mô tả.

Blogs - Danh sách bài viết (List Blogs)

Chức năng: Lấy danh sách bài viết trực tiếp trên platform, hỗ trợ phân trang và bộ lọc chi tiết.
Cấu hình Input:
- Trang: Số trang hiện tại cần lấy dữ liệu (Page).
- Số bản ghi: Giới hạn số lượng bài viết hiển thị trên mỗi trang (Limit).
- Tìm kiếm: Truyền từ khóa (Keyword) để tìm kiếm bài viết cụ thể theo nội dung hoặc tiêu đề (Search).
- Sắp xếp theo: Chỉ định trường dữ liệu dùng để sắp xếp kết quả trả về (Sort By).
- Thứ tự sắp xếp: Chọn hướng sắp xếp danh sách kết quả (Tăng dần - ASC hoặc Giảm dần - DESC) (Sort Direction).
- Loại blog: Bộ lọc theo loại bài viết, ví dụ chọn một tùy chọn như My Blogs (Bài viết của tôi), Purchasable (Có thể mua), All (Tất cả).
- Trạng thái: Bộ lọc theo trạng thái hiện tại của bài viết (Draft - Nháp, Pending - Chờ Duyệt, Approved - Đã Duyệt, Rejected - Bị Từ Chối, Deleted - Đã Xóa).
- Hiển thị: Lọc bài viết theo trạng thái hiển thị (true = hiện, false = ẩn) bằng checkbox.

Blogs - Chi tiết bài viết (Get Blog Detail)

Chức năng: Lấy các thông tin chi tiết đầy đủ của một bài viết cụ thể thông qua ID của nó.
Cấu hình Input:
- ID bài viết (Bắt buộc): Mã định danh (ID) chính xác của bài viết cần truy vấn dữ liệu chi tiết.

Blogs - Danh sách bài viết đã mua (Get Purchased Blogs)

Chức năng: Lấy danh sách các bài viết đã được người dùng mua, hỗ trợ phân trang và bộ lọc thời gian.
Cấu hình Input:
- Trang: Số trang dữ liệu yêu cầu (bắt đầu từ 1).
- Số bản ghi: Số lượng bài viết giới hạn hiển thị mỗi trang.
- Thời gian bắt đầu: Timestamp (tính bằng milliseconds) xác định thời điểm bắt đầu lọc.
- Thời gian kết thúc: Timestamp (tính bằng milliseconds) xác định thời điểm kết thúc lọc.

Blogs - Chi tiết giao dịch mua (Get Blog Purchase Detail)

Chức năng: Lấy thông tin chi tiết về một giao dịch mua bán bài viết cụ thể trên hệ thống.
Cấu hình Input:
- ID giao dịch (Bắt buộc): Mã ID của giao dịch (Purchase ID) cần lấy dữ liệu tra cứu.

Blogs - Kiểm tra trạng thái mua (Check Blog Purchase Status)

Chức năng: Kiểm tra xem một bài viết/đoạn nội dung cụ thể đã được người dùng mua hay chưa.
Cấu hình Input:
- ID bài viết (Bắt buộc): Mã định danh bài viết cần kiểm tra trạng thái thanh toán/mua.

Blogs - Lấy bình luận (Get Blog Comments)

Chức năng: Trích xuất danh sách các bình luận của một bài viết cụ thể, có hỗ trợ phân trang.
Cấu hình Input:
- ID bài viết (Bắt buộc): Mã định danh ID của bài viết cần lấy danh sách bình luận.
- Trang: Số trang bắt đầu để lấy bình luận (bắt đầu từ 1).
- Số bản ghi: Giới hạn số lượng bình luận được hiển thị trên mỗi trang dữ liệu.