HB Jewish Calendar

Description

HB Jewish Calendar provides accurate Hebrew date information, weekly Torah portions (Parasha), zmanim (Jewish times), and a fully client-side monthly Hebrew calendar. Calculations are performed in the browser using the bundled ‘Hebcal’ library.

Key capabilities:

• Shortcodes to embed a monthly Hebrew calendar, today’s Hebrew date, current weekday, Parasha and individual zmanim values (with optional minute offset).
• Elementor widgets mirroring the shortcodes, grouped under the “Hebrew Calendar” category, with style and prefix controls.
• Admin settings to select a city (used for zmanim) and toggle Parasha Israel/Diaspora behavior.

Features

• Shortcodes:
  • jcal_heb_calendar — Embed a monthly Hebrew calendar with holidays.
  • jcal_today_hdate — Show today’s Hebrew date.
  • jcal_day_in_week — Show the current weekday name.
  • jcal_parasha — Show this week’s Parasha (Israel / Diaspora controlled in settings).
  • jcal_zmanim — Show a specific zman (Jewish time); supports type and offset attributes.
• Elementor widgets for the same features (category: “Hebrew Calendar”): Hebrew Calendar, Today hebrew date, Parashat hashavua, Zmanim, Day in week.
• Settings page (JCal Settings) to choose city for zmanim and set Parasha display (Israel or Diaspora).
• Localized: supports both Hebrew and English.
• All date & holiday calculations are performed client-side using the bundled ‘Hebcal’ library.

Usage

Shortcodes:

• [jcal_heb_calendar] — Renders the monthly Hebrew calendar. The calendar also displays holidays.
• [jcal_today_hdate] — Outputs today’s Hebrew date (localized to site language).
• [jcal_day_in_week] — Outputs the current weekday name (localized).
• [jcal_parasha] — Outputs the current Parasha. Use settings to choose Israel or Diaspora version.
• [jcal_zmanim type="<type>" offset="<minutes>"] — Outputs a zman value. type is one of:
  • chatzotNight, alotHaShachar, alotHaShachar72, neitzHaChama, sunrise,
  • sofZmanShma, sofZmanShmaMGA, sofZmanShmaMGA16Point1, sofZmanTfilla, sofZmanTfillaMGA,
  • sofZmanTfillaMGA16Point1, chatzot, minchaGedola, minchaGedolaMGA, minchaKetana,
  • minchaKetanaMGA, plagHaMincha, sunset, shkiah, beinHaShmashos, dusk,
  • tzeit, misheyakir.
  • offset is an integer number of minutes to add/subtract.

Elementor widgets: find the “Hebrew Calendar” category in Elementor; widgets provide style controls, optional prefixes and allow inserting the same shortcodes as elements.

Settings Page

Access: WP Admin → JCal Settings (menu entry appears for users with manage_options).

• City: choose a city (used for zmanim calculations).
• Parasha Display: choose Israel or Diaspora to control how the weekly Parasha is determined.

Localization

Translation files are included in the languages/ directory. The plugin uses the text domain hb-jewish-calendar.

Credits

Developed by HBCode.

This plugin bundles a minified build of the Hebcal library (js/hebcal.min.js) for client-side Hebrew calendar calculations:
https://github.com/hebcal/hebcal-es6

Hebcal is provided under the Creative Commons Attribution 4.0 International License (CC BY 4.0). See Hebcal for details and privacy policy: https://www.hebcal.com/home/privacy-policy

Support

For support, contact the developer.

License

This plugin is licensed under GPL v3 or later: https://www.gnu.org/licenses/gpl-3.0.html