Рейтинг@Mail.ru Архив RSS Карта сайта
Православие.Ru Поместные Церкви Православный Календарь English version
ПРАВОСЛАВИЕ.RU Православный Календарь
ПРАВОСЛАВИЕ.RU карта сайтаПРАВОСЛАВНЫЙ КАЛЕНДАРЬ »  Скрипт календаря




Рейтинг@Mail.ru


Инструкция по использованию скрипта календаря calendar.php

17 октября 2005 года.

Внимание! Просьба к тем, кто уже установил скрипт.
Поменяйте адрес скрипта с www.days.ru на script.days.ru!
Скрипт будет работать несколько быстрее.

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

О разработчиках:

программа (calendar.php) - Иван www.hristianstvo.ru

данные (XML файлы) - Дмитрий days.pravoslavie.ru

Правила использования

Скрипт предназначен для использования только на православных сайтах.

Скрипт будет запрещен для использования на сайте, если он:

  • относится к одной из неправославных христианских конфессий;
  • имеет отношение к раскольническим и неканоническим "православным" церквям и группировкам;
  • относится к "общехристианской", "экуменической", "межрелигиозной", "обновленческой" тематике;
  • содержит религиозные и мистические материалы нехристианского, оккультного, языческого характера;
  • содержит призывы к расколам или материалы, способствующие усугублению существующих расколов;
  • содержит материалы, оскорбляющие христианскую нравственность;
  • содержит подборки ссылок на инославные и антихристианские ресурсы сети интернет;

Лучшей проверкой на соответствие Вашего сайта предъявляемым требованиям будет его регистрация в каталоге www.hristianstvo.ru.

Принцип работы и варианты использования

1-й вариант (JavaScript)

Используется java-script на Вашей страничке и программа calendar.php на сайте script.days.ru.
Достаточно разместить на html-страничке одну или несколько строчек с java-script кодом.
При просмотре пользователем Вашей странички, java-script запускает на сайте script.days.ru программу, которая собирает информацию о текущем дне, а результат её работы вставляется в заданное вами место на страничке.
Это самый простой вариант, доступный любому вебмастеру и не предъявляющий никаких требований к серверу.

2-й вариант (PHP)

Вы можете написать свой код на PHP для обработки и вывода календарной информации. Для получения данных с script.days.ru вы должны будете добавить в Ваш код 2 строчки.

require("http://script.days.ru/php.php?var=varname&php=1");
$arra=unserialize(stripslashes($varname));

Массив $arra будет содержать все данные одного дня. Изменять формат данных можно, добавляя общие параметры. Параметр php=1 обрамляет возвращаемый скриптом код тегами <?php и ?>. Параметр var задает имя переменной, которой в скрипте присваивается значение . Если параметр var не использовать, скрипт возвратит только данные.

Тестовый пример и формат возвращаемых данных можно посмотреть здесь.

Принцип работы. В соответствии с установленными общими параметрами скрипт на стороне сервера производит формирование всех данных одного дня, укладывает их в массив, сериализует, экранирует спецсимволы и, полученный результат в виде строки отправляет в ответ на запрос. Если установлены параметры php и var - возвращаемый ответ принтмает вид php-скрипта в котором переменной присваивается строчное значение. Ваш скрипт должен распаковать эту переменную в массив, который затем можно использовать. Страницы дней календаря days.ru работают по такому же принципу.

Это очень гибкий и весьма простой вариант, доступный любому вебмастеру, знающему PHP и предъявляющий самые простейшие требования к серверу.

3й вариант(XML)

Используется написанная Вами программка на любом языке (asp, php,pl и др.), обрабатывающая XML файлы с информацией, лежащие на сервере script.days.ru Программка может быть сделана по образцу calendar.php и запускаться на Вашем сервере или на script.days.ru

Это самый гибкий вариант, дающий Вам максимум возможностей.

Прочие варианты

Вы можете дополнительно обрабатывать результаты работы calendar.php, с помощью скриптов, работающих на клиентской или серверной стороне. Вы можете периодически скачивать XML файлы к себе на сервер и обрабатывать их там по собственному желанию.

Описание запуска скрипта и его параметров

Скрипт можно запускать двух режимах: упрощенном и расширенном

Упрощенный режим.

В нужном месте html-страницы достаточно вставить одну строчку кода:

<script language="Javascript" src="http://script.days.ru/calendar.php"></script>

Результат:

Совет: Для немосковских сайтов - применяйте параметр hrams=0 и hram=0, чтобы отключить вывод престольных праздников в московских храмах.

Формат вывода можно изменить с помощью параметров.
В скобках указаны значения параметра по умолчанию.
Обычно, значение 1 включает регулируемый параметром режим, 0- выключает.

Все параметры имеют "значения по умолчанию", и Вы можете не устанавливать те параметры, "значения по умолчанию" которых Вам подходят.

Параметры упрощенного режима:

chten (1) - печатать в конце календаря Евангельские чтения;
hrams (1) - печатать список престольных праздников;

Общие параметры:

advanced(0)- включение расширенного режима
name (1) - в тексте календаря имена святых выводить ссылками на жития;
life (0) - выводить ссылку на житие святого отдельно;
icon (1) - выводить ссылку на икону/иконы святого;
trop (1) - выводить ссылку на тропарь святому;
hram (1) - выводить ссылку на храмы в честь святого;
relics (0) - выводить ссылку на святыни;
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.
mesta (1) - в список храмов помещать только храмы расположенные в выбранных местах.
    1 - Москва,
    2 - СПб,
    3 - Московская область,
    4 - Ленинградская область,
    all - все.
Можно перечислить несколько параметров через запятую.
church (0) В список святых, празднуемых РПЦ, можно добавить святых других Православных Церквей.
    0 - РПЦ,
    1 - РПЦ+РПЦЗ,
    all - все.
dayicon(0) - выводить икону дня.
iconsmaxw - установить максимальную ширину иконы. При превышении - икона дня не будет выводиться.

Совет: Для подбора параметров используйте калькулятор параметров.

Пример - выведем календарь за 27 сентября, отключим список храмов, ссылки сделаем в виде картинок:

<script language="Javascript" src="http://script.days.ru/calendar.php?images=1&hrams=0&date=0927"></script>

Результат:

Совет: Если круг Ваших посетителей охватывает далекие от Москвы часовые пояса - используйте код, выводящий календарь в соответствии с датой на компьютере читателя:

<script language="Javascript">
var d=new Date();
var to=-4-d.getTimezoneOffset()/60;
document.write ( '<script language="Javascript" src="http://script.days.ru/calendar.php?tmshift='+to +'"><\/script>');
</script>

Расширенный режим.

В расширенном режиме вы можете произвольно выбирать, располагать и оформлять необходимые вам фрагменты календаря.

В начале страницы, например, после тега <body>, необходимо вставить код с параметром advanced=1:

<script language="Javascript" src="http://script.days.ru/calendar.php?advanced=1&date=0927"></script>

(Для наглядности, в примере используется дополнительный параметр, устанавливающий дату - 27 сентября, а также feofan=1 и dayicon=1, для демонстрации работы соответствующих функций)

Затем, в любых других местах страницы разместить следующие инструкции на java-script:

Выводимый фрагмент Инструкция Результат
дата print_day()
седмица-неделя-суббота print_week()
праздник print_holiday()
пост print_post()
трапеза print_trapeza()
святые дня print_saints()

Евангельские чтения дня print_chten()
Храмы с престольными праздниками в этот день print_hrams()
"Мысли на каждый день года" свт. Феофана
Затворника. Необходимо установить параметр feofan=1
print_feofan()
Вывод "иконы дня"
Необходимо установить параметр dayicon=1
print_icon()

В расширенном режиме можно применять все общие параметры

В следующем примере демонстрируются возможности оформления календаря в расширенном режиме:


Исходный код:

<script language="Javascript"
src="http://script.days.ru/calendar.php?advanced=1&date=0927"></script>
<p align=
"center"><b><font face="Arial" size="5">
<script language
="Javascript">print_day(); </script></font></b></p>
<p align=
"center"><b><font color="#FF0000" size="3" face="Arial">&nbsp;
<script language
="Javascript">print_holiday(); </script></font></b>
<p align=
"center">&nbsp;
<table border="0" cellpadding="5" cellspacing="0" width="100%">
<tr>
<td width=
"50%"><b>
<script language
="Javascript">print_week()</script></b></td>
<td width=
"50%" align="right">
<script language
="Javascript">print_post(); </script>&nbsp;<br>
<i>
<script language="Javascript">print_trapeza();</script></i></td>
</tr>
</table>
<table border=
"0" cellpadding="5" cellspacing="0" width="100%">
<tr>
<td width=
"70%" valign="top">
<script language
="Javascript">print_saints(); </script>
<p>
&nbsp;
<script language
="Javascript">print_chten(); </script></td>
<td width=
"30%" bgcolor="#CCCCCC"><font size="1" face="Arial">&nbsp;
<script language
="Javascript">print_hrams(); </script>
</font></td></tr>
</table>

Сайты, использующие предлагаемый сервис.

Более 200 православных сайтов уже используют calendar.php

Список сайтов с описаниями и ссылками.

История изменений в проекте:

  • 7 октября 2003 -запуск проекта.
  • 8 октября - исправлена ошибка, связанная с переходом на летнее время.
  • 10 октября - удалены лишние запятые между значками.
  • 15 октября - добавлена ссылка на страничку о празднике.
  • 4 января 2004 года - добавлены новые параметры bold, para, vek.
  • - небольшие изменения в формате XML.
  • 26 февраля - исправлена ошибка в работе параметра name.
  • 27 февраля - сделан калькулятор параметров.
  • 14 января 2005 года - добавлены параметры: relics, tipikon, feofan, short, css, mesta, church, dayicon, iconsmaxw, функции print_feofan(), print_icon(). Серьезные изменения в формате XML.
  • 17 октября 2005 года - добавлена возможность загрузки скрипта в PHP.

Другие сервисы для православных вебмастеров на script.days.ru:

"Икона дня" на Вашем сайте.

Просьба!

Если Вы будете использовать этот сервис, напишите нам об этом: script@days.ru
Мы разместим ссылку на Вашу страницу в списке сайтов, установивших calendar.php.

Каталог Православное Христианство.Ру
© ПРАВОСЛАВИЕ.RU