{"id":281872,"date":"2026-03-01T15:17:47","date_gmt":"2026-03-01T15:17:47","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/tomanify-smart-toman-rial-currency-manager\/"},"modified":"2026-10-08T17:50:14","modified_gmt":"2026-10-08T17:50:14","slug":"tomanify","status":"publish","type":"plugin","link":"https:\/\/rhg.wordpress.org\/plugins\/tomanify\/","author":23327723,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.0","stable_tag":"1.1.0","tested":"7.1.3","requires":"5.2","requires_php":"7.4","requires_plugins":null,"header_name":"Tebaro \u2013 Currency Conversion for WooCommerce","header_author":"Amin Raoufi","header_description":"Lightweight multi-source currency conversion for WooCommerce with Toman\/Rial support and live exchange rates.","assets_banners_color":"0d3e7c","last_updated":"2026-10-08 17:50:14","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/tomanify","header_author_uri":"https:\/\/www.linkedin.com\/in\/araoufi","rating":0,"author_block_rating":0,"active_installs":70,"downloads":1181,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.2":{"tag":"1.0.2","author":"araoufi","date":"2026-03-01 15:20:47","revision":3472124},"1.0.3":{"tag":"1.0.3","author":"araoufi","date":"2026-03-26 23:16:47","revision":3492224},"1.0.4":{"tag":"1.0.4","author":"araoufi","date":"2026-06-04 15:31:57","revision":3561227},"1.1.0":{"tag":"1.1.0","author":"araoufi","date":"2026-10-08 17:50:14","revision":3735277}},"upgrade_notice":{"1.1.0":"<p>Retires legacy JSON\/provider runtime with safe migration, adds Official\/Offline\/Manual conversion architecture and optional scalar coefficient feed, rebrands display name to Tebaro, and preserves pricing\/unit compatibility.<\/p>","1.0.4":"<p>WordPress 7.0 compatibility, safer HTTPS handling, mobile admin improvements, source setup links, language switching, backup\/import\/uninstall fixes, and official-estimate defaults.<\/p>","1.0.3":"<p>Adds direct submenu navigation, About-tab documentation links, and plugin-row shortcuts for settings, tour, docs, and support.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.gif":{"filename":"icon-128x128.gif","revision":3733473,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.gif":{"filename":"icon-256x256.gif","revision":3733473,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3733473,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3733473,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.2","1.0.3","1.0.4","1.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3734779,"resolution":"1","location":"assets","locale":"","width":1672,"height":941},"screenshot-10.png":{"filename":"screenshot-10.png","revision":3735277,"resolution":"10","location":"assets","locale":"","width":1672,"height":941},"screenshot-11.png":{"filename":"screenshot-11.png","revision":3734779,"resolution":"11","location":"assets","locale":"","width":1672,"height":941},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3735277,"resolution":"2","location":"assets","locale":"","width":1672,"height":941},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3735277,"resolution":"3","location":"assets","locale":"","width":1672,"height":941},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3735277,"resolution":"4","location":"assets","locale":"","width":1672,"height":941},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3735277,"resolution":"5","location":"assets","locale":"","width":1672,"height":941},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3735277,"resolution":"6","location":"assets","locale":"","width":1672,"height":941},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3735277,"resolution":"7","location":"assets","locale":"","width":1672,"height":941},"screenshot-8.png":{"filename":"screenshot-8.png","revision":3735277,"resolution":"8","location":"assets","locale":"","width":1672,"height":941},"screenshot-9.png":{"filename":"screenshot-9.png","revision":3734779,"resolution":"9","location":"assets","locale":"","width":1672,"height":941}},"screenshots":{"1":"Dashboard: overview of conversion-value updates, scheduling, effective coefficient status, and stored values with local source\/provenance.","2":"Products: bulk editor for foreign-product amount, currency, margin, and computed final Toman\/Rial price.","3":"Product edit: <strong>Foreign Product (Tebaro)<\/strong> meta box shown directly in the WooCommerce create\/edit product screen.","4":"Sources: administrator-configured Official source URLs, estimate calibration coefficient, feed status, and Manual conversion values.","5":"Frontend widget: responsive conversion-values card rendered locally by <strong>[tomanify_rates]<\/strong> with no frontend rate\/coefficient request.","6":"General: source mode, Toman\/Rial display unit, independent plugin language, and optional same-host cache purge.","7":"Advanced: change threshold, stored Official USD reference\/CAGR settings, and Factory Reset controls.","8":"Backup &amp; Restore: portable configuration\/product-meta export, safe restore, and explicit uninstall-data preference.","9":"Shortcode: currency selection, optional last-update display, and shortcode copy\/settings controls.","10":"Guided migration\/onboarding: contextual guidance for safely handling legacy foreign-price\/source configuration.","11":"Coefficient feed example: scalar-only JSON coefficient document accepted by the optional calibration-feed schema."}},"plugin_section":[],"plugin_tags":[8504,4870,256857,153263,286],"plugin_category":[45],"plugin_contributors":[245216],"plugin_business_model":[],"class_list":["post-281872","plugin","type-plugin","status-publish","hentry","plugin_tags-currency","plugin_tags-iran","plugin_tags-rial","plugin_tags-toman","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-araoufi","plugin_committers-araoufi"],"banners":{"banner":"https:\/\/ps.w.org\/tomanify\/assets\/banner-772x250.png?rev=3733473","banner_2x":"https:\/\/ps.w.org\/tomanify\/assets\/banner-1544x500.png?rev=3733473","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/tomanify\/assets\/icon-128x128.gif?rev=3733473","icon_2x":"https:\/\/ps.w.org\/tomanify\/assets\/icon-256x256.gif?rev=3733473","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/tomanify\/assets\/screenshot-1.png?rev=3734779","caption":"Dashboard: overview of conversion-value updates, scheduling, effective coefficient status, and stored values with local source\/provenance."},{"src":"https:\/\/ps.w.org\/tomanify\/assets\/screenshot-2.png?rev=3735277","caption":"Products: bulk editor for foreign-product amount, currency, margin, and computed final Toman\/Rial price."},{"src":"https:\/\/ps.w.org\/tomanify\/assets\/screenshot-3.png?rev=3735277","caption":"Product edit: <strong>Foreign Product (Tebaro)<\/strong> meta box shown directly in the WooCommerce create\/edit product screen."},{"src":"https:\/\/ps.w.org\/tomanify\/assets\/screenshot-4.png?rev=3735277","caption":"Sources: administrator-configured Official source URLs, estimate calibration coefficient, feed status, and Manual conversion values."},{"src":"https:\/\/ps.w.org\/tomanify\/assets\/screenshot-5.png?rev=3735277","caption":"Frontend widget: responsive conversion-values card rendered locally by <strong>[tomanify_rates]<\/strong> with no frontend rate\/coefficient request."},{"src":"https:\/\/ps.w.org\/tomanify\/assets\/screenshot-6.png?rev=3735277","caption":"General: source mode, Toman\/Rial display unit, independent plugin language, and optional same-host cache purge."},{"src":"https:\/\/ps.w.org\/tomanify\/assets\/screenshot-7.png?rev=3735277","caption":"Advanced: change threshold, stored Official USD reference\/CAGR settings, and Factory Reset controls."},{"src":"https:\/\/ps.w.org\/tomanify\/assets\/screenshot-8.png?rev=3735277","caption":"Backup &amp; Restore: portable configuration\/product-meta export, safe restore, and explicit uninstall-data preference."},{"src":"https:\/\/ps.w.org\/tomanify\/assets\/screenshot-9.png?rev=3734779","caption":"Shortcode: currency selection, optional last-update display, and shortcode copy\/settings controls."},{"src":"https:\/\/ps.w.org\/tomanify\/assets\/screenshot-10.png?rev=3735277","caption":"Guided migration\/onboarding: contextual guidance for safely handling legacy foreign-price\/source configuration."},{"src":"https:\/\/ps.w.org\/tomanify\/assets\/screenshot-11.png?rev=3734779","caption":"Coefficient feed example: scalar-only JSON coefficient document accepted by the optional calibration-feed schema."}],"raw_content":"<!--section=description-->\n<p><strong>Tebaro, formerly Tomanify,<\/strong> helps WooCommerce stores convert foreign product costs in <strong>USD, EUR, AED, TRY, and CNY<\/strong> into final product prices stored in Iranian <strong>Toman<\/strong> or <strong>Rial<\/strong>.<\/p>\n\n<p>Tebaro is a product-pricing\/conversion tool. It is not an exchange, broker, market maker, remittance service, financial adviser, or authoritative publisher of currency buy\/sell quotations.<\/p>\n\n<h4>Start Here<\/h4>\n\n<p>New to Tebaro? Follow the <a href=\"https:\/\/tomanify.github.io\/docs\/quick-start\/\">Quick Start<\/a>.\nFor full setup and configuration, see the <a href=\"https:\/\/tomanify.github.io\/docs\/\">main documentation<\/a>.\nFor source setup, use <a href=\"https:\/\/tomanify.github.io\/docs\/sources\/\">Sources &amp; Coefficient<\/a> and <a href=\"https:\/\/tomanify.github.io\/docs\/rate-links\/cbi\/\">Official Source Links<\/a>.\nFor automatic calibration, see <a href=\"https:\/\/tomanify.github.io\/docs\/free-api\/\">About Auto Coefficient<\/a>.\nFor frontend display, see the <a href=\"https:\/\/tomanify.github.io\/docs\/shortcode\/\">Shortcode Guide<\/a>.\nIf something does not work, check <a href=\"https:\/\/tomanify.github.io\/docs\/troubleshooting\/\">Troubleshooting<\/a> or ask in <a href=\"https:\/\/wordpress.org\/support\/plugin\/tomanify\/\">Community support<\/a>.<\/p>\n\n<p>The core pricing model remains deliberately simple and upgrade-safe:<\/p>\n\n<ul>\n<li>Final conversion values are stored canonically as integer <strong>Toman<\/strong> values.<\/li>\n<li>Foreign products keep an integer <strong>Toman baseline<\/strong> in product meta.<\/li>\n<li>Product pricing uses: <strong>Foreign price \u00d7 conversion value \u00d7 (1 + margin\/100)<\/strong>, rounded to the nearest 1000 Toman.<\/li>\n<li>Toman display writes the baseline directly; Rial display writes <strong>baseline \u00d7 10<\/strong>.<\/li>\n<li>Switching Toman\/Rial rewrites WooCommerce prices from the saved baseline and does <strong>not<\/strong> re-fetch sources or recalculate from the foreign amount.<\/li>\n<\/ul>\n\n<h4>Conversion source modes<\/h4>\n\n<p>Tebaro provides four administrator-facing modes:<\/p>\n\n<ul>\n<li><strong>Automatic fallback<\/strong> \u2014 tries Official-rate estimate, then Offline estimate, then Manual conversion values.<\/li>\n<li><strong>Official-rate estimate<\/strong> \u2014 reads administrator-configured HTTPS official Rial observations and applies an effective estimate calibration coefficient.<\/li>\n<li><strong>Offline estimate<\/strong> \u2014 uses locally stored official reference data, CAGR, an official cross-currency snapshot when available, and a cached\/manual coefficient. Offline mode performs no external request.<\/li>\n<li><strong>Manual conversion values<\/strong> \u2014 uses administrator-entered per-currency Toman values and performs no external request.<\/li>\n<\/ul>\n\n<p>No source URL is bundled, pre-filled, hidden, or used as a fallback. External requests are possible only after an administrator explicitly configures HTTPS URLs.<\/p>\n\n<h4>Estimate calibration coefficient<\/h4>\n\n<p>The manual fallback coefficient is stored locally and remains administrator-controlled.<\/p>\n\n<p>Administrators may optionally enable a separate HTTPS coefficient feed. The feed supplies <strong>one dimensionless scalar coefficient<\/strong>, not per-currency market rates or provider lists. The plugin never uses the feed to overwrite the manual fallback coefficient.<\/p>\n\n<p>The accepted feed schema is intentionally narrow:<\/p>\n\n<pre><code>{\n  \"schema_version\": 1,\n  \"coefficient\": 1.294,\n  \"generated_at\": \"2026-10-06T12:00:00Z\",\n  \"valid_until\": \"2026-10-07T12:00:00Z\",\n  \"method\": \"median_of_currency_medians_v1\",\n  \"sample_count\": 25,\n  \"status\": \"ok\"\n}\n<\/code><\/pre>\n\n<p>Unknown top-level keys are rejected. Payloads containing per-currency values, provider lists, provider\/source URLs, or similar rate-feed fields are not accepted by this schema.<\/p>\n\n<p>The plugin also applies local freshness\/TTL checks, a bounded last-known-good cache, a seven-day cache grace window, and a scalar jump guard before using a newly received coefficient.<\/p>\n\n<h4>Legacy JSON migration<\/h4>\n\n<p>The former multi-provider\/free-market JSON runtime is retired in revised 1.1.0.<\/p>\n\n<p>On upgrade, Tebaro protects existing shops instead of silently switching a legacy JSON-dependent installation to a different source:<\/p>\n\n<ul>\n<li>when current stored values can be preserved safely and no existing Manual values conflict, stored values may be copied to Manual conversion values without changing current canonical rates or product prices;<\/li>\n<li>when existing Manual values could be overwritten, stored values are unavailable, or migration is ambiguous, the plugin enters a <strong>Legacy migration hold<\/strong>;<\/li>\n<li>while Hold is active, source refreshes and refresh-driven full product recalculation are paused until an administrator explicitly resolves the migration;<\/li>\n<li>the old JSON URL may remain locally for one transition release as inactive legacy data, but it is never requested by the revised runtime and is not included in new backups.<\/li>\n<\/ul>\n\n<h4>Independence and naming<\/h4>\n\n<p>Tebaro, formerly Tomanify, is an independent free and open-source WordPress\/WooCommerce project. It is not affiliated with, endorsed by, operated by, or connected with <strong>tomanify.com<\/strong> or any exchange, brokerage, cryptocurrency platform, or remittance service.<\/p>\n\n<p>The public display name changed to Tebaro while the technical WordPress identity remains <code>tomanify<\/code> for safe in-place updates. Existing option names, hooks, classes, the plugin folder\/slug, text domain, and shortcode remain technically compatible.<\/p>\n\n<h3>Key Features<\/h3>\n\n<ul>\n<li>Foreign-product pricing: foreign flag, currency, foreign amount, and margin (%)<\/li>\n<li>Canonical integer-Toman conversion values<\/li>\n<li>Per-product Toman baseline for safe Toman\/Rial switching<\/li>\n<li>Automatic fallback: Official \u2192 Offline \u2192 Manual<\/li>\n<li>Administrator-configured HTTPS official source URLs; empty by default<\/li>\n<li>Manual fallback coefficient plus optional scalar-only automatic coefficient feed; disabled\/empty by default<\/li>\n<li>Deterministic no-network Offline mode<\/li>\n<li>Manual conversion values in Toman<\/li>\n<li>Stored local source\/provenance labels without frontend network requests<\/li>\n<li>Bulk editor for foreign products<\/li>\n<li>Frontend shortcode: <strong>[tomanify_rates]<\/strong><\/li>\n<li>Frontend assets load only when the shortcode is rendered<\/li>\n<li>Optional same-host cache purge, disabled by default<\/li>\n<li>Backup\/Restore with legacy-migration safeguards<\/li>\n<li>Independent plugin locale: <code>site<\/code>, <code>en_US<\/code>, or <code>fa_IR<\/code><\/li>\n<li>Explicit RTL\/LTR containers based on the plugin locale<\/li>\n<li>Guided onboarding and product-editor steps<\/li>\n<\/ul>\n\n<h3>Supported Currencies<\/h3>\n\n<p>USD, EUR, AED, TRY, CNY<\/p>\n\n<h3>Usage<\/h3>\n\n<h4>Official-rate estimate<\/h4>\n\n<p>For each supported currency, the administrator may enter an HTTPS URL that returns the official Rial observation in the supported text\/RSS\/XML form.<\/p>\n\n<p>For a valid observation, Tebaro calculates:<\/p>\n\n<pre><code>Estimated Toman conversion value = Official Rial observation \u00d7 Effective coefficient \u00f7 10\n<\/code><\/pre>\n\n<p>If all five official observations are valid in the same refresh, the plugin records a coefficient-independent official cross-currency ratio snapshot for future Offline estimates.<\/p>\n\n<p>The plugin does not bundle or recommend a specific official endpoint. Empty URL fields disable Official-rate retrieval for that currency.<\/p>\n\n<h4>Offline estimate<\/h4>\n\n<p>Offline mode makes <strong>no external request<\/strong>. It uses the last real stored official USD observation, its timestamp, the administrator CAGR setting, the latest complete official ratio snapshot when available, and a locally usable cached\/manual coefficient.<\/p>\n\n<p>Until a valid official ratio snapshot exists, the existing deterministic compatibility fallback remains available.<\/p>\n\n<h4>Manual conversion values<\/h4>\n\n<p>Manual mode uses the administrator-entered Toman values directly. It does not contact an external service.<\/p>\n\n<h4>Foreign products<\/h4>\n\n<p>Open a WooCommerce product and use the <strong>Foreign Product (Tebaro)<\/strong> box:<\/p>\n\n<ul>\n<li>Enable <strong>Is foreign product<\/strong><\/li>\n<li>Enter <strong>Foreign price<\/strong><\/li>\n<li>Choose <strong>Currency<\/strong><\/li>\n<li>Enter <strong>Margin (%)<\/strong><\/li>\n<\/ul>\n\n<p>Only products with the foreign flag enabled are eligible for conversion updates.<\/p>\n\n<h4>Shortcode<\/h4>\n\n<p>Use:<\/p>\n\n<pre><code>[tomanify_rates]\n<\/code><\/pre>\n\n<p>The widget can show the selected conversion values, display unit, optional last-update time, and locally recorded source\/provenance. It does not fetch rates or coefficients from the frontend.<\/p>\n\n<p>The public note explains that the values are estimates for product pricing and are not currency buy\/sell quotations.<\/p>\n\n<h3>Backup and Upgrade Safety<\/h3>\n\n<p>New backups contain portable user configuration and selected foreign-product meta. Derived runtime state is not treated as authoritative portable configuration.<\/p>\n\n<p>New exports do not include the retired legacy JSON URL or retired provider\/anomaly settings. Old backups that contain the legacy JSON source are recognized only through the compatibility path and cannot silently reactivate the old runtime.<\/p>\n\n<p>A backup made while Legacy Hold is active restores into Hold. Import does not queue a full product recalculation while Hold remains unresolved.<\/p>\n\n<p>Normal plugin updates do not intentionally overwrite administrator-entered official URLs, Manual values, a custom coefficient, locale, display unit, cron interval, CAGR, shortcode selections, purge preference, foreign-product meta, or existing product baselines except for specifically documented compatibility migrations.<\/p>\n\n<h3>Documentation<\/h3>\n\n<ul>\n<li><a href=\"https:\/\/tomanify.github.io\/docs\/\">Main documentation<\/a><\/li>\n<li><a href=\"https:\/\/tomanify.github.io\/docs\/quick-start\/\">Quick Start<\/a><\/li>\n<li><a href=\"https:\/\/tomanify.github.io\/docs\/sources\/\">Sources &amp; Coefficient<\/a><\/li>\n<li><a href=\"https:\/\/tomanify.github.io\/docs\/rate-links\/cbi\/\">Official Source Links<\/a><\/li>\n<li><a href=\"https:\/\/tomanify.github.io\/docs\/free-api\/\">About Auto Coefficient<\/a><\/li>\n<li><a href=\"https:\/\/tomanify.github.io\/docs\/shortcode\/\">Shortcode Guide<\/a><\/li>\n<li><a href=\"https:\/\/tomanify.github.io\/docs\/troubleshooting\/\">Troubleshooting<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.org\/support\/plugin\/tomanify\/\">Community support<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/tebaro-wp\/coefficient-index\">Public coefficient-index repository (optional)<\/a><\/li>\n<\/ul>\n\n<p>These are documentation\/reference links only. Source and coefficient URL fields remain empty by default and are filled only by an administrator.<\/p>\n\n<h3>External Services<\/h3>\n\n<p>Tebaro has <strong>no bundled, required, hidden, or default external rate\/coefficient endpoint<\/strong>. All external-source URL fields are empty by default. Documentation may link to the optional public <strong>Tebaro Coefficient Index<\/strong>, but the plugin never copies that feed URL into settings automatically.<\/p>\n\n<p>External requests can occur only after an administrator explicitly configures HTTPS URLs and the corresponding runtime mode uses them. There are two possible external request families:<\/p>\n\n<ol>\n<li><strong>Official-rate source URLs<\/strong> \u2014 one administrator-selected URL per supported currency. During an explicit or scheduled Official\/Automatic refresh, Tebaro may request those URLs and parse supported official Rial observations.<\/li>\n<li><strong>Optional calibration-coefficient feed URL<\/strong> \u2014 disabled by default and empty by default. When explicitly enabled, Tebaro may request this URL during an Official\/Automatic refresh after at least one valid official observation exists. The expected response contains one scalar coefficient plus bounded metadata; it is not a per-currency market-rate feed.<\/li>\n<\/ol>\n\n<p><strong>Offline mode and Manual mode make no external request. The frontend shortcode makes no external rate\/coefficient request.<\/strong><\/p>\n\n<p>Plugin code does not send customer data, order data, product data, personally identifiable store-user data, analytics, or telemetry to configured source URLs. Like any HTTPS request, the destination server can observe ordinary connection\/HTTP metadata such as the requesting server IP address. Requests also use the plugin's compatibility User-Agent identifier <code>Tomanify\/&lt;version&gt;<\/code>; coefficient requests additionally declare JSON acceptance.<\/p>\n\n<p>Tebaro does not bundle a required external service. Administrators choose whether to configure any documented optional endpoint, including the public Tebaro Coefficient Index. <strong>Before configuring any endpoint, the site administrator is responsible for reviewing the chosen service or repository policies, permissions, privacy implications, and applicable law.<\/strong> Configuring a URL is an explicit administrator action.<\/p>\n\n<p>The legacy multi-provider JSON URL from older versions is inactive migration data only: revised runtime code does not request it, normal UI does not expose it as a source, and new backups do not export it.<\/p>\n\n<h3>Privacy<\/h3>\n\n<p>Tebaro does not include tracking, advertising telemetry, remote JavaScript\/CSS\/fonts, tracking pixels, or remote frontend assets.<\/p>\n\n<p>The plugin stores operational configuration in WordPress options and foreign-product configuration in product meta. It does not transmit customer\/order\/product content to external source URLs.<\/p>\n\n<p>Administrators should consider the privacy and terms of any third-party endpoint they choose to configure, including the ordinary server\/network metadata visible to that endpoint during an HTTPS request.<\/p>\n\n<h3>License<\/h3>\n\n<p>GPL-2.0-or-later.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate the plugin.<\/li>\n<li>Open <strong>WP Admin \u2192 Tebaro<\/strong>.<\/li>\n<li>Choose the desired source mode in <strong>General<\/strong>.<\/li>\n<li>If using Official-rate estimates, add the administrator-selected HTTPS official source URL for each required currency in <strong>Sources<\/strong>. See <a href=\"https:\/\/tomanify.github.io\/docs\/rate-links\/cbi\/\">Official Source Links<\/a>.<\/li>\n<li>Set the manual fallback coefficient and, only if desired, enable an administrator-configured coefficient feed. See <a href=\"https:\/\/tomanify.github.io\/docs\/free-api\/\">About Auto Coefficient<\/a>.<\/li>\n<li>Add Manual conversion values if you want Manual mode or a Manual fallback for Automatic mode.<\/li>\n<li>Mark products as <strong>Foreign Product (Tebaro)<\/strong> and enter the foreign amount, currency, and margin.<\/li>\n<li>Use <strong>Update Conversion Values<\/strong> on the Dashboard or the configured schedule.<\/li>\n<li>Optionally add <strong>[tomanify_rates]<\/strong> to a page or post. See the <a href=\"https:\/\/tomanify.github.io\/docs\/shortcode\/\">Shortcode Guide<\/a>.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20tebaro%20include%20or%20pre-fill%20any%20source%20url%3F\"><h3>Does Tebaro include or pre-fill any source URL?<\/h3><\/dt>\n<dd><p>No. Official-source and coefficient-feed URL fields are empty by default. The plugin has no bundled provider URL or hidden fallback endpoint.<\/p><\/dd>\n<dt id=\"what%20does%20automatic%20fallback%20do%3F\"><h3>What does Automatic fallback do?<\/h3><\/dt>\n<dd><p>It tries <strong>Official-rate estimate \u2192 Offline estimate \u2192 Manual conversion values<\/strong>. The retired JSON source is not part of the revised Automatic chain.<\/p><\/dd>\n<dt id=\"does%20the%20coefficient%20feed%20provide%20currency%20rates%3F\"><h3>Does the coefficient feed provide currency rates?<\/h3><\/dt>\n<dd><p>No. It provides one dimensionless calibration coefficient and bounded metadata only. The plugin rejects per-currency rate\/provider fields under the current feed schema.<\/p><\/dd>\n<dt id=\"can%20an%20automatic%20coefficient%20change%20my%20manual%20coefficient%20setting%3F\"><h3>Can an automatic coefficient change my manual coefficient setting?<\/h3><\/dt>\n<dd><p>No. Remote data never overwrites the administrator-controlled manual fallback coefficient.<\/p><\/dd>\n<dt id=\"does%20offline%20mode%20contact%20the%20internet%3F\"><h3>Does Offline mode contact the internet?<\/h3><\/dt>\n<dd><p>No. Offline mode resolves only from locally stored\/cached data.<\/p><\/dd>\n<dt id=\"can%20i%20use%20only%20manual%20values%3F\"><h3>Can I use only Manual values?<\/h3><\/dt>\n<dd><p>Yes. Select <strong>Manual conversion values<\/strong> and enter the required per-currency Toman values.<\/p><\/dd>\n<dt id=\"what%20happens%20to%20an%20old%20installation%20that%20used%20json%20rates%3F\"><h3>What happens to an old installation that used JSON rates?<\/h3><\/dt>\n<dd><p>The old JSON runtime is retired. Tebaro either preserves eligible stored values safely as Manual values or pauses source-driven updates in Legacy Hold until an administrator explicitly chooses the revised source strategy. It does not silently switch a legacy JSON-dependent shop to Official mode.<\/p><\/dd>\n<dt id=\"can%20i%20switch%20between%20toman%20and%20rial%20later%3F\"><h3>Can I switch between Toman and Rial later?<\/h3><\/dt>\n<dd><p>Yes. Tebaro stores the product baseline in Toman and rewrites WooCommerce prices from that baseline. Unit switching does not fetch sources or recompute from the foreign product amount.<\/p><\/dd>\n<dt id=\"is%20tebaro%20connected%20with%20tomanify.com%3F\"><h3>Is Tebaro connected with tomanify.com?<\/h3><\/dt>\n<dd><p>No. Tebaro is an independent open-source project. The technical <code>tomanify<\/code> identity is retained only for WordPress update compatibility with existing installations.<\/p><\/dd>\n<dt id=\"does%20tebaro%20provide%20financial%20advice%20or%20an%20authoritative%20exchange%20quotation%3F\"><h3>Does Tebaro provide financial advice or an authoritative exchange quotation?<\/h3><\/dt>\n<dd><p>No. Its conversion values are inputs for WooCommerce product pricing. Official and Offline outputs are estimates; Manual values are supplied by the administrator.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Retired the legacy multi-provider\/free-market JSON runtime with safe upgrade migration and Legacy Hold protection.<\/li>\n<li>Added Official-rate estimates using administrator-configured official sources and an administrator-controlled calibration coefficient.<\/li>\n<li>Added an optional scalar-only coefficient feed with strict schema, freshness\/TTL checks, cache grace, and jump protection.<\/li>\n<li>Reworked Offline estimates to remain network-free and use official reference\/snapshot data with cached\/manual coefficient fallback.<\/li>\n<li>Simplified source provenance and public wording around product-pricing conversion values and estimates.<\/li>\n<li>Hardened Backup\/Restore so old JSON backups and Hold states cannot silently resume retired source behavior or unintended product recalculation.<\/li>\n<li>Soft-rebranded the public display name to <strong>Tebaro<\/strong> while retaining the technical <code>tomanify<\/code> identity for in-place update compatibility.<\/li>\n<li>Added contextual documentation links across Dashboard, Sources, Products, Shortcode, Advanced, Backup, language\/cache controls, and About without pre-filling any source URL.<\/li>\n<li>Added a concise legacy-source retirement admin notice for affected upgraded installations.<\/li>\n<li>Improved Persian localization so the Tebaro brand is displayed as <strong>\u062a\u0628\u0627\u0631\u0648<\/strong>, including the translated plugin title and description.<\/li>\n<li>Preserved the Toman product baseline, Toman\/Rial unit-switch architecture, foreign-product pricing formula, independent locale, and RTL\/LTR behavior.<\/li>\n<\/ul>\n\n<h4>1.0.4<\/h4>\n\n<ul>\n<li>Added WordPress 7.0 compatibility metadata and safer HTTPS request handling.<\/li>\n<li>Improved mobile admin layout, form spacing, card alignment, table scrolling, and reduced-motion support.<\/li>\n<li>Added documentation links next to source URL fields without pre-filling or saving source URLs.<\/li>\n<li>Improved plugin-language switching after saving General settings and backup downloads.<\/li>\n<li>Improved official conversion defaults.<\/li>\n<li>Improved uninstall cleanup, HTTPS-only import handling, and admin action checks.<\/li>\n<\/ul>\n\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>Added direct admin submenu entries for all plugin tabs for faster navigation.<\/li>\n<li>Added documentation links to the About tab.<\/li>\n<li>Added plugin-row links for settings, tour, documentation, and community support.<\/li>\n<li>Improved guided tour behavior for admin submenu pages and the quick Tour link.<\/li>\n<li>Minor admin navigation improvements.<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Initial public release on WordPress.org.<\/li>\n<li>Secure admin forms with capability checks, nonces, sanitization, validation, and escaped output.<\/li>\n<li>No pre-filled external URLs; external requests only when an administrator configures URLs.<\/li>\n<li>Optional purge feature disabled by default and restricted to same-host requests.<\/li>\n<li>Added Backup\/Restore and optional uninstall cleanup.<\/li>\n<li>Improved RTL\/LTR support and independent plugin locale.<\/li>\n<\/ul>","raw_excerpt":"WooCommerce product-pricing conversion for foreign costs with Toman\/Rial baselines, official estimates, offline fallback, and manual values.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/rhg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/281872","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/rhg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/rhg.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/rhg.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=281872"}],"author":[{"embeddable":true,"href":"https:\/\/rhg.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/araoufi"}],"wp:attachment":[{"href":"https:\/\/rhg.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=281872"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/rhg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=281872"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/rhg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=281872"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/rhg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=281872"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/rhg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=281872"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/rhg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=281872"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}