WP Residence Help WP Residence Help

  • WpEstate
  • How to Build Your Website
  • Video Tutorials
  • Client Support
  • API
Home / Residence Widgets, Theme Options / Multi currency – how does it work

Multi currency – how does it work

5489 views 2
Note:
The Multi-Currency feature is a function that converts the original price into a new value based on the currency a user has selected from the Multi-Currency Widget.
The theme has 1 main currency and 1 price per property only. There is no option to have different prices for each property (like price in Euro and price in USD).
Each price will be originally displayed using the main currency you set in Theme Options -> Price & Currency

To manage the multi currency options navigate to Theme Options > General > Price & Currency.

Here you have the following options:

  1. Price number thousand separator (for properties price)
  2. Price symbol (for property price)
  3. Price label (for multi currency widget)
  4. Price symbol position. Options are before/after price value.
  5. Enable or disable API for multi-currency and set multi-currency options.

How to set Multi Currency Widget

If you want to use the multi-currency feature, first add a default currency in the admin options.

Add the new currency you can also add currency value.

This value will be used to transform the price from the main currency in this new currency.

For ex 1 EUR = 0.73 x 1 GBR . (0.73 is the GBR).

Auto-exchange currency convertor

For the currency value to change automatically you must set all these 3 settings correctly:

  1. You must enable Enable auto loading of exchange rates from free.currencyconverterapi.com (1 time per day)? AND add your Currencyconverterapi.com Api Key
  2. Get the free api key from here https://free.currencyconverterapi.com/free-api-key and add it in Theme Options
  3. Set the Currency Code and Label according to Internation Standards http://www.xe.com/iso4217.php
Also, since the currencies values can vary from day to day, we create a cron job that runs 1 time per day and takes the financial data from Currencyconverterapi to auto-fill these value forms in Theme Options.

Add the Widget to widget area

For multi-currency we use a widget with dropdowns – https://help.wpresidence.net/article/multi-currency-how-is-working/ When a user changes the currency from the dropdown widget, we read the currency value you just set and convert the original price.

Cookies and Caching
Please note that the user currency options are saved as cookies on user computer. Some cache plugins may interfere with this mechanism.
If use a cache plugin see this help where is explained how  to use a cache plugin with Multicurrency widget dropdown: https://help.wpresidence.net/article/how-to-use-a-cache-plugin-with-multicurrency-widget-dropdown/

Multi Currency Doesn’t sync with Auto Exchange API

If you cannot make the Multi-Currency sync with the Auto Exchange API enabled

Contact hosting and ask them to Activate the fopen function 

Then save the currencies settings again and should solve the problem.

Residence WidgetsTheme Options

Related Articles

  • WPResidence White Label
  • Theme Options – Maps – Google Maps Extra Settings
  • Theme Options – Search – Taxonomies Multi Selection
  • Theme Options -> Search -> Advanced Search Results page

WP Residence Documentation

  • 1. General
    • How to Get Support
    • Get your buyer license code.
    • Use SSL / https
    • Server / Theme Requirements
  • 2. Installation
  • 3. Installation FAQ
  • 4. Advanced Search
    • Advanced Search Display Settings
    • Advanced Search Form
    • Geolocation Search for Half Map
    • Save Search Theme Options
    • Advanced Search Colors
  • 5. Agent, Agency & Developers
  • 6. Property Page
  • 7. Properties List
  • 8. Property Taxonomies
  • WpResidence Elementor Studio
  • 10. Blog Posts & Blog List
  • 11. Shortcodes
    • Contact Form
    • Featured Agency/Developer
    • Membership Packages
    • Testimonials
    • Google Map with Property Marker
    • Listings per Agent, Agency or Developer
    • Display Categories
    • Agent List
    • Recent Items Slider
    • Recent items
    • List Properties or Articles by ID
    • Featured Agent
    • Featured Article
    • Featured Property
    • Login & Register Form
    • Icon Content Box Shortcode
  • 12. Widgets
  • Theme Options
    • General Settings
    • User Types Settings
    • Appearance
    • Logos & Favicon
    • Header
    • Footer Style and Colors
    • Price & Currency
    • Property Custom Fields
    • Features & Amenities
    • Listing Labels
    • Theme Slider
    • Permalinks
    • Splash Page
    • Social & Contact
    • Map Settings
    • Pin Management
    • How read from file works
    • General Design Settings
    • Custom Colors Settings
    • Header Design & Colors
    • Mobile Menu Colors
    • User Dashboard Colors
    • Print PDF Design
    • Property, Agent, Blog Lists Design Settings
    • Sidebar Widget Design
    • Font management
    • How to add custom CSS
    • Custom Property Card Unit – Beta version
    • Email Management
    • Import & Export theme options
    • reCaptcha settings
    • YELP API Integration
    • iHomefinder Optima Express IDX
    • MEMBERSHIP & PAYMENT Settings
    • Property Submission Page
    • PayPal Setup
    • Stripe Setup
    • Wire Transfer Payment Method
  • Translation
  • FAQ
  • Pages
  • Header
  • Footer
  • Google or Open Street Maps
  • Payment Options
  • Plugins
    • Included Plugins
    • Third Party Plugins – IDX Compatibility
    • Third Party Plugins – Multi Languages
    • Third party Plugins – Other
  • Technical
    • Technical how to | Custom Code Required
    • Technical: Child Theme

Join Us On

Powered by WP Estate - All Rights Reserved
  • WpEstate
  • How to Build Your Website
  • Video Tutorials
  • Client Support
  • API