@dtu-olp-2024/carousel-nocobase/README.md

A NocoBase plugin for carousel view display. Built for the DTU GreenHope project.

# Carousel NocoBase Plugin

## 🌟 Giới Thiệu

`@dtu-olp-2024/carousel-nocobase` là một plugin cho nền tảng NocoBase, cung cấp trải nghiệm hiển thị hình ảnh linh hoạt với Carousel dựa trên Ant Design (antd). Plugin giúp người dùng dễ dàng tạo và quản lý các slide show một cách trực quan và nhanh chóng.

### 🏆 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 dễ dàng Ant Design Carousel với NocoBase
- 🔀 Hỗ trợ hiển thị hình ảnh từ các nguồn dữ liệu khác nhau
- 🔧 Quản lý và tùy chỉnh carousel hiệu quả
- 🔗 Tương thích với phiên bản NocoBase 1.x

## 🚀 Cài Đặt

### Sử Dụng npm:

```bash
npm install @dtu-olp-2024/carousel-nocobase
```

### Sử Dụng Yarn:

```bash
yarn add @dtu-olp-2024/carousel-nocobase
```

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

- Node.js version 18.x trở lên
- NocoBase phiên bản 1.x
- Ant Design phiên bản 4.x trở lên

## 👥 Tác Giả

- Lê Minh Tuấn
- Trần Nguyễn Duy Khánh

## 📄 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

---

**Được phát triển với ❤️ bởi Nhóm DTU-GreenHope**