Smart currency conversion and Toman/Rial pricing for WooCommerce with configurable live rates, safe fallbacks, and multilingual support.

Amin Raoufi

Tomanify helps WooCommerce stores that buy or list products in foreign currencies (USD / EUR / AED / TRY / CNY) and need to store the final selling price in Iranian Toman or Rial.
The plugin is designed to be safe, predictable, and practical for real stores:
<ul>
<li>No external source URLs are pre-filled inside the plugin.</li>
<li>External requests happen only if an administrator explicitly enters URLs.</li>
<li>Converted prices are stored using a TOMAN baseline to avoid double-conversion when switching between Toman and Rial.</li>
<li>You are not required to buy a paid API to use the core workflow. Many stores can start with a compatible free-market JSON feed, then add official RSS/XML, manual rates, or offline estimation as fallback layers.</li>
</ul>
<h4>Start Here</h4>
See the <a href="https://tomanify.github.io/" rel="nofollow ugc">public Persian documentation</a> for an overview and full guides. 
New here? Follow the <a href="https://tomanify.github.io/docs/quick-start/" rel="nofollow ugc">Quick Start</a>. 
For setup and configuration, open the <a href="https://tomanify.github.io/docs/" rel="nofollow ugc">plugin documentation</a>. 
For rate sources and how they work, see <a href="https://tomanify.github.io/docs/sources/" rel="nofollow ugc">Source modes (API docs)</a>. 
If something doesn’t work, check <a href="https://tomanify.github.io/docs/troubleshooting/" rel="nofollow ugc">Troubleshooting</a>. 
Need help? Post your issue on the <a href="https://wordpress.org/support/plugin/tomanify/" rel="ugc">Community support</a> and we’ll respond as soon as possible.
<h4>2-minute Quick Setup Video</h4>
<iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/Tf7MEaR9xy0?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe>
<h4>What makes Tomanify different?</h4>
Many store owners do not just want a display-only exchange-rate widget. They need WooCommerce to keep a real final price for imported products so sorting, filtering, reporting, and other price-dependent features continue to work correctly.
Tomanify is built for that workflow:
<ul>
<li>It stores a final Toman baseline per foreign product.</li>
<li>It stores that baseline in product meta and uses it to rewrite WooCommerce price values.</li>
<li>It lets you switch between Toman and Rial without re-fetching rates.</li>
<li>It supports multiple rate-source strategies instead of forcing one remote service.</li>
</ul>
<h4>Key Features</h4>
<ul>
<li>Per-product foreign pricing: foreign flag + currency + foreign amount + margin (%)</li>
<li>Automatic conversion to Toman baseline and storage in WooCommerce price meta</li>
<li>Switch display unit (Toman/Rial) without re-fetching rates (rewrites from baseline)</li>
<li>Rate sources (admin configurable):
<ul>
<li>Live free-market JSON endpoint (Toman values)</li>
<li>Official RSS/XML (per currency) + premium conversion (Free/Official)</li>
<li>Manual rates (Toman)</li>
<li>Offline estimation model (reference-based)</li>
</ul>
</li>
<li>Bulk editor for all foreign products (Products tab)</li>
<li>Frontend widget shortcode: [tomanify_rates] (frontend assets load only when shortcode is used)</li>
<li>Optional cache purge integration (OFF by default)</li>
<li>Backup/Restore (export/import JSON) + uninstall cleanup option</li>
<li>Independent plugin language (fa_IR / en_US) regardless of site language</li>
<li>RTL/LTR aware admin and frontend UI</li>
<li>Faster admin navigation with direct submenu pages, quick Tour access, and plugin-row links to Settings, Docs, API docs, and Community support</li>
</ul>
<h4>Supported Currencies</h4>
USD, EUR, AED, TRY, CNY
<h4>How it works (one line)</h4>
Foreign Price × Rate(Toman) × (1 + Margin/100) → round to nearest 1000 Toman → store baseline → write WooCommerce price in selected unit.
<h4>Public Documentation</h4>
For user-friendly guides, setup walkthroughs, and practical explanations, see:
<ul>
<li><a href="https://tomanify.github.io/docs/" rel="nofollow ugc">Main docs</a></li>
<li><a href="https://tomanify.github.io/docs/quick-start/" rel="nofollow ugc">Quick Start</a></li>
<li><a href="https://tomanify.github.io/docs/free-api/" rel="nofollow ugc">Free-market JSON guide (no built-in provider required)</a></li>
<li><a href="https://tomanify.github.io/docs/sources/" rel="nofollow ugc">Source modes</a></li>
<li><a href="https://tomanify.github.io/docs/troubleshooting/" rel="nofollow ugc">Troubleshooting</a></li>
</ul>
<h3>Quick Start (Recommended)</h3>
<h4>Option A: JSON (recommended for many stores)</h4>
<ol>
<li>In Tomanify → Sources tab, set JSON URL.</li>
<li>
Your endpoint must return this schema (values are TOMAN integers):
{“values”:{“USD”:60000,”EUR”:130000,”AED”:30000,”TRY”:2500,”CNY”:22550}}
</li>
<li>
Click Update Rates.
</li>
<li>Mark a product as foreign and enter its foreign amount, currency, and margin.</li>
</ol>
You can host this JSON on your own server, GitHub Pages, or raw GitHub content.
A compatible free-market JSON feed is often enough for many stores. If your business is more sensitive to timing or smaller rate movements, you can combine it with margin, official RSS/XML fallback, or your own paid/self-hosted source.
<h4>Option B: Official rates (RSS/XML)</h4>
<ol>
<li>In Tomanify → Sources tab, set the official RSS/XML URL for each currency (HTTPS).</li>
<li>The plugin converts official Rial to free-market Toman using: 
Premium = Free / Official 
Free (Toman) = Official (Rial) / (10 × Premium)</li>
</ol>
If you do not know the RSS/XML feed URL, open the <a href="https://www.cbi.ir/ExRates/rates_en.aspx" rel="nofollow ugc">official rates page</a> and copy the RSS link for each currency row.
(You will see an RSS icon next to each currency. Open it and copy the XML URL into the matching field.)
<h4>Option C: Manual / Offline</h4>
If you do not want to rely on a live URL all the time, you can also use:
<ul>
<li>Manual mode for fixed per-currency Toman values</li>
<li>Offline mode for reference-based estimation</li>
</ul>
These are useful as fallback strategies, not just emergency modes.
<h3>Recommended Source Links (Optional Copy/Paste)</h3>
Important: 
These links are OPTIONAL suggestions. Tomanify does not pre-fill them automatically. 
You may use any valid HTTPS source you trust.
<h4>1) Example JSON endpoint format</h4>
You need one URL that returns the JSON schema shown above. 
Example GitHub raw URL format:
https://raw.githubusercontent.com////data.json
Optional community-maintained JSON URL (free to use as long as GitHub and the underlying free resources remain available):
<blockquote>
https://raw.githubusercontent.com/rate-json/default/main/data.json
</blockquote>
<h4>2) Central Bank RSS/XML (Copy/Paste per currency)</h4>
USD — United States Dollar
<blockquote>
https://cbi.ir/ExRatesRSS.aspx?cid=1
</blockquote>
EUR — Euro
<blockquote>
https://cbi.ir/ExRatesRSS.aspx?cid=94
</blockquote>
AED — United Arab Emirates Dirham
<blockquote>
https://cbi.ir/ExRatesRSS.aspx?cid=14
</blockquote>
TRY — Turkish Lira
<blockquote>
https://cbi.ir/ExRatesRSS.aspx?cid=38
</blockquote>
CNY — Chinese Yuan
<blockquote>
https://cbi.ir/ExRatesRSS.aspx?cid=85
</blockquote>
<h3>Usage</h3>
<h4>Mark a product as foreign</h4>
Open the product edit screen → Foreign Product (Tomanify) box:
<ul>
<li>Enable Is foreign product</li>
<li>Enter Foreign price</li>
<li>Choose Currency</li>
<li>Enter Margin (%)</li>
</ul>
Save the product → Tomanify recalculates using stored rates.
<h4>Bulk edit foreign products</h4>
WP Admin → Tomanify → Products tab 
Edit foreign price, currency, margin; then Save.
<h4>Shortcode Widget</h4>
Add this shortcode to any page/post:
[tomanify_rates]
The widget displays:
<ul>
<li>Title + optional last update time</li>
<li>Unit (Toman/Rial)</li>
<li>Selected currencies table</li>
</ul>
Frontend CSS/JS assets load only when the shortcode exists on the page.
<h3>External Services</h3>
Tomanify does not transmit customer data, order data, or personally identifiable information. 
The plugin can fetch currency-rate data only from external URLs that you provide in the Sources tab (JSON and/or RSS/XML). 
Requests happen only when you update rates (manually or by scheduled cron).
Important:
<ul>
<li>The plugin does not pre-fill third-party URLs.</li>
<li>The plugin does not require a specific commercial API provider.</li>
<li>You are responsible for choosing the source that matches your business needs.</li>
</ul>
<h3>License</h3>
GPL-2.0-or-later.

Alternatives to Tomanify – Smart Toman & Rial Currency Manager

Top alternatives