Plugin / Bg Orthodox Calendar

Description

Plugin allows you to display the window with the Orthodox calendar.

Details in Russian only:

Плагин позволяет вывести на экран окно с православным календарем на год.
Для каждого дня года во всплывающей подсказке высвечиваются: дата по старому стилю, праздники по типикону (от двунадесятых до вседневных), памятные даты, дни поминовения усопших, дни почитания икон, посты и сплошные седмицы.
Светлое Христово Воскресение выделено белым цветом на красном фоне, двунадесятые и великие праздники – красным цветом, кроме того красным цветов отмечены воскресные дни, дни особого поминовения усопших – синим цветом.
Постные дни (многодневные и однодневные посты, а также среды и пятницы) отмечены серым фоном.
Плагин позволяет для каждой даты выбрать дальнейшее действие перейти на официальный календарь РПЦ или сайта Православие.Ru, вывести на экран Богослужебные указания, показать этот день в календаре и выбрать имя по Месяцеслову.
С помощью нашего календаря существует возможность выбора имени новорожденному в соответствии с традицией по Месяцеслову.
При желании можно отметить на календаре дни браковенчаний.

Используйте настройки, чтобы изменить цветовую палитру некоторых элементов календаря.

Чтобы вставить в текст статьи кнопку для вызова календаря используется шорт-код [ortcal_button val=' Календарь на год ']

Вы также можете встроить календарь на год на страницу, используя шорт-код [ortcal_button val=' Календарь на год ']

Информация о дне

Шорт-код [dayinfo] позволяет вывести в тексте заметки/страницы информацию о событиях указанного дня из православного календаря.

В шорт-коде могут использоваться следующие параметры:

• day, month, year – день, месяц и год по Григорианскому календарю, по умолчанию – данные текущего дня,
• date – формат отображения даты по Григорианскому календарю (см. формат PHP даты), по умолчанию ‘l, j F Y г. ‘,
• old – формат отображения даты по Юлианскому календарю, по умолчанию ‘(j F ст.ст.)’,
• sedmica – вкл.(‘on’) или выкл.(‘off’) отображение названия Седмицы (Недели) по годичному кругу богослужений, или только Недели (‘nedela’), по умолчанию ‘on’,
• memory – вкл.(‘on’) или выкл.(‘off’) отображение памятных дней, по умолчанию ‘on’,
• honor – вкл.(‘on’) или выкл.(‘off’) отображение дней поминовения усопших, по умолчанию ‘on’,

• holiday – отображать праздники до указанного уровня значимости, по умолчанию = 7. Существует 7 уровней значимости православных праздников:

  • 0 – СВЕТЛОЕ ХРИСТОВО ВОСКРЕСЕНИЕ
  • 1 – ДВУНАДЕСЯТЫЕ ПРАЗДНИКИ
  • 2 – Великие праздники
  • 3 – Средние бденные праздники
  • 4 – Средние полиелейные праздники
  • 5 – Малые славословные праздники
  • 6 – Малые шестиричные праздники
  • 7 – Вседневные праздники. Cовершается служба, не отмеченная в Типиконе никаким знаком

Если, например, указан уровень holiday=4, то будут отображаться: Пасха, двунадесятые, великие, средние бденные и полиелейные праздники. Если holiday=7 – все праздники.

• img – вкл.(‘on’) или выкл.(‘off’) отображение соответствующего знака Типикона при отображении названия праздника, по умолчанию ‘on’,
• hosts – вкл.(‘on’) или выкл.(‘off’) отображение Соборов святых, день памяти, которых приходится на эту дату, по умолчанию ‘off’,
• saints – вкл.(‘on’) или выкл.(‘off’) отображение имен святых, день памяти, которых приходится на эту дату, по умолчанию ‘off’,
• martyrs – вкл.(‘on’) или выкл.(‘off’) отображение имен исповедников и новомучеников российских, день памяти, которых приходится на эту дату, по умолчанию ‘off’,
• icons – вкл.(‘on’) или выкл.(‘off’) отображение названий икон Богородицы, день памяти, которых приходится на эту дату, по умолчанию ‘off’,
• posts – вкл.(‘on’) или выкл.(‘off’) отображение постных дней или светлых седмиц, по умолчанию ‘off’,
• noglans – вкл.(‘on’) или выкл.(‘off’) отображение информации о том, в что в этот день браковенчание не совершается, по умолчанию ‘off’,

• readings – вкл.(‘on’) или выкл.(‘off’) отображение Апостольских и Евангельских чтений и Псалтири с комментариями, по умолчанию ‘off’,

  • если readings=’M’, отображаются только чтения на Утрене,
  • если readings=’A’, отображаются только Апостольские чтения на Литургии,
  • если readings=’G’, отображаются только Евангельские чтения на Литургии,
  • если readings=’AG’, отображаются только Апостольские и Евангельские чтенияна Литургии,
  • если readings=’MAG’, отображаются только Апостольские и Евангельские чтения на Утрене и на Литургии,
  • если readings=’E’, отображаются только чтения на Вечерне,
  • если readings=’H’, отображаются только чтения на часах,
  • если readings=’F’, отображаются только чтения на Праздники,
  • если readings=’P’, отображаются только чтения Псалтири,
  • если readings=’N’, чтения Нового Завета (то же, что и ‘on’, но без Псалтири),
  • в остальных случаях ВСЕ тексты, указанные на заданный день с комментариями.

• links – отображение ссылок и цитат; выкл.(‘off’) – ничего не отображать, вкл.(‘on’ или ”) – отображать ссылки (по умолчанию), в остальных случаях отображать цитаты:

  • ’book’, то отображаются наименование книги, заголовки глав и стихи, каждый отдельным абзацем, с указанием его номера.
  • ’verses’, то отображаются только стихи, каждый отдельным абзацем, с указанием номера главы и номера стиха.
  • ’b_verses’, то отображаются только стихи, каждый отдельным абзацем, с указанием короткого названия книги, номера главы и номера стиха.
  • ’t_verses’, то отображаются наименование книги и стихи, каждый отдельным абзацем, с указанием номера главы и номера стиха.
  • ’quote’, то отображаются только стихи без деления их на абзацы.

Для параметров hosts, saints, martyrs, icons, posts, noglans и readings в качестве значения Вы можете также указать любую строку, которая будет отображаться на экране в качестве заголовка соответствующих данных.
Для дополнительной разметки текста в можете использовать теги HTML.
Например, saints='<b>День памяти святых:</b><br>' выведет на экран жирным шрифтом заголовок перед списком святых, день памяти, которых приходится на указанную дату. При этом список будет отображаться с новой строки.

ВНИМАНИЕ! Чтобы отображались ссылки или цитаты необходимо, чтобы в Ваш WordPress был установлен плагин Bg Bible References версии не ниже 2.10.

Если в параметре day указать число со знаком “+” или “-”, шорт-код будет воспринимать это число как смещение от текущей даты, соответственно вперед (“+“) или назад (“-“).
Если в параметре day указать ‘post’, то в качестве даты, будет принята дата публикации поста/страницы.
Вы можете создать собственную функцию, возвращающую значение даты и указать имя этой функции в качестве значения параметра day в шорт-кодах.
Эта возможность может применяться для совместимости с другими плагинами.
Пользовательская функция должна возвращать значение даты в соответствии с шаблоном, заданным в качестве аргумента, аналогично php-функции date( string $format ) : string get_custom_date ( string $format )
Во всех этих случаях значения параметров month и year будут проигнорированы.

Задание в параметре day значения ’get’, указывает на необходимость получить дату дня из командной строки браузера. Например:

https://bogaiskov.ru/ortcal/?date=2015-10-31,

где date – дата в формате год-месяц-день по новому стилю.
Эта возможность может использоваться вместе с шорт-кодом [ortcal month='10' year='2015'], который выводит на экран календарь на месяц, позволяющий выбрать требуемую дату с последующим отображением развернутой информации о дне на странице блога.
Параметры шорт-кода month и year определяют месяц и год, которые будут отображены в календаре по умолчанию (если не заданы соответствующие параметры в командной строке).
Если month и year не заданы, то отображается текущий месяц.

Для оформления отображаемой информации можно использовать следующие стили:

• bg_ortcal_date – даты по Григорианскому календарю,
• bg_ortcal_old – даты по Юлианскому календарю,
• bg_ortcal_sedmica – названия Седмицы (Недели) по годичному кругу богослужений,
• bg_ortcal_sunday – дополнительный класс, используемый вместе с классами bg_ortcal_date, bg_ortcal_old и bg_ortcal_sedmica для обозначения воскресного дня,
• bg_ortcal_memory – памятных дней,
• bg_ortcal_honor – дней поминовения усопших,
• bg_ortcal_great – Пасхи, двунадесятых и великих праздников,
• bg_ortcal_middle – Средних праздников,
• bg_ortcal_small – Малых и вседневных праздников,
• bg_ortcal_hosts – Соборов святых, день памяти, которых приходится на эту дату,
• bg_ortcal_saints – имен святых, день памяти, которых приходится на эту дату,
• bg_ortcal_martyrs – имен исповедников и новомучеников российских, день памяти, которых приходится на эту дату,
• bg_ortcal_icons – названий икон Богородицы, день памяти, которых приходится на эту дату,
• bg_ortcal_posts – постных дней или светлых седмиц,
• bg_ortcal_noglans – информации о том, в что в этот день браковенчание не совершается,
• bg_ortcal_readings – Апостольских и Евангельских чтений.

Вспомогательные шорт-коды [prev_day] и [next_day] могут использоваться на одной странице совместно с шорт-кодом [dayinfo day='get'] для отображения данных предыдущего или следующего дня.
По умолчанию шорт-коды [prev_day] и [next_day] выводят на экран фразы '⏴ Предыдущий день' и 'Следующий день ⏵' с ссылками на соответствующую страницу.
Фраза может быть изменена в параметре title.

Для задания внешнего вида ссылок можно использовать описание классов bg_ortcal_prevday и bg_ortcal_nextday.

Шорт-код [oldstyle] выводит на экран дату по Юлианскому календарю (по старому стилю). Параметры:

• day, month, year – день, месяц и год по Григорианскому календарю, по умолчанию – данные текущего дня,
• old – формат отображения даты по Юлианскому календарю, по умолчанию ‘j F Y г. по ст.ст.’.

ВНИМАНИЕ! Для отображения дня недели используйте в строке формата символы l (строчное ‘L‘) – для полного наименования дня недели и D – для сокращенного наименования дня недели (2 символа).
Порядковый номер дня недели (N, w) отображается не корректно! Не используйте этот шорт-код для его отображения.

Шорт-код [sedmica] выводит на экран название Седмицы (Недели) по годичному кругу богослужений, на которую приходится указанный день. Параметры:

• day, month, year – день, месяц и год по Григорианскому календарю, по умолчанию – данные текущего дня.

Для указания Евангелие дня можно использовать короткий шорткод [readings] . Параметры:

• day, month, year – день, месяц и год по Григорианскому календарю, по умолчанию – данные текущего дня,
• readings – отображение Апостольских и Евангельских чтений, по умолчанию ‘G‘,
• links – отображение ссылок и цитат; по умолчанию – links=’t_verses’.

Для отображения всей информации о дне можно использовать его короткий шорткод [dayinfo_all]. Параметры:

• day, month, year – день, месяц и год по Григорианскому календарю, по умолчанию – данные текущего дня.

Календарь на месяц

Шорт-код календарь на месяц [ortcal month='10' year='2015'], позволяет выбрать требуемую дату в Православном календаре с последующим отображением развернутой информации о дне на странице блога.

При щелчке мышкой по дате в календаре осуществляется переход на страницу блога, указанную в настройках плагина.
На этой странице должен быть размещен шорт-код [dayinfo day='get'].

Для тонкой настройки внешнего вида календаря используйте класс bg_moncal.

Ближайшие события

Шорт-код [upcoming_events] позволяет вывести в тексте заметки/страницы информацию о ближайших событиях из православного календаря. Параметры:

• numdays – количество дней поиска ближайших событий,
• остальные параметры как в шорткоде [dayinfo], при этом параметры day, month, year – игнорируются.

По умолчанию шорт-код [upcoming_events] отображает только двунадесятые и великие праздники, а также дни поминовения усопших в ближайшие две недели (14 дней).

Расписание богослужений

Шорт-код [schedule]...[/schedule] преобразует расписание богослужений, заданное в простой текстовой форме и заключенное между тегами шорт-кода, в таблицу, добавляя описания дней и наименования седмиц.

• period – период группировки дней: ‘m’ – месяц, ‘s’ – седмица,
• остальные параметры как в шорткоде [dayinfo], при этом параметры day, month, year – игнорируются, а параметр sedmica по умолчанию = ‘nedela’.

Каждое событие в расписание должно иметь следующий формат:

dd-mm-yyyy hh:mm Название_события

где dd-mm-yyyy – дата события, hh:mm – время начала события, Название_события – произвольный текст.

Если дата и/или время не заданы или заданы неверно, событие не отображается.

Чтобы задать событие на целый день, укажите вместо времени начала события: 88:88.

Классы для оформления расписания:

• bg_ortcal_schedule – общий класс контейнера с расписанием,
• bg_ortcal_week – класс ячейки с отображением названия седмицы,
• bg_ortcal_day – класс ячейки с отображением информации о дне,
• bg_ortcal_time – класс ячейки с отображением времени события,
• bg_ortcal_event – класс ячейки с отображением названия событи

Вы можете добавлять события в базу данных, используя пользовательский XML-файл данных.

Внутренний кеш плагина

Для ускорения работы плагина используется внутренний кеш данных, построенный на базе WP-функций set_transient()/get_transient().
Будьте готовы к тому, что в вашей базе данных появятся более 800 новых записей.

Кеш будет обновляться при каждом обновлении плагина.
Он также будет сброшен при обновлении настроек плагина.

Для ускорения отображения информации мы также настоятельно рекомендуем использовать один из известных плагинов для кеширования.
Например, WP Super Cache или W3 Total Cache.

License

GNU General Public License v2