Module · Currency

Currency settings

Where: ExpertPress → Currency (Валюта), in the Modules group of the admin app.

Who can open it: users with platform management permission (expertpress_operate): Administrators and Managers. See Roles and access.

The screen has three parts:

  • the settings form, saved with Save (Зберегти). After saving you see "Saved.";
  • Current rate (Поточний курс) with the Get today's rate now button;
  • Saved price snapshots (Збережені знімки цін), a read-only check.

No option needs an account or credentials: the rate source is the public open-data service of the National Bank of Ukraine.

When saving, a value that is not valid is not kept as typed: it is replaced as described under each option.


Settings form

Currency switcher

  • Where: ExpertPress → Currency, first row (Перемикач валюти). Checkbox Show prices in the visitor's currency (Показувати ціни у валюті відвідувача).
  • What it does: Turns the whole module on or off for visitors. When on, and once a usable rate is stored, visitors get approximate prices and the [expertpress_currency_switcher] shortcode shows its links. When off, every page shows the exact sale price only, booking history and emails included; the daily automatic rate update also stops. Stored rates and snapshots are kept.
  • Default: off.
  • Values / limits: on / off.
  • When to change it:
    • A marketplace prices sessions in UAH but has many clients abroad: turn it on so they see a rough amount in EUR or USD.
    • All clients pay in the same currency the prices are in: leave it off.
    • The rate source is unavailable for a long time and you prefer not to show any approximation: turn it off (the module also hides itself once the rate is too old).
  • Related: Hide after (days without a new rate), Overview

Currencies

  • Where: same form (Валюти). One checkbox per currency: UAH, EUR, USD. Under the checkboxes the screen shows the platform's sale currency ("Sale currency of the platform: … Rates: National Bank of Ukraine.").
  • What it does: The currencies visitors can choose in the switcher, and the currencies whose rates are fetched every day.
  • Default: all three.
  • Values / limits: at least two. If fewer than two are ticked, all three are saved. Only UAH, EUR and USD are available.
  • When to change it:
    • Prices in UAH and clients mostly in Europe: tick UAH and EUR.
    • Prices in EUR and clients in Ukraine and the US: tick all three.
  • Note: keep the sale currency ticked. For EUR or USD sale prices, its rate must be fetched for any conversion to work, and the sale currency is the fallback display currency for visitors who have not chosen one. UAH is the rate source's base currency and needs no rate of its own.
  • Related: Pricing currency

Daily update

  • Where: same form (Щоденне оновлення). An hour field (:00) followed by a Time zone (Часовий пояс) text field.
  • What it does: The local hour from which the site fetches the new day's rate, and the time zone used for this hour and for counting the age of a rate. Before that hour, yesterday's rate stays active. The site checks once an hour; if the rate is not available yet, it tries again the next hour. A site with no stored rate fetches at once, whatever the hour.
  • Default: 12 (12:00), time zone Europe/Kyiv.
  • Values / limits: hour 0–23 (values outside are clamped). The time zone must be a PHP time zone name such as Europe/Kyiv, Europe/Berlin or America/New_York; an unknown name is replaced with Europe/Kyiv on save.
  • When to change it:
    • The bank publishes the day's rate earlier or later than you need: move the hour so the site does not keep retrying for hours.
    • Your team works in another time zone and wants the change to happen at a predictable local time: set that zone.
  • Related: Get today's rate now. The update relies on WordPress scheduled tasks; check them under System check.

Hide after (days without a new rate)

  • Where: same form (Сховати через (днів без нового курсу)).
  • What it does: How many calendar days the last stored rate may be used. Days are counted in the time zone from Daily update. When the rate is older, the switcher hides and all pages show the exact sale price only, until a new rate is stored. A rate dated in the future is never used.
  • Default: 7 days.
  • Values / limits: 1–30 days (values outside are clamped).
  • When to change it:
    • Prices in currencies that move fast: set 2–3 days so visitors never see an outdated approximation for long.
    • Weekends and holidays without new rates leave gaps: keep at least 3–4 days so the switcher does not disappear over a long weekend.
  • Related: Overview: When the rate is too old

Uninstall

  • Where: same form (Видалення). Checkbox Delete rate tables, snapshots, settings, and visitor currency preferences when the plugin is deleted.
  • What it does: When ticked, deleting the plugin from the Plugins screen also deletes its tables (rates and snapshots), its settings and every user's saved currency choice. When not ticked, deleting the plugin keeps all of this. The scheduled rate update is removed in both cases.
  • Default: off.
  • Values / limits: on / off. On a multisite network, users' saved choices are shared by the network and are deleted only when every site that used the module has this option ticked and its data was deleted successfully.
  • When to change it:
    • You are removing the module for good and want a clean database: tick it, save, then delete the plugin.
    • You are reinstalling or moving the site: leave it off so stored snapshots (what clients saw for past bookings) survive.
  • Related: Overview: Turning it off and removing it, How long data is kept

Current rate

  • Where: ExpertPress → Currency, below the form.
  • What it shows: the date and source of the active rate set ("Rate of YYYY-MM-DD (NBU).") and one line per currency, for example "1 EUR = 48.1234 UAH". If the set is older than Hide after, the line ends with "Outdated — prices are shown in the sale currency only." Before the first rate: "No rate stored yet. The switcher stays hidden until the first rate arrives."

Get today's rate now

  • Where: button under Current rate.
  • What it does: Fetches today's rate immediately, ignoring the daily hour. It works even while the switcher is off, so you can check the source before turning the module on. Results: "Today's rate is stored." (also shown when today's rate was already stored) or "The rate source did not answer. The previous rate stays; the site retries every hour." A new rate set replaces the active one only when every chosen currency came back for today's date.
  • Default / values: none (an action).
  • When to use it:
    • Right after turning the module on, so visitors see approximate prices without waiting for the scheduled run.
    • After changing Currencies, so the new currency gets a rate today.
    • When the screen says the rate is outdated and you want to check whether the source answers.

Saved price snapshots

  • Where: ExpertPress → Currency, bottom section (Збережені знімки цін). Button Check snapshots (Перевірити знімки), then Check again.
  • What it does: A read-only check of the stored "what the client saw" amounts (bookings, shop orders and other purchases that store them). It counts Snapshots, those that Point to a missing rate set, those that Point to an unusable rate set, and Damaged records, and lists up to the first problem snapshots by number. On a very large table only part is checked, and the screen says so ("Only the first … of … snapshots were checked…"). Nothing is changed.
  • When to use it:
    • Before removing the module or moving the site, to confirm stored amounts are intact.
    • After a database restore, to see whether snapshots still match their rate sets.
  • Note: a snapshot with a problem simply shows no approximate amount; exact prices and money records are not affected. The screen offers no repair action.

Things that are not on the screen

  • Visitor country. Choosing a currency by the visitor's country needs a developer to supply the country (see Overview: Visitor country).
  • How long a visitor's choice is remembered. 180 days in the browser; for signed-in users also in their account, with no time limit.
  • The rate source. The National Bank of Ukraine is the only source; it cannot be changed on the screen.