Descripción
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.
External services
This plugin connects to the Hebcal Shabbat Times API (https://www.hebcal.com/shabbat/) to retrieve the Torah portion, candle lighting, Havdalah and related times that the shortcode displays.
When a page containing the shortcode is rendered (and no cached result exists; results are cached for 15 minutes), the plugin sends the location given in the shortcode: either a zip code, or a longitude, latitude and time zone ID. No visitor data is sent; only the values written in your shortcode, plus the server’s IP address as part of the normal HTTP request.
This service is provided by Hebcal.com. Its API terms of use (Creative Commons Attribution 4.0 license, attribution to Hebcal.com required) are described on the Hebcal Developer APIs page and in the license text. See also the Hebcal Privacy Policy.
Capturas
Bloques
Este plugin provee 1 bloque.
- Shabbat Times Display the weekly Torah portion, candle lighting and Havdalah times from Hebcal.
Instalación
- 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
Preguntas frecuentes
-
What does it do?
-
It simple gives a few shortcodes to display the Shabbat lighting times. Watch the video to see what it does:
-
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
- holiday
-
Thanks
-
Thanks goes to the team at Hebcal.com. The plugin just grabs the information from the JSON feed by hebcal.com.
Reseñas
No hay reseñas para este plugin.
Colaboradores y desarrolladores
“Weekly Shabbat Times” es un software de código abierto. Las siguientes personas han colaborado con este plugin.
Colaboradores
Traduce “Weekly Shabbat Times” a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN , o suscríbete al log de desarrollo por RSS .
Registro de cambios
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