Плагин позволяет любому посетителю сайта оценить качество статьи (поста) в вашем блоге. Плагин суммирует все оценки и вычисляет среднюю. [микроформат убран из вёрстки, т.к. для Google это более не актуально]
Плагин показывает всем посетителям форму с просбой оценить статью. Голосовать может любой посетитель сайта. Идентификатор оцененной статьи сохраняется в cookies браузера со сроком хранения одна неделя. Таким образом посетитель через неделю может снова оценить вашу статью.
Плагин может работать в двух режимах. В автоматическом режиме подключение css-стилей, js-скрипта для голосования, самой формы происходит с использованием хуков. В ручном режиме подключить файлы css и js вам придется вручную, а форму голосования и рейтинга вставить в любое место шаблона post.html
Хелпер плагина
Получить объект хелпера в шаблоне:
{$vote_helper = blogVotePlugin::helper()}
Получить объект данных рейтинга для поста:
{$rating = $vote_helper->getRating($post)}
где $post — это массив данных о посте блога (он есть на странице поста)
Получить HTML с рейтингом и формой голосования:
{$vote_helper->getRatingHtml($rating)} – тут в качестве параметра передается объект данных рейтинга $rating
или {$vote_helper->getRatingHtml($rating, '/path/to/template')} – в качестве второго параметра можно указать свой файл шаблона
- getRating() — получить суммарный рейтинг, т.е. сумму всех оценок. {$rating->getRating()}
- getVoteCount() — получить общее количество голосов {$rating->getVoteCount()}
- getPercent() — получить процент (с точностью до десятой от 0 до 100). Может пригодиться для использования в атрибуте style для задания ширины например {$rating->getPercent()}
- getScore() — получить средний рейтинг поста. Число с точностью до десятой в дианазоне от 0 до 5. {$rating->getScore()}
