Description
Currency Rate Widget fetches up-to-date currency exchange rates and the official policy interest rate directly from the Central Bank of the Republic of Turkey (TCMB) XML service. No API key is required; it is completely free and open-source.
Thanks to its advanced admin settings panel, you can customize every detail, from font sizes and hover effects to status colors and price display preferences, making it match your website’s exact design.
Features:
* 3 different view layouts: Horizontal Bar, Auto-scrolling Ticker, and Modern Card Grid
* Supported assets: USD, EUR, GBP, CHF, JPY, SAR, XAU (Gold Gram), and INTEREST (CBRT Policy Interest Rate)
* Toggle buying and/or selling prices on the front-end
* Advanced Font Settings: Customize font family, size, weight, and font color
* Custom Trend Colors: Choose separate colors for uptrend, downtrend, and stable rates
* Hover background color effect control for layout items
* Optional CBRT source notice and last successful update timestamp on the front-end
* Smart caching system (via WordPress transients) to prevent server overload
* Shortcode support for easy placement in any page, post, or widget area
* Fully responsive and mobile-friendly layouts
Shortcode Usage
To display the currency widget on any page, post, or widget area, simply use the following shortcode:
[oirmcuan_doviz_kuru]
All styling, layout selections (Bar, Ticker, or Card), and visible currencies are managed directly through the plugin’s advanced admin settings panel.
Installation
- Upload the
doviz-kuru-widgetfolder to the/wp-content/plugins/directory. - Activate the plugin through the
Plugins>Installed Pluginsmenu in WordPress. - Navigate to
Settings>Döviz Kuru Widgetto configure your layouts, fonts, and assets. - Add the shortcode to any page, post, or widget area to display the rates.
FAQ
-
How often are the exchange rates updated?
-
TCMB publishes new rates on business days around 15:30 (GMT+3). The plugin utilizes a smart transient caching structure to prevent overhead, checking and updating data from TCMB automatically at regular intervals.
-
Does it support the Central Bank interest rate?
-
Yes! By adding INTEREST to your asset list or shortcode parameter, you can display the official CBRT policy interest rate as a percentage (%) on your website.
-
Does it show Gold prices?
-
Yes, you can easily display and track the Gold Gram price by adding XAU to your currency list.
-
Does it work on weekends?
-
TCMB does not publish new rates on weekends. In this case, the plugin securely displays the last available data (Friday’s rates) without throwing any errors.
-
Does it adapt to my theme’s typography?
-
Yes. If you set the font family to
inheritin the settings page, it will automatically adopt your theme’s default fonts. Alternatively, you can explicitly choose popular fonts, custom sizes, and weights from the dashboard.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Döviz Kuru Widget” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Döviz Kuru Widget” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
2.0.3
- Core codebase and all functionalities upgraded to v2.0.3 standard.
- Integrated Horizontal Bar, Auto-scrolling Ticker, and Card Grid modes.
- Added official Central Bank Interest Rate (INTEREST) and Gold Gram (XAU) tracking support.
- Implemented advanced font typography, hover style toggles, and trend color customization in the admin panel.