Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

Excerpt

From version 3.82+, websites using BPD are able to implement country-based geocoding and multi-currency support. This enables the display of region-specific information (product prices in $USD, for example).

...

Widget in Theme Layout Top ZoneModal Window for Country Selection

Image Modified

Image Modified

Geolocation

When a user lands on your site, Customer Self Service makes an API call to the geolocation provider - this retrieves the user's IP address and associated location details.

...

  1. Login to the CMS. 
  2. Navigate to Settings --> Settings
  3. Scroll to the Geolocation Settings section.
  4. Set the Geolocation Provider to MaxMind.
  5. Enter your credentials: 
    • Username - your MaxMind username
    • Password - your MaxMind password 
  6. Click 'Update' to save changes. 


Country Selector

Even though the user's default country is set via the geolocation service, the user is still free to select a different country while on the website. To do this, they simply select from the country list displayed by the Country Select widget. 

...

  1. Login to the CMS.
  2. Navigate to Settings --> Dictionary
  3. Search for 'cvlanguage' and click 'Open'. 
  4. Click 'New'. 
  5. Enter values for the first country, we'll presume it's Australia:
    • Language Code - AU
    • Language Description - Australia
    • Default Date Format - dd-MMM-yyyy
    • Default Currency Format - $0.00
    • Active - Ticked / Yes
  6. All other fields can be left blank / as default. 
  7. Click 'OK' to save. 
  8. Repeat steps 4 - 7 for other countries and currencies your site will support.

    Tip

    If your site supports an extensive list of countries and currencies, we can import this data on your behalf. Contact Commerce Vision to enquire about a bulk update if required.

     

     

  9. Still on the same page, refresh the Dictionary by ticking System Control and clicking 'Refresh Cache'. 

...

  1. Login to the CMS.
  2. Navigate to Content --> Theme Layout
  3. In the zone Top Bar, add the Country Select widget.
  4. Load your website in another browser / incognito tab to verify the widget displays as expected. (You can adjust the widget's position by dragging and dropping it within the zone in CMS as required.) 
  5. Click the country name to launch the selector window. 
  6. You should see the list of countries from the CV Language table. Each country name is paired with its flag. 

 

 

 

Info

Content by Label
showLabelsfalse
max5
spacesKB
sortmodified
showSpacefalse
reversetrue
typepage
labelshow-to cms settings