Title: Weekly Shabbat Times
Author: Aaron Reimann
Published: <strong>30 de agosto de 2018</strong>
Last modified: 12 de noviembre de 2026

---

Buscar plugins

![](https://ps.w.org/weekly-shabbat-times/assets/icon-256x256.png?rev=3735318)

# Weekly Shabbat Times

 Por [Aaron Reimann](https://profiles.wordpress.org/areimann/)

[Descargar](https://downloads.wordpress.org/plugin/weekly-shabbat-times.1.4.0.zip)

 * [Detalles](https://es.wordpress.org/plugins/weekly-shabbat-times/#description)
 * [Valoraciones](https://es.wordpress.org/plugins/weekly-shabbat-times/#reviews)
 *  [Instalación](https://es.wordpress.org/plugins/weekly-shabbat-times/#installation)
 * [Desarrollo](https://es.wordpress.org/plugins/weekly-shabbat-times/#developers)

 [Soporte](https://wordpress.org/support/plugin/weekly-shabbat-times/)

## 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](https://www.hebcal.com/home/developer-apis)
and in the [license text](https://creativecommons.org/licenses/by/4.0/). See also
the Hebcal [Privacy Policy](https://www.hebcal.com/home/privacy-policy).

## Capturas

[⌊Frontend display featuring the modern card layout, weekly summary list, single
candle lighting, and Hebrew RTL mode.⌉⌊Frontend display featuring the modern card
layout, weekly summary list, single candle lighting, and Hebrew RTL mode.⌉[

Frontend display featuring the modern card layout, weekly summary list, single candle
lighting, and Hebrew RTL mode.

[⌊Gutenberg block editor showing the Shabbat Times block with sidebar inspector 
controls.⌉⌊Gutenberg block editor showing the Shabbat Times block with sidebar inspector
controls.⌉[

Gutenberg block editor showing the Shabbat Times block with sidebar inspector controls.

[⌊Elementor page builder showing the Shabbat Times widget and panel settings.⌉⌊Elementor
page builder showing the Shabbat Times widget and panel settings.⌉[

Elementor page builder showing the Shabbat Times widget and panel settings.

[⌊Beaver Builder page builder showing the Shabbat Times module settings dialog.⌉⌊
Beaver Builder page builder showing the Shabbat Times module settings dialog.⌉[

Beaver Builder page builder showing the Shabbat Times module settings dialog.

## Bloques

Este plugin proporciona 1 bloque.

 *   Shabbat Times Display the weekly Torah portion, candle lighting and Havdalah
   times from Hebcal.

## Instalación

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

## FAQ

### 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

### 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 valoraciones 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

 *   [ Aaron Reimann ](https://profiles.wordpress.org/areimann/)

[Traduce «Weekly Shabbat Times» a tu idioma.](https://translate.wordpress.org/projects/wp-plugins/weekly-shabbat-times)

### ¿Interesado en el desarrollo?

[Revisa el código](https://plugins.trac.wordpress.org/browser/weekly-shabbat-times/),
echa un vistazo al [repositorio SVN](https://plugins.svn.wordpress.org/weekly-shabbat-times/)
o suscríbete al [registro de desarrollo](https://plugins.trac.wordpress.org/log/weekly-shabbat-times/)
por [RSS](https://plugins.trac.wordpress.org/log/weekly-shabbat-times/?limit=100&mode=stop_on_copy&format=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

## Meta

 *  Versión **1.4.0**
 *  Última actualización **hace 3 días**
 *  Instalaciones activas **10+**
 *  Versión de WordPress ** 4.7 o superior **
 *  Probado hasta **7.2**
 *  Versión de PHP ** 7.2 o superior **
 *  Idioma
 * [English (US)](https://wordpress.org/plugins/weekly-shabbat-times/)
 * Etiquetas:
 * [elementor](https://es.wordpress.org/plugins/tags/elementor/)[gutenberg](https://es.wordpress.org/plugins/tags/gutenberg/)
   [hebcal](https://es.wordpress.org/plugins/tags/hebcal/)[jewish](https://es.wordpress.org/plugins/tags/jewish/)
   [Shabbat](https://es.wordpress.org/plugins/tags/shabbat/)
 *  [Vista avanzada](https://es.wordpress.org/plugins/weekly-shabbat-times/advanced/)

## Valoraciones

Aún no se han enviado valoraciones.

[Tu valoración](https://wordpress.org/support/plugin/weekly-shabbat-times/reviews/#new-post)

[Ver todas las reseñas](https://wordpress.org/support/plugin/weekly-shabbat-times/reviews/)

## Colaboradores

 *   [ Aaron Reimann ](https://profiles.wordpress.org/areimann/)

## Soporte

¿Tienes algo que decir? ¿Necesitas ayuda?

 [Ver el foro de soporte](https://wordpress.org/support/plugin/weekly-shabbat-times/)

## Donar

¿Te gustaría apoyar el progreso de este plugin?

 [ Dona a este plugin ](https://aaronreimann.com)