TruyenGG - Nền tảng đọc truyện trực tuyến - Blog chia sẻ kiến thức: Máy tính

Chào mừng bạn đến với TruyenGG, một ứng dụng web đọc truyện mạnh mẽ với giao diện thân thiện, hỗ trợ chế độ sáng/tối và tích hợp các tính năng quản lý nội dung, người dùng. TruyenGG mang đến trải nghiệm đọc truyện mượt mà với khả năng tích hợp API bên ngoài để lấy nội dung và lưu trữ hình ảnh.

Tính năng

Hiển thị truyện: Lấy dữ liệu truyện từ OTruyen API và hiển thị hình ảnh từ ImgBB.
Tương tác người dùng: Thích, theo dõi truyện, lưu lịch sử đọc và bình luận chương.
Xác thực người dùng: Đăng ký, đăng nhập, khôi phục mật khẩu và đăng nhập bằng Google.
Quản lý nội dung: Tự động crawl truyện từ TruyenQQ hoặc thêm, sửa, xóa truyện và chương thủ công.
Quản lý người dùng: Bảng quản trị cho phép quản lý tài khoản, phân quyền (admin, user, nhóm dịch).
Giao diện: Hỗ trợ chế độ sáng/tối, thiết kế hiện đại và thân thiện với người dùng.
Tính năng nâng cao: Tìm kiếm theo thể loại, xem top truyện tháng, quản lý thông tin cá nhân.

Video hướng dẫn: https://youtu.be/v7DEGN3ZVsg?si=ABQ8Dv0iLTzvBnbI

Ảnh Demo

Dưới đây là các ảnh chụp giao diện của TruyenGG, sắp xếp từ trang người dùng đến trang quản trị:

Trang chủ

Giao diện chính với bố cục trực quan để khám phá truyện.
Thông tin truyện

Xem chi tiết truyện, bao gồm tóm tắt, thể loại và danh sách chương.
Trang đọc truyện

Trải nghiệm đọc truyện mượt mà với điều hướng chương.
Lọc theo thể loại

Duyệt truyện theo thể loại để dễ dàng tìm kiếm.
Tìm kiếm nâng cao

Tìm kiếm truyện theo nhiều tiêu chí.
Truyện mới cập nhật

Cập nhật danh sách truyện mới nhất.
Top truyện tháng

Khám phá các truyện nổi bật theo tháng.
Lịch sử đọc

Theo dõi tiến độ đọc truyện.
Danh sách theo dõi

Quản lý danh sách truyện đang theo dõi.
Thông tin tài khoản

Xem và chỉnh sửa thông tin cá nhân.
Đăng ký

Form đăng ký tài khoản đơn giản và an toàn.
Đăng nhập

Trang đăng nhập hỗ trợ Google OAuth.
Bảng quản trị

Trang tổng quan dành cho quản trị viên.
Quản lý truyện

Thêm, sửa, xóa truyện và chương.
Quản lý người dùng

Quản lý tài khoản và phân quyền.
Công cụ crawl

Công cụ tự động crawl truyện từ TruyenQQ.

Hướng dẫn cài đặt

Yêu cầu

Môi trường local: Cài đặt Laragon hoặc XAMPP.
PHP: Phiên bản 7.4 trở lên.
MySQL: Quản lý cơ sở dữ liệu.
Composer: Quản lý thư viện (nếu dùng Laravel).
Trình duyệt: Chrome, Firefox hoặc bất kỳ trình duyệt hiện đại nào.

Cấu hình

Cấu hình cơ sở dữ liệu
Chỉnh sửa thông tin kết nối trong file config/database.php:

$servername = "localhost";      // Tên host cơ sở dữ liệu
$username = "root";            // Tên người dùng cơ sở dữ liệu
$password = "";                // Mật khẩu cơ sở dữ liệu
$dbname = "hoangtoph";         // Tên cơ sở dữ liệu

Cập nhật các giá trị phù hợp với cấu hình MySQL của bạn.

Cấu hình gửi email khôi phục mật khẩu
Sửa thông tin email trong file config/send_email.php (dòng 68-69):

$mail->Username = 'tophvn17@gmail.com'; // Email của bạn
$mail->Password = 'aaaa bbbb cccc dddd'; // Mật khẩu ứng dụng (không phải mật khẩu Gmail)

Sử dụng mật khẩu ứng dụng cho Gmail.

Cấu hình bảng settings trong cơ sở dữ liệu
Bảng settings chứa các khóa cấu hình quan trọng. Cập nhật các giá trị sau:
- google_client_id: ID ứng dụng Google API cho đăng nhập OAuth.
  Ví dụ: 614640831923-t6u5hqvrp2t8g3lv557bede6gu8c35fo.apps.googleusercontent.com
- google_client_secret: Khóa bí mật của Google API.
  Ví dụ: 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
- google_redirect_uri: URL chuyển hướng cho Google OAuth.
  Ví dụ: http://localhost/truyengg/includes/auth/google-callback.php
- turnstile_secret_key: Khóa bí mật Cloudflare Turnstile để chống bot.
  Ví dụ: 0x4AAAAAABBmdz5FqnaxoDoaMqkvkbV7Q1o
- imgbb_api_key: Khóa API ImgBB để tải ảnh lên.
  Ví dụ: 643885b88cdae3183c2ddd0e9ae4b5bc

Chạy trên localhost

Tải mã nguồn:

git clone https://github.com/your-username/truyengg.git

Nhập cơ sở dữ liệu:
- Tạo cơ sở dữ liệu MySQL tên hoangtoph.
- Nhập file SQL được cung cấp vào cơ sở dữ liệu.
Cấu hình dự án:
- Cập nhật file config/database.php, config/send_email.php và bảng settings như hướng dẫn.
Khởi động server:
- Sử dụng Laragon hoặc XAMPP, trỏ server đến thư mục truyengg.
- Truy cập tại http://localhost/truyengg/.
Cài đặt thư viện (nếu cần):
```
composer install
```

Triển khai lên web

Tải mã nguồn lên server (ví dụ: qua FTP).
Cấu hình thư mục gốc của server trỏ đến thư mục truyengg.
Tạo cơ sở dữ liệu MySQL trên server và nhập file SQL.
Cập nhật config/database.php, config/send_email.php và bảng settings với thông tin môi trường production.
Đảm bảo server hỗ trợ PHP và các tiện ích mở rộng cần thiết (như pdo_mysql).
Trỏ tên miền đến server và truy cập trang web.