Show Location-Based Storefront Currencies with CF Geo Controller - Article
Summary
Presenting a familiar currency can make a commercial training offer easier to evaluate before a visitor signs in. CF Geo Controller supplies location information; Eurekos uses that result to choose among the prices configured for the offer.
This supports a localized storefront experience. It does not create a new currency price or perform automatic foreign-exchange conversion.
Use this article to:
- Connect the supported geolocation service
- Enable the corresponding Commerce display settings
- Check anonymous price selection and fallback cases
Business Context
The CF Geo Controller integration enables Eurekos to adapt the commercial storefront experience based on a user’s geographic location. Rather than presenting all users with a single currency, the platform can select an available price in a relevant currency, helping the visitor understand the offer without manually comparing currencies.
From a business perspective it directly supports:
- Clearer regional pricing to support the purchase decision
- Market adaptation across regions
- Improved user experience at the point of entry
Importantly, this functionality applies before login, shaping the initial storefront experience.
Feature Overview
CF Geo Controller (formerly CF Geo Plugin) is a WordPress-based geolocation service that integrates with Eurekos to enable location-aware storefront behavior.
Once configured, the integration allows Eurekos to:
- Detect a user’s geographic location (via external service)
- Request user consent for location tracking
- Display prices in the user’s local currency
This functionality applies specifically to anonymous users browsing the storefront, ensuring that pricing is aligned with their location before any interaction takes place.
Data Exchange: Geo Controller & Eurekos
The CF Geo Controller integration is dependent on an external WordPress-based geolocation service and cannot function independently within Eurekos. Rather than performing geolocation internally, Eurekos relies entirely on a connected WordPress environment where the Geo Controller plugin is installed and configured.
This means that the integration is not self-contained—it is part of a broader ecosystem setup, where WordPress acts as the source of truth for user location data.
To successfully enable this integration, the following prerequisites must be met:
- An active Geo Controller subscription
- A WordPress-managed website with the Geo Controller plugin installed
- Administrative access to configure and retrieve API credentials from that site
Without this setup, no geolocation data will be available to Eurekos, and the feature will not operate.
| System | Responsibility |
|---|---|
| WordPress (Geo Controller) | Detects user location based on IP and manages user consent |
| Eurekos | Receives location data and applies it to storefront currency display |
⚠️ Eurekos does not control how location is detected — it only consumes the result provided by the Geo Controller plugin
Configuration
The integration is configured in two steps:
Step 1: Configure CF Geo Controller Integration
Navigate to Settings → Third-party integrations → CF Geo Plugin.
Enter the required API configuration.
| Field | Description |
|---|---|
| API Version | Use API v2; v1 is deprecated |
| Endpoint | WordPress endpoint (e.g. /wp-admin/admin-ajax.php) |
These values must be retrieved from your WordPress Geo Controller setup.
Step 2: Enable Currency Detection
Navigate to Settings → Commerce → Activity information (General tab).
Ensure the following settings are enabled:
- Price is enabled
- Auto detect currency for anonymous users based on location
Click Save to activate the feature
Understand which price is selected
Configure the relevant currency prices on the offer before relying on location detection. Eurekos selects an existing price using this sequence:
| Available offer prices | Anonymous Storefront result |
|---|---|
| A price matches the detected location currency | That matching currency price is displayed |
| No matching price, but a default-currency price exists | The default-currency price is displayed |
| Neither matching nor default-currency price exists | One of the available configured prices is displayed |
| Automatic detection is disabled | The Storefront uses the default-currency display behavior |
For example, a product-training offer may have EUR and GBP prices. A UK visitor can see its configured GBP price; that amount need not be a conversion of the EUR price. Decide the commercial prices deliberately.
Relationship to the User Journey
This integration operates at the very beginning of the user journey, before any interaction or authentication takes place.
| Stage | Behavior |
|---|---|
| Anonymous visit | Currency is auto-detected |
| Signup | No direct impact |
| Login | Standard behavior applies |
| Enrollment | Uses defined pricing from configurations |
Governance and Best Practices
- Ensure alignment with pricing strategy → Currency display should match how pricing is structured in activities and tax configuration
- Always test with different locations → Use VPN tools to verify:
- Currency changes correctly
- Consent flow behaves as expected
- Validate configuration → Most issues originate from:
- Incorrect endpoint
- An unsupported API version; use v2
- Plugin misconfiguration
- Understand consent requirements → Users must approve location tracking—otherwise, default behavior applies
- Use in combination with commerce setup → This feature only works when:
- Pricing is enabled
- Commerce configuration is correctly set
Verify the anonymous shopping experience
| Check | Expected result or evidence |
|---|---|
| Configured matching currency | A representative anonymous visit selects the intended configured price |
| No matching currency | The configured fallback is used; no new exchange amount is calculated |
| Price display disabled | The storefront follows its Commerce visibility configuration |
| Location unavailable | Review provider consent and fallback behavior without assuming a detected country |
Troubleshooting
| Problem | What to check |
|---|---|
| Currency does not change | Anonymous visit, API v2 endpoint, provider setup and both Commerce display settings |
| Unexpected amount is displayed | Which currency prices actually exist on the offer and which fallback applies |
| Location is not detected | External service availability and the consent flow |
| Signed-in behavior differs | This location-based display feature applies to anonymous visitors |
FAQ
-
Does CF Geo Controller convert a training price into another currency?
No. Eurekos selects from the offer’s configured currency prices. If a matching price is unavailable, it uses the configured fallback rather than calculating a new foreign-exchange amount.
-
Which CF Geo API version should a new configuration use?
Use API v2 for new configurations. API v1 is deprecated.