[Tickets] 1.3.0-beta Сниппет TicketMeta и рейтинги

Представляю вам новую версию Tickets, с большими изменениями.

В первую очередь, добавились социальные функции - возможность голосовать за тикеты и комментарии. Кое-что было предусмотрено для этого в компоненте с самого начала, но руки так и не дошли.

А вот недавно товарищ Wassi Wassinen профинансировал вопрос, и теперь у нас есть рейтинги. Не знаю, насколько это будет полезно у меня на сайте, но как минимум протестировать нужно. А там решим - оставить или отключить.

Система голосования

Голосовать можно за комментарии и тикеты. Для этого нужно обладать правами - ticket_vote - разрешение голосовать за тикеты

• comment_vote - разрешение голосовать за комментарии

Оба разрешения включены в политики безопасности по умолчанию. За свои тикеты и комменты голосовать нельзя.

Чтобы включить рейтинги, вам нужно просто обновить чанки. Пришлось довольно сильно помучиться с оформлением всех этих стрелочек и статусов, но я умудрился сделать всё без единого фильтра - только "быстрыми плейсхолдерами" pdoTools.

Изменены чанки: - tpl.Tickets.list.row - чанк оформления списка тикетов

• tpl.Tickets.comment.one.auth - комментарий для авторизованного пользователя
• tpl.Tickets.comment.one.guest - комментарий для гостя

Их можно перезаписать при обновлении пакета, если у вас там немного изменений. Иначе топаем по ссылкам на github и делаем как там.

Чего пока нет: 1. Нет периода скрытия рейтинга тикета для гостей. Гости видят рейтинг сразу, а юзеры после голосования. 2. Нет подсчета рейтинга юзера и кармы. Честно говоря, не уверен, что это вообще будет, но вы легко можете делать выборки из таблицы TicketVote и считать что угодно. 3. Заминусованные комментарии никак не прячутся. 4. Время голосования никак не ограничивается.

Всё остальное вроде реализовал (поправьте в комментариях, если нет).

Сниппет TicketMeta

Для голосования за тикет на его собственной странице пришлось написать новый сниппет.

Он умеет: - Выводить симатичную дату [[+date_ago]]

• Выводить информацию о секции тикета с префиксом "section.", то есть: [[+section.id]], [[+section.uri]] и т.д.
• Выводить информацию об авторе тикета
• Выводить количество просмотров [[+views]]
• Выводить количество комментариев [[+comments]]
• Выводить общий рейтинг и нужную информацию для его работы

То есть, это готовый сниппет для вывода всей нужной информации на странице тикета. В комплекте к нему идёт чанк tpl.Tickets.meta. Если вдруг кто пользовался плейсхолдерами [[+views]], [[+comments]] и [[+date_ago]], то переходите на использование нового сниппета - этих плейсхолдеров на странице больше нет.

У сниппета всего три параметра: чанк для вывода и возможность отключить получение секции и автора, чтобы не делать лишних запросов, если они вам не нужны.

Исправления и улучшения

В комментарии добавлена прикольная штука, подсмотренная на Хабре - перемотка к родителю и обратно. Может быть полезно при больших беседах, когда зыбываешь, на что отвечаешь.

Также в комментарии добавлен плейсхолдер [[+idx]]. Ну, просто для порядка.

[#57] Добавлены все плейсхолдеры юзера при просмотре и публикации комментария - можно использовать [[+username]].

[#56] При редактировании тикета в админке добавлено окошко description.

[#55] Исправлена ошибка с изменением alias тикета при редактировании pagetitle на фронтенде.

Почистил код класса Ticket и сниппета TicketComments.

Заключение

Обновляемся из репозитория и благодарим Wassi Wassinen за финансирование новой версии. Просьба тестировать и писать об ошибках - здесь и на GitHub.

Ну и, конечно, голосуем!

Обновлено 01.02.2014

Выложил в репозиторий beta2: - [#58] Исправлено переключение класса существующего документа на Ticket

• Так как тикеты не показываются в дереве, и при переключении modDocument на Ticket, вы можете их просто потерять - добавил checkbox show_in_tree.
• А заодно добавил и системную настройку ticket_show_in_tree_default
• И поменял системные настройки по умолчанию. Теперь тикеты не скрываются в меню, не являются контейнерами и не именуются по id. Ваши текущие настроки это не заденет, изменения касаются только новых установок.
• Добавлена колонка owner в класс TicketVote. Теперь вы можете легко считать рейтинг юзеров по сумме голосов за их тикеты и комменты (очередное спасибо Wassi Wassinen).

[[!pdoPage?
    &element=`pdoUsers`
    &leftJoin=`{"Vote":{"class":"TicketVote","on":"modUser.id=Vote.owner AND class IN ('Ticket','TicketComment')"}}`
    &select=`{"modUser":"*", "Vote":"SUM(value) as rating"}`
    &groupby=`modUser.id`
    &sortby=`rating`
    &sortdir=`desc`
    &tpl=`@INLINE <p>[[+idx]]. [[+fullname]] — <b>[[+rating]]</b></p>`
]]
[[!+page.nav]]

Кстати говоря, еще вы можете выводить тикеты, отсортировав их по рейтингу:

[[!pdoPage?
    &element=`getTickets`
    &parents=`0`
    &leftJoin=`{"Vote":{"class":"TicketVote","on":"Ticket.id=Vote.id and Vote.class='Ticket'"}}`
    &select=`{"Ticket":"*", "Vote":"SUM(value) as rating"}`
    &groupby=`Ticket.id`
    &sortby=`rating`
    &sortdir=`desc`
    &tpl=`@INLINE <p>[[+idx]]. [[+pagetitle]] — <b>[[+rating]]</b></p>`
]]
[[!+page.nav]]

Присоединение таблиц в сниппетах pdoTools - могучая вещь!