Отредактировано: 20 Марта 2023

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

Для того, чтобы пользователи могли оставлять записи или комментарии, они должны обладать соответствующими правами. При установке, Tickets создает следующие политики доступа:

• TicketSectionPolicy — разрешение для создания новых тикетов в разделе;
• TicketUserPolicy — разрешение на управление возможностями Tickets, добавление, удаление, чтение и т.п.;
• TicketVipPolicy — тоже самое что TicketUserPolicy, но с воможностью просматривать приватные Тикеты.

Сам компонент состоит из нескольких сниппетов, каждый из которых отвечает за определенные действия.

Публикация из фронт-энда

[[!TicketForm?
&allowedFields=`parent,pagetitle,content,published,image`
&requiredFields=`parent,pagetitle,content`
&tplFormCreate=`shareForm`
&redirectUnpublished=`31`
]]

Ресурсы Tickets находятся в той же таблице SQL что и остальные ресурсы — prefix_site_content. Несмотря на то, что в админке нет возможности сделать из тикета обычный ресурс, это можно сделать с помощью SQL запросов.

Показ пользователю опубликованных им же ресурсов 

[[!getTickets?
	&user=`[[!+modx.user.id]]`
	&showUnpublished=`1`
	&parents=`21`
	&includeTVs=`tags,image,slider,year,view,like`
	&tpl=`getArticle`
]]

Вставка файлов в Tickets — плейсхолдер [[+files]]

Можно добавлять файлы при помощи 

Файлы загружаются сразу при добавлении и сохраняются в таблицу TicketFile.

Параметры сниппета TicketForm для испоьзования файлов:

• allowFiles — Разрешить загрузку файлов? Если да — то подключится загрузчик и нужные скрипты.
• source — Источник медиа-файлов, в который будут сохранены изображения. По умолчанию берется системны настройка tickets.source_default, в которую прописывается источник Tickets Files.
• tplFiles — Чанк-обертка всего блока работы с файлами. Загружчик, список файлов и прогрессбар.
• tplFile — Чанк оформление файла, который не является изображением.
• tplImage — Чанк офомрления картинок.

Выводом файлов занимается снипет TicketMeta, но также можно использовать pdoResources, добавив к вызову параметры &class=`TicketFile` &sortby=`createdon`
&sortdir=`ASC`. Если не указать сортировку, сниппет попытается сортировать по колонке publishedon, которая у TicketFile отсутствует.

Голосование и прочее meta

[[!TicketMeta]]

TicketMeta позволяет голосовать, сохранять ресурсы в избранное,

Избранное сохраняется в таблицу TicketStar, где пишется имя класса (Ticket или TicketComment), id объекта, id его автора и дата.

Добавление\удаление избранного работает через процессоры, которые требуют прав: ticket_star и comment_star.

Параметры сниппета TicketMeta для вывода файлов:

• getFiles — Выводить список загруженных файлов?
• tplFile — Чанк оформления сслыки на файл.
• unusedFiles — Выводить только файлы, неиспользованные в контенте документа.

Обертка для вывода файлов прописана в чанке tpl.Tickets.meta, в быстром плейсхолдере has_files.

Комментарии

Построение дерева комментариев

[[!TicketComments]]

Для вывода списка комментариев

[[getComments]]

Параметры сниппета getComments

• parents — выбор родительского раздела комментариев;
• resources — выбор родительского ресурса комментариев;
• threads — выбор ветки;
• comments — id комментариев.

Избранное

Для вывода избранных тикетов можно использовать:

[[!pdoPage? 
&element=`getTickets` 
&sortby=`{"star_createdon":"DESC"}` 
&groupby=`star_id HAVING star_id IS NOT NULL AND star_user = [[!+modx.user.id]]`
]]

Для вывода избранных тикетов и комментариев можно использовать:

[[getStars]]

• class — указывается Ticket или TicketComment.

Выберет id избранного и передаст в getTickets или getComments. Если не указан параметр &user, то будет показано избранное текущего пользователя.

Документации

getTickets

[[!pdoPage?
    &element=`getTickets`
]]

[[!+page.nav]]

getTicketsSections

[[!getTicketsSections?]]

TicketComments

[[!TicketComments?]]

[[!TicketComments? &allowGuest=`1`]]

TicketForm

[[!TicketForm?]]

TicketLatest

[[!TicketLatest? &limit=`5` &fastMode=`1` &action=`tickets` &tpl=`tpl.Tickets.ticket.latest`]]

[[!TicketLatest? &limit=`5` &fastMode=`1` &action=`comments` &tpl=`tpl.Tickets.comment.latest`]]

TicketMeta

[[!TicketMeta?]]

[[!TicketMeta? &tpl=``]]