=== Bulgaria Dual Currency ===
Contributors: AlexNetsov
Donate link: https://webtospec.com
Tags: woocommerce, currency, bulgaria, bgn, eur, euro, conversion, dual, transition
Requires at least: 5.0
Tested up to: 7.4
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Display both BGN and EUR prices in WooCommerce to help with Bulgaria's EUR transition.

== Description ==

Bulgaria Dual Currency plugin helps Bulgarian WooCommerce stores during the transition period from Bulgarian Lev (BGN) to Euro (EUR). The plugin automatically displays all prices in both currencies in the format: "10.00 лв. / € 5.11"

**Key Features:**

* **Automatic Detection**: Only activates when store currency is set to BGN
* **Official Conversion Rate**: Uses the official rate of 1 BGN = 0.511292 EUR (1 EUR = 1.956 BGN)
* **Comprehensive Coverage**: Displays dual currency across all WooCommerce areas
* **Configurable Settings**: Admin panel to customize display options
* **Email Support**: Includes dual currency in order confirmation emails

**Supported Areas:**

Frontend Display:
* Shop page (WooCommerce archive)
* Product category pages  
* Single product pages
* Variable product price ranges
* Grouped product prices
* Sale price displays
* Cart page and mini cart widget
* Checkout page
* Order confirmation/receipt pages

Admin & Email Display:
* Admin order pages with EUR column
* Product edit pages showing EUR equivalent
* Order confirmation emails
* All WooCommerce email templates

**Usage:**

1. Set your WooCommerce store currency to BGN
2. Install and activate the plugin
3. Prices will automatically display as: "10.00 лв. / € 5.11"
4. Configure settings in WooCommerce > Dual Currency

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/woo-bg-dual-currency/`
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Set your WooCommerce store currency to BGN (if not already set)
4. Go to WooCommerce > Dual Currency to configure settings

== Frequently Asked Questions ==

= Does this plugin work with any currency? =

No, this plugin specifically activates only when your WooCommerce store currency is set to Bulgarian Lev (BGN). It's designed specifically for the BGN to EUR transition in Bulgaria.

= Can I change the conversion rate? =

Yes, you can adjust the conversion rate in the plugin settings, though the default uses the official Bulgarian National Bank rate.

= Will this affect my actual store prices? =

No, this plugin only changes the display of prices. Your actual product prices, orders, and transactions remain in BGN.

= Does it work with variable products? =

Yes, the plugin handles variable products by showing dual currency for both minimum and maximum prices, or single prices when min/max are the same.

= Can I disable dual currency in emails? =

Yes, you can enable/disable dual currency display in emails through the plugin settings.

== Screenshots ==

1. Product page showing dual currency display
2. Cart page with BGN/EUR prices
3. Admin settings page
4. Admin order page with EUR column
5. Email with dual currency prices

== Changelog ==

= 1.0.0 =
* Initial release
* Automatic dual currency display for BGN stores
* Comprehensive WooCommerce integration
* Admin settings panel
* Email support
* Official conversion rate (1 BGN = 0.511292 EUR)

== Upgrade Notice ==

= 1.0.0 =
Initial release of Bulgaria Dual Currency plugin.

== About the Bulgarian EUR Transition ==

Bulgaria is transitioning from the Bulgarian Lev (BGN) to the Euro (EUR). During this transition period, it's helpful for customers to see prices in both currencies. This plugin uses the official fixed exchange rate set by the Bulgarian National Bank: 1 EUR = 1.956 BGN.

The plugin automatically detects if your store uses BGN and displays all prices in the format: "Amount лв. / € EUR_equivalent"

`<?php code(); // goes in backticks ?>`