Persian Kit Wordpress Plugin - Rating, Reviews, Demo & Download

Persian Kit Preview Wordpress Plugin - Rating, Reviews, Demo & Download

No ratings yet

Free

Follow for free plugins, new theme releases and theme news

Plugin Description

Persian Kit makes WordPress and WooCommerce work the way Persian-speaking visitors expect: Jalali (Shamsi) dates, Persian digits, the right Persian letters, a checkout for Iran and form fields that check Iranian mobile numbers and national IDs. Each part has its own switch, so you turn on only what you need.

WordPress dates stay Gregorian in the database and display as Jalali dates. Display-only changes stop when disabled. Normalization, saved slugs and imported data are not automatically reversed. Replace custom form fields and review thousand-unit currencies before deactivating; uninstall removes settings and import undo logs.

Jalali dates

Jalali dates for posts, comments, the admin screens and the block editor’s date panel: ۱۲ مهر ۱۴۰۵
Jalali archive pages (/1405/07/ lists the posts of Mehr 1405), and Jalali months and days in the Archives and Calendar widgets and blocks
Optional Jalali dates in post links (/1405/07/09/my-post/), with old links redirected
Optionally, the Gregorian date next to the Jalali one: ۱۲ مهر ۱۴۰۵ (2026-10-04)
Afghan and Kurdish month names: Dari (۱۲ میزان ۱۴۰۵), Pashto (۱۲ تله ۱۴۰۵) or Sorani Kurdish (۱۲ ڕەزبەر ۱۴۰۵), chosen by the site’s language or by you
A Jalali date picker for the post date in the classic editor and Quick Edit, and for WooCommerce’s order, product and coupon dates

Persian digits and letters

Persian digits in content, titles, the browser tab, widgets, menus, dates, counts and prices (off until you turn it on)
Search that finds words typed with Arabic (ي ك) or Persian (ی ک) letters, and numbers typed with Persian (۱۴۰۵) or English (1405) digits
Arabic ي and ك fixed to Persian ی and ک when posts, comments, categories, tags and menus are saved (off until you turn it on), and a tool that fixes existing posts after counting them first
Half-space (ZWNJ) shortcuts in the classic and block editors, and optional half-spaces in compound words
Persian slugs that keep Persian letters readable
A Persian admin, in Vazirmatn, Noto Sans Arabic or IBM Plex Sans Arabic

WooCommerce

A checkout for Iran: Persian digits in phone numbers and postcodes saved as English digits, Iranian phone numbers and postcodes checked, an optional national ID (کد ملی) field, city suggestions for each province, and only the provinces you deliver to
A shorter checkout for courses, files and services: name, country, phone and email
Thousand toman and thousand rial currencies, with prices in rials for search engines
“Call for price” (تماس بگیرید) in place of an empty price
Jalali dates on orders, and WooCommerce Analytics by Jalali months, seasons and years
Persian digits in the cart and checkout block prices and in emails, and a Persian font in emails
Compatible with HPOS (custom order tables) and the block checkout

Forms

Contact Form 7: a Jalali date picker, and mobile, national ID, postcode, card number and IBAN fields that check what is typed
Gravity Forms: Jalali Date fields in all three styles, an “Iranian fields” group, an Iran address type, and toman and rial
WPForms, also Lite: an “Iranian fields” group and a Jalali date field
Forminator: a Jalali date picker, and Iranian checks with a CSS class
ACF: a Jalali date picker for Date Picker and Date Time Picker fields

Supported form inputs submit Gregorian dates. WPForms also keeps a formatted display value, which can be Jalali, alongside its Gregorian date and UTC timestamp. Supported email date displays can be Jalali; test exports and add-ons with your form plugin.

Works with your plugins

Yoast SEO and Rank Math: search engines still get Gregorian dates and prices in rials, and date archives get Jalali titles
WPML and Polylang: configured page languages control date and digit display; Persian, Pashto and Sorani Kurdish use Jalali by default, while writing tools follow Persian content
Integrations default on and run when the required plugin is active and meets any minimum version

Switch from Parsi Date or Persian WooCommerce

A guided switch from Parsi Date, Persian WooCommerce and Persian WooCommerce Shipping. Before anything changes, it shows each of their settings next to Persian Kit’s. Then it brings over settings, widgets and blocks, ACF dates, Iranian provinces and cities and order statuses, keeps old Jalali links working, and gives you a report and an undo.

For developers

PHP helpers for Persian text, digits, dates and Iranian data: persian_kit_date(), persian_kit_to_persian_digits(), persian_kit_validate_national_id(), persian_kit_validate_iban() and more
Jalali companion fields in the REST API
Filters, documented in the reference
WP-CLI commands: wp persian-kit normalize and wp persian-kit import

Privacy

Persian Kit doesn’t track you or your visitors and sends nothing to other sites. Its fonts, scripts, date picker and city list all ship with the plugin, so nothing is loaded from elsewhere.

Bundled software

Persian Kit ships and credits the following third-party components:

eram/abzar — MIT-licensed PHP utilities for Persian text and digit handling.
eram/daynum — MIT-licensed PHP Jalali date library.
Alpine.js — MIT-licensed JavaScript framework, bundled into the admin script together with its MIT-licensed dependencies @vue/reactivity and @vue/shared.
Vazirmatn — Persian font by Saber Rastikerdar, licensed under the SIL Open Font License 1.1.
Noto Sans Arabic — font by Google and the Noto Project Authors, licensed under the SIL Open Font License 1.1.
IBM Plex Sans Arabic — font by IBM, licensed under the SIL Open Font License 1.1.
intl-datepicker — MIT-licensed date picker Web Component, bundled into public/js/datepicker.js.
@internationalized/date — Adobe’s calendar library, licensed under the Apache License 2.0, bundled into public/js/datepicker.js.
Tapin’s list of provinces and cities, from Persian WooCommerce Shipping by Mahdi Yousefi (GPLv3), in public/data/pws-tapin.json, to read addresses that plugin saved with Tapin’s ids.

Because public/data/pws-tapin.json is GPLv3, the plugin as distributed is under GPLv3. The plugin’s own code stays GPLv2 or later.

All bundled components are GPL-compatible. Their license texts ship with the plugin: packages/eram/*/LICENSE, public/fonts/vazirmatn/OFL.txt, public/fonts/noto-sans-arabic/OFL.txt, public/fonts/ibm-plex-sans-arabic/OFL.txt, public/licenses/ and the header of public/js/admin.js.

Source code

Plugin homepage: https://eram.dev/fa/projects/persian-kit/

Full source, build instructions, and issue tracker:
https://github.com/eramhq/persian-kit

Full guides: English and فارسی.

Screenshots

Jalali dates and Persian digits across the site: post dates, the calendar and the archive list.
A WooCommerce checkout for Iran: provinces in Persian, city suggestions, checked postcodes and phone numbers, and prices in toman.
WooCommerce Analytics on the Jalali calendar: Jalali months, seasons and years.
Iranian fields and the Jalali date picker in forms, with errors in Persian.
Jalali dates and a Jalali month filter on the admin post list.
Display settings: each part has its own switch.
Works with the plugins you already use: each active one gets its own card.
Switching from Parsi Date: each of its settings next to Persian Kit’s, before anything changes.