Примеры

    AnythingRating: Примеры

    Примеры вызова сниппета 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