🚀 Cài đặt và Sử dụng

 

Dự án được xây dựng bằng PHP thuần (Native PHP) nên rất dễ dàng triển khai.

Yêu cầu hệ thống

 

• PHP 7.4 trở lên.
• Extension gd (thư viện xử lý ảnh) phải được bật trong php.ini.

  📂 Cấu trúc dự án

 

qranime/ ├── admin/ # Các class xử lý cốt lõi (Core rendering) │ └── TemplateRenderer.php # Xử lý render ảnh chung ├── assets/ # Tài nguyên tĩnh (CSS, JS, Images) ├── font/ # Font chữ sử dụng để chèn text lên ảnh ├── template/ # Kho giao diện (Mỗi thư mục là một mẫu) │ ├── pink2/ # Ví dụ một mẫu template │ │ ├── index.php # Logic xử lý riêng (ví dụ: coordinates, warping) │ │ └── bg.jpg # Hình nền của mẫu │ └── ... ├── api/ # Các API endpoint (nếu có) ├── qr-bank/ # Các thành phần liên quan đến VietQR ├── index.php # Trang chủ và giao diện chính └── README.md 🛠 Công nghệ sử dụng

 

• Frontend:
  • HTML5, CSS3, JavaScript.
  • Bootstrap 5 - Framework giao diện.
  • QRCode.js - Tạo QR Code phía client.
• Backend:
  • PHP (Vanilla).
  • thư viện GD - Để xử lý đồ họa, ghép QR vào ảnh, xử lý màu sắc và biến dạng hình học (Image Warping).

📝 Cách thêm Template mới

 

1. Tạo thư mục mới trong template/ (ví dụ: template/new-style).
2. Thêm file hình nền bg.jpg vào thư mục đó.
3. (Tùy chọn) Tạo file index.php trong thư mục template để định nghĩa tọa độ chèn QR (coords) và màu sắc (targetHex) nếu cần xử lý phối cảnh phức tạp. Tham khảo cấu trúc trong template/pink2/index.php.

🤝 Đóng góp

 

Mọi đóng góp đều được hoan nghênh! Hãy gửi Pull Request hoặc tạo Issue nếu bạn phát hiện lỗi hoặc muốn đề xuất tính năng mới.