=== Bg BTime ===

Contributors: VBog

Donate link: http://bogaiskov.ru/about-me/donate/

Tags: orthodoxy, Christianity, Byzantine, Athos, clock, православие, христианство, Византия, Афон, часы, ορθοδοξία, χριστιανισμός, Βυζαντίου, Άθως, ρολόι

Requires at least: 3.0.1

Tested up to: 5.8.2

Stable tag: trunk

License: GPLv2

License URI: http://www.gnu.org/licenses/gpl-2.0.html


Calculates and displays Byzantine time in your location.

== Description ==

Плагин позволяет рассчитать и отобразить византийское время в вашем регионе.

Сутки по Византийскому времени начинаются с заходом солнца, поэтому их начало зависит от даты и местоположения (долготы и широты).

* 1 Сутки = 24 часа
* 1 Час = 10 лепт
* 1 Лепта = 15 мойр
* 1 Мойра = 8 рип
	
Византийское время не может быть определено за полярным кругом (Широта по модулю > 66.5622).

Если заданы координаты за полярным кругом, то функция получает текущие координаты пользователя и рассчитывает для них Византийское время. 

Если получить координаты невозможно или пользователь находится за полярным кругом, то рассчитывается псевдо-византийское время с полночью в 18:00.

Следует иметь ввиду, что getCurrentPosition() и watchPosition() больше не работают на сайтах ненадежного происхождения. 
Чтобы использовать эту функцию, вы должны подумать о переходе к использованию безопасного режима, такого как HTTPS. 
Подробнее см. <https://goo.gl/rStTGz>

Сутки по Церковному (псевдо-византийскому) времени начинаются с принятым на приходе началом вечерней службы. 
Как правило это: 16, 17 или 18 часов. По умолчанию принято 18 часов.

**Используются:**

*  Sunrise/Sunset Algorithm by Nautical Almanac Office US Naval Observatory
*  HTML5 Geolocation API
*  Алгоритм реализован на JavaScript. Подобное описание см. [/btime/readme.md](https://plugins.svn.wordpress.org/bg-btime/trunk/btime/readme.md)




**Шорт-код `[bg_btime]`** выводит на экран византийское время.

Параметры:

**format** - формат отображения византийского времени. 

Если `format == 'image' или 'img'`, то отображаются стрелочные византийские часы. 
При `format == 'img'` стрелка неподвижна.
	
В остальных случаях время отображается в виде текста.
	
Используйте следующие плейсхолдеры:

* **%y** - год,
* **%2y** - две последние цифры года,
* **%m** - месяц (1...12),
* **%0m** - то же с ведущим нулем,
* **%1m** - месяц (января...декабря),
* **%2m** - месяц (янв...дек),
* **%d** - день месяца (0...31),
* **%0d** - то же с ведущим нулем,
* **%n** - день недели (0...6), где 0 - воскресенье,
* **%0n** - то же с ведущим нулем,
* **%1n** - (воскресенье...суббота),
* **%2n** - (Вс...Сб),
* **%N** - (Воскресенье...Суббота),
* **%h** - час (0...23),
* **%0h** - то же с ведущим нулем,
* **%1h** - час (1...12) без указания дня/ночи,
* **%H** - час (1-й...12-й час дня/ночи),
* **%l** - лепта (0...9),
* **%0l** - то же с ведущим нулем,
* **%j** - мойра (0...14),
* **%0j** - то же с ведущим нулем,
* **%r** - рипа (0...7),
* **%0r** - то же с ведущим нулем,
* **%w** - стража,
* **%s** - богослужение.
	
По умолчанию: `format="%0h:%0l:%0j:%0r - %w (%s)"`.	
	
**size** - размер стрелочных часов в пикселях. Допустимые размеры от 150x150 до 750x750. По умолчанию 150x150.

**mode** - режим работы функции. 

1. Если передан массив, то mode - это координаты места. 
1. Иначе, mode - это час начала вечернего богослужения для расчета церковного (псевдо-византийского) времени.
		
По умолчанию `mode=[90,0]` (Северный полюс) - то есть плагин будет пытаться определить координаты пользователя.
		
**time** - гражданское время по Григорианскому календарю, для которого необходимо определить византийское время.
По умолчанию `time=''` - текущее время.

**date** - дата, на которую необходимо определить византийское время при time = 0 - текущем времени пользователя.


**Дополнительный шорт-код `[bg_bclock]`** выводит на экран только стрелочные часы.

Параметры: **size**, **mode**, **time** - описание см. выше.
		
== Installation ==
1. Upload the plugin files to the `/wp-content/plugins/bg-btime` directory, or install the plugin through the WordPress plugins screen directly.
1. Activate the plugin through the \'Plugins\' screen in WordPress
1. Use the Settings->Plugin Name screen to configure the plugin

== Frequently Asked Questions ==

Спрашивайте. Ответим. :)

== Screenshots ==

1. Стрелочные византийские часы


== Changelog ==
= 2.4 =

* Добавлен параметр date - дата, на которую необходимо определить византийское время при time = 0 - текущем времени пользователя.

= 2.3.1 =

* Циферблат часов в формате png
* Исправлен баг с минутами для стрелочных часов.


= 2.2 =

* Добавлен format='img', при котором стрелка неподвижна.
* Исправлен баг непозвявший иметь на странице более одних стрелочных часов.

= 2.1 =

* Добавлена обработка ошибки при попытке определить координаты на незащищенном сайте.

= 2.0 =

* Добавлены стрелочные часы.

= 1.1 =

* Добавлена возможность вывода даты по Юлианскому календарю.

== Upgrade Notice ==

Первый релиз плагина.