EZRate Price Widgets
| 开发者 | aslanaria2000 |
|---|---|
| 更新时间 | 2026年11月1日 04:48 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
EZRate Price Widgets shows Iran's free-market exchange rates on your WordPress site: the US dollar, euro, UAE dirham, Turkish lira and 20+ other currencies, 18K and 24K gold, Emami and Bahar Azadi coins, the global gold ounce, USDT, Bitcoin and other crypto — in Toman or in US dollars, euros, Turkish lira, UAE dirhams or Russian rubles, in Persian, English, Arabic, Russian or Turkish.
Everything is set up from your own dashboard. No account, no API key, no code.
Five widget types
- Moving ticker — prices scroll like a news ticker (pauses on hover, respects "reduce motion").
- Price bar — one row of prices.
- Price cards — tidy cards for a sidebar or home page, 1–6 columns.
- Price table — name, buy, sell and 24-hour change.
- Chart — one asset with day / week / month / all ranges, low and high.
- Pick the prices and their order (up to 20), the language (Persian, English, Arabic, Russian or Turkish; Persian and Arabic right-to-left) and a light or dark theme.
- Show the prices in Toman or in another currency your visitors know: US dollar, euro, Turkish lira, UAE dirham or Russian ruble (crypto and the gold ounce stay in dollars).
- Your own colours: background, text, secondary text, border, accent, price up / down and the chart line.
- Corner radius, text size, your theme's font or the system font.
- Show or hide the buy price, the 24-hour change, flags and icons, the update time.
- Live preview while you edit.
- One-click placing, no code: show it at the top or bottom of every page, above or below the text of your posts or pages, add it to your sidebar, or create a ready "Live prices" page — each with one button (on all pages, the home page, posts only or pages only; optionally hidden on phones).
- Or place it yourself with its shortcode, the "EZRate price widget" block or the classic widget.
- Your theme files are never changed.
- Quick shortcode without saving a widget:
[ezrate_widget type="cards" assets="usd,eur,g18,emami" lang="fa" cur="irt" theme="dark"](lang: fa, en, ar, ru, tr ·cur: irt, usd, eur, try, aed, rub)
- Widgets are rendered on your server from a cached copy of the prices: no external scripts, no iframes, nothing slows your pages down.
- The prices are refreshed in the background every 30 minutes (the free EZRate data plan). Your visitors never wait for the data service, and if it cannot be reached the last prices stay on the page.
- About 6 KB of CSS and 1 KB of JavaScript, loaded only on pages that show a widget.
安装:
- Install the plugin from Plugins › Add New (search for "EZRate") or upload the zip, then activate it.
- Go to EZRate › Widgets. A first ticker is already there; click it to choose prices, language and colours, or click Add widget.
- Right after activation a notice on your dashboard offers one-click buttons: Show at the top of my whole site, Add to my sidebar (classic themes: opens Appearance › Widgets, where you add "EZRate price widget") or Create a prices page with it. The same buttons are on every widget's page.
- Or choose Where should it appear? in the widget (top / bottom of the site, above / below posts and pages), or use its shortcode, e.g.
[ezrate_widget id="1"], or the EZRate price widget block.
屏幕截图:
常见问题:
Is it free?
Yes. The plugin and the data it uses are free.
How often are the prices updated?
Every 30 minutes, the update interval of the free EZRate data plan. For live, minute-by-minute prices use the widgets of your EZRate account at https://ezrate.me/services/widgets/en.
Where do the prices come from?
From EZRate: the median of real trades on Iran's free market for currencies, gold and coins; crypto from major global exchanges.
Will it slow down my site?
No. Prices are stored in your database and the widgets are plain HTML and CSS rendered by your server. Pages never wait for the data service.
Does it work with page caching plugins?
Yes. Cached pages show the prices of the moment they were cached; most caching plugins refresh pages regularly.
Can I show the prices in English?
Yes, every widget has its own language: Persian (right-to-left, Persian digits) or English.
How do I change the colours?
Edit the widget under EZRate › Widgets and set the colours in the "Style" box. Leave a colour empty to use the light or dark theme colour.
The prices are not shown
Open EZRate › Settings: it shows when the prices were last downloaded and any error. Your server must be able to reach https://api.ezrate.me over HTTPS. Click "Refresh prices now" to try again.
更新日志:
2.2.0
- New: widgets in Arabic, Russian and Turkish (besides Persian and English), with their own number and date formats; Arabic right-to-left.
- New: currency of the prices per widget — Toman, US dollar, euro, Turkish lira, UAE dirham or Russian ruble; charts and low / high follow it.
- New: default language and currency for new widgets in EZRate › Settings;
curattribute in the shortcode.
- Translations are delivered by translate.wordpress.org; corrected service links.
- New: one-click placing — show a widget at the top of the site or above all posts, add it to the sidebar, or create a prices page, without code.
- New: "above / below the text of posts and pages" placement for every widget type, on all pages, posts only, pages only or the home page.
- New: a short welcome notice after activation with the one-click buttons (dismissible).
- The block uses Block API version 3 (works in the iframed editor of WordPress 7).
- The widget styles load inside the editor iframe as well as on the site.
- Tested up to WordPress 7.1.
- New: everything is configured in WordPress — five widget types, prices and order, language, theme and custom colours, live preview.
- New: price table widget; fixed top / bottom bars; block, shortcode and classic widget.
- New: server-side rendering from cached prices (no external scripts), background refresh every 30 minutes.
- New: Persian translation and a bilingual guide.
- Gutenberg block with live preview.