LeDoviz – Turkish Exchange Rates

LeDoviz – Turkish Exchange Rates is a lightweight, modern, and fully secure WordPress plugin that displays Turkish exchange rates. It works with Gutenberg blocks, Elementor widgets, classic shortcodes, and header/footer widgets. All data sources are free public APIs – no API keys required.

• Responsive mobile‑first design with Persian red accents and premium silver/white theme.
• Accessible UI – ARIA live regions, keyboard navigation, and reduced‑motion support.
• SEO‑friendly – schema.org FinancialProduct markup.
• KVKK‑compliant privacy page and disclaimer.
• Multisite compatible, translation ready (EN & TR), and fully PHPCS/WordPress‑Coding‑Standards compliant.

External Services

This plugin connects to external APIs to retrieve daily exchange rates and stock index values:
1. Central Bank of the Republic of Turkey (TCMB) API (https://www.tcmb.gov.tr/kurlar/today.xml) is used to obtain daily currency exchange rates against the Turkish Lira. No personal visitor data is sent or stored. Data is fetched anonymously and cached locally on your server for 1 hour.
– TCMB Terms of Use: https://www.tcmb.gov.tr/wps/wcm/connect/tr/tcmb+tr/main+menu/yasal+uyari
– TCMB Privacy Policy: https://www.tcmb.gov.tr/wps/wcm/connect/tr/tcmb+tr/main+menu/yasal+uyari
2. Bigpara (Hürriyet) API (https://bigpara.hurriyet.com.tr) is used to fetch the current BIST 100 stock index data. No personal visitor data is sent or stored. Data is cached locally on your server for 1 hour.
– Hürriyet Terms & Privacy: https://www.hurriyet.com.tr/veriler/politikamiz/

Shortcodes

Use the following shortcodes to display exchange rates and ticker feeds anywhere on your site:
* [ledoviz_turkish_exchange_rates_exchange_rates currencies="usd,eur,gbp" layout="list"] – Displays a list or grid of currency exchange rates.
* currencies: Comma-separated ISO codes (default: usd,eur,gbp).
* layout: list, grid (default: list).
* theme: auto, light, dark (default: auto).
* [ledoviz_turkish_exchange_rates_ticker currencies="usd,eur,gbp" speed="5000"] – Displays a scrolling marquee header/footer ticker.
* currencies: Comma-separated ISO codes (default: usd,eur,gbp).
* speed: Animation duration per item in ms (default: 5000).
* [ledoviz_turkish_exchange_rates_privacy] – Outputs standard disclosure/privacy text stating that the rates are provided for informational purposes only.

Gutenberg Blocks & Elementor Widgets

The plugin includes native, high-performance editor integrations:
* Exchange Rates: Drag and drop block/widget to display selected rates as a list or grid.
* Live Ticker: Sliding marquee block/widget showing live exchange rates.

Custom Styling

Colors can be customized in your theme stylesheet using CSS custom properties:

:root {
  --ledoviz-turkish-exchange-rates-primary: #C41E3A; /* Persian Red accent color */
  --ledoviz-turkish-exchange-rates-bg: #f8f9fa;      /* Silver/white container background */
  --ledoviz-turkish-exchange-rates-text: #212529;    /* Text color */
}

Developer Filters

• ledoviz_turkish_exchange_rates_tcmb_url – Filter the TCMB XML feed URL.
• ledoviz_turkish_exchange_rates_enqueue_assets – Control when assets are enqueued on the frontend.

Performance & Caching

• Cache Engine: Utilizes the WordPress Transients API.
• Cache TTL: Cached for 1 hour (3600 seconds) to prevent redundant external API hits.
• Asset Optimization: CSS and JS files are enqueued conditionally (only when blocks, widgets, or shortcodes are present on the rendered page).

Accessibility (a11y)

• ARIA Live Regions: Tickers use aria-live="polite" so screen readers process updates gracefully.
• Motion Control: Disables animations if prefers-reduced-motion: reduce is enabled at the OS/browser level.
• Keyboard Navigation: Native tab indices and focus states are respected in all layouts.