=== FX Currency Converter ===
Contributors: falselight
Tags: currency converter, currency conversion, currency exchange, exchange rates, currencies
Donate link: https://currencyconvert.online/
Requires at least: 3.1
Requires PHP: 5.3
Tested up to: 7.0
Stable tag: 0.2.3
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Easy-to-use, free currency converter. 🔑 No API key needed. ❤️ Install and enjoy.

== 📌 About ==
Unlock real-time currency conversion on your WordPress site. Enjoy hassle-free updates every hour, drawing from 80 reliable sources. No API KEY required and absolutely free. Just install and elevate your site's functionality now!

[DEMO👀](https://yuri.ws/uncategorized/fx-currency-converter/)

= ⭐️ FEATURES ⭐️ =

* 🚀 Lightweight code;
* 🌐 Exchange rates from 86 world central banks;
* 🎨 Flexible styling options;
* 💯 Free, No Ads;
* 🔑 No API key needed;
* 🔒 SSL support;
* 📱 Mobile-friendly;
* 🔋 UpTime 99.99%;
* 🔍 SEO-friendly.

== 🗜 Shortcode 🗜 ==

The shortcode of `[fxcc_convert]` has the following parameters that you may specify...

* **num** - The amount you wish to convert from one currency to another.
* **from** - The currency [ISO code](https://currencyrate.today/different-currencies) you wish to convert from. The default is USD.
* **to** - The currency [ISO code](https://currencyrate.today/different-currencies) you wish to convert to. The default is EUR.
* **dec** - Specifies the number of decimal places in the output. This should be numeric or the word "match". The default is "match", which means that the output will match the number of decimal places that the **num** had.
* **prefix** - emoji | symbol;
* **suffix** - emoji | symbol;
* **template** - See the later section, "Using Templates", for more information.

== 💡 Examples 💡 ==

`
[fxcc_convert num="100" from="USD" to="EUR" /] - 92
[fxcc_convert num="49.123" dec="2" from="USD" to="EUR" /] - 45,22
[fxcc_convert num="49.123" dec="2" from="USD" to="EUR" prefix="symbol" suffix="emoji" /] - €45,22🇪🇺
[fxcc_convert num="49.99" from="USD" to="EUR" prefix="symbol" tmpl="49.99 USD is %result% EUR" /] - 49.99 USD is €46,02 EUR
[fxcc_convert num="49.99" from="USD" to="EUR" tmpl="49.99 USD is %result% EUR" src="eu-ecb" /] - 49.99 USD is 45,83 EUR
[fxcc_convert num="100" from="USD" dec="4" to="EUR"]100 USD is %result% EUR[/fxcc_convert] - 100 USD is 92,0641 EUR
`


== 💱 API and Data sources 💱 ==

We are collect data from multiple data sources and store them on our server, [https://api-bank.fex.to/](https://api-bank.fex.to/). Before you start using the plugin, please read the disclaimer. This plugin retrieve data one request per hour. 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

== ⚠️ Disclaimer ⚠️ ==

**Disclaimer for the https://api-bank.fex.to/ API** 🚫

1. **Use at Your Own Risk** ⚠️: The use of this API is at your own discretion and risk. We do not accept any responsibility for any losses, damages, or issues arising from the use of this API.
2. **Data Accuracy** 📊: We make every effort to ensure the accuracy and timeliness of the data provided through our API. However, we do not guarantee the completeness, accuracy, or timeliness of this data and do not accept responsibility for any errors or omissions.
3. **Changes and Termination of Service** 🔄: We reserve the right to make changes to or terminate the operation of this API at any time, without prior notice. We are not liable for any consequences resulting from such changes or termination.
4. **Third-Party Services** 🌐: This API may interact with third-party services or APIs. We do not endorse or take responsibility for the functionality, accuracy, or availability of these third-party services.
5. **No Warranty** 🛡️: We provide this API on an "as is" and "as available" basis, without any warranties, express or implied. We disclaim all warranties, including but not limited to the implied warranties of merchantability, fitness for a particular purpose, and non-infringement.
By using this API, you agree to accept and abide by the terms of this disclaimer. If you do not agree with any part of this disclaimer, you must not use this API.

== Installation ==
= From your WordPress dashboard =

1. Visit "Plugins > Add New"
2. Search for "FX Currency Converter"
3. Activate "FX Currency Converter" from your Plugins page.
4. Add widgets on yourdomain.com/wp-admin/widgets.php page.

= From WordPress.org =

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

== Frequently Asked Questions ==
= How to display currency conversion in a theme or PHP code? =
To incorporate the shortcode into PHP code, use the following syntax: `<?php echo do_shortcode('[fxcc_convert num="100" from="USD" to="EUR"]'); ?>`

== Upgrade Notice ==

= 0.2.3 =

* Fixes bundled translation loading and refreshes the translation template.

= 0.1.0 =

* First release

== Changelog ==
= 0.2.3 =

* Fixed bundled translation loading by using the correct plugin-relative languages path.
* Refreshed the translation template for the current release.

= 0.2.2 =

* Verified compatibility with WordPress 7.0.

= 0.2.1 =

* Security fix: Sanitized and escaped all user-supplied shortcode attributes to prevent Stored XSS vulnerability (CVE-2025-13963)
* Security fix: Added proper output escaping in settings page

= 0.2.0 =

* Minor bug fixed
* Add multi language support

= 0.1.0 =

* First release

== Screenshots ==

1. screenshot-1.png - Admin page.

== 🍩 Donations ==

ℹ️ Website: [CurrencyConvert](https://currencyconvert.online/)

🌐 Sources: [CurrencyRate](https://currencyrate.today/)
