Documentation

Everything you need to know to get the most out of GeoConvert Pro. Browse guides, tutorials, and API references.

Welcome to GeoConvert Pro Documentation

This documentation covers everything from installation to advanced configuration of GeoConvert Pro, the most powerful currency conversion and geo-targeting plugin for WooCommerce. If you are new here, start with the installation guide below.

Installation

Follow these steps to install GeoConvert Pro on your WordPress site:

  1. Purchase and download the GeoConvert Pro plugin from your account dashboard.
  2. Log in to your WordPress admin panel and navigate to Plugins → Add New.
  3. Click the Upload Plugin button at the top of the page.
  4. Choose the geoconvert-pro.zip file you downloaded and click Install Now.
  5. After installation completes, click Activate Plugin.
  6. You will see a new GeoConvert Pro menu item in your WordPress admin sidebar.
# Example: Upload via WP-CLI
wp plugin install geoconvert-pro.zip --activate

Note: GeoConvert Pro requires WooCommerce 6.0 or higher and WordPress 5.8 or higher. See system requirements for full details.

Quick Start Guide

After activation, follow these steps to get GeoConvert Pro running in minutes:

  1. Go to GeoConvert Pro → Settings in your WordPress admin.
  2. Enter your License Key to activate the plugin.
  3. Set your Base Currency (the currency your products are priced in).
  4. Enable Auto Currency Detection to automatically detect visitor countries.
  5. Select which currencies you want to support from the 120+ available options.
  6. Save your settings and visit your store to see currency conversion in action.
// Example: Programmatically set base currency
add_filter('geoconvert_base_currency', function() {
    return 'USD';
});

System Requirements

To run GeoConvert Pro smoothly, ensure your server meets these requirements:

  • WordPress 5.8 or higher (recommended: 6.0+)
  • WooCommerce 6.0 or higher (recommended: 7.0+)
  • PHP 7.4 or higher (recommended: 8.0+)
  • MySQL 5.6 or higher (recommended: MariaDB 10.3+)
  • WordPress memory limit of at least 128MB (256MB recommended)
  • SSL certificate installed for secure API calls
  • cURL extension enabled in PHP

Currency Settings

Customize how currencies are displayed and converted on your store.

Adding Currencies

From the GeoConvert Pro → Currencies page, you can add, remove, and configure individual currencies. Each currency can have custom formatting, rounding rules, and exchange rate overrides.

// Example: Add a custom exchange rate filter
add_filter('geoconvert_exchange_rate', function($rate, $from, $to) {
    if ($from === 'USD' && $to === 'INR') {
        return 83.15; // Custom rate
    }
    return $rate;
}, 10, 3);

Rounding Rules

GeoConvert Pro offers smart rounding to display psychologically optimal prices. You can configure rounding per currency:

  • Nearest Integer: Round to the nearest whole number (₹4,157)
  • Nearest .99: Round to end with .99 ($39.99)
  • Nearest .95: Round to end with .95 (C$67.95)
  • No Rounding: Display exact converted amount

Geo Pricing Engine

Set unique prices for different countries and regions. The geo-pricing engine lets you control exactly what each market pays.

Setting Country-Specific Prices

Navigate to GeoConvert Pro → Geo Pricing. You can set prices per product, category, or globally:

  • Fixed Price: Set an exact price for a specific country.
  • Percentage Adjustment: Increase or decrease the base price by a percentage.
  • Formula-Based: Use advanced formulas to calculate prices dynamically.
// Example: Apply 10% discount for Indian customers
add_filter('geoconvert_geo_price_adjustment', function($price, $country) {
    if ($country === 'IN') {
        return $price * 0.9;
    }
    return $price;
}, 10, 2);

Geo Offers

Create targeted promotions that display based on the visitor's country. Geo offers help you increase conversion rates by showing relevant local deals.

Creating an Offer

Go to GeoConvert Pro → Geo Offers and click Add New Offer. Configure:

  • Target Countries: Select which countries see this offer.
  • Offer Type: Percentage discount, fixed discount, free shipping, or BOGO.
  • Display Rules: Show on specific pages, products, or categories.
  • Schedule: Set start and end dates for time-limited promotions.

Smart Popups

Create location-aware popups that engage visitors with localized messaging:

  • Welcome Popups: Greet visitors from specific countries with a personalized message.
  • Exit-Intent Popups: Show a targeted offer when a visitor is about to leave.
  • Discount Popups: Display country-specific discount codes.
  • Newsletter Popups: Encourage signups with localized incentives.

Pro Tip: A/B test your popup designs and offers to maximize conversion rates. GeoConvert Pro includes built-in A/B testing for all popup types.

Shipping

Configure location-based shipping options and rates:

  • Set different shipping rates for each country or region.
  • Offer free shipping thresholds based on converted prices.
  • Display estimated delivery times based on destination.
  • Show shipping options in local units and formats.

Tax & Duty Estimation

Automatically calculate and display accurate taxes for international customers:

  • VAT: European Union VAT rates (standard and reduced).
  • GST: India GST with HSN code support.
  • Sales Tax: US state-level sales tax rates.
  • Customs Duties: Estimate import duties based on product category and country.
// Example: Override tax rate for a specific country
add_filter('geoconvert_tax_rate', function($rate, $country) {
    if ($country === 'DE') {
        return 0.19; // 19% VAT for Germany
    }
    return $rate;
}, 10, 2);

Analytics

Track your international sales performance with the built-in analytics dashboard:

  • Conversion by Country: See which countries convert best.
  • Currency Performance: Track revenue by currency.
  • Geo Offer Analytics: Measure the impact of geo-targeted promotions.
  • Customer Insights: Understand buying patterns across regions.
  • Export Reports: Download data as CSV or PDF for further analysis.

Troubleshooting

Common issues and their solutions:

Currency Not Converting

  • Ensure the plugin is activated and your license key is valid.
  • Check that WooCommerce is installed and activated.
  • Verify that the base currency is set correctly in settings.
  • Clear your site cache and browser cache.

IP Detection Not Working

  • Check if your server is behind a proxy or CDN (Cloudflare, etc.).
  • Configure trusted proxy IPs in the GeoConvert Pro settings.
  • Test using the built-in IP detection tester in the tools menu.

Performance Issues

  • Enable the caching option in GeoConvert Pro settings.
  • Use a CDN for static assets.
  • Update to the latest version of the plugin.
  • Contact support if issues persist.
// Enable debug logging
define('GEOCONVERT_DEBUG', true);

Frequently Asked Questions

Additional common questions about GeoConvert Pro:

Does GeoConvert Pro work with subscription products?

Yes, GeoConvert Pro fully supports WooCommerce Subscriptions. Recurring payments are converted to the customer's local currency at checkout. The exchange rate used at checkout is locked for the subscription's duration.

Can I manually override prices for specific products?

Absolutely. You can set individual pricing rules per product from the product edit page. A new "Geo Pricing" meta box appears for each product, allowing you to set country-specific prices or percentage adjustments.

How does GeoConvert Pro handle cached pages?

GeoConvert Pro uses a combination of JavaScript-based client-side detection and server-side caching to ensure fast page loads. Prices are injected dynamically after the cached page loads, so your caching strategy remains intact.

Is GeoConvert Pro compatible with WooCommerce Blocks?

Yes, GeoConvert Pro is fully compatible with WooCommerce Blocks, including the All Products block, Featured Product block, Hand-picked Products block, and all cart and checkout blocks.