Инструкция по использованию скрипта календаря calendar.php
17 октября 2005 года.
Внимание! Просьба к тем, кто уже установил скрипт.
Поменяйте адрес скрипта на https://script.pravoslavie.ru!
Инструкция предназначена для православных вебмастеров, желающих разместить на своих страницах постоянно обновляемую информацию о текущем дне по Православному календарю.
Скрипт предназначен для использования
только на православных сайтах.
Скрипт будет запрещен для
использования на сайте, если он:
относится к одной из неправославных христианских конфессий;
имеет отношение к раскольническим и неканоническим "православным" церквям и группировкам;
относится к "общехристианской", "экуменической", "межрелигиозной", "обновленческой" тематике;
содержит религиозные и мистические материалы нехристианского, оккультного, языческого характера;
содержит призывы к расколам или материалы, способствующие усугублению существующих расколов;
содержит материалы, оскорбляющие христианскую нравственность;
содержит подборки ссылок на инославные и антихристианские ресурсы сети интернет;
Лучшей проверкой на соответствие Вашего сайта предъявляемым требованиям будет его регистрация в каталоге www.hristianstvo.ru.
Принцип работы и варианты использования
1-й вариант (JavaScript)
Используется java-script на Вашей страничке и программа calendar.php на сайте script.pravoslavie.ru.
Достаточно разместить на html-страничке одну или несколько строчек с java-script кодом.
При просмотре пользователем Вашей странички, java-script запускает на сайте script.pravoslavie.ru программу, которая собирает информацию о текущем дне, а результат её работы вставляется в заданное вами место на страничке.
Это самый простой вариант, доступный любому вебмастеру и не предъявляющий никаких требований к серверу.
2-й вариант (PHP)
Вы можете написать свой код на PHP для обработки и вывода календарной информации. Для получения данных с script.pravoslavie.ru вы должны будете добавить в Ваш код 2 строчки.
Массив $arra будет содержать все данные одного дня. Изменять формат данных можно, добавляя общие параметры. Параметр php=1 обрамляет возвращаемый скриптом код тегами <?php и ?>. Параметр var задает имя переменной, которой в скрипте присваивается значение . Если параметр var не использовать, скрипт возвратит только данные.
Тестовый пример и формат возвращаемых данных можно посмотреть здесь.
Принцип работы. В соответствии с установленными общими параметрами скрипт на стороне сервера производит формирование всех данных одного дня, укладывает их в массив, сериализует, экранирует спецсимволы и, полученный результат в виде строки отправляет в ответ на запрос. Если установлены параметры php и var - возвращаемый ответ принтмает вид php-скрипта в котором переменной присваивается строчное значение. Ваш скрипт должен распаковать эту переменную в массив, который затем можно использовать. Страницы дней календаря days.ru работают по такому же принципу.
Это очень гибкий и весьма простой вариант, доступный любому вебмастеру, знающему PHP и предъявляющий самые простейшие требования к серверу.
Прочие варианты
Вы можете дополнительно обрабатывать результаты работы calendar.php, с помощью скриптов, работающих на клиентской или
серверной стороне.
Описание запуска скрипта и его параметров
Скрипт можно запускать двух режимах: упрощенном и расширенном
Упрощенный режим.
В нужном месте html-страницы достаточно вставить одну строчку кода:
26 марта 2025 г. ( 13 марта ст.ст.), среда. Седмица 4-я Великого поста, Крестопоклонная. Великий пост. Монастырский устав: cухоядение (хлеб, овощи, фрукты).
Совет: Для немосковских сайтов - применяйте параметр hrams=0 и hram=0, чтобы отключить вывод престольных праздников в московских храмах.
Формат вывода можно изменить с помощью параметров.
В скобках указаны значения параметра по умолчанию.
Обычно, значение 1 включает регулируемый параметром режим, 0- выключает.
Все параметры имеют "значения по умолчанию", и Вы можете не устанавливать те параметры, "значения по умолчанию" которых Вам подходят.
Параметры упрощенного режима:
chten (1) - печатать в конце календаря Евангельские чтения; hrams (1) - печатать список престольных праздников;
Общие параметры:
advanced(0)- включение расширенного режима name (1) - в тексте календаря имена святых выводить ссылками на жития; life (0) - выводить ссылку на житие святого отдельно; icon (1) - выводить ссылку на икону/иконы святого; trop (1) - выводить ссылку на тропарь святому; images (0) - выводить ссылки на житие, иконы, храм, тропарь в виде картинок; date (0) - выводить календарь на конкретный день года (в формате ммдд, например, 0427 - 27 апреля н.ст.); target (1) - все ссылки открывать в новом окне (target=_blank); tmshift (0) - сдвиг времени (в часах) часового пояса относительно Москвы - необходимо для правильной работы календаря в других часовых поясах; encoding ('w') - кодировка русских букв (возможные варианты: 'k' для 'koi8-r', 'w' для 'win', 'u' для UTF-8, 'd' для 'dos', 'm'
для 'mac').
ssi (0) - выдавать вместо javascript-кода "чистый" html-код для включения календаря с помощью SSI; vek (0) - выводить год кончины, прославления, перенесения мощей или век жизни святого. bold (0) - выделять жирным шрифтом имена особо почитаемых святых. para (0) - разбивать текст на абзацы. tipikon (0) - выводить значки типикона. trapeza (1) - выводить сведения о трапезе. feofan (0) - выводить "Мысли на каждый день года" свт. Феофана Затворника.. short (1) - выводить краткий календарь. css (0) - добавлять имена классов css. dayicon(0) - выводить икону дня. iconsmaxw - установить максимальную ширину иконы. При превышении - икона дня не будет выводиться.
Совет: Если круг Ваших посетителей охватывает далекие от Москвы часовые пояса - используйте код, выводящий календарь в соответствии с датой на компьютере читателя:
<script language="Javascript">
var d=new Date();
var to=-4-d.getTimezoneOffset()/60;
document.write ( '<script language="Javascript" src="https://script.pravoslavie.ru/calendar.php?tmshift='+to +'"><\/script>');
</script>
Расширенный режим.
В расширенном режиме вы можете произвольно выбирать, располагать и оформлять необходимые вам фрагменты календаря.
В начале страницы, например, после тега <body>, необходимо вставить код с параметром advanced=1:
(Для наглядности, в примере используется дополнительный параметр, устанавливающий дату - 27 сентября, а также feofan=1 и dayicon=1, для демонстрации работы соответствующих функций)
Затем, в любых других местах страницы разместить следующие инструкции на java-script:
Выводимый фрагмент
Инструкция
Результат
дата
print_day()
27 сентября 2025 г. ( 14 сентября ст.ст.), суббота.
"Мысли на каждый день года" свт. Феофана Затворника. Необходимо установить параметр feofan=1
print_feofan()
Среди Великого поста предлагается поклонению Честный Крест, чтобы воодушевить постных тружеников к терпеливому несению поднятого ими ига до конца; а в сентябре для чего это делается? Так случилось? Но у промыслительной Премудрости, все устраивающей, нет случаев. Вот это для чего: в сентябре убираются с поля, по крайней мере у нас. Итак, чтоб одни из христиан в чувстве довольства не сказали: "душа! много добра лежит у тебя на многие годы: покойся, ешь, пей, веселись!", а другие от скудости не пали в духе, представляется очам всех воздвигаемый крест, напоминая первым, что опора благобытия не имение, а христианское внутреннее крестоношение, когда внешнее, по благости Божией, слагается, внушая вторым в терпении стяжать души свои, воодушевляя на то уверенностью, что со креста идут прямо в рай; посему, одни да терпят, чая, что идут углажденным путем в Царство Небесное, а другие да вкушают внешних утешений со страхом, как бы не заключить себе вход на небо.
Вывод "иконы дня" Необходимо установить параметр dayicon=1
14 января 2005 года - добавлены параметры: relics, tipikon, feofan, short, css, mesta, church, dayicon, iconsmaxw, функции print_feofan(), print_icon(). Серьезные изменения в формате XML.
17 октября 2005 года - добавлена возможность загрузки скрипта в PHP.