=== Pashizi Currency Exchange Widget ===
Contributors: pashizi
Tags: currency, exchange rate, iranian rial, calculator, widget
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Display real-time Iranian Rial exchange rates with an interactive calculator. Supports 28+ currencies and 10 languages.

== Description ==

The Pashizi Currency Exchange Widget plugin allows you to display real-time Iranian Rial (IRR) exchange rates for major world currencies with an interactive calculator. Perfect for financial websites, Iranian businesses, and anyone needing current exchange rate information.

= Key Features =

* **Real-time Exchange Rates**: Live buy/sell prices for various currencies against Iranian Rial
* **Interactive Calculator**: Built-in currency converter for user calculations
* **28+ Supported Currencies**: USD, EUR, GBP, JPY, CHF, CAD, AUD, and many more
* **10 Languages**: Including Persian (Farsi), English, Arabic, German, Spanish, French, Italian, Dutch, Russian, and Chinese
* **Multiple Integration Options**: Shortcode, WordPress Widget, and Gutenberg Block
* **Responsive Design**: Mobile-friendly and adaptive layout
* **RTL Support**: Full right-to-left language support for Persian and Arabic
* **Clean & Modern Design**: Professional appearance that fits any website theme

= Supported Currencies =

USD, EUR, GBP, JPY, CHF, CAD, AUD, SGD, HKD, NOK, SEK, DKK, MYR, RUB, TRY, INR, CNY, AED, THB, QAR, SAR, OMR, BHD, KWD, IQD, AZN, AFN, AMD

= Supported Languages =

* English (en)
* Persian/Farsi (fa) - فارسی
* German (de)
* Arabic (ar) - العربية
* Spanish (es)
* French (fr)
* Italian (it)
* Dutch (nl)
* Russian (ru)
* Chinese (zh)

= Usage Examples =

**Shortcode:**
`[pashizi_widget currency="usd" lang="en"]`
`[pashizi_widget currency="eur" lang="fa"]`

**WordPress Widget:**
Go to Appearance > Widgets and add "Pashizi Currency Widget"

**Gutenberg Block:**
Search for "Pashizi Currency" in the block editor

= About Pashizi =

Pashizi is Iran's leading currency exchange rate service, providing accurate and up-to-date exchange rates for Iranian businesses and individuals. This plugin connects to Pashizi's reliable API to ensure you always have the latest exchange rate information.

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel
2. Go to Plugins > Add New
3. Search for "Pashizi Currency Exchange Widget"
4. Click "Install Now" and then "Activate"
5. Configure settings under Settings > Pashizi Widget

= Manual Installation =

1. Download the plugin ZIP file
2. Log in to your WordPress admin panel
3. Go to Plugins > Add New > Upload Plugin
4. Select the ZIP file and click "Install Now"
5. Activate the plugin
6. Configure settings under Settings > Pashizi Widget

= Configuration =

After activation, you can:

1. Set default currency and language in Settings > Pashizi Widget
2. Use the shortcode `[pashizi_widget]` in posts/pages
3. Add the widget in Appearance > Widgets
4. Use the Gutenberg block in the block editor

== Frequently Asked Questions ==

= What currencies are supported? =

The widget supports 28+ major world currencies including USD, EUR, GBP, JPY, CHF, CAD, AUD, SGD, HKD, NOK, SEK, DKK, MYR, RUB, TRY, INR, CNY, AED, THB, QAR, SAR, OMR, BHD, KWD, IQD, AZN, AFN, and AMD.

= Can I display the widget in Persian (Farsi)? =

Yes! The plugin fully supports Persian language with proper RTL (right-to-left) layout. Use `lang="fa"` parameter or select Persian in the widget settings.

= How often are exchange rates updated? =

Exchange rates are updated in real-time and cached for optimal performance. The widget connects to Pashizi's API to ensure you always have current rates.

= Can I customize the widget appearance? =

Yes, you can add custom CSS classes using the `class` parameter in the shortcode or the widget settings. The widget uses standard CSS classes that can be styled with your theme's CSS.

= Does this work with Gutenberg? =

Yes! The plugin includes a dedicated Gutenberg block called "Pashizi Currency Widget" with an easy-to-use interface for selecting currency and language options.

= Is the widget responsive? =

Yes, the widget is fully responsive and works perfectly on mobile devices, tablets, and desktop computers.

= Does this plugin collect any user data? =

No, the plugin doesn't collect or store any personal user data. It only connects to Pashizi's API to fetch exchange rate data for display purposes.

== Screenshots ==

1. Widget displaying USD to IRR exchange rates in English
2. Widget in Persian (Farsi) language with RTL layout
3. Interactive currency calculator feature
4. WordPress widget configuration panel
5. Gutenberg block settings
6. Plugin settings page in WordPress admin

== Changelog ==

= 1.0.0 =
* Initial release
* Shortcode support with customizable parameters
* WordPress widget with configuration options
* Gutenberg block integration
* Support for 28+ currencies
* Support for 10 languages including Persian (Farsi)
* RTL language support for Persian and Arabic
* Interactive currency calculator
* Responsive design
* Admin settings panel
* Persian translations

== Upgrade Notice ==

= 1.0.0 =
Initial release of the Pashizi Currency Exchange Widget plugin.

== Support ==

For support, documentation, and updates, please visit:

* Plugin Support: WordPress.org plugin support forums
* Pashizi Website: https://www.pashizi.com
* Documentation: Plugin settings page in WordPress admin

== Privacy Policy ==

This plugin connects to Pashizi's external API (widget.pashizi.com/calculator) to fetch real-time currency exchange rates. No personal user data is transmitted, collected, or stored. Only exchange rate requests are made to provide the currency information displayed in the widget.

For more information about Pashizi's privacy practices, please visit: https://www.pashizi.com/privacy

== Credits ==

This plugin is developed and maintained by the Pashizi team. Exchange rate data is provided by Pashizi's financial data services.
