Title: Nik Zoroastrian Calendar &amp; Events
Author: Maziyar Nikbakhsh
Published: <strong>October 13, 2026</strong>
Last modified: October 13, 2026

---

Search plugins

![](https://ps.w.org/nik-zoroastrian-calendar/assets/banner-772x250.png?rev=3742937)

![](https://ps.w.org/nik-zoroastrian-calendar/assets/icon-256x256.png?rev=3742929)

# Nik Zoroastrian Calendar & Events

 By [Maziyar Nikbakhsh](https://profiles.wordpress.org/vestar/)

[Download](https://downloads.wordpress.org/plugin/nik-zoroastrian-calendar.1.0.2.zip)

 * [Details](https://wordpress.org/plugins/nik-zoroastrian-calendar/#description)
 * [Reviews](https://wordpress.org/plugins/nik-zoroastrian-calendar/#reviews)
 *  [Installation](https://wordpress.org/plugins/nik-zoroastrian-calendar/#installation)
 * [Development](https://wordpress.org/plugins/nik-zoroastrian-calendar/#developers)

 [Support](https://wordpress.org/support/plugin/nik-zoroastrian-calendar/)

## Description

**سالنمای زرتشتیان** (تقویم زرتشتی) تاریخ روز بر پایه‌ی گاهشماری فصلی زرتشتیان را
به همراه جشن‌ها و گاهنبارهای پیش رو در سایت وردپرسی شما نمایش می‌دهد؛ همچنین یک 
سالنمای ماهانه و ابزار تبدیل تاریخ برای تقویم‌های زرتشتی (فصلی و قدیمی) دارد. خروجی‌ها
به‌صورت شورت‌کد و ویجت المنتور، و به دو زبان فارسی و انگلیسی در دسترس‌اند.

Nik Zoroastrian Calendar & Events adds six independent output units. Each is available
as a shortcode and as an Elementor widget, and can be enabled or disabled separately:

 1. **Today’s Date** `[gahs_today]` – the current weekday and Jalali date with the 
    matching Zoroastrian (Fasli) day name, month and year. Simple and Card templates,
    optional link.
 2. **Upcoming Events** `[gahs_events]` – the next Zoroastrian festivals and Gahanbars
    plus your own events (soonest N, this week, this month, or next N days).
 3. **Month Calendar** `[gahs_month_calendar]` – a full-month grid for the Fasli or
    Kadmi calendar, browsed in the Gregorian or Jalali calendar. Nabar days, the weekend
    day, and official and custom events can be shown on the grid (each toggled separately).
 4. **Date Converter** `[gahs_date_converter]` – a three-way converter between the 
    Zoroastrian (roj/mah), Jalali and Gregorian calendars.
 5. **Month Events List** `[gahs_month_events]` – a browsable month-by-month list of
    festivals, Gahanbars and your own events.
 6. **Upcoming Days Events** `[gahs_days_events]` – the same list for a fixed window
    of the next N days.

The Zoroastrian date uses the Fasli calendar, which shares the month/day structure
of the Iranian Jalali calendar; only the 30 named days and the year offset (Jalali
year + 2359 by default, adjustable) differ. Output is available in Persian and English.

**Custom events:** add your own events (title, date, time, city, location, address,
link, tag) from the admin page. They are stored in a dedicated `{prefix}gahs_events`
table.

**Caching:** pages that show a calendar unit are cached only until the next local
midnight when LiteSpeed Cache is active, and its cache is purged when events or 
settings change.

### Shortcodes

    ```
    [gahs_today] - `template` (`simple`/`card`), `lang`, `eyebrow`, `format`, `link`.

    [gahs_events] - `template`, `mode` (`count`/`week`/`month`/`days`), `count`, `lang`, `heading` (supports `{{month}}`), `title_length`.

    [gahs_month_calendar] - `system` (`fasli`/`kadmi`), `ref` (`gregorian`/`jalali`), `lang`, `heading`, `show_official_events`, `show_custom_events`.

    [gahs_date_converter] - `system`, `lang`.

    [gahs_month_events] - `ref`, `lang`, `heading` (`yes`/`no`).

    [gahs_days_events] - `days`, `ref`, `lang`, `heading`.<h3>Source Code and Build</h3>
    ```

The front-end JavaScript and CSS in `assets/` are minified. Their human-readable
sources are included in the plugin package:

 * `assets/js/zc-calendar.src.js` – source of `assets/js/zc-calendar.js`
 * `assets/css/zc-frontend.src.css` – source of `assets/css/zc-frontend.css` (the
   per-unit stylesheets are slices of the same source)

Rebuild the JavaScript with Terser (https://github.com/terser/terser): `npx terser
assets/js/zc-calendar.src.js --compress --mangle --comments false -o assets/js/zc-
calendar.js`. The admin files `assets/js/zc-admin.js` and `assets/css/zc-admin.css`
are not minified.

Bundled third-party asset: the Vazirmatn font (`assets/fonts/Vazirmatn-Variable.
woff2`), version 33.0.3, SIL Open Font License 1.1 – https://github.com/rastikerdar/
vazirmatn (license in `assets/fonts/OFL.txt`). It is loaded only when the “Admin
Font” option is enabled (off by default).

## Installation

 1. Upload the plugin to `/wp-content/plugins/nik-zoroastrian-calendar` or install 
    it from the Plugins screen.
 2. Activate it. A “Zoroastrian Calendar” menu appears in the admin.
 3. Add a shortcode to a page, or use the Elementor widgets.

## FAQ

### Which roles can manage the plugin?

Administrators and Editors by default. The “Access” option in the Settings tab lists
every role registered on the site.

### How do I change the language?

Set the display language in the Settings tab, or use the `lang` attribute (`fa` 
or `en`) on a shortcode.

### Does the plugin contact external servers?

No. All assets, including the optional admin font, are served from the plugin.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Nik Zoroastrian Calendar & Events” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ Maziyar Nikbakhsh ](https://profiles.wordpress.org/vestar/)

[Translate “Nik Zoroastrian Calendar & Events” into your language.](https://translate.wordpress.org/projects/wp-plugins/nik-zoroastrian-calendar)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/nik-zoroastrian-calendar/),
check out the [SVN repository](https://plugins.svn.wordpress.org/nik-zoroastrian-calendar/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/nik-zoroastrian-calendar/)
by [RSS](https://plugins.trac.wordpress.org/log/nik-zoroastrian-calendar/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.2

 * First release on WordPress.org: unique `gahs_` prefix for all code, options, 
   shortcodes and handles; fixed activation on older MySQL versions; bundled admin
   font (opt-in, no external requests); targeted LiteSpeed Cache support; separate
   toggles for official and custom events on the Month Calendar.

#### 1.0.0

 * شروع و پیاده‌سازی (Initial development and implementation).

Full history: CHANGELOG.md in the plugin package.

## Meta

 *  Version **1.0.2**
 *  Last updated **4 days ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.2 or higher **
 *  Tested up to **7.1.3**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [calendar](https://wordpress.org/plugins/tags/calendar/)[events](https://wordpress.org/plugins/tags/events/)
   [Jalali](https://wordpress.org/plugins/tags/jalali/)[persian](https://wordpress.org/plugins/tags/persian/)
 *  [Advanced View](https://wordpress.org/plugins/nik-zoroastrian-calendar/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/nik-zoroastrian-calendar/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/nik-zoroastrian-calendar/reviews/)

## Contributors

 *   [ Maziyar Nikbakhsh ](https://profiles.wordpress.org/vestar/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/nik-zoroastrian-calendar/)