Description

Kurs Rublya FX Rates Calculator adds FX rate cards, a currency calculator, and a multi-currency board to any WordPress page.

It is especially useful for travel agencies and tour operators that organize trips to Russia: publish clear, up-to-date exchange-rate information for Russia on your site so clients can see typical FX levels and convert amounts before or during their travel.

This is an independent plugin by kurs-rublya.ru. It is not an official product of the Central Bank of Russia. Rates shown in the widgets are provided by kurs-rublya.ru based on publicly published Central Bank of Russia figures.

Features

Single-currency rate card with daily change (Δ%)
Currency calculator / converter
Multi-currency board with daily change
Gutenberg blocks, shortcodes, and classic widgets
Dark / light widget theme
30+ popular currencies
No API key required for iframe widgets on the front end
Rates update on the service side (no heavy site load)

Shortcodes

Rate:

[kurs_rublya_cbr currency="USD"]

Optional attribution host (.ru only): site="example.ru"

Calculator:

[kurs_rublya_converter from="USD" to="RUB" amount="100"]

Board:

[kurs_rublya_board codes="USD,EUR,CNY,GBP,JPY"]

Board height: omit or height="0" for auto; any positive value is used as-is (px).

Unified alias:

[kurs_rublya type="rate" currency="EUR"]
[kurs_rublya type="converter" from="USD" to="CNY" amount="50"]
[kurs_rublya type="board" codes="USD,EUR,CNY"]

External service

Front-end widgets embed HTML from kurs-rublya.ru.

Terms: https://kurs-rublya.ru/api-terms/
Privacy: https://kurs-rublya.ru/privacy-policy/
Widget builder: https://kurs-rublya.ru/widget/

Blocks

This plugin provides 3 blocks.

Kurs Rublya rate FX rate card from kurs-rublya.ru (Central Bank of Russia publications), with daily change.
Kurs Rublya rates board Multi-currency FX board from kurs-rublya.ru with daily change.
Kurs Rublya calculator Currency calculator powered by kurs-rublya.ru (Central Bank of Russia publications).

Installation

Upload the ZIP or copy the folder to /wp-content/plugins/kurs-rublya-fx-rates-calculator/.
Activate the plugin.
Go to Settings Kurs Rublya FX and choose a theme if needed.
Add a block, shortcode, or widget to a page.

FAQ

Is this an official Central Bank plugin?: No. Kurs Rublya is an independent service. Widgets use rates published by the Central Bank of Russia via kurs-rublya.ru.
Where do exchange rates come from?: From kurs-rublya.ru, based on publicly available Central Bank of Russia data.
Do I need an API key?: No for the front-end iframe widgets.
How do I change the theme?: Settings Kurs Rublya FX dark or light.
Can I remove the kurs-rublya.ru link?: Attribution is rendered by the embed service. See https://kurs-rublya.ru/api-terms/

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Kurs Rublya FX Rates Calculator” is open source software. The following people have contributed to this plugin.

kursrublya

Translate “Kurs Rublya FX Rates Calculator” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.4.7

Translated Plugin Description for Russian, Spanish, Hindi, and Simplified Chinese (Plugins screen).

1.4.6

Settings preview: sample rate + brand wordmark (курс/рубля) instead of placeholder ellipsis.
Admin layout polish for theme cards and shortcode columns.

1.4.5

Expanded converter currency allowlist on kurs-rublya.ru to match the plugin.
Board height: only 0 means auto (no longer forces auto for heights under 160px).
Partner site (.ru) control in block inspectors; live theme preview on settings; Copy clipboard fallback.
Editor asset cache-bust versions tied to the plugin version.

1.4.4

Travel-agencies pitch translated for Spanish, Hindi, and Simplified Chinese (hidden on Russian admin locales).

1.4.3

Bundled Spanish (es_ES), Hindi (hi_IN), and Simplified Chinese (zh_CN) translations.

1.4.2

Packaging / WordPress.org trunk restore.
English readme: travel agencies organizing trips to Russia.

1.4.1

Bundled Russian (ru_RU) translation for admin, blocks, and widgets.
Source strings normalized to English with Domain Path /languages.

1.4.0

Renamed to Kurs Rublya FX Rates Calculator (no leading CBR trademark).
Requested slug: kurs-rublya-fx-rates-calculator.
Removed auto-loading external iframe from the wp-admin settings screen.
Contributors: egorwp, kursrublya.
Clarified independent (non-official) relationship to the Central Bank of Russia.

1.3.1

Plugin Check: block apiVersion 3, English readme, Latin plugin name, safer widget escaping.
Tested up to WordPress 7.0.

1.3.0

Multi-currency board with daily change.
Expanded currency list (30+).
Settings screen improvements.

1.2.0

Converter uses full block width.
Widget theme setting.

1.1.0

Converter block, shortcode, classic widget.
Unified [kurs_rublya] shortcode alias.

1.0.0

Initial release.