AnythingRating 1.0.1 Рейтинг ресурсов. Голосование посетителей

Добавьте первый вызов в начале страницы , для определения группы рейтинга:

[!AnythingRating? &define=`1` &atrGrp=`grpName`!]

где:

• &define=`1` - указываем, что данный вызов сниппета предназначен для определения группы рейтинга
• &atrGrp=`grpName` - имя группы рейтинга. Любая комбинация символов AZ, подчеркивания и цифр 0-9

Возле предмета (изображения, статьи и т.д.), к которому добавляем голосование размещаем такой вызов сниппета:

[!AnythingRating? &atrGrp=`grpName` &atrId=`idItem`!]

где:

• &atrGrp=`grpName` - определяем, к какой группе относится наш рейтинг
• &atrId=`idItem` - уникальный идентификатор предмета рейтинга. Может быть [*id*] или [+maxigallery.picture.id+] в чанке maxigallery или каким либо другим id.

Для вывода ТОП рейтинга используем следующий вызов сниппета:

[!AnythingRating? &getTopRated=`1` &atrGrp=`grpName` &topTable=`site_content` &topTitleField=`pagetitle`!]

где:

• &getTopRated=`1` - указываем, что данный вызов предназначен для вывода результатов голосования
• &atrGrp=`grpName` - определяем группу по которой будем выводить результаты
• &topTable=`site_content` - указываем имя таблицы, которая содержит данные предметов рейтинга. Имя таблицы указывается без префикса MODx
• &topTitleField=`pagetitle` - поле, используемое в качестве названия предмета рейтинга

Вы можете настроить внешний вид результатов голосования с помощью CSS в файле css/anythingRating.css. Так же вы можете настроить форму для голосования в шаблоне templates/anythingRating.tpl.html или форму вывода результатов голосования в шаблоне templates/topRated.tpl.html. Смотрите возможные плэйсхолдеры для использования в шаблонах.

Это простейший пример вызова определяет рейтинг группы 'photos':

[!AnythingRating? &define=`1` &atrGrp=`photos`!]

• хранение всех IP-адресов проголосовавших по каждому пункту
• виджет из 5 звезд (определено по умолчанию файлом CSS)
• дата проведения рейтинга неограничена
• язык установлен в качестве языка менеджера MODx

Этот вызов сниппета определяет рейтинг группы 'travelbook':

[!AnythingRating? &define=`1` &atrGrp=`travelbook` &language=`francais-utf8` &canVote=`travel` &nbIP=`200` &nbStars=`10` &endDate=`2014-06-30` &atrTpl=`@FILE:assets/snippets/anythingRating/templates/travelBookTpl.tpl.html` &atrCss=`@FILE:assets/snippets/anythingRating/css/travelBookCss.css`!]

• &language=`francais-utf8` - языковой пакет Francais-utf8
• &canVote=`travel` - проголосовать могут только веб-пользователи из веб-группы "travel"
• &nbIP=`200` - хранение до 200 IP-адресов проголосовавших по каждому пункту
• &nbStars=`10` - виджет и 10 звезд (определяется CSS-файлом)
• &endDate=`2014-06-30` - дата окончания конкурса
• travelBookTpl.tpl.html - как файл шаблона
• travelBookCss.css - как CSS-файл

[!AnythingRating? &atrGrp=`travelbook` &atrId=`[*id*]`!]

где:

• &atrGrp=`travelbook` - группа рейтинга
• &atrId=[*id*] - уникальный идентификатор текущего документа

Этот пример вызова сниппета может использоваться, например в шаблоне для Ditto:

[[AnythingRating? &atrGrp=`travelbooks` &atrId=`[+id+]` &init=`opinion:[+id+]`]]

где:

• &atrGrp=`travelbook` - группа рейтинга
• &atrId=[+id+] - уникальный идентификатор текущего документа
• &init=`opinion:[+id+]` - начальное значение рейтинга из TV 'opinion' документа [+id+]

Этот сниппет вызывается в шаблоне изображения maxigallery:

[!AnythingRating? &atrGrp=`photos` &atrId=`[+maxigallery.picture.id+]`!]

где:

• &atrGrp=`photos` - группа рейтинга
• &atrId=[+maxigallery.picture.id+] - уникальный идентификатор изображения, которое вы хотите оценить

[!AnythingRating? &atrGrp=`products` &atrId=`[*id*]` &noVotes=`1` &init=`opinion`!]

где:

• &atrGrp=`products` - группа рейтинга
• &atrId=[*id*] - уникальный идентификатор текущего документа
• &noVotes=`1` - голосование не разрешается, отображается только результат
• &init=`opinion` - инициализация голосов от TV 'opinion'

Этот сниппет выведет рейтинг документов в конкурсе `travelbook`:

[[AnythingRating? &getTopRated=`1` &atrGrp=`travelbook` &topTable=`site_content` &topTitleField=`pagetitle` &topLabel=`travelbooks`]]

• отображение 5 лучших по рейтингу
• идентификатор, название и описание в рейтинге берется из таблицы "site_content"
• поле идентификатора используется как "ID" по умолчанию
• название блока с результатми рейтинга "travelbooks"
• имя поля для названия pagetitle из таблицы "site_content"
• поля с описанием, изображением и ссылкой по умолчанию не используются
• шаблон по умолчанию: assets/snippets/anythingRating/templates/topRated.tpl.html

Этот сниппет выведет рейтинг изображений в конкурсе `photos`:

[!AnythingRating? &getTopRated=`1` &topDir=`worst` &atrGrp=`photos` &topNb=`3` &topTpl=`@FILE:assets/snippets/anythingRating/templates/anotherTopRated.tpl.html` &topTable=`maxigallery` &topDescrField=`descr` &topImageField=`filename` &topLinkField=`gal_id` &topLabel=`photos`!]

• отображение 3 худших по рейтингу!
• идентификатор, название и описание в рейтинге берется из таблицы "maxigallery"
• поля для идентификатора и названия используется как 'id' и 'title' по умолчанию
• название блока с результатми рейтинга "photos"
• имя поля для описания 'descr' берется из таблицы "maxigallery"
• для ссылки используется поле 'gal_id'
• для изображения используется поле 'filename'
• шаблон по умолчанию: assets/snippets/anythingRating/templates/anotherTopRated.tpl.html