WooCommerce second currency display

WooCommerce second currency display

195,56 лв. / 99,99 €

A WooCommerce plugin that displays product prices in both BGN and EUR) during Bulgaria’s Eurozone transition period It uses a fixed exchange rate (default: 1 EUR = 1.95583 BGN), with automatic currency conversion at a scheduled cutoff date.




Category:

The WooCommerce Second Currency Display plugin enables WooCommerce stores to display product prices in both Bulgarian Lev (BGN) and Euro (EUR) during a defined transition period (default: July 8, 2025, to December 31, 2026), aligning with Bulgaria’s Eurozone adoption. It appends the equivalent price in EUR for BGN-based stores (or BGN for EUR-based stores) across product pages, cart, and checkout, using a fixed exchange rate (default: 1.95583 BGN/EUR).

The plugin includes an admin settings page to configure the start, cutoff date, and end dates for dual currency display, the exchange rate, and an optional cron job to automatically convert all product prices to EUR at the cutoff date (default: December 31, 2025). The plugin supports WooCommerce blocks and dynamic cart updates, ensuring accurate price displays. It also stores original BGN prices before conversion for reference. With a user-friendly admin interface and secure data processing, it simplifies currency transition management for WooCommerce stores in Bulgaria.

Features of WooCommerce second currency display

  • Dual currency display: Shows prices in both BGN and EUR during the transition period, appending the equivalent price (e.g., “100.00 лв. / 51.13 €” or vice versa) on product pages, cart, and checkout.
  • Configurable transition period: Admin settings for start date (default: July 8, 2025), cutoff date (default: December 31, 2025), and end date (default: December 31, 2026) for dual currency display.
  • Fixed exchange rate: Uses a customizable BGN/EUR rate (default: 1.95583), adjustable via the admin panel.
  • Automatic price conversion: Optionally schedules a cron job to convert all product prices (regular, sale, and base) to EUR at the cutoff date, disabling checkout during conversion to prevent errors.
  • Price history storage: Saves original BGN prices as meta data before conversion.
  • Dynamic cart updates: Updates prices in WooCommerce blocks (cart and checkout) in real-time, ensuring consistent dual currency display.
  • Admin settings page: Provides a user-friendly interface for setting dates, exchange rate, and cron job activation.
  • Manual conversion trigger: Allows admins to manually run the price conversion process via a button in the settings page.
  • Secure & efficient: Implements sanitization, verification, and permission checks for settings and conversion processes.
  • Localization support: Uses own text domain for translatable strings.

Installation

  1. Upload the plugin folder to the /wp-content/plugins/ directory.
  2. Activate the Mobileship WooCommerce Second Currency Display plugin through the WordPress admin panel.
  3. Ensure WooCommerce is installed and activated.
  4. Navigate to Settings > BGN to EUR in the WordPress admin to configure the start date, cutoff date, end date, exchange rate, and cron job settings.
  5. Save the settings to enable dual currency display and schedule automatic conversion if desired.

Usage of WooCommerce second currency display

  • Configure settings: Go to Settings > BGN to EUR to set the transition period (start, cutoff, and end dates), exchange rate, and enable the cron job for automatic price conversion. Default settings align with Bulgaria’s Eurozone timeline.
  • Display dual prices: During the transition period, prices automatically display in both BGN and EUR (e.g., “100.00 лв. / 51.13 €” if BGN is primary, or vice versa). After the cutoff date, the order reverses (e.g., “51.13 € / 100.00 лв.”).
  • Automatic conversion: If the cron job is enabled, all product prices (regular, sale, and base) convert to EUR at the cutoff date, and the store’s currency switches to EUR. Original BGN prices are saved as meta data.
  • Manual conversion: Admins can trigger the conversion manually by clicking “Run Conversion Now” in the settings page, useful for testing or immediate conversion.
  • Cart & checkout: Prices in the cart and checkout update dynamically to show dual currencies, ensuring consistency with WooCommerce blocks.
  • Customize styling: Adjust the appearance of dual price displays by targeting WooCommerce price classes (e.g., .woocommerce-Price-amount) in your theme’s CSS.

Requirements

  • WordPress 5.0 or higher
  • PHP 7.0 or higher
  • WooCommerce 4.0 or higher
  • Admin permissions for configuring settings and running conversions

Related products