Опросы в реальном времени в комментариях

Чтобы создать опрос, нажмите кнопку опроса на панели инструментов редактора комментариев. Редактор опроса открывается под полем ввода текста, где вы можете задать:

• Вопрос, до 200 символов.
• Варианты, от 2 до 10, каждый до 100 символов. Используйте Add option, чтобы добавить больше.
• Когда опрос закрывается: без даты окончания, 1 день, 3 дня или 1 неделя. Закрытый опрос показывает окончательные результаты и больше не принимает голоса.
• Конфиденциальность: остаются ли голосующие анонимными, видимыми для администраторов или публичными. См. Voter Privacy.
• Требовать голос для просмотра результатов: если отмечено, результаты скрыты от каждого зрителя, пока они не проголосуют или опрос не закроется.

Пишите ваш комментарий как обычно и публикуйте его. Опрос публикуется вместе с комментарием. Опросы можно добавлять к новым комментариям и к ответам.

Чтобы отменить опрос перед публикацией, нажмите Remove poll.

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

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

Результаты обновляются в реальном времени. Когда кто‑то на странице голосует, счётчики и полосы обновляются у всех, кто просматривает опрос, без перезагрузки страницы.

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

Каждый опрос имеет настройку конфиденциальности, выбранную его автором при создании. Опрос отображает свою настройку под параметрами, чтобы избиратели знали, кто может видеть их голос до того, как они его отдадут.

• Анонимный (по умолчанию): показываются только итоги. Никто, включая администраторов, не может увидеть, кто за что проголосовал.
• Администраторы могут видеть, кто проголосовал: только администраторы и модераторы могут открыть See who voted, где перечислены каждый избиратель и его выбор.
• Публичный: любой зритель может нажать See who voted и увидеть, кто за что проголосовал.

Голоса от посетителей, не вошедших в систему, учитываются, но без привязанного имени, поэтому они не отображаются в списке избирателей.

Автор опроса получает уведомления по мере поступления ответов:

• В приложении: уведомление под значком колокольчика, когда в опросе появляется новый ответ. Когда многие люди голосуют, они группируются в одно уведомление.
• Электронная почта: ежедневное письмо автору опроса, когда их опрос получает новые ответы в течение дня.

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

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

Электронное письмо содержит ссылку для отключения уведомлений для этого опроса. Его содержание можно изменить с помощью шаблона Poll Response Notification, см. Шаблоны электронной почты.

Опросы также можно управлять из собственного кода с помощью REST API, например, чтобы добавить опрос к комментарию из вашего бэкенда, закрыть опрос или экспортировать голоса:

• Poll Structure описывает объект опроса и его ограничения.
• GET, PUT, PATCH и DELETE /api/v1/polls/:commentId читают, заменяют, редактируют и удаляют опрос в комментарии.
• PollVote Structure описывает отдельный голос.
• GET, POST и DELETE /api/v1/poll-votes перечисляют, регистрируют и удаляют голоса.

Опрос также можно создать вместе с его комментарием, передав poll в POST /api/v1/comments.

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