=== Exchange Rates ===
Contributors: falselight
Tags: currency converter, currency conversion, currency exchange, exchange rates, currencies
Donate link: https://currencyrate.today/
Requires at least: 5.6
Requires PHP: 5.6
Tested up to: 7.0
Stable tag: 1.3.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Currency Converter & Exchange Rates Widgets, easy-to-use, with beautiful UI. 🔑 No API key needed, ❤️‍ plug and play.

== Description ==

Simple and powerful real-time Currency Converter and Exchange Rates widgets.  
Perfect for blogs, e-commerce shops, travel websites, and financial portals.  
Includes exchange rate data from 86 central banks and sources worldwide.

[DEMO👀](https://yuri.ws/exchange-rates/)

[Video Demo ▶️](https://www.youtube.com/watch?v=FTxvE9oeDyU)

📩 Feel free, write if you will have any questions: [online support](https://wordpress.org/support/plugin/exchange-rates/)
⭐️ Please, don't forget to [RATE the plugin](https://wordpress.org/support/plugin/exchange-rates/reviews/#new-post). 🙏 This will influence future development.

= 🪄 FEATURES 🪄 =

☑️ 200+ [Currencies](https://currencyrate.today/different-currencies) and Popular [CryptoCurrencies](https://currencyrate.today/other);
☑️ Currency exchange rate data from 86 central banks of the world;
☑️ Including: black markets, dollar blue etc., [sources](https://api-bank.fex.to/);
☑️ 🔑 No API key needed;
☑️ Updates automatically (per hour by WordPress Cron);
☑️ Flexible design and settings, easy to adapt to your style;
☑️ Types of currency icons: rectangular, square, circular;
☑️ Real-time conversion;
☑️ Easy-to-use;
☑️ Free forever;
☑️ Our plugin will complement your site and keep your users engaged.


== Widgets ==

- Currency Converter is easy to use, simple real-time converter;
✔ Universal widget, it can be used on travel and property website/blog, as well as online stores.
- Currency Table is a table with exchange rates and another features.
✔ The currency rates table is mainly used by news websites, portals and financial forums.

== Shortcode ==

- Badge is a simple exchange rates list.
✔ An excellent shortcode that can be used in international online stores. With ease you can add a list of prices in different currencies to the product page.


== Installation ==

= From your WordPress dashboard =
1. Visit "Plugins > Add New"
2. Search for "Exchange Rates"
3. Activate "Exchange Rates" from your Plugins page.
4. Add widgets on yourdomain.com/wp-admin/widgets.php page.

= From WordPress.org =
1. Download "Exchange Rates".
2. Upload the "Exchange Rates" directory to your "/wp-content/plugins/" directory, using your favorite method (ftp, sftp, scp, etc...).
3. Activate "Exchange Rates" from your Plugins page.
4. Add widgets on yourdomain.com/wp-admin/widgets.php page.

== Frequently Asked Questions ==

= ⏲️ How often is the data updated? =

Each hour.

= 💱 Data sources 💱 =

The main data hub is the website [CurrencyRate](https://currencyrate.today/).

We are collect data from multiple data sources and store them on our server, [https://api-bank.fex.to/](https://api-bank.fex.to/). This plugin retrieve data  one request per hour by WordPress Cron. Our public API don't require any keys or passwords. Data providers, such as:

1. 🇦🇪 AE Central Bank of the UAE
2. 🇦🇱 AL Bank of Albania
3. 🇦🇷 AR Central Bank of Argentina (retail)
4. 🇦🇷 AR Central Bank of Argentina (uva)
5. 🇦🇷 AR Central Bank of Argentina (wholesale)
6. 🇦🇷 AR Cronista Dollar Blue
7. 🇦🇺 AU Reserve Bank of Australia
8. 🇦🇿 AZ Central Bank of the Republic of Azerbaijan
9. 🇧🇦 BA The Central Bank of Bosnia and Herzegovina
10. 🇧🇩 BD Bangladesh Bank
11. 🇧🇬 BG Bulgarian National Bank
12. 🇧🇭 BH Central Bank of Bahrain
13. 🇧🇷 BR Banco Central do Brasil (USD)
14. 🇧🇹 BT Royal Monetary Authority of Bhutan
15. 🇧🇾 BY National Bank of the Republic of Belarus (Belta)
16. 🇨🇦 CA Bank of Canada
17. 🇨🇭 CH Swiss National Bank
18. 🇨🇱 CL Central Bank of Chile
19. 🇨🇺 CU Central Bank of Cuba
20. 🇨🇿 CZ Czech National Bank
21. 🇩🇰 DK Danmarks Nationalbank
22. 🇩🇿 DZ Crédit Populaire d’Algérie
23. 🇩🇿 DZ Devise Square (Black Market)
24. 🇪🇬 EG Central Bank of Egypt
25. 🇪🇹 ET National Bank of Ethiopia
26. 🇪🇺 EU European Central Bank
27. 🇬🇧 GB Bank of England
28. 🇬🇪 GE The National Bank of Georgia
29. 🇭🇺 HU Hungarian National Bank
30. 🇮🇱 IL Bank of Israel
31. 🇮🇳 IN Financial Benchmarks India
32. 🇮🇸 IS Central Bank of Iceland
33. 🇰🇭 KH Bank of Cambodia
34. 🇰🇷 KR Seoul Money Brokerage Services
35. 🇰🇿 KZ National Bank of Kazakhstan
36. 🇱🇧 LB Bank of Lebanon
37. 🇱🇧 LB Lebanese Lira Black Market
38. 🇱🇧 LB Lebanese Lira Sayrafa Rate
39. 🇲🇦 MA BANK AL-MAGHRIB
40. 🇲🇩 MD National Bank of Moldova
41. 🇲🇲 MM Central Bank of Myanmar
42. 🇲🇽 MX Bank of Mexico
43. 🇲🇽 MX Bank of Mexico (FIX)
44. 🇳🇬 NG Central Bank of Nigeria
45. 🇳🇬 NG Naira Black Market Exchange Rates Today
46. 🇳🇵 NP Nepal Rastra bank
47. 🇵🇪 PE Cambi
48. 🇵🇪 PE Cambia FX
49. 🇵🇪 PE Cambix
50. 🇵🇪 PE Dollar House
51. 🇵🇪 PE Hir Power
52. 🇵🇪 PE Instakash FX
53. 🇵🇪 PE oKane Cambio Online
54. 🇵🇪 PE Roblex
55. 🇵🇪 PE Srcambio
56. 🇵🇪 PE TKambio
57. 🇵🇪 PE Yanki
58. 🇵🇭 PH Central Bank of the Philippines
59. 🇵🇱 PL Polish National Bank
60. 🇷🇴 RO Banca Transilvania
61. 🇷🇴 RO National Bank of Romania
62. 🇷🇸 RS National Bank of Serbia
63. 🇷🇺 RU The Central Bank of the Russian Federation
64. 🇸🇪 SE Riksbank
65. 🇸🇬 SG Monetary Authority of Singapore
66. 🇸🇸 SS Bank of South Sudan
67. 🇹🇭 TH Bank of Thailand
68. 🇹🇯 TJ National Bank of Tajikistan
69. 🇹🇲 TM Central Bank of Turkmenistan
70. 🇹🇳 TN Central Bank of Tunisia
71. 🇹🇷 TR Central Bank of the Republic of Turkey
72. 🇹🇼 TW Central Bank of the Republic of China
73. 🇺🇦 UA Minfin Blackmarket USD
74. 🇺🇦 UA Monobank
75. 🇺🇦 UA National Bank of Ukraine
76. 🇺🇦 UA PrivatBank
77. 🇺🇿 UZ The Central Bank of the Republic of Uzbekistan
78. 🇻🇪 VE Central bank of Venezuela
79. 🇻🇳 VN Vietcombank
80. 🇿🇦 ZA South African Reserve Bank
81. 🏴 OECS Eastern Caribbean Central Bank
82. 🏴 XX CurrencyRate.Today
83. 🏴 XX Transnistrian Republican Bank
84. 🏴 XX West African Monetary Agency
85. 🇪🇬 EG Egypt Pound Black Market Rate
86. 🎮 Second Life Game Currency: Linden Dollar

= 💲 Supported Currencies 💲 =

- Afghan Afghani
- Albanian Lek
- Algerian Dinar
- Angolan Kwanza
- Argentine Peso
- Armenian Dram
- Aruban Florin
- Australian Dollar
- Azerbaijanian Manat
- Bahamian Dollar
- Bahraini Dinar
- Bangladeshi Taka
- Barbados Dollar
- Belarusian ruble
- Belize Dollar
- Bermudian Dollar
- Bhutanese Ngultrum
- Bitcoin
- Boliviano
- Botswana Pula
- Brazilian Real
- British Pound
- Brunei Dollar
- Bulgarian Lev
- Burundi Franc
- CFA Franc BCEAO
- CFA Franc BEAC
- CFP Franc
- Cabo Verde Escudo
- Cambodian Riel
- Canadian Dollar
- Cayman Islands Dollar
- Chilean Peso
- Chilean Unit of Account
- Chinese Yuan (offshore)
- Colombian Peso
- Comoro Franc
- Congolese Franc
- Convertible Mark & Herzegovina
- Convertible peso
- Cordoba Oro
- Costa Rican Colon
- Croatian Kuna
- Cuban Peso
- Czech Koruna
- Danish Krone
- Djibouti Franc
- Dominican Peso
- East Caribbean Dollar
- Egyptian Pound
- El Salvador Colon
- Eritrean Nakfa
- Ethereum
- Ethiopian Birr
- Euro  
- Falkland Islands Pound
- Fiji Dollar
- Gambian Dalasi
- Georgian Lari
- Ghana Cedi
- Gibraltar Pound
- Gold (ounce)
- Guatemalan Quetzal
- Guernsey Pound
- Guilder
- Guinea Franc
- Guyana Dollar
- Haitian Gourde
- Honduran Lempira
- Hong Kong Dollar
- Hungarian Forint
- Iceland Krona
- Indian Rupee
- Indonesian Rupiah
- Iranian Rial
- Iraqi Dinar
- Israeli Shekel
- Jamaican Dollar
- Japanese Yen
- Jersey Pound
- Jordanian Dinar
- Kazakhstani Tenge
- Kenyan Shilling
- Kuwaiti Dinar
- Kyrgyzstani Som
- Lao Kip
- Lebanese Pound
- Lesotho Loti
- Liberian Dollar
- Libyan Dinar
- Macanese Pataca
- Macedonian Denar
- Malagasy Ariary
- Malawian Kwacha
- Malaysian Ringgit
- Maldivian Rufiyaa
- Manx pound
- Mauritanian Ouguiya
- Mauritius Rupee
- Mexican Peso
- Moldovan Leu
- Mongolian Tugrik
- Moroccan Dirham
- Mozambique Metical
- Myanmar Kyat
- Namibia Dollar
- Nepalese Rupee
- New Taiwan Dollar
- New Zealand Dollar
- Nigerian Naira
- North Korean Won
- Norwegian Krone
- Pakistani Rupee
- Palladium (ounce)
- Panamanian Balboa
- Papua New Guinean Kina
- Paraguayan Guarani
- Peruvian Sol
- Peso Uruguayo
- Philippine Peso
- Platinum (ounce)
- Polish Zloty
- Qatari Rial
- Renminbi
- Rial Omani
- Romanian Leu
- Russian Ruble
- Rwanda Franc
- Saint Helena Pound
- Samoan Tala
- Sao Tomean Dobra
- Saudi Riyal
- Serbian Dinar
- Seychelles Rupee
- Sierra Leonean Leone
- Silver (ounce)
- Singapore Dollar
- Solomon Islands Dollar
- Somali Shilling
- South African Rand
- South Korean Won
- South Sudanese Pound
- Special Drawing Rights
- Sri Lanka Rupee
- Sudanese Pound
- Surinam Dollar
- Swazi Lilangeni
- Swedish Krona
- Swiss Franc
- Syrian Pound
- Tajikistani Somoni
- Tanzanian Shilling
- Thai Baht
- Tongan Pa?anga
- Transnistrian ruble
- Trinidad and Tobago Dollar
- Tunisian Dinar
- Turkish Lira
- Turkmenistan New Manat
- UAE Dirham
- US Dollar
- Uganda Shilling
- Ukrainian Hryvnia
- Uzbekistan Sum
- VEF BLKMKT
- VEF DICOM
- VEF DIPRO
- Vanuatu Vatu
- Venezuelan Bolivar
- Vietnamese Dong
- W-African Unit of Account
- Yemeni Rial
- Zambian Kwacha
- ARS blue dollar
- Linden Dollar
- Caribbean Guilder
- Zimbabwean Dollar
- Zimbabwean ZiG

== Screenshots ==

1. screenshot-1.png - Currency Table Widget (Exchange Rates) with circular icons
2. screenshot-2.png - Currency Converter Widget
3. screenshot-3.png - Currency Table Widget (Exchange Rates) with circular icons, country
4. screenshot-4.png - Currency Table Widget (Exchange Rates) with emoji icons, country
5. screenshot-5.png - Currency Table Shortcode (Exchange Rates) with circular icons, country, code, prev price and changes
6. screenshot-6.png - Badge Shortcode (Exchange Rates) with emoji icons
7. screenshot-7.png - Badge Shortcode (Exchange Rates) with circular icons
8. screenshot-8.png - Currency Table Widget (Exchange Rates) with active amount input
9. screenshot-9.png - Currency Table Widget (Exchange Rates) with active amount input, circular icons, code, prev price and changes
10. screenshot-10.png - Currency Table Widget (Exchange Rates) with active amount input, rectangular icons, code, prev price and changes
11. screenshot-11.png - Admin panel / Appearance / Widgets preview
12. screenshot-12.png - Plugin settings page

== Changelog ==

= 1.3.1 =
* Fixed handling of sources that provide current rates without previous-day close data.
* Hardened API response validation before saving exchange-rate data.
* Improved shortcode, widget, admin, and settings sanitization.
* Standardized boolean shortcode flags so only explicit false disables an attribute.
* Improved compatibility metadata for WordPress 7.0 and PHP 5.6+.

= 1.3.0 =
* Added: Caribbean Guilder (XCG) and Zimbabwean ZiG (ZWG).
* Security: fixed vulnerability.
* Minor bug fixes and improvements.

= 1.2.5 =
* Minor bug fixes.

= 1.2.4 =
* Improved compatibility with PHP 8.

= 1.2.3 =
* Security: fixed vulnerability.

= 1.2.2 =
* Minor bug fixes.

= 1.2.1 =
* Added RTL (Right-to-Left) style support.
* Minor bug fixes.
* Tested up to WordPress 6.5.

= 1.2.0 =
* Security: fixed XSS vulnerability.
* Performance optimizations.
* Accessibility improvements.
* Minor bug fixes.
* Tested up to WordPress 6.5.

= 1.1.6 =
* Minor bug fixes.

= 1.1.5 =
* Tested up to WordPress 6.4.
* Added source: 🇪🇬 Egypt Pound Black Market Rate.
* Added source: 🎮 Second Life game currency (Linden Dollar).
* Minor bug fixes.

= 1.1.4 =
* Minor bug fixes.

= 1.1.3 =
* Fixed shortcode generator.

= 1.1.2 =
* Fixed classic widget generator.

= 1.1.1 =
* Improved style compatibility.

= 1.1.0 =
* Added new sources including black markets, blue dollar, etc.
* Added Devises du Square Port-Saïd à Alger.
* Added Dólar Blue.
* Added Black Market Hryvnia.
* Added Black Market Naira.
* Added Sayrafa Rate LBP.
* Simplified translations by removing bank names.
* Minor bug fixes.

= 1.0.4 =
* Improved compatibility with other plugins (thanks @denver28).
* Improved PHP 8 compatibility.
* Minor bug fixes.

= 1.0.3 =
* Minor bug fixes.

= 1.0.2 =
* Added new sources.
* Minor bug fixes.

= 1.0.1 =
* Fixed decimal comma format for “amount form”.
* Fixed CSS caption color.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.3.1 =
Compatibility and security hardening release for WordPress 7.0. Recommended for all users.

= 1.3.0 =
Important update: added new currencies (Caribbean Guilder, Zimbabwean ZiG) and fixed a security issue. Recommended for all users.

= 1.2.5 =
Maintenance release: minor bug fixes.

= 1.2.4 =
Compatibility update: improved support for PHP 8.

= 1.2.3 =
Security update: vulnerability fixed. Please update immediately.

= 1.2.2 =
Maintenance release: minor bug fixes.

= 1.2.1 =
Added RTL style support and tested up to WordPress 6.5. Minor fixes.

= 1.2.0 =
Major release: fixed XSS vulnerability, improved performance and accessibility, tested up to WordPress 6.5.

= 1.1.5 =
New sources added (Egypt Pound Black Market, Linden Dollar). Tested up to WordPress 6.4.

= 1.1.0 =
Added multiple new exchange rate sources (blue dollar, black markets, Sayrafa rate, etc.). Minor fixes.

= 1.0.4 =
Improved compatibility with other plugins and PHP 8.

= 1.0.0 =
First public release.


== 🍩 Donations ==

ℹ️ Sources: [CurrencyRate](https://currencyrate.today/)
💵 [CurrencyConvert.Online](https://currencyconvert.online/)

You may also like these plugins:

* [Currency Converter Calculator](https://wordpress.org/plugins/currency-converter-calculator/)
* [Crypto Converter Widget](https://wordpress.org/plugins/crypto-converter-widget/)
* [Cryptocurrency Price Widget](https://wordpress.org/plugins/cryptocurrency-price-widget/)
* [Currency Converter Widget PRO](https://wordpress.org/plugins/currency-converter-widget-pro/)
* [CurrencyRate.Today - Currency Blocks and Widgets](https://wordpress.org/plugins/currencyrate-today-currency-blocks/)
* [Exchange Rates](https://wordpress.org/plugins/exchange-rates/)
* [FX Currency Converter](https://wordpress.org/plugins/fx-currency-converter/)
