=== Pars Kit (پارس کیت) ===
Contributors: parskit
Tags: ووکامرس,ووکامرس-فارسی,درگاه,شمسی,webP
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.1.8
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Jalali dates for WordPress and WooCommerce, including Analytics, plus Iranian bank gateways and essential tools for Persian sites.

== Description ==

**Pars Kit** is a lightweight, modular plugin for WordPress and WooCommerce. It brings together common tools for Persian sites and Iranian stores, including Jalali dates, Iranian bank gateways, WebP conversion, outbound-connection control, admin activity logs, WooCommerce tools, and SMTP.

Each feature is independent. Enable only what your site needs.

= 1. Complete Jalali (Shamsi) dates =

Pars Kit provides Jalali date conversion across WordPress and WooCommerce, including wp-admin, the storefront, calendars, date fields, and emails.

WooCommerce Analytics reports and date ranges can also be displayed in the Jalali calendar.

Optional Persian digits are available for supported output.

Date conversion is display-only. Stored dates remain Gregorian, so REST data, feeds, and SEO dates remain unchanged.

= 2. Iranian bank gateways =

Pars Kit includes six Iranian bank payment gateways:

* Behpardakht Mellat
* Saman Electronic Payment (SEP)
* Pasargad Electronic Payment
* Sadad (Bank Melli)
* Iran Kish
* Pardakht Novin Arian

Gateways are disabled by default. After enabling one in Pars Kit, configure its merchant credentials under **WooCommerce → Settings → Payments**.

Classic checkout, Cart and Checkout Blocks, and HPOS are supported.

= 3. Speed: WebP and outbound connections =

**Automatic WebP.** New JPG and PNG uploads can be converted to WebP to reduce file size. Existing media is not converted. After a successful conversion, the original file is removed.

**Outbound connections.** Add allowed domains to a whitelist and choose whether the rule applies to wp-admin, the site frontend, or both. Requests to non-whitelisted hosts are blocked.

= 4. Admin activity log =

When enabled, Pars Kit records activity by users with dashboard access in WordPress and WooCommerce, including username, date and time, IP address, event type, target, and details.

Actions made with a WooCommerce REST API key are identified by that key's description followed by **(API)**.

Logs can be filtered by field and date range. Retention can be set to 7, 30, or 90 days.

= 5. WordPress and WooCommerce tools =

Each tool can be enabled or disabled separately.

* **Vazirmatn admin font** — a local Persian-friendly font for wp-admin.
* **Admin speed** — reduces Heartbeat activity and lightens the Dashboard.
* **Jalali order date filter** — filter WooCommerce orders by a Shamsi date or date range.
* **Persian checkout names** — requires Persian letters for first and last name on classic checkout and the Checkout Block.
* **Hide price when out of stock** — on the single product page, removes the price HTML when the product is not in stock.

= 6. SMTP email =

In **Pars Kit → Email**, you can switch WordPress email from the server's default mail system to an SMTP server you configure.

This can be used for WooCommerce emails, password resets, and the built-in test email.

= Notes =

* Do not run another Shamsi date plugin at the same time.
* Do not run another plugin for the same bank while its Pars Kit gateway is enabled.
* WordPress 6.2+ and PHP 7.4+ are supported.
* WooCommerce 8.2+ is supported for WooCommerce features.

== Installation ==

1. Install Pars Kit from WordPress.org or upload the plugin ZIP.
2. Activate **Pars Kit**.
3. Open **Pars Kit** and enable the modules you need.
4. For a bank gateway, enable it and configure its credentials under **WooCommerce → Settings → Payments**.

== Frequently Asked Questions ==

= Does this change dates in the database? =

No. Date conversion is for display only. Stored dates remain Gregorian.

= Where do I enter bank credentials? =

Enable the gateway in Pars Kit, then configure it under **WooCommerce → Settings → Payments**.

= Can I use it with Parsi Date or another Shamsi plugin? =

No. Running multiple date-conversion plugins at the same time can cause double conversion.

= Does WebP convert existing media? =

No. Only new JPG and PNG uploads are converted. The original file is removed after a successful conversion.

= How do I send mail through SMTP? =

Open **Pars Kit → Email**, select SMTP, enter the server details, save the settings, and use **Send test**.

= Does Pars Kit use a CDN or collect telemetry? =

No. Plugin assets are included locally and Pars Kit does not send telemetry or visitor data to its own servers. Optional gateways and SMTP connect only to the services you configure.

== External Services ==

Pars Kit does not send data to its own servers or track visitors.

Optional features may connect to third-party services when you enable and use them.

= Iranian payment gateways =

Pars Kit's payment gateways connect to the selected Iranian payment provider through the Shaparak payment network.

Gateways are disabled by default and connect only when enabled and selected during checkout.

Depending on the provider, payment requests may include merchant credentials, order ID, amount, callback URL, and optional customer information such as a mobile number. Pasargad may also receive customer name and email.

Card details are entered on the payment provider's page and are not collected or stored by Pars Kit.

Shaparak: https://www.shaparak.ir

= Behpardakht Mellat =

Used for Mellat payment requests, verification, settlement, and reversal.

Service: https://bpm.shaparak.ir
Provider: https://www.behpardakht.com

= Saman Electronic Payment (SEP) =

Used for payment token requests, verification, and reversal.

Service: https://sep.shaparak.ir
Provider: https://www.sep.ir

= Iran Kish =

Used for payment token requests, confirmation, and reversal.

Service: https://ikc.shaparak.ir
Provider: https://www.irankish.com

= Sadad (Bank Melli) =

Used for payment token requests and transaction verification.

Service: https://sadad.shaparak.ir
Provider: https://sadadpsp.ir

= Pardakht Novin Arian =

Used for payment requests, confirmation, reversal, and transaction inquiry.

Service: https://pna.shaparak.ir
Provider: https://pna.co.ir

= Pasargad Electronic Payment =

Used for payment token requests, purchase, inquiry, verification, and reversal.

Service: https://pep.shaparak.ir
Provider: https://www.pep.co.ir

= SMTP (optional) =

When enabled, WordPress sends email through the SMTP server configured by the site administrator.

The outgoing email and the credentials required for authentication are sent to that SMTP server. The SMTP provider's own terms and privacy policy apply.

Pars Kit does not operate an SMTP service.

== Privacy ==

Pars Kit does not send data to Pars Kit servers.

* **Activity log:** when enabled, administrator activity is stored on your site, including user, time, IP address, event details, and changes. Retention can be set to 7, 30, or 90 days.
* **SMTP:** the configured SMTP settings are stored on your server and used to send WordPress email.
* **Payment gateways:** payment requests are sent between your site and the selected payment provider.
* **Outbound connection blocker:** non-whitelisted outbound requests are blocked locally. No information about blocked requests is sent elsewhere.

== Third-party resources ==

* **Vazirmatn v33.003** — SIL Open Font License 1.1. Source: https://github.com/rastikerdar/vazirmatn. License: `assets/admin/fonts/vazirmatn/OFL.txt`.
* **Payment method logos** — trademarks of the respective payment providers, bundled only to identify the available payment method.

== Screenshots ==

1. Jalali date settings in Pars Kit
2. WooCommerce Analytics with Jalali dates
3. Speed — automatic WebP and the outbound-connection blocker
4. Iranian bank gateways
5. Tools — admin font, dashboard speed, order date filter, Persian checkout names, hide price when out of stock
6. Admin activity log
7. SMTP email

== Changelog ==

= 2.1.8 =

* Packaging bump for the current 2.1.x line

= 2.1.7 =

* Packaging bump for the current 2.1.x line

= 2.1.6 =

* Packaging bump for the current 2.1.x line

= 2.1.5 =

* Packaging bump for the current 2.1.x line

= 2.1.4 =

* Tools: rename the out-of-stock price toggle to clarify it applies on the product page

= 2.1.3 =

* Tools: optional hide-price-when-out-of-stock on the single product page
* Orders list: keep Jalali dates when opening the page from Analytics
* Checkout Blocks: empty gateway titles keep the Persian label instead of the word "undefined"
* Classic admin dates: do not assign wp.date.dateI18n when WordPress exports it as a getter-only property
* Activity log: show (API) in uppercase

== Upgrade Notice ==

= 2.1.8 =
Maintenance packaging release for the 2.1.x line.

= 2.1.7 =
Maintenance packaging release for the 2.1.x line.
