=== Kurs Rublya FX Rates Calculator ===
Contributors: egorwp
Tags: kurs rublya, курс рубля, exchange rates, currency converter, calculator
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.4.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Kurs Rublya FX widgets for WordPress: rate cards, currency calculator, and multi-currency board. Data via kurs-rublya.ru.

== 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](https://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/](https://kurs-rublya.ru/api-terms/)
* Privacy: [https://kurs-rublya.ru/privacy-policy/](https://kurs-rublya.ru/privacy-policy/)
* Widget builder: [https://kurs-rublya.ru/widget/](https://kurs-rublya.ru/widget/)

== Installation ==

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

== Frequently Asked Questions ==

= 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/

== 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.

== Upgrade Notice ==

= 1.4.7 =
Localized plugin description on the Plugins screen (ru/es/hi/zh).

= 1.4.6 =
Clearer settings preview with brand wordmark.

= 1.4.5 =
Converter currency sync, board height fix, partner site UI, clipboard/theme UX.

= 1.4.4 =
Travel-agencies copy for Spanish, Hindi, and Simplified Chinese.

= 1.4.3 =
Spanish, Hindi, and Simplified Chinese translations.

= 1.4.2 =
Packaging fix for the WordPress.org plugin directory.

= 1.4.1 =
Russian translation for wp-admin and block editor on ru_RU sites.

= 1.4.0 =
Trademark-safe name, no admin iframe preview, Contributors updated for WordPress.org review.
