Skip to main content

VietQR NocoBase Plugin

🌟 Giới Thiệu​

@dtu-olp-2024/vietqr-nocobase là một plugin cho nền tảng NocoBase, tích hợp VietQR API, giúp dễ dàng sinh mã QR thanh toán

🏆 Bối Cảnh​

Plugin được phát triển như một phần của cuộc thi Mã Nguồn Mở năm 2024.

✨ Tính Năng​

  • 🏦 Tích hợp trực tiếp với VietQR API
  • ⚡ Sinh mã QR thanh toán nhanh chóng
  • 🌐 Hỗ trợ đa ngân hàng
  • 🔧 Tùy chỉnh thông tin thanh toán linh hoạt
  • 📄 Xuất mã QR dưới nhiều định dạng (PNG, SVG)

🔧 Sử dụng yarn:​

    yarn add @olp-dtu-2024/vietqr-nocobase

🛠️ Thêm trực tiếp với plugin manager:​

Từ trên menu, bạn chọn biểu tượng Plugin manager để truy cập vào Plugin manager

Truy cập plugin manager page

Tiếp theo, bạn ấn nút Add new để mở hộp thoại thêm plugin.

Mở hộp thoại thêm mới plugin

✏️ Sử dụng tên plugin:

Điền tên plugin vào Npm package name

✅ Kích hoạt plugin:

Sau khi thêm plugin thành công, bạn phải enable plugin này để sử dụng:

Kích hoạt plugin

💡 Hướng dẫn sử dụng​

@dtu-olp-2024/vietqr-nocobase là một plugin server. Vì thế, để sử dụng bạn sử dụng nó bằng cách gọi API.

Ví dụ với WorkFlow:

alt text Bao gồm các thành phần:

  • Methods: POST
  • Path: '/api/qr-donate'
  • Body: Dữ liệu bạn muốn dùng để tạo nội dung chuyển khoản

📋 Yêu Cầu Tiên Quyết​

  • Node.js version 18.x trở lên
  • NocoBase phiên bản 1.x
  • Kết nối internet ổn định

👥 Tác Giả​

  • Lê Minh Tuấn
  • Trần Nguyễn Duy Khánh
  • Trịnh Minh Son

📄 Giấy Phép​

Dự án được phân phối dưới giấy phép GNU General Public License v3.0

🤝 Đóng Góp​

Chúng tôi rất hoan nghênh các đóng góp từ cộng đồng! Vui lòng:

  • Tạo issue để báo cáo lỗi
  • Gửi pull request để đề xuất cải tiến
  • Truy cập GitHub Repository của chúng tôi để biết thêm chi tiết

🆘 Hỗ Trợ​

Nếu gặp bất kỳ vấn đề nào, vui lòng:

  • Mở issue tại GitHub repository
  • Liên hệ trực tiếp với nhóm phát triển

⚠️ Lưu Ý​

  • Đảm bảo tương thích với phiên bản NocoBase hiện tại
  • Kiểm tra kết nối và cấu hình trước khi sử dụng

📝 License​

Dự án này được cấp phép theo các điều khoản của giấy phép GPL V3 GPL V3 License

"Được phát triển với ❤️ bởi Nhóm DTU_DZ1 🌟"