npm package: @globusplus/widget
Description: Віджет курсу валют від GlobusPlus для партнерських сайтів.
Author: GlobusPlus
Latest version: 1.0.2


<div align="center">

![GlobusPlus Logo](image/w-logo.svg)

![GlobusPlus Logo](image/widget.png)

# 💰 GlobusPlus Currency Widget

**Віджет курсу валют для вашого сайту**

[![Version](https://img.shields.io/badge/version-1.0.0-ff8c00.svg)](https://github.com/globusplus/currency-widget)
[![License](https://img.shields.io/badge/license-MIT-ff8c00.svg)](LICENSE)
[![JavaScript](https://img.shields.io/badge/JavaScript-ES6+-ff8c00.svg)](https://developer.mozilla.org/en-US/docs/Web/JavaScript)
[![Preact](https://img.shields.io/badge/Preact-10.x-ff8c00.svg)](https://preactjs.com/)

*Легкий та потужний інструмент для відображення актуальних курсів валют на вашому сайті*

[🚀 Швидкий старт](#-швидкий-старт) • [💻 Використання](#-використання) • [⚙️ Конфігурація](#️-конфігурація) • [🤝 Підтримка](#-підтримка)

</div>

---

## 🎯 Про проект

**GlobusPlus Currency Widget** — сучасний віджет курсу валют для інтеграції з веб-сайтами. Відображає актуальні курси USD та EUR для обміну та карткових операцій з підтримкою курсу НБУ.

### ✨ Можливості

- 💵 **USD/EUR** курси валют з НБУ
- 🔄 **Два режими**: обмінний та картковий курс
- 📊 **Індикатори трендів** з кольоровою індикацією
- 📱 **Адаптивний дизайн** для всіх пристроїв
- ⚡ **Легкий бандл** (~20KB) на Preact
- 🎨 **Сучасний UI** з плавними анімаціями

---

## 🚀 Швидкий старт

### 1. Підключіть файли

```html
<!DOCTYPE html>
<html>
<head>
    <!-- CSS -->
    <link rel="stylesheet" href="https://unpkg.com/@globusplus/widget@1.0.1/gp-currency-widget.css">
</head>
<body>
    <!-- Контейнер віджета -->
    <div data-gp-currency-widget></div>
    
    <!-- JavaScript -->
    <script src="https://unpkg.com/@globusplus/widget@1.0.1/gp-currency-widget.iife.js" defer></script>
</body>
</html>
```

### 2. Альтернативні методи

```html
<!-- З користувацьким ID -->
<div id="globusPlusCurrencyWidget"></div>

<!-- Ручна ініціалізація -->
<script>
const component = document.getElementById('componentId');    
window.GPCurrencyWidget.init(component);
</script>
```

---

## 💻 Використання

### Базова інтеграція

```html
<div data-gp-currency-widget></div>
```

---

## 🤝 Підтримка

### 📞 Зв'язок з нами

- 🌐 **Сайт**: [globusplus.ua](https://globusplus.ua)
- 📱 **Instagram**: [@globusplus.ua](https://www.instagram.com/globusplus.ua/)
- 📧 **Email**: support@globusplus.ua

### ❓ FAQ

**Чи можна використовувати безкоштовно?**  
Так, для некомерційного використання та клієнтів GlobusPlus.

**Які валюти підтримуються?**  
USD та EUR. Плануємо додати GBP, PLN.

**Як часто оновлюються курси?**  
Кожні 15 хвилин з офіційних джерел GlobusPlus.

---

## 📄 Ліцензія

MIT License © 2025 GlobusPlus. Всі права захищені.

---

<div align="center">

**Зроблено з ❤️ командою GlobusPlus**

[![GitHub stars](https://img.shields.io/github/stars/globusplus/currency-widget?style=social)](https://github.com/globusplus/currency-widget/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/globusplus/currency-widget?style=social)](https://github.com/globusplus/currency-widget/network/members)
[![Follow Instagram](https://img.shields.io/badge/Instagram-@globusplus.ua-ff8c00?style=social&logo=instagram)](https://www.instagram.com/globusplus.ua/)
</div>