Skip to content

A professional WooCommerce plugin for multi-currency management, designed to maximize international sales by allowing customers to view and pay in their local currency.

License

Notifications You must be signed in to change notification settings

ProgrammerNomad/WC-Multi-Currency-Manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌍 WC Multi Currency Manager

A professional WooCommerce plugin for multi-currency management, designed to maximize international sales by allowing customers to view and pay in their local currency.

πŸ“‹ Current Features (v1.0.1)

βœ… Core Currency Management

  • Multi-currency Support: Enable multiple currencies in your WooCommerce store
  • Exchange Rate Management: Manual exchange rate configuration with automatic updates
  • Currency Formatting: Customize symbol position, decimal places, and separators per currency
  • Base Currency Integration: Seamless integration with WooCommerce base currency
  • Enable/Disable Control: Easy currency activation/deactivation

βœ… Professional Admin Interface

  • General Settings: Centralized configuration for all currency options
  • Currency Management: Dedicated page for adding/editing currencies
  • Style Customization: Color schemes and visual customization options
  • Payment Restrictions: Control which payment methods work with specific currencies
  • Card-based Design: Modern, WordPress-standard admin interface
  • Plugin Directory Integration: Quick access settings link

βœ… Frontend Integration

  • Currency Switcher: Dropdown widget for currency selection
  • Product Page Integration: Automatic currency conversion on product pages
  • Cart & Checkout: Full cart and checkout currency support
  • Session Management: Persistent currency selection across user sessions
  • Cookie-based Storage: Remember user preferences

βœ… Cart & Mini-Cart Features (v1.0.1)

  • Real-time Cart Updates: Instant price conversion when currency changes with intelligent caching
  • Mini-Cart Fragments: Proper AJAX updates for mini-cart widget with WooCommerce integration
  • Cart Page Integration: Complete currency information display on cart page
  • Theme Compatibility: Works with Storefront, Organio, and most WordPress themes
  • Performance Optimized: Efficient cart recalculation with smart caching and memory management
  • Error Handling: Comprehensive fallbacks and graceful error recovery
  • Loading Indicators: Visual feedback during cart updates and currency switches

βœ… Checkout & Order Management (v1.0.1)

  • Checkout Currency Lock: Prevents currency switching during checkout process with JavaScript validation
  • Order Currency Tracking: Saves currency and exchange rate with each order for accurate records
  • Admin Order Display: Shows currency information in WooCommerce order details and lists
  • Order History: Correct currency display in customer order history and account pages
  • Thank You Page: Order summary with proper currency details and formatting
  • Email Integration: Proper currency formatting in order confirmation and notification emails
  • HPOS Support: Full compatibility with WooCommerce High-Performance Order Storage

βœ… Enhanced User Experience (v1.1.0)

  • Currency Information: Clear display of exchange rates and currency details with improved formatting
  • Loading Indicators: Visual feedback during currency switches with professional animations
  • Error Handling: Graceful fallbacks and user-friendly error messages
  • Browser Compatibility: Works with all modern browsers including Chrome, Firefox, Safari, Edge
  • Mobile Responsive: Touch-friendly currency switchers optimized for mobile devices
  • Performance Optimized: Fast loading and efficient memory usage even with large product catalogs

βœ… Widget & Display Options

  • Sticky Widget: Optional floating currency switcher
  • Position Control: Left/right positioning for sticky widget
  • Multiple Styles: Dropdown, buttons, and link display options
  • Flag Support: Optional country flag display
  • Shortcode Support: [wc_multi_currency_manager] with parameters

βœ… Payment Gateway Integration

  • Gateway Filtering: Show/hide payment methods per currency
  • Currency-Specific Settings: Configure gateways for specific currencies
  • Checkout Validation: Ensures payment method compatibility

βœ… Advanced Features

  • HPOS Support: Compatible with WooCommerce High-Performance Order Storage
  • Order Columns: Additional currency columns in admin order lists
  • Coupon Conversion: Automatic coupon amount conversion
  • Shipping Conversion: Shipping cost calculation in selected currency
  • Tax Integration: Proper tax calculation with currency conversion

βœ… Customization & Styling

  • Color Customization: Titles, text, active selection, background, borders
  • Custom CSS Support: Advanced styling options
  • Responsive Design: Mobile-friendly currency switchers
  • Theme Compatibility: Works with most WordPress themes
  • Nice Select Support: Compatible with custom select styling plugins

πŸš€ Planned Features (Roadmap)

Phase 1: Advanced Rate Management

  • πŸ”² Automatic Exchange Rates: Integration with Fixer.io, CurrencyLayer, OpenExchangeRates
  • πŸ”² Scheduled Updates: Hourly/daily automatic rate updates
  • πŸ”² Rate Providers: Multiple providers with fallback options
  • πŸ”² Update Logs: Rate change history and error logging

βœ… Phase 2: Geolocation & Smart Detection (COMPLETED)

  • βœ… IP Geolocation: Automatic currency detection based on visitor location using WooCommerce geolocation
  • βœ… Country Rules: Specific currency rules per country with comprehensive mapping system
  • βœ… Geolocation Settings: Advanced rule management interface with 240+ countries
  • βœ… Default Currency Mappings: Pre-configured country-currency mappings with customization options
  • βœ… Custom Mapping Management: Admin interface to override default mappings per country
  • βœ… Fallback Mechanisms: Smart defaults when detection fails (enabled currencies β†’ WooCommerce default)
  • βœ… Search Functionality: Country search in mapping interface for easy management
  • βœ… Navigation Integration: Seamless links between general settings and currency mapping

Phase 3: Enhanced Shortcodes & Widgets

  • πŸ”² Currency Converter: Real-time conversion calculator widget
  • πŸ”² Rate Display: Show current exchange rates
  • πŸ”² Alphabetic Lists: Organized currency displays
  • πŸ”² Shortcode Builder: Visual shortcode creation tool
  • πŸ”² WordPress Widgets: Sidebar integration
  • πŸ”² Gutenberg Blocks: Block editor integration

Phase 4: Advanced E-commerce Features

  • πŸ”² Coupon Conversion: Fixed-amount coupon currency conversion
  • πŸ”² Shipping Costs: Currency-specific shipping rates
  • πŸ”² Free Shipping Thresholds: Per-currency minimum order amounts
  • πŸ”² Enhanced Product Pricing: Advanced per-currency pricing options
  • πŸ”² Tax Integration: Currency-specific tax handling

Phase 5: Analytics & Reporting

  • πŸ”² Order Currency Tracking: Detailed currency usage analytics
  • πŸ”² Revenue Reporting: Currency-based sales reports
  • πŸ”² Rate History: Historical exchange rate tracking
  • πŸ”² Customer Insights: Currency preference analytics

Phase 6: Integrations & Compatibility

  • πŸ”² Page Builder Support: Elementor, Beaver Builder integration
  • πŸ”² SEO Optimization: Yoast, RankMath compatibility
  • πŸ”² Caching Solutions: WP Rocket, W3 Total Cache support
  • πŸ”² Popular Themes: Compatibility testing and optimization
  • Consistent admin interface with intuitive navigation tabs
  • Shortcodes for flexible currency switcher placement
  • Responsive design that works on all devices

Installation

  1. Download the plugin
  2. Upload it to your WordPress site via the Plugins menu
  3. Activate the plugin
  4. Configure settings in the "Currency Manager" menu in the WordPress admin dashboard

Usage

Basic Configuration

  1. Navigate to Currency Manager > General Settings to configure default options
  2. Go to Currency Manager > Currencies to enable currencies and set exchange rates
  3. Use Currency Manager > Style Settings to customize the appearance

Currency Management

  • Add currencies using the dropdown menu on the Currencies tab
  • Remove currencies you don't need with the remove button
  • Set exchange rates manually for each currency
  • Configure decimal places, thousand separators, and symbol positions

Payment Gateway Restrictions

  • Control which payment methods are available for each currency
  • Disable specific gateways for certain currencies to avoid processing fees

Style Customization

  • Customize colors for currency switcher elements
  • Configure widget position
  • Set text colors, background colors, and border styles

Shortcode Usage

  • Use [wc_multi_currency_manager] to display the currency switcher anywhere on your site
  • Additional parameters available for customization: [wc_multi_currency_manager style="dropdown"]

Troubleshooting

  • If you encounter memory issues with large currency lists, increase your PHP memory limit or reduce the number of enabled currencies
  • For issues with currency display, clear your WooCommerce cache
  • Check that your currency settings match your WooCommerce general settings

Author

Created by ProgrammerNomad.

License

This plugin is licensed under the MIT License. See the LICENSE file for details.

Support

For issues or feature requests, please visit the GitHub repository.

About

A professional WooCommerce plugin for multi-currency management, designed to maximize international sales by allowing customers to view and pay in their local currency.

Resources

License

Stars

Watchers

Forks

Releases

No releases published