(none at this time)<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3239767,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.0.0","1.0.1","1.1.0","2.0.0","2.1.0","2.1.1","2.2.0","2.2.1","2.2.2","2.2.3","2.3.0","2.4.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3239453,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3239453,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3239453,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3239453,"resolution":"4","location":"assets","locale":""},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3239453,"resolution":"5","location":"assets","locale":""},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3239453,"resolution":"6","location":"assets","locale":""},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3239453,"resolution":"7","location":"assets","locale":""}},"screenshots":{"1":"Zmanim WP initial page where you set the location, set nusach, and more.","2":"Standard zmanim settings (1 of 3)","3":"Standard zmanim settings (2 of 3)","4":"Standard zmanim settings (3 of 3)","5":"Options to determine if Shabbat is \"early\", along with the 4 shortcode options","6":"Settings to set the full year display, plus the columns to display.","7":"A sample page with the shortcodes on the left and the result on the right"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[247042],"plugin_category":[],"plugin_contributors":[88426],"plugin_business_model":[],"class_list":["post-220461","plugin","type-plugin","status-publish","hentry","plugin_tags-time-zmanim-jewish","plugin_contributors-adatosystems","plugin_committers-adatosystems"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/zmanim-wp\/assets\/icon-256x256.png?rev=3239767","icon_2x":"https:\/\/ps.w.org\/zmanim-wp\/assets\/icon-256x256.png?rev=3239767","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/zmanim-wp\/assets\/screenshot-1.png?rev=3239453","caption":"Zmanim WP initial page where you set the location, set nusach, and more."},{"src":"https:\/\/ps.w.org\/zmanim-wp\/assets\/screenshot-2.png?rev=3239453","caption":"Standard zmanim settings (1 of 3)"},{"src":"https:\/\/ps.w.org\/zmanim-wp\/assets\/screenshot-3.png?rev=3239453","caption":"Standard zmanim settings (2 of 3)"},{"src":"https:\/\/ps.w.org\/zmanim-wp\/assets\/screenshot-4.png?rev=3239453","caption":"Standard zmanim settings (3 of 3)"},{"src":"https:\/\/ps.w.org\/zmanim-wp\/assets\/screenshot-5.png?rev=3239453","caption":"Options to determine if Shabbat is \"early\", along with the 4 shortcode options"},{"src":"https:\/\/ps.w.org\/zmanim-wp\/assets\/screenshot-6.png?rev=3239453","caption":"Settings to set the full year display, plus the columns to display."},{"src":"https:\/\/ps.w.org\/zmanim-wp\/assets\/screenshot-7.png?rev=3239453","caption":"A sample page with the shortcodes on the left and the result on the right"}],"raw_content":"\n
As with most WordPress plugins, you download the zip file and Activate the plugin through the 'Plugins' menu in WordPress.<\/p>\n\n\n
(none at this time)<\/p>\n\n\n
This plugin lets you configure a variety of halachic time calculations and add them via shortcodes.<\/p>\n\n
This plugin lets WordPress administrators configure a variety of shitot (halachic opinions) on time calculation. A series of shortcodes, along with standard options to control the date, formatting, time offset, and more. These shortcodes can be used to display the zmanim (times) in any post, page, widge, or even outbound email coming from the site.<\/p>\n\n
This plugin would not be possible without the amazing kosher java<\/a> library by Eliyahu Hershveld<\/a>, which has been ported to PHP<\/a> by the incredible Zachary Weixelbaum<\/a>.<\/p>\n\n For a synagogue or other (Jewish) religious institution, providing times for daily tefillot prayers, fasts, and events (candle lighting, sundown, etc) is not only critical to the mission of the organization, but extremely work-intensive. Either an admin had to go in and change those times by hand (sometimes daily); or link to external sources (hebcal.com<\/a>,myzmanim.com<\/a>, or even google spreadsheets).<\/p>\n\n These options had multiple drawbacks, the most critical among them being:\n \u2013 the times provided by the external source can't be customized (to show 5 minutes before Mincha Gedola, for example)\n \u2013 the times can't be displayed on the page or post, but rather only allow for a link that takes the visitor out of the organization's website.\n \u2013 No support for the full range of WordPress options (pages, posts, widgets, automatic emails, etc)<\/p>\n\n Zmanim WP addresses all of these issues and more.<\/p>\n\n First, the WordPress admin provides location information and selects from a range of shitot (halachic opinions) which will use the kosher java library<\/a> by Eliyahu Hershveld<\/a>. This sets up the fundamental time calculations.<\/p>\n\n Next, pages, posts, widges, etc can be created using a comprehensive list of shortcodes which allow the display of various zmanim across the website.<\/p>\n\n The admin page options and shortcodes are described in detail below.<\/p>\n\n The admin panel lets you set some basic information about the website \u2013 location, name, etc \u2013 and also select from a list of pre-set time calculation systems.<\/p>\n\n For the drop-down selections (Alot Hashachar, Misheyakir, etc), there is a detailed explanation of each option at the bottom of this README file.<\/p>\n\n Details information appear below.<\/p>\n\n On the initial page, you can set the following items:<\/p>\n\n \u2013 Time Zone \u2013 The IANA Time Zone<\/a> formatted string for the time zone of the website. All time calculations will take this time zone into consideration. \n \u2013 Latitude\/Longitude \u2013 The standard latitude and longitude for this location.\n \u2013 Location Name \u2013 Any name you want to give.\n \u2013 Molad Text \u2013 The text which will be used as the title for the section announcing the Molad. This can include HTML formatting.\n \u2013 Rosh Chodesh Text \u2013 The text which will be used as the title for the section announcing Rosh Chodesh. This can include HTML formatting.<\/p>\n\n The standard times page is where you select your shitot for each of the various zmanim. Open the drop-down next to each item and select the appropriate shita. For a brief explanation of each of the zmanim, see this page on the Orthodox Union web site<\/a>.<\/p>\n\n \u2013 Candle Offset \u2013 Time, in minues, before shkia that candles will be lit for Shabbat\n \u2013 Alot Hashachar \u2013 \"daybreak\", or the time when some light is visible. \n \u2013 Misheyakir \u2013 the time when one can put on Tallit and Tefillin.\n \u2013 Sha'ah Zmanim \u2013 A halachic hour, or 1\/12 of the available daylight time.\n \u2013 Sof Zman Kria Shema \u2013 the latest time one can say Shema.\n \u2013 Sof Zman Tefilla \u2013 the latest time one can pray Shacharit.\n \u2013 Mincha Gedola \u2013 The earliest time one can pray Mincha\n \u2013 Mincha Ketana \u2013 by some authorities, the preferable time to pray Mincha\n \u2013 Plag HaMincha \u2013 the mid-point between Mincha Ketana and sunset, and and used for various decisions about when to light candles, pray on Friday, etc.\n \u2013 Start of Bain HaShmashot \u2013 \"Twilight\", or the time between Shkia (sunset) and Tzait haKochavim (nightfall)\n \u2013 Tzait haKochavim \u2013 \"Nightfall\", or the starting time for varios mitzvot that are to be performed at night.<\/p>\n\n NOTE: Netz haChama (sunrise) and Shkia (sunset) are always calculated using nautical sunrise \/ sunset at sea level for the given latitude and longitude.<\/p>\n\n Some congregations prefer to switch to \"early\" times to begin Shabbat between spring and fall, when days are longer. The Zmanim WP plugin allows you to automatically set the start and stop date based on:<\/p>\n\n \u2013 A Gregorian (secular) date\n \u2013 A Hebrew date\n \u2013 When either plag or sunset (Shkia) occur after a set time\n \u2013 During daylight savings time<\/p>\n\n You can identify the start and end date for early Shabbat based on a single condition above, or based on a combination of the above factors.<\/p>\n\n Once set, there are four available shortcodes: [zman_early_shabbat_1] through [zman_early_shabbat_4]. Each shortcode has possible results: something to display when it's early Shabbat, and something to display when it's regular time.<\/p>\n\n You can set the early\/regular display using any combination of plain text, HTML, and other Zmanim WP shortcodes.<\/p>\n\n Example 1: early Mincha (on Friday only) should be 20 minutes before Plag haMincha. Regular Mincha should be 22 minutes before Shkia (sunset). For this you'd set the \"Early Calculation\" to be: [zman_plag offset=-20 date=\"friday\"]. And the \"Regular Calculation\" to: [zman_sunset offset=-22 date=\"friday\"]<\/p>\n\n Example 2: On Friday nights, Shir haShirim is sung either 35 minutes before Plag haMincha (if it's early Shabbat); or after Kabbalat Shabbat (if it's regular time). For this you'd set the \"Early Calculation\" to: [zman_plag offset=-35 date=\"friday\"]; and the \"Regular Calculation\" to: \"after Kabbalat Shabbat\"<\/p>\n\n Many congregations like to publish a full year's worth of zmanim, in column-and-row format. This page allows for a grid of times with the following configuration options:<\/p>\n\n At the top of the page, the administrator chooses whether the display will start on January 1 (and sets the year); or 1 Tishrei (and sets the year).<\/p>\n\n NOTE: the correct (secular \/ Hebrew) year must be used in combination with start date.\nALSO NOTE: Leaving this blank will default to the current year.<\/p>\n\n Finally, select whether the rows will display each day, or just a single day in each week. If \"weekly\" is chosen, the day of the week to display is also required.<\/p>\n\n Then, in the table display at the bottom of the page, the admin will set the column titles and what should display in each column.<\/p>\n\n \u2013 The titles can contain any combination of text and HTML.\n \u2013 The actual display should can use any combination of text, HTML, and Zmanim WP shortcodes.<\/p>\n\n NOTE: Up to 10 columns are available.<\/p>\n\n To use this feature, add the shortocde \"[zman_fullyear]\" once on a post or page. The entire table will be rendered whenever it's displayed.<\/p>\n\n Shortcodes are the primary focus of the Zmanim WP plugin. While configuration seems important at first, it's generally a one-time activity. As a reminder, these shortcodes can can be used in almost any area of the WordPress system including Posts, Pages, Widgets, and any other element (whether it's built-in or an add-on option via another plugin) that supports shortcodes.<\/p>\n\n Broadly speaking, shortcodes consist of a keyword surrounded by square brackets. For this Zmanim WP, all shortcodes begin with the\u00a0zman_\u00a0prefix.<\/p>\n\n Example:\n[zman_alot]<\/p>\n\n Most of the Zmanim WP shortcodes will take optional parameters after the main keyword. These parameters allow administrators to control everything from the language used to the format a time appears in to an offset of minutes before or after the calculated zman.<\/p>\n\n Examples:\n1) Display the Torah Portion in Hebrew rather than English:\n[zman_parsha lang=\"hebrew\"]<\/p>\n\n 2) Display the time 20 minutes before Shkia (sunset):\n[zman_sunset offset=-20]<\/p>\n\n 3) Display the time for misheyakir, but show military style time with seconds and am\/pm:\n[zman_misheyakir dateformat='H:i:s a']<\/p>\n\n The parameters which are available across all (or at least most) Zmanim WP shortcodes are:\n \u2013 date: Indicates relative or specific date you want. Valid options include:\n \u2013 today \u2013 show the time for the current date (when the page \/ post is being viewed)\n \u2013 tomorrow \u2013 show the time for the day after the current date\n \u2013 sunday, monday, tuesday, etc \u2013 show the time for the next upcoming weekday indicated.\n \u2013 (actual date) \u2013 Any reasonable date format (2023-01-20, Jan 20, 2023, 1\/20\/23, etc.) will show the time for that specific date.<\/p>\n\n Example: Notes: Leaving this option blank defaults to \"today\".<\/p>\n\n \u2013 offset: A number of minutes (including fractions \u2013 i.e. 10.5), either positive or negative, to adjust the time by.<\/p>\n\n Example: Notes: Leaving this option blank defaults to 0. If no sign (+ or -) is given, the number is assumed to be positive.<\/p>\n\n \u2013 dateformat: this takes PHP codes to format the output. Here's a nice tutorial<\/a> on those codes. And here is the full PHP page<\/a> on the topic.<\/p>\n\n Example: Notes: Leaving this option blank defaults to \"h:i a\", or hh:mm am\/pm (i.e.: 10:32 pm).<\/p>\n\n The following parameters only work with certain Zmanim WP shortcodes.<\/p>\n\n lang<\/strong>\nIt displays the information in English (the default) or Hebrew. Applies to: Rosh Chodesh ([zman_chodesh]), the Molad ([zman_molad]), and the Parsha ([zman_parsha]).\nExample: month<\/strong>\nIndicates a specific Hebrew month. Applies to: Rosh Chodesh ([zman_chodesh]) and the Molad ([zman_molad]).<\/p>\n\n Valid options include:<\/p>\n\n \u2013 this \u2013 show information for the end of this month, beginning of next month.\n \u2013 next \u2013 show information for the end of next month.\n \u2013 Specify a particular month, by number. This uses the Hebrew month numbering, with Nissan = 1.<\/p>\n\n Example: [zman_chodesh month=1 ]<\/p>\n\n NOTE: If you specify a year (see below), you may get Rosh Chodesh for a date which has already passed (i.e.: If you ask for month=4 (Tammuz), and it's already Elul (month 6))<\/p>\n\nUsage \u2013 the Admin Panel<\/h3>\n\n
Zmanim WP Page<\/h3>\n\n
Standard Times<\/h3>\n\n
Early Shabbat Options\\*<\/h3>\n\n
Full Year Display\\*<\/h3>\n\n
Using the shortcodes<\/h3>\n\n
Shortcode Options<\/h3>\n\n
[zman_alot date=\"Wednesday\"]<\/code>\nExample: [zman_alot date=\"2023-01-20\"]<\/code><\/p>\n\n[zman_alot offset=-10]<\/code>\nExample: [zman_alot offset=20]<\/code>\nExample: [zman_alot offset=+20]<\/code><\/p>\n\n[zman_alot dateformat=\"m\/d\/Y h:i:s a\"]<\/code><\/p>\n\nSpecial-case shortcode options<\/h3>\n\n
[zman_parsha lang=\"hebrew\"]<\/code><\/p>\n\n