Инструкция по использованию icon.php
1 февраля 2010 года.
Инструкция предназначена для православных вебмастеров, желающих разместить на своих страницах обновляемую каждый день "икону дня".
Правила использования
Скрипт предназначен для использования только на православных сайтах.
Скрипт будет запрещен для использования на сайте, если он:
- относится к одной из неправославных христианских конфессий;
- имеет отношение к раскольническим и неканоническим "православным" церквям и группировкам;
- относится к "общехристианской", "экуменической", "межрелигиозной", "обновленческой" тематике;
- содержит религиозные и мистические материалы нехристианского, оккультного, языческого характера;
- содержит призывы к расколам или материалы, способствующие усугублению существующих расколов;
- содержит материалы, оскорбляющие христианскую нравственность;
- содержит подборки ссылок на инославные и антихристианские ресурсы сети интернет;
Лучшей проверкой на соответствие Вашего сайта предъявляемым требованиям будет его регистрация в каталоге www.hristianstvo.ru.
Описание запуска скрипта и его параметров
Скрипт можно запускать в трёх режимах: упрощенном, расширенном и режиме AJAX.
Упрощенный режим.
В нужном месте html-страницы достаточно вставить одну строчку кода:
<script language="Javascript" src="http://script.pravoslavie.ru/icon.php"></script> |
Результат:
Формат вывода можно изменить с помощью параметров.
В скобках указаны значения параметра по умолчанию.
Значение 1 включает регулируемый параметром режим, 0- выключает.
Общий для http формат использования параметров:
имя_скрипта?имя_параметра1=значение_параметра1&имя_параметра2=значение_параметра2...
Параметры:
advanced(0)- управление режимом
date (0) - выводить календарь на конкретный день года (в формате ГГГГММДД, например, 20100427 - 27 апреля);
old (0) - используется вместе с date; дата воспринимается в старом стиле.
href (1) - Установка в 1 - щелчок мышкой открывает в новом окне увеличенное изображение. Установка в 2 - переход на соотв. день календаря. 0 - ссылки нет.
tmshift (0) - сдвиг времени (в часах) часового пояса относительно Москвы - необходимо для правильной работы календаря в других часовых поясах;(24 - завтрашний день по Москве)
encoding ('w') - кодировка русских букв (возможные варианты: 'u'- unicode, 'k' для 'koi8-r', 'w' для 'win', 'd' для 'dos', 'm' для 'mac').
ssi(0) - отключает вывод java-script кода. Используется для вставки результатов работы скрипта в файл другими методами, например, с помощью SSI.
scale(1) - Растягивает- сжимает картинку в указанное число раз. (scale=0.5 - уменьшение в 2 раза)
|
Например, выведем икону для завтрашнего дня:
<script language="Javascript" src="http://script.pravoslavie.ru/icon.php? tmshift=24"></script> |
Результат:
Расширенный режим
В расширенном режиме вы можете произвольно располагать и оформлять изображение и подпись к иконе.
В начале страницы, например, после тега <body>, необходимо вставить код с параметром advanced=1 :
<script language="Javascript" src="http://script.pravoslavie.ru/icon.php?advanced=1"></script> |
Затем, в любых других местах страницы разместить следующие инструкции на java-script:
Выводимый фрагмент |
Инструкция |
Результат |
Икона |
print_img() |
|
Подпись к иконе |
print_podpis() |
|
В расширенном режиме можно применять все общие параметры
В следующем примере демонстрируются возможности оформления календаря в расширенном режиме:
Режим AJAX
Режим включается установкой параметра advanced=2. В этом режиме скрипт поставляет только данные.
Отображение этих данных - дело javascript-кода на Вашей странице. Код Вы можете написать сами или приспособить для себя код из примера.
Простейший вариант работы со скриптом в режиме AJAX такой:
- Создаете функцию с именем dayiconloaded(). Эта функция будет автоматически вызываться тогда, когда скрипт выдаст данные. В этой функции должен быть размещен код обработки данных скрипта
- Размещаете на страничке код с вызовом скрипта icon.php с параметром advanced=2.
В следующем примере представлен более сложный способ, позволяющий повторно вызывать скрипт без перезагрузки страницы.
- В html коде страницы выделяется место(<DIV>), куда будет выводится икона
- На событие onload тега body навешивается функция динамической загрузки скрипта
- В фунции с именем dayiconloaded() размещается код обработки данных скрипта
- Функция dayiconloaded() динамически создает тег <IMG> для вывода иконы в предназначенное ей место на странице
- Дополнительно, для демонстрации повторного вызова скрипта, на <IMG> навешивается ссылка с кодом повторного запуска скрипта с другими параметрами (следующего дня)
Пример
Код примерa .
История изменений в проекте:
- 5 ноября 2003 - запуск проекта.
- 1 февраля 2010 - добавлен режим AJAX, юникод кодировка.
Другие сервисы для православных вебмастеров на days.pravoslavie.ru:
Православный календарь на Вашем сайте.
|