# Модул за Двойна Валута за OpenCart

## Българско описание

### Какво прави този модул?

Модулът за двойна валута ви позволява да показвате цени в основната ви валута заедно с втора валута с автоматично преобразуване. Например, ако магазинът ви използва български лев (BGN), можете автоматично да показвате еквивалента в евро (€) до всички цени.

**Пример за резултат:**
- Преди: `195.58 лв.`
- След: `195.58 лв. (100.00 €)`

**[Вижте пълното представяне на модула](https://opencart.drpanchev.com/dual-currency-showcase.html)** - Снимки, функции и демо на живо

### Ключови функционалности

**Множество валутни двойки** - Конфигурир��йте множество вторични валути за всяка основна валута

**Персонализирани обменни курсове** - Задайте свои собствени обменни курсове независимо от валутната система на OpenCart

**Гъвкаво показване** - Персонализирайте символи и десетични знаци за всяка валутна двойка

**Неинвазивен подход** - Използва OCMOD система - не се изискват промени в основните файлове

**Лесна конфигурация** - Прост админ интерфейс за управление на валутни съответствия

**Независим от темата** - Работи с всякакви OpenCart шаблони/теми без да изисква модификации

**Универсална съвместимост** - Работи с всички версии на OpenCart и теми

### Защо да изберете този модул?

- **Готов за глобален пазар** - Моментalno направете магазина си подходящ за международни клиенти
- **Максимален контрол** - Собствени обменни курсове и настройки за показване
- **Безопасен и обновяем** - Никакви промени в основните файлове на OpenCart
- **Професионална поддръжка** - Пълна документация и технически съпорт

### Демо на живо

Можете да тествате модула на живо в различни версии на OpenCart:

- **OpenCart 3.x**: [Демо магазин](https://opencart.drpanchev.com/30/) | [Админ панел](https://opencart.drpanchev.com/30/admin/)
- **OpenCart 2.3.x**: [Демо магазин](https://opencart.drpanchev.com/23/) | [Админ панел](https://opencart.drpanchev.com/23/admin/)
- **OpenCart 2.1.x**: [Демо магазин](https://opencart.drpanchev.com/21/) | [Админ панел](https://opencart.drpanchev.com/21/admin/)

**Данни за вход в админ панела:**
- Потребител: `demo`
- Парола: `demo`

### Съвместимост

- OpenCart 2.0.x, 2.1.x, 2.2.x, 2.3.x (OCMOD)
- OpenCart 3.x (Extension структура, Twig шаблони)

### Пример за конфигурация

За показване на EUR заедно с BGN цени:
- Изходна валута: `Български лев`
- Обменен курс: `1.95583`
- Символ: `€`
- Десетични знаци: `2`

### Лесна инсталация

1. Качете файловете във вашата OpenCart инсталация
2. Инсталирайте модификацията (OCMOD)
3. Активирайте модула от админ панела
4. Конфигурирайте валутните двойки
5. Готово!

### Поддръжка

- Пълна документация включена
- Професионална техническа поддръжка

---

## English Description

### What does this module do?

The Dual Currency Module allows you to display prices in your main currency alongside a secondary currency with automatic conversion. For example, if your store uses Bulgarian Lev (BGN), you can automatically show the Euro (€) equivalent next to all prices.

**Example output:**
- Before: `195.58 лв.`
- After: `195.58 лв. (100.00 €)`

**[View Full Module Showcase](https://opencart.drpanchev.com/dual-currency-showcase.html)** - Screenshots, features & live demos

### Key Features

**Multiple Currency Pairs** - Configure multiple secondary currencies for each primary currency

**Custom Exchange Rates** - Set your own exchange rates independent of OpenCart's currency system

**Flexible Display** - Customize symbols and decimal places for each currency pair

**Non-Invasive** - Uses OCMOD system - no core file modifications required

**Easy Configuration** - Simple admin interface to manage currency mappings

**Theme Agnostic** - Works with any OpenCart template/theme without requiring modifications

**Universal Compatibility** - Works with all OpenCart versions and themes

### Why Choose This Module?

- **Global Ready** - Instantly make your store international-friendly
- **Maximum Control** - Custom exchange rates and display settings
- **Safe & Upgradeable** - No core OpenCart file modifications
- **Professional Support** - Complete documentation and technical support

### Live Demos

You can test the module live on different OpenCart versions:

- **OpenCart 3.x**: [Demo Store](https://opencart.drpanchev.com/30/) | [Admin Panel](https://opencart.drpanchev.com/30/admin/)
- **OpenCart 2.3.x**: [Demo Store](https://opencart.drpanchev.com/23/) | [Admin Panel](https://opencart.drpanchev.com/23/admin/)
- **OpenCart 2.1.x**: [Demo Store](https://opencart.drpanchev.com/21/) | [Admin Panel](https://opencart.drpanchev.com/21/admin/)

**Admin Login Credentials:**
- Username: `demo`
- Password: `demo`

### Compatibility

- OpenCart 2.0.x, 2.1.x, 2.2.x, 2.3.x (OCMOD)
- OpenCart 3.x (Extension structure, Twig templates)

### Configuration Example

To display EUR alongside BGN prices:
- Source Currency: `Bulgarian Lev`
- Exchange Rate: `1.95583`
- Symbol: `€`
- Decimal Places: `2`

### Easy Installation

1. Upload files to your OpenCart installation
2. Install the modification (OCMOD)
3. Enable the module from admin panel
4. Configure currency pairs
5. Done!

### Support

- Complete documentation included
- Professional technical support

---

## Technical Information

- **Module Name:** Dual Currency Module
- **Version:** 1.0.0
- **Author:** Dr. Panchev
- **License:** Commercial
- **File Size:** Varies by OpenCart version
- **Installation:** OCMOD (version-specific)
- **Database Changes:** Minimal (configuration only)


*Easy-to-use admin configuration panel*
*Clean, professional dual currency display*

---

*Transform your OpenCart store into a global marketplace with professional dual currency display. Perfect for international businesses!*