Posted by & filed under Developers, APIs, RSS Feeds, Source Code.

To display a Jewish calendar on your website, you can use event data from Hebcal.com and the open source JavaScript event calendar from fullcalendar.io.

First, you’ll want to start by including the CSS and JS in your header, per the FullCalendar Basic Usage.

Then, for the events configuration, use a url that references our Jewish calendar REST API, but change cfg=json to cfg=fc. For best performance, be sure to use cache: true.

Here’s the FullCalendar invocation:

We recommend some specific styles to make the page look prettier:

Here’s a complete example that uses the aforementioned JS + CSS, and also includes the necessary stuff to load FullCalendar.io and dependencies via CDN:

Posted by & filed under Candle lighting.

Hebcal offers a way to specify candle-lighting times location by latitude and longitude for remote or less-populated areas.

Hebcal supports already over 45,000 world cities. Just search for the name of any world city with population 5,000+. However, if you can’t find what you’re looking for in our location database, here’s how you could find candle-lighting times for a specific location.

Example: Ixiamas, Bolivia.

  1. Go to the Getty Thesaurus of Geographic Names at http://www.getty.edu/research/tools/vocabulary/tgn/
  2. Type “Ixiamas” in the Find box and click “Search” button
  3. Click on the link that says “Ixiamas… inhabited place”
  4. Note the latitude/longitude represented in “degrees minutes direction” (in the example of Ixiamas, La Paz, Bolivia it is Lat: 13 45 S and Long: 068 10 W) and write this information down on a sheet of paper
  5. Visit the Hebcal Custom Calendar latitude/longitude page at http://www.hebcal.com/hebcal/?c=on;geo=pos
  6. Type the latitude and longitude into the form (13 degrees, 45 minutes South Latitude, 68 degrees 10 minutes West Longitude)
  7. Select the Time zone option specific to your location (see Wikipedia’s List of tz database time zones)
  8. Click “Get Calendar” button at the bottom of the form

Posted by & filed under Download - Microsoft Outlook.

Follow these instructions to add a Hebcal Jewish holiday calendar 5-year feed to newer versions of Microsoft Outlook.

This technique uses Outlook’s “Internet Calendar Subscription” feature which keeps a separate calendar from your primary calendar. The calendar appears as an “overlay” and can be managed separately from your main calendar.

This method is preferred for newer versions, e.g. Outlook 2010, Outlook 2010, Outlook 2013, Office 365. If you plan to sync Outlook with a BlackBerry, consider using the old-style Outlook CSV instructions instead.

  1. Open a web browser on your Microsoft Windows computer.
    1. to download holidays and candle-lighting times, navigate to http://www.hebcal.com/hebcal/
    2. OR, to download Yahrzeit + Anniversary calendar, navigate to to http://www.hebcal.com/yahrzeit/
  2. Fill out the form with your preferences and click the Create Calendar button
  3. Click the Download… button
    Jewish_Calendar_2014_Providence___Hebcal_Jewish_Calendar
  4. Select the Outlook option from the Download dialog box
    Outlook Jewish calendar download dialog box v2
  5. Click on the Download Outlook Internet Calendar Subscription button
  6. You might be prompted to acknowledge that you are opening a hyperlink. You should click Yes.
  7. Microsoft Office Outlook 2007, 2010, or 2013 will start up
  8. At the prompt, Add this Internet Calendar to Outlook and subscribe to updates, click Yes.
  9. The Internet Calendar opens in side-by-side view in the Outlook Calendar and is added to the Navigation Pane in Calendar view under Other Calendars. The calendar will check periodically for any updates made by the calendar publisher.

For more details, see Add an Internet Calendar Subscription to Outlook from Microsoft’s support site.

Included in the Hebcal Jewish holiday downloads are options to select major holidays (Rosh Hashana, Yom Kippur, Pesach, etc.), minor holidays (Purim, Chanukah, etc.), special Shabbatot, public fasts (Tish’a B’Av, etc.), Rosh Chodesh, and modern holidays (Yom HaAtzma’ut, etc.).

Posted by & filed under Download - Microsoft Outlook.

Follow these instructions to add a Hebcal Jewish holiday calendar 5-year feed to older versions of Microsoft Outlook.

First, you’ll need to download an Outlook CSV (Comma-separated values) file from hebcal.com:

  1. Open a web browser on your Microsoft Windows computer.
    1. to download holidays and candle-lighting times, navigate to http://www.hebcal.com/hebcal/
    2. OR, to download Yahrzeit + Anniversary calendar, navigate to to http://www.hebcal.com/yahrzeit/
  2. Fill out the form with your preferences and click the Create Calendar button
  3. Click the Download… button
    Jewish_Calendar_2014_Providence___Hebcal_Jewish_Calendar
  4. Select the CSV option from the Download dialog box
    CSV Jewish calendar download dialog box
  5. In the dialog box, select one of the two Download buttons – either Outlook CSV – USA date format (month/day/year) or Outlook CSV – European date format (day/month/year) (depending on whether you want USA or European date formats).
  6. When prompted, specify a convenient name and location for the hebcal_DATE_LOCATION.csv file in the “Save As” dialogue box. We recommend saving the file on the Desktop

Next, import that file into Outlook:

  1. Open Microsoft Outlook
  2. Select the File -> Import and Export… menu option
  3. Select “Import from another program or file” and click Next
  4. Select “Comma Separated Values (Windows)” and click Next
  5. Find the hebcal_DATE_LOCATION.csv file you downloaded and select “Do not import duplicate items” and click Next
  6. Select Calendar and click Next. This will import your chosen file
  7. (optional) Synchronize your Pocket PC or Palm handheld with Outlook

For specific instructions for a particular version of Outlook, please see the “How to Import Text Data” section of one of these articles:

Included in the Hebcal Jewish holiday downloads are options to select major holidays (Rosh Hashana, Yom Kippur, Pesach, etc.), minor holidays (Purim, Chanukah, etc.), special Shabbatot, public fasts (Tish’a B’Av, etc.), Rosh Chodesh, and modern holidays (Yom HaAtzma’ut, etc.).

Posted by & filed under Download - Apple Mac OS X iCal.

Follow these instructions to subscribe to a Hebcal Jewish holiday calendar 5-year feed in Calendar.app on Mac OS X desktop:

  1. Open a web browser on your Mac OS X computer.
    1. to download holidays and candle-lighting times, navigate to http://www.hebcal.com/hebcal/
    2. OR, to download Yahrzeit + Anniversary calendar, navigate to to http://www.hebcal.com/yahrzeit/
  2. Fill out the form with your preferences and click the Create Calendar button
  3. Click the Download… button
    Jewish_Calendar_2014_Providence___Hebcal_Jewish_Calendar
  4. Click on the “Mac OS X” option from the Download dialog box
    Apple Mac OS X Jewish calendar download dialog box
  5. Click on the “Download to Mac Calendar” button
  6. Apple Calendar (OS X Mountain Lion and later) or iCal (OS X Lion and earlier) will start up
  7. Click Subscribe in the “Calendar URL:” dialog box (see screenshot below)
    Enter the url of the calendar you want to subscribe to
  8. In the next dialog box, uncheck the “Remove Alerts” option if you wish to be notified of candle-lighting and Havdalah times.
    Mac OS X Calendar Info dialog box v3
  9. Use Location: iCloud if you wish to synchronize with other Apple devices such as iPhone or iPad. Use Location: On My Mac if you wish to have the calendar subscription only on your desktop.
  10. Click OK

Included in the Hebcal Jewish holiday downloads are options to select major holidays (Rosh Hashana, Yom Kippur, Pesach, etc.), minor holidays (Purim, Chanukah, etc.), special Shabbatot, public fasts (Tish’a B’Av, etc.), Rosh Chodesh, and modern holidays (Yom HaAtzma’ut, etc.).