內容簡介
Tomanify 是一款專為 WooCommerce 商店設計的外掛，幫助商家在使用外幣（如 USD、EUR、AED、TRY、CNY）進行交易時，能夠安全地將最終售價儲存為伊朗托曼或里亞爾，確保價格顯示的準確性與一致性。
【主要功能】
• 每產品外幣定價：外幣標誌 + 貨幣 + 外幣金額 + 利潤（%）
• 自動轉換為托曼基準並儲存於 WooCommerce 價格元資料
• 切換顯示單位（托曼/里亞爾）無需重新獲取匯率
• 支援多種匯率來源策略，無需強迫使用單一遠端服務
外掛標籤
開發者團隊
② 後台搜尋「Tomanify – Smart Toman & Rial Currency Manager」→ 直接安裝（推薦）
原文外掛簡介
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:
No external source URLs are pre-filled inside the plugin.
External requests happen only if an administrator explicitly enters URLs.
Converted prices are stored using a TOMAN baseline to avoid double-conversion when switching between Toman and Rial.
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.
Start Here
See the public Persian documentation for an overview and full guides.
New here? Follow the Quick Start.
For setup and configuration, open the plugin documentation.
For rate sources and how they work, see Source modes (API docs).
If something doesn’t work, check Troubleshooting.
Need help? Post your issue on the Community support and we’ll respond as soon as possible.
2-minute Quick Setup Video
What makes Tomanify different?
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:
It stores a final Toman baseline per foreign product.
It stores that baseline in product meta and uses it to rewrite WooCommerce price values.
It lets you switch between Toman and Rial without re-fetching rates.
It supports multiple rate-source strategies instead of forcing one remote service.
Key Features
Per-product foreign pricing: foreign flag + currency + foreign amount + margin (%)
Automatic conversion to Toman baseline and storage in WooCommerce price meta
Switch display unit (Toman/Rial) without re-fetching rates (rewrites from baseline)
Rate sources (admin configurable):
Live free-market JSON endpoint (Toman values)
Official RSS/XML (per currency) + premium conversion (Free/Official)
Manual rates (Toman)
Offline estimation model (reference-based)
Bulk editor for all foreign products (Products tab)
Frontend widget shortcode: [tomanify_rates] (frontend assets load only when shortcode is used)
Optional cache purge integration (OFF by default)
Backup/Restore (export/import JSON) + uninstall cleanup option
Independent plugin language (fa_IR / en_US) regardless of site language
RTL/LTR aware admin and frontend UI
Faster admin navigation with direct submenu pages, quick Tour access, and plugin-row links to Settings, Docs, API docs, and Community support
Supported Currencies
USD, EUR, AED, TRY, CNY
How it works (one line)
Foreign Price × Rate(Toman) × (1 + Margin/100) → round to nearest 1000 Toman → store baseline → write WooCommerce price in selected unit.
Public Documentation
For user-friendly guides, setup walkthroughs, and practical explanations, see:
Main docs
Quick Start
Free-market JSON guide (no built-in provider required)
Source modes
Troubleshooting
Quick Start (Recommended)
Option A: JSON (recommended for many stores)
In Tomanify → Sources tab, set JSON URL.
Your endpoint must return this schema (values are TOMAN integers):
{“values”:{“USD”:60000,”EUR”:130000,”AED”:30000,”TRY”:2500,”CNY”:22550}}
Click Update Rates.
Mark a product as foreign and enter its foreign amount, currency, and margin.
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.
Option B: Official rates (RSS/XML)
In Tomanify → Sources tab, set the official RSS/XML URL for each currency (HTTPS).
The plugin converts official Rial to free-market Toman using:
Premium = Free / Official
Free (Toman) = Official (Rial) / (10 × Premium)
If you do not know the RSS/XML feed URL, open the official rates page 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.)
Option C: Manual / Offline
If you do not want to rely on a live URL all the time, you can also use:
Manual mode for fixed per-currency Toman values
Offline mode for reference-based estimation
These are useful as fallback strategies, not just emergency modes.
Recommended Source Links (Optional Copy/Paste)
Important:
These links are OPTIONAL suggestions. Tomanify does not pre-fill them automatically.
You may use any valid HTTPS source you trust.
1) Example JSON endpoint format
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):
https://raw.githubusercontent.com/rate-json/default/main/data.json
2) Central Bank RSS/XML (Copy/Paste per currency)
USD — United States Dollar
https://cbi.ir/ExRatesRSS.aspx?cid=1
EUR — Euro
https://cbi.ir/ExRatesRSS.aspx?cid=94
AED — United Arab Emirates Dirham
https://cbi.ir/ExRatesRSS.aspx?cid=14
TRY — Turkish Lira
https://cbi.ir/ExRatesRSS.aspx?cid=38
CNY — Chinese Yuan
https://cbi.ir/ExRatesRSS.aspx?cid=85
Usage
Mark a product as foreign
Open the product edit screen → Foreign Product (Tomanify) box:
Enable Is foreign product
Enter Foreign price
Choose Currency
Enter Margin (%)
Save the product → Tomanify recalculates using stored rates.
Bulk edit foreign products
WP Admin → Tomanify → Products tab
Edit foreign price, currency, margin; then Save.
Shortcode Widget
Add this shortcode to any page/post:
[tomanify_rates]
The widget displays:
Title + optional last update time
Unit (Toman/Rial)
Selected currencies table
Frontend CSS/JS assets load only when the shortcode exists on the page.
External Services
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:
The plugin does not pre-fill third-party URLs.
The plugin does not require a specific commercial API provider.
You are responsible for choosing the source that matches your business needs.
License
GPL-2.0-or-later.