Weekly Shabbat Times

开发者	areimann jfennell
更新时间	2026年10月9日 02:17
捐献地址:	去捐款
PHP版本:	7.2 及以上
WordPress版本:	7.1
版权:	GPLv2 or later
版权网址:	版权信息

下载

1.2.0 1.4.0 1.0.0 1.1.0

详情介绍:

Display the weekly Torah portion, candle lighting times, Havdalah times and more, powered by Hebcal.com.

Gutenberg block - "Shabbat Times" with a live preview, modern card or list layout, weekly summary or single-value mode, English or Hebrew, and your site's color and typography settings.
Elementor widget - "Shabbat Times" in the General category, with layout presets (card / list), location, display and style controls.
Beaver Builder module - "Shabbat Times" in the Basic category, with layout presets, location and display controls.
Modern Card Layout - optional elegant card display (layout="card") with candle and wine icons and badge times.
Torah & Haftarah Leyning - display weekly Torah portion (param="torah"), Haftarah (param="haftarah"), and Maftir.
Custom Havdalah Minutes - customize Havdalah past sunset (e.g. 42, 50, 72 minutes) globally or per shortcode/block.
12-Hour & 24-Hour Formats - display times in either standard 12-hour (6:53pm) or European/military 24-hour (18:53) formats.
High-Availability Fallback Cache - resilient stale-cache fallback ensures your site never displays an empty widget during transient API outages.
Settings page (Settings > Shabbat Times) - configure site-wide default location, candle lighting minutes, Havdalah offset, time format, and RTL.
Candle lighting minutes before sunset, adjustable (default 18).
Hebrew-only RTL mode with right-to-left styling.
Shortcode - [hebcal_sc] works anywhere, including post titles.

安装:

Unzip and upload the plugin into the plugins directory and then activate it.
Grab a shortcode example and place it in the content of a page
View the page

屏幕截图:

升级注意事项:

1.3.0 Adds a Gutenberg block, an Elementor widget, a Beaver Builder module and a weekly summary display. 1.2.0 Security hardening, per-location caching and compliance fixes.

常见问题:

What does it do?

It simple gives a few shortcodes to display the Shabbat lighting times. Watch the video to see what it does: [youtube https://www.youtube.com/watch?v=ztzHENB9g7Y]

Why did you write this plugin?

My synagogue needed to display the current Portion on the website and I couldn't find a good plugin to do this. This allows me to display the shortcode in the title of a post/page or within the content of a page/post.

How do I use the block, Elementor widget or Beaver Builder module?

Add the "Shabbat Times" block, Elementor widget or Beaver Builder module, enter a US zip code or a longitude, latitude and time zone ID, and choose either the weekly summary or a single value.

How do I use the shortcode?

To show the modern card layout: [hebcal_sc display="summary" layout="card" zip="30066"] To show the classic bulleted list (v1.0–v1.3 legacy look): [hebcal_sc display="summary" layout="list" zip="30066"] (or layout="classic") Options:

zip: US zip code.
longitude, latitude, tzid: Coordinates & timezone ID.
display: "summary" or "single".
layout: "card" (modern card), "list" / "classic" (legacy unstyled list), or "inline" (single value). Configurable site-wide in Settings.
icon: "yes" (adds 🕯️ / 🍷 icon) or "no".
param: "title", "time", "hebrew", "torah", "haftarah", "maftir", "date".
time_format: "12h" (e.g. 6:53pm) or "24h" (e.g. 18:53).
candle_minutes: Minutes before sunset (e.g. "18", "40").
havdalah_minutes: Minutes past sunset (e.g. "42", "50", "72").
rtl: "yes" for Hebrew right-to-left output. Example shortcodes:

[hebcal_sc display="summary" layout="card" zip="30066"] (modern card with portion, candles, havdalah) [hebcal_sc display="summary" layout="list" zip="30066"] (classic list for full backwards compatibility) [hebcal_sc category="candles" param="title" zip="30066"] (outputs plain text: Candle lighting: 6:53pm) [hebcal_sc category="candles" param="time" zip="30066"] (outputs time only: 6:53pm) [hebcal_sc category="candles" param="time" icon="yes" zip="30066"] (outputs with emoji: 🕯️ 6:53pm) [hebcal_sc category="candles" param="time" time_format="24h" zip="30066"] (outputs 24h: 18:53) [hebcal_sc category="parashat" param="torah" zip="30066"] (outputs Torah portion reading) [hebcal_sc category="parashat" param="haftarah" zip="30066"] (outputs Haftarah reading) [hebcal_sc category="havdalah" param="time" havdalah_minutes="50" zip="30066"] (custom Havdalah offset) [hebcal_sc category="candles" param="hebrew" zip="30066"] (outputs Hebrew: הדלקת נרות) Example shortcode using Longitude, Latitude, and Time Zone ID: [hebcal_sc category="candles" param="title" longitude="-84.500434" latitude="34.024356" tzid="America/New_York"] You can get a list of timezone ID's by going to [https://en.wikipedia.org/wiki/List_of_tz_database_time_zones]https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Possible categories from the feed

holiday
roshchodesh
candles
parashat
havdalah

Thanks

Thanks goes to the team at Hebcal.com. The plugin just grabs the information from the JSON feed by hebcal.com.

更新日志:

1.4.0

New: Modern Card Layout preset (layout="card"), with candle & wine badges.
New: Torah & Haftarah reading portion fields (param="torah", param="haftarah", param="maftir").
New: Havdalah calculation preference / custom minutes past sunset (havdalah_minutes="50" or global setting).
New: 12-Hour vs. 24-Hour time formatting option (time_format="12h"|"24h" or global setting).
New: High-availability stale-cache fallback ensures continuous display during upstream API hiccups.
New: Block, Elementor widget, and Beaver Builder module controls updated with card layout, Havdalah offset, 24h format, and reading portions.

1.3.0

New: Gutenberg block "Shabbat Times" with live preview.
New: Elementor widget "Shabbat Times".
New: Beaver Builder module "Shabbat Times".
New: weekly summary display (portion, candle lighting, Havdalah), also available as display="summary" in the shortcode.
New: Settings page with a default location (zip or longitude/latitude/time zone), used whenever a shortcode, block or widget has none.
New: candle lighting minutes before sunset (candle_minutes="40", block/widget field, or site default).
New: Hebrew-only right-to-left mode (rtl="yes", block/widget field, or site default).
New: "Time only" field option (param="time") to display just the time (e.g. "6:53pm") without the title label.
Removed an unused co-author credit.

1.2.0

Fix stable tag, tested up to and license declarations.
Document the Hebcal external service.
Escape shortcode and title filter output.
Use wp_remote_get() with error handling instead of file_get_contents().
Cache results per location (previously one cache entry was shared by all locations).
PHP 7.2 through 8.5 compatibility.

1.1.0

Adds longitude and latitude to the shortcode so you can drop in your longitude, latitude, and timezone ID.

1.0.0

Initial release