О плагине
Kinopoisk - это jQuery плагин, который с лёгкостью позволяет добавить на вашу страницу информер о рейтинге фильма. Этот информер показывает рейтинг с сайтов kinopoisk.ru и imdb.com. Вам не надо устанавливать на свой сайт никаких серверных скриптов, только файлы плагина с javascript и css.
Начало
Подключить jQuery и плагин:
<script src="http://yandex.st/jquery/1.9.1/jquery.min.js"></script>
<link rel="stylesheet" type="text/css" href="kinopoisk.min.css" />
<script type="text/javascript" src="kinopoisk.min.js"></script>
Использовать плагин следующим образом: (89515 - идентификатор фильма на kinopoisk.ru):
<div class="kinopoisk" data-movie="89515"></div>
Результат:
Вот и всё!
Настройки
Порядок рейтингов
Установка порядка показа рейтингов (["kinopoisk", "imdb"] по умолчанию):
<div class="kinopoisk" data-movie="89515" data-order='["imdb", "kinopoisk"]'></div>
Результат:
Если нужен только один рейтинг:
<div class="kinopoisk" data-movie="89515" data-order='["imdb"]'></div>
Результат:
Диапазон звёзд
Можно установить нужный вам диапазон звёзд (10 по умолчанию):
<div class="kinopoisk" data-movie="89515" data-range=5 ></div>
Результат:
Округление рейтинга
Можно установить нужное количество знаков после запятой (по умолчанию 1). Рейтинг кинополиса отдаёт значение с тремя знаками после запятой, а IMDB - с 1 знаком.
<div class="kinopoisk" data-movie="89515" data-range=5 data-fix=3></div>
Результат:
Использование ссылки вместо идентификатора
Можно использовать не идентификатор фильма на кинопоиске, а ссылку на него.
<div class="kinopoisk" data-movie="http://www.kinopoisk.ru/film/566055" ></div>
Результат:
Использование кеша
По умолчанию все данные рейтингов кешируюся на сутки. Но вы можете управлять этим параметром. Аттрибут cache_time хранит значение времени хранения кеша в миллисекундах. Если установить его в 0, то рейтинг кешироваться не будет.
<div class="kinopoisk" data-movie="506005" data-cache_time="0"></div>
Результат:
Информация, что данных не найдено
По умолчанию, если данных о фильме не найдено, будет выдано преупреждение. Вы можете его отключить или изменить его текст с помощью параметра data-no_data.
<div class="kinopoisk" data-movie="5060055555" data-no_data=""></div>
Результат с надписью по умолчанию:
Результат с вашей надписью:
Результат, когда скрипт ничего не выводит на страницу:
Отключение вывода рейтинга, если он равен нулю
Вы можете отключить вывод рейтинга, если он нулевой с помощью параметра data-show_zero_rating. По умолчанию этот параметр включен.
<div class="kinopoisk" data-movie="89515" data-show_zero_rating="false" ></div>
Результат:
API
Вы можете использовать API для контроля работы плагина.
<div id="my-rating"></div>
<script>
$("#my-rating").kinopoisk(
{
"movie": 326,
"range": 5,
"order": ["imdb", "kinopoisk"]
}
);
</script>
Результат:
Можно изменять шаблоны информера отдельно для каждого типа рейтинга.
<div id="my-rating2"></div>
<script>
$("#my-rating2").kinopoisk(
{
"movie": 327,
"order": ["kinopoisk"],
"kinopoisk_template": '<div>' +
'Рейтинг: <span class="kp_stars">$stars</span>' +
'<span class="kp_rating">$rating</span>' +
'<span><small>(Голосов: $vote)</small></span>' +
'</div>',
}
);
</script>
Результат:
Лицензия
Этот плагин находится под двойным лицензированием MIT и GPL2, так же как и сам jQuery.©2012, Dmitry Shamin