AbdiScript

selfit

This plugin connects your WooCommerce store to SELFiT and lets customers pay securely via the SELFiT wallet. 
If you are upgrading from a previous version, please read the Upgrade Notice.
Highlights 
– Direct integration with the SELFiT API to create secure payment links 
– Compatible with WooCommerce (min 5.0), tested up to 8.5 
– HPOS-ready (High-Performance Order Storage) 
– Full refund from the WooCommerce order screen 
– Auto-detects the billing phone; optionally reads Digits plugin fields if present 
– Optional request/error logging in a dedicated “SELFiT Logs” admin page 
– Supports IRR/Toman (auto-converts IRR by dividing by 10)
Requirements 
– WordPress 5.0+ (tested up to 6.8) 
– WooCommerce 5.0+ (tested up to 8.5) 
– PHP 7.4+ 
– A SELFiT merchant account and API credentials
<h4>External services</h4>
This plugin uses an API to connect to the payment gateway. This connection is required to perform the transaction. 
The information sent via the API is derived from the order details, including: 
* Item name, price and quantity 
* Shipping method 
* buyer’s information (Name and phone number) 
For more detailed description about how Selfit API works, please visit <a href="https://selfit.ir/about" rel="nofollow ugc">Selfit Terms of Use</a>.
<h3>Privacy</h3>
To create and verify payments, the plugin sends the following to <code>api.selfit.ir</code>: 
– Customer phone number (to validate SELFiT user existence) 
– Order ID, amount, and optionally line items (as metadata)
If logging is enabled, limited request/response data are stored in the database for troubleshooting. Store owners are responsible for informing users according to their local privacy laws.
<h3>Notes for Developers</h3>
<ul>
<li>Gateway ID: <code>selfit</code></li>
<li>Internal confirmation endpoint: <code>woocommerce_api_wc_selfit_gateway</code></li>
<li>Important hooks: <code>woocommerce_order_status_cancelled</code>, <code>woocommerce_order_status_refunded</code></li>
<li>HPOS compatibility declared with <code>FeaturesUtil::declare_compatibility('custom_order_tables', ...)</code></li>
<li>Log table: <code>{prefix}selfit_debug_logs</code></li>
</ul>
<h3>Support</h3>
For support or merchant onboarding, please contact: https://selfit.ir

SELFiT Payment Gateway for WooCommerce

Official SELFiT payment gateway for WooCommerce.

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) × Premium / 10</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>Optional Example Source Formats</h3>
Important: 
These examples are optional documentation only. Tomanify does not pre-fill them automatically. 
You may use any valid HTTPS source you trust, including your own server or provider.
<h4>1) Example JSON endpoint format</h4>
You need one URL that returns the JSON schema shown above. 
Example self-hosted or repository-hosted URL format:
https://raw.githubusercontent.com////data.json
<h4>2) Central Bank RSS/XML URL format</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.

Tomanify – Smart Toman & Rial Currency Manager

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

SELFiT Payment Gateway for WooCommerce vs Tomanify – Smart Toman & Rial Currency Manager