AnythingRating: Примеры

1455

AnythingRating: Примеры

Использование

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

[!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