Тестовая Страницы

О плагине

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