=== Zmanim WP ===
Contributors: AdatoSystems
Donate link: https://adatosystems.com
Tags: #time #zmanim #jewish
Tested up to: 7.0
Stable tag: 2.7.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

This plugin lets you configure a variety of halachic time calculations and add them via shortcodes. 

== Zmanim WP ==
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.

For detailed information on how it works, including how to set shitot and the shortcode options available, see: [https://adatosystems.com/zmanim-wp/](https://adatosystems.com/zmanim-wp/).

The shortcodes available are:
**Location and Reference**
- zman_location - Displays the location, as defined on the admin page.
- zman_lat - Shows the latitude, as defined on the admin page.
- zman_long - Shows the longitude, as defined on the admin page.
- zman_tzone - Shows the Time Zone, as defined on the admin page.

**Special Dates and Days**
- zman_shaah - A halachic hour, or 1/12 of the available daylight, as calculated based on the shita selected in the drop-down on the admin page.
- zman_parsha - Provides the Torah reading for that week
- zman_zmandate - Provides the date
- zman_chodesh - The day(s) for the indicated Rosh Chodesh. If the date indicated is "today" or "next", text ONLY be visible if this week/next week is Rosh Chodesh.
- zman_molad - The day/time for the indicated Molad. If the date indicated is "today" or "next", text ONLY be visible if this week/next week is the Molad.
- zman_omer - prints the day of the omer, if it is during that period of the year. 
- zman_yomtov - prints any special days including fast days, special shabbatot, etc. 

**Standard Zmanim**
- zman_sunrise - Netz haChachma (nautical sunrise, without elevation).
- zman_sunset - Shkia (nautical sunset, without elevation).
- zman_candles - The time for Shabbat candles, which is sunset/shkia minus the number of minutes indicated on the admin page.
- zman_alot - Alot haShachar (earliest time for tallit & tefillin).
- zman_misheyakir - Misheyakir (earliest time for tefillot).
- zman_shema - Sof Zman Kriat Shema (latest time to say Shema)
- zman_tefilla - Sof Zman Tefilla (latest time to say Shacharit)
- zman_gedola - Mincha Gedola
- zman_ketana - Mincha Ketana
- zman_plag - Plag haMincha
- zman_bain - B'ain haShmashot (time between sunset/shkia and tzeit haKochavim).
- zman_tzait - Tzait haKochavim (the time 3 stars are visible in the night sky). 

**Secondary shitot**
A few zmanim have a secondary option so that two opinions can be used in certain cases:
- zman_shema2
- zman_tefillah2
- zman_tzait2
- zman_plag2

**Advanced and Special Zmanim**
- zman_chatzot - halfway through the day
- zman_earlyshkia -Displays the earliest shkia time for the week (Sunday - Thursday) in which the provided date occurs.
- zman_lateshkia - Displays the latest shkia time for the week (Sunday - Thursday) in which the provided date given
- zman_fullyear* - as described in the "Full Year Display" section above, this displays a grid of times for a complete year.
- zman_early_shabbat_1* through zman_early_shabbat_4* - As described in the "Early Shabbat Options" section above, each of these will display one of two shortcode outputs for early/regular Shabbat.
- zman_misheyakirweekly - provide an array of times for misheyakir, either for this week or next week. Specific times are accessed by using the "daynum" option.
- zman_announcement1 through zman_announcement4 - text blocks you can use to place announcements on the page and then change them through the zmanim-wp interface. 

== Installation ==
As with most WordPress plugins, you download the zip file and Activate the plugin through the 'Plugins' menu in WordPress.

== Frequently Asked Questions ==

(none at this time)

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

== Changelog ==
= 2.7.2 =
* fixed bug with "weekday" datevalues pushing to next week on that weekday instead of showing the current day. 

= 2.7.1 =
* No changes from 2.7.0, I just borked up svn again.

= 2.7.0 =
* Added secondary zman/shortcode for sof zman kria shema, Sof Tefilah, Tzait, and Plag haMincha that can use a different shita. (use shortcodes zman_shema2, zman_tefillah2, zman_tzait2, and zman_plag2)
* Added a new page to set choices for parsha, month, and holiday transliterations
* Changed "Sefardic nusach" checkbox to "Custom Transliterations"
* Added a second set of conditional zmanim for custom edge cases.

= 2.6.0 =
* Fixed issue with using correct dictionary for holidays when set to Sephardic nusach
* Fixed issue with blank parsha information on days with special readings
* Added zman_omer function

= 2.5.0 =
* add more early/late shabbat entries
* add "rounding" option to times. Up, down, nearest (nearest is default)
* Bugfixes

= 2.4.0 =
* Added 3 additional announcement boxes (shortcode: zman_announcement1 through zman_announcement4)

= 2.3.0 =
* Added announcement box (shortcode: zman_announcement)

= 2.2.3 =
* fixed issue with yomtov spacing and title visibility

= 2.2.2 =
* formatting issues with yomtov shortcode

= 2.2.1 =
* Fixed issues with zman_yomtov and zman_parsha not showing correctly on "special" shabbatot

= 2.2.0 =
* Tested up to WordPress version 6.9
* Nusach checkbox now also controls month names and holiday/yomtov names
* added [zman_yomtov] - indicates if it's a special chag coming up.
* [zman_date] now takes lang= options "english", "hebrew", and "transliterated" to output separate styles of date

= 2.1.1 =
* fixed multiple versioning issues because I'm an idiot when it comes to SVN. 

= 2.1.0 =
* Added zman_mevorchim for more accurate molad and chodesh. Takes additional parameter "get=" with options "molad", "chodesh", or "both".

= 2.0.0 =
* Removed freemium concept, all functions are now free
* added chatzot (zman_chatzot) function and shortcode

= 1.1.0 =
* split plugin into 2 files
* added support for unit tests

= 1.0.1 =
* Fixed issues with molad and rosh chodesh handlers

= 1.0 =
* Initial release
== Upgrade Notice ==
(none at this time)
