AboveWP Bulgarian Eurozone

A WordPress plugin that adds bidirectional dual currency display (BGN ⇄ EUR) for WooCommerce as Bulgaria prepares to join the Eurozone. The plugin automatically displays prices in both Bulgarian Lev (BGN) and Euro (EUR) throughout your WooCommerce store, working in both directions.

AboveWP

Features

• Bidirectional support: Works when store currency is BGN (shows EUR) OR when store currency is EUR (shows BGN)
• Currency Migration Tool: One-click conversion of all product prices from BGN to EUR with automatic store currency update
• Display prices in both BGN and EUR throughout your WooCommerce store
• Fixed conversion rate at the official rate (1.95583 BGN = 1 EUR)
• Standard currency symbols (€ for EUR, лв. for BGN)
• Configurable secondary currency positioning (left or right of primary prices)
• Batch processing for stores with thousands of products
• Support for all WooCommerce price points including:
  • Single product pages
  • Variable product pages
  • Cart item prices
  • Cart subtotals
  • Cart totals
  • Order confirmation & email
  • My Account orders table
  • REST API responses
  • Shipping method labels
  • Tax amount labels
  • Mini cart
  • WooCommerce Gutenberg blocks (cart, checkout, and shipping methods)
  • Dynamic updates when shipping methods change in checkout blocks

Requirements

• WordPress 5.0 or higher
• WooCommerce 5.0 or higher
• PHP 7.2 or higher

Configuration

1. Navigate to AboveWP > Eurozone Settings in your WordPress admin
2. Enable or disable dual currency display
3. Choose whether secondary currency appears on the left or right of primary prices
4. Select display format (brackets or side divider)
5. Choose which pages should display dual currency
6. Save changes

Currency Migration Tool

When Bulgaria joins the Eurozone, use the built-in Currency Migration Tool to seamlessly transition your store from BGN to EUR:

1. Navigate to AboveWP > Currency Migration in your WordPress admin
2. IMPORTANT: Create a full database backup before proceeding
3. Review the migration warnings and instructions
4. Click “Start Migration to EUR” to begin the process
5. The tool will:
   • Convert all product prices (regular and sale prices) from BGN to EUR
   • Update all product variations
   • Change your WooCommerce store currency to EUR
   • Process products in batches to handle large catalogs
6. After completion, verify your product prices and currency settings

Note: The migration is irreversible without a database backup. Always backup your database first!

Support

For support, feature requests, or bug reports, please contact us at:

• Website: AboveWP.com
• Email: support@abovewp.com

1. Upload the abovewp-bulgarian-eurozone folder to the /wp-content/plugins/ directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Go to AboveWP > Eurozone Settings to configure the plugin

1. 

   Settings Page Part 1

2. 

   Settings Page Part 2

2.0.0

• NEW: Currency Migration Tool – one-click conversion of all product prices from BGN to EUR
• NEW: Bidirectional currency support – now works when store currency is EUR (shows BGN) or BGN (shows EUR)
• NEW: Automatic detection of primary currency and displays the opposite as secondary
• NEW: Batch processing for migration to handle stores with thousands of products
• NEW: Real-time progress tracking during currency migration
• NEW: Admin-wide notices for currency migration availability
• IMPROVED: All conversion functions now work bidirectionally
• IMPROVED: Admin settings updated to reflect dual-mode support with clear indicators
• IMPROVED: API responses now include both price_eur and price_bgn fields depending on primary currency
• IMPROVED: JavaScript blocks updated with primary/secondary currency awareness
• IMPROVED: Simplified settings interface by removing unnecessary customization options
• IMPROVED: Enhanced admin UI with AboveWP dark theme styling
• FIXED: Sale prices now correctly converted in Gutenberg cart blocks
• This update prepares the plugin for Bulgaria’s Eurozone transition, allowing stores to switch to EUR while still displaying BGN

1.2.4

• Fix tax display in order total for some themes

1.2.3

• Now shows old price on sale products in euro as well.

1.2.2

• Compatibility issue fixes for promo codes.

1.2.1

• FIX ORDER TOTALS BUG

1.2.0

• NEW: Added EUR price display format option – choose between brackets (25лв. (12.78 €)) or side divider (25лв. / 12.78 €)
• NEW: Enhanced admin settings with clear examples for both display formats
• IMPROVED: Fixed thank you page order total not showing EUR equivalent
• IMPROVED: Updated JavaScript to support both bracket and divider formats
• IMPROVED: Added proper translation support for new format options
• IMPROVED: Consistent format application across all price display locations

1.1.5

• Further enhancements to TAX support.

1.1.4

• Fixed an issue with Tax items on Thank You page

1.1.3

• Improved functionality for 3rd party shipping methods

1.1.2

• Resolved an issue causing fatal error in order edit page for some tax types.

1.1.1

• NEW: Support for 3rd party plugins (e.g. Speedy Shipping Method by Extensa)
• IMPROVED: Better handling of shipping method changes in both traditional and block-based checkouts
• IMPROVED: More robust mutation observer for real-time price updates

1.1.0

• REMOVED: Configurable conversion rate option – now uses fixed official rate (1.95583 BGN = 1 EUR)
• NEW: Added EUR price positioning option – choose left or right of BGN prices
• IMPROVED: Enhanced positioning consistency across all price display locations
• IMPROVED: Updated JavaScript for Gutenberg blocks to support positioning
• IMPROVED: Better admin interface with clearer settings organization

1.0.2

• Fixed issue with shipping prices not displaying in EUR in WooCommerce order emails
• Improved shipping price conversion handling in email templates

1.0.1

• Added support for WooCommerce block-based cart and checkout
• Fixed issue with double EUR price display in mini cart
• Improved handling of variable product prices
• Enhanced compatibility with other plugins

1.0.0

• Initial release