Примеры

AnythingRating: Примеры

Примеры вызова сниппета AnythingRating.

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

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

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

где:

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

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

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

где:

• &atrGrp=`grpName` - определяем, к какой группе относится наш рейтинг
• &atrId=`idItem` - уникальный идентификатор предмета рейтинга. Может быть 2903 или в чанке 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=`2903`!]

где:

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

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

где:

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

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

[!AnythingRating? &atrGrp=`photos` &atrId=``!]

где:

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

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

где:

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

Лучшие по рейтингу

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

• отображение 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