Инструкции по использованию скрипта календаря calendar.php
Данная инструкция предназначена для православных веб-мастеров, которые хотят постоянно обновлять информацию о текущей дате по православному календарю.
О разработчиках:
Программа (calendar.php) — Иван www.hristianstvo.ru
Данные (файл XML) — Дмитрий days.pravoslavie.ru
Правила использования
Этот скрипт предназначен только для использования на православных сайтах.
Скрипт запрещено использовать на сайте, если
- Он связан с одной из неортодоксальных христианских деноминаций.
- Он относится к раскольническим, неправославным «ортодоксальным» церквям и группам, и
- Она относится к «панхристианским», «экуменическим», «межрелигиозным» и «обновленческим» темам
- Содержит религиозные и мистические материалы нехристианского, оккультного или языческого характера.
- Содержит материал, который является приглашением к расколу или способствует обострению существующих разногласий.
- Содержит материалы, противоречащие христианской морали.
- Содержит коллекцию ссылок на неправославные и антихристианские ресурсы в Интернете.
Лучший способ проверить, соответствует ли сайт требованиям, — зарегистрировать его в каталоге www.hristianstvo.ru.
Принцип работы и варианты использования
Вариант 1 (JavaScript)
Используйте java-script на страницах и calendar.php на script.pravoslavie.ru. Достаточно разместить одну или несколько строк кода Java script на HTML-странице. Когда пользователь просматривает вашу страницу, java-скрипт запускает программу в script.pravoslavie.ru для сбора информации о дне, и результаты этой работы отображаются на указанной вами странице. Это самый простой вариант, доступный всем веб-мастерам и не имеющий требований к серверу.
Второй вариант (PHP).
Вы можете написать свой собственный PHP-код для обработки и отображения информации журнала. Чтобы получить данные с сайта script.pravoslavie.ru, вам нужно добавить две строки в ваш код.
Массив $arra содержит все данные за день. Формат данных может быть изменен путем добавления общих параметров. Параметр php=1 обозначает код, возвращаемый скриптом. Параметр var задает имя переменной, которая будет присвоена скрипту. Если параметр var не используется, сценарий будет возвращать только данные.
Здесь вы можете увидеть тестовый пример и формат возвращаемых данных.
Как это работает. В соответствии с указанными общими параметрами скрипт на стороне сервера генерирует все данные за день, помещает их в массив, сериализует, выделяет специальные символы и отправляет результат в виде строки в запрос. Если заданы параметры php и var, возвращаемый ответ будет в виде php-скрипта, где переменная принимает строковое значение. Сценарий должен распаковать эту переменную в массив, чтобы ее можно было использовать. Страница календаря Дни.ру работает по тому же принципу.
Это очень гибкий и очень простой вариант, который может использовать любой веб-мастер со знанием PHP и самыми простыми требованиями к серверу.
Другие варианты.
Для дальнейшего редактирования результатов работы calendar.php можно использовать сценарии на стороне клиента или сервера.
Описание запуска скрипта и его параметров
Сценарии могут выполняться в двух режимах: простом и расширенном.
Простое управление.
Просто вставьте строку кода в определенное место HTML-страницы.
Совет: За пределами Москвы используйте параметры hrams=0 и hram=0, чтобы отключить вывод церковных праздников для церквей в Москве.
Параметры могут быть использованы для изменения формата вывода. В скобках указаны значения параметров по умолчанию. Обычно значение 1 включает функцию, управляемую параметром, а значение 0 отключает ее.
Все параметры имеют «значение по умолчанию», и «значение по умолчанию» может быть установлено не для удобного параметра.
Упрощенные рабочие параметры :
chten (1) — выводит евангельское чтение в конце календаря — hrams (1) — выводит список праздников,
Общие параметры:
advanced (0)- включить расширенные возможности name (1) — текст календаря с именем святого со ссылкой на биографию святого — life (0) — выводить отдельные ссылки на биографию святого — icon (1) — выводить ссылку на изображение / образ святого, trop (1) — выводить ссылку на trop? изображения (0) — выводить ссылку на жизнь, изображение, церковь, троп как изображение? date (0) — вывести календарь на определенный день (формат mmdd, например, 0427 — 27 апреля, ч. target (1) — открыть все ссылки в новом окне (target=_blank); tmshift (0) — смещение времени от московского (в часах) — другое время Требуется для корректной работы в зоне; encoding (‘w’) — кодировка русских символов (возможные варианты: ‘k’ для ‘koi8-r’, ‘w’ для ‘win’, ‘u’ для UTF-8, ‘d’ для ‘dos’, ‘m’ для ‘mac’).ssi (0) — Генерирует чистый html-код вместо кода JavaScript для включения календаря SSI; vek (0) — генерирует год смерти, славы, перенесения мощей или век рождения святого. bold (0) — отображает имена высокочтимых святых жирным шрифтом. para (0) — разбивает текст на абзацы. tipikon (0) — отображает значок tipikon. трапеза (1) — отображение деталей блюд. feofan (0) — выводит «мысли на каждый день года» отшельника святителя Феофана…. короткий (1) — Внешний вид I — короткий дневник… c ss (0) — добавить имя класса css… dayicon (0) — вывод значка дня. iconsmaxw — Устанавливает максимальную ширину значка. Если этот параметр превышен, значок дня не будет экспортирован.
Совет: Для расчета параметров используйте калькулятор параметров.
Пример — Отображение календаря на 27 сентября, отключение списка храмов и создание ссылки в виде изображения.
Совет: Если круг посетителей охватывает часовой пояс, удаленный от Москвы, используйте код, который выводит календарь в соответствии с датой на компьютере читателя.
Расширенный режим.
В расширенном режиме можно выбрать, расположить и отформатировать необходимые разделы календаря.
Вставьте код advanced=1 в начало страницы, например, после
(Для наглядности в данном примере используются дополнительные параметры для отображения функции, задающие 27 сентября, feofan=1 и dayicon=1).
Затем разместите следующие директивы java-script в других местах страницы
В расширенном режиме можно применять все общие параметры
В следующем примере показано, как создать календарь в расширенном режиме
История изменений в проекте:
- 7 октября 2003 года — начало проекта.
- 8 октября — Исправлена ошибка перехода на летнее время.
- 10 Oct — Удалены лишние запятые между иконками.
- 15 октября — Добавлена ссылка на страницу праздника.
- 4 Янв 2004 — Добавлены новые параметры bold, para и vek.
- — Незначительные изменения в форматировании XML.
- 26 Feb — Исправлены ошибки в параметре name.
- 27 февраля — Реализована функциональность расчета параметров.
- 14 Янв 2005 — Добавлены параметры: relics, tipikon, feofan, short, css, mesta, church, dayicon, iconsmaxw, функции print_feofan(), print_icon(). Важные изменения в формате XML.
- 17 Oct 2005 — Добавлена возможность загрузки скриптов на PHP.
Другие сервисы для православных вебмастеров на script.pravoslavie.ru:
Если вы хотите воспользоваться этой услугой, пожалуйста, свяжитесь с webmaster@pravoslavie.ru.
