| Краткое описание | Плагин Discourse Surveys позволяет создавать опросы непосредственно в сообщениях вашего форума Discourse с помощью простого синтаксиса Markdown. | |
| Ссылка на репозиторий | https://github.com/discourse/discourse-surveys | |
| Руководство по установке | Как установить плагины в Discourse |
Плагин Discourse Surveys позволяет создавать опросы непосредственно в сообщениях вашего форума Discourse с помощью простого синтаксиса Markdown. Плагин в настоящее время поддерживает множество типов вопросов, таких как радиокнопки, флажки, выпадающие списки, поля ввода чисел, текстовые области, рейтинги по звездам и оценки «палец вверх/вниз».
Возможности
-
7 различных типов полей: радиокнопки, флажки, выпадающие списки, текстовые области, выбор чисел, рейтинг по звездам и «палец вверх/вниз»
-
Обязательные/необязательные поля: помечайте поля как обязательные, чтобы гарантировать их заполнение
-
Поддержка эмодзи: используйте эмодзи в вариантах ответов опроса
-
Поддержка Markdown: богатое форматирование текста в вопросах и вариантах ответов
-
Аутентификация пользователей: автоматическое предложение войти в систему для анонимных пользователей
-
Отслеживание ответов: предотвращает повторные отправки от одного и того же пользователя
-
Учет прав доступа: уважает права доступа к темам и категориям
-
Адаптивный дизайн: работает без проблем на всех устройствах
Использование
Базовая структура опроса
Все опросы должны быть заключены в теги [survey]:
[survey name="my-survey" title="Опрос клиентов"]
<!-- Здесь размещаются поля опроса -->
[/survey]
Атрибуты опроса
-
name: уникальный идентификатор опроса (по умолчанию «survey») -
title: необязательное название, отображаемое в верхней части опроса -
public: настройка видимости (функция планируется в будущем) -
status: статус опроса (функция планируется в будущем)
Типы полей
1. Радиокнопки (одиночный выбор)
[radio question="Какой ваш любимый цвет?"]
- Красный
- Синий
- Зеленый
- Желтый
[/radio]
2. Флажки (множественный выбор)
[checkbox question="Какие функции вы используете? (Выберите все подходящие)"]
- Уведомления по электронной почте
- Мобильное приложение
- Уведомления на рабочем столе
- Доступ к API
[/checkbox]
3. Выбор из выпадающего списка
[dropdown question="Какова ваша возрастная группа?"]
- До 18 лет
- 18–24 года
- 25–34 года
- 35–44 года
- 45–54 года
- 55+ лет
[/dropdown]
4. Текстовая область (длинный текст)
[textarea question="Пожалуйста, оставьте подробную обратную связь:" required="false"]
[/textarea]
5. Выбор числа
[number question="Оцените эту функцию от 1 до 10:" min="1" max="10"]
[/number]
6. Рейтинг по звездам
[star question="Как вы оцените ваш общий опыт?"]
[/star]
7. Палец вверх/вниз
[thumbs question="Порекомендовали бы вы это другим?"]
[/thumbs]
Атрибуты полей
Все типы полей поддерживают эти атрибуты:
-
question: текст вопроса (обязательно) -
required: обязательно ли заполнять поле (true/false, по умолчаниюtrue) -
min: минимальное значение для числовых полей -
max: максимальное значение для числовых полей
Полный пример
Базовый Markdown для опроса
Вот базовый пример Markdown для опроса, включающий все доступные поля:
[survey name="awesome-survey-thumbs" title="Отличный опрос"]
[radio question="Выберите один вариант:"]
- Кот
- Собака
[/radio]
[checkbox question="Выберите несколько вариантов:"]
- Красный
- Синий
- Зеленый
[/checkbox]
[dropdown question="Пол:"]
- Мужской
- Женский
[/dropdown]
[number question="Оцените этот опрос от 1 до 10:"]
[/number]
[textarea question="Какова ваша обратная связь по xyz?" required="false"]
[/textarea]
[star question="Как вы оцените общий опыт?"]
[/star]
[thumbs question="Устроили ли вас наши услуги?"]
[/thumbs]
[/survey]
Отображение опроса
Ниже приведен пример того, как приведенный выше Markdown отображается в Discourse:
Расширенное использование
Использование эмодзи в вариантах ответов
[radio question="Выберите ваше любимое животное:"]
- 🐈 Кот
- 🐶 Собака
- 🐦 Птица
- 🐠 Рыба
[/radio]
Форматирование Markdown в вопросах
[radio question="Какой **язык программирования** вы предпочитаете?"]
- JavaScript
- Python
- Ruby
- Go
[/radio]
[checkbox question="Выберите ваши *любимые* функции:"]
- Скорость
- Безопасность
- Простота использования
[/checkbox]
[textarea question="Пожалуйста, прочитайте наши [руководства](https://example.com) и оставьте обратную связь:"]
[/textarea]
Поддерживаемое форматирование:
- Жирный текст:
**текст** - Курсив:
*текст* Зачеркнутый текст:~~текст~~Код в строке:`код`- Ссылки:
[текст](url)
Смешанные обязательные и необязательные поля
[survey name="mixed-survey"]
[radio question="Какова ваша роль?" required="true"]
- Разработчик
- Дизайнер
- Менеджер
- Другое
[/radio]
[textarea question="Есть дополнительные мысли?" required="false"]
[/textarea]
[/survey]
Результаты опроса
В настоящее время у этого плагина нет пользовательского интерфейса для просмотра результатов опроса напрямую. Вместо этого вы можете использовать запросы Data Explorer для получения и анализа ответов на опрос. Вот пример запроса:
-- [params]
-- text :survey_name = survey
SELECT
s.id,
s.name,
s.post_id,
sf.question,
COALESCE(sr.value, sfo.html) AS value,
sr.user_id,
sr.created_at AS responded_at
FROM
surveys s
JOIN survey_fields sf ON sf.survey_id = s.id
JOIN survey_responses sr ON sr.survey_field_id = sf.id
LEFT JOIN survey_field_options sfo ON sfo.id = sr.survey_field_option_id
WHERE
s.name = :survey_name
ORDER BY
s.id DESC
Поддержка экспорта страниц администратора из бэкенда
Посетите /admin/plugins/discourse-surveys/export
Права доступа и безопасность
-
Требуется вход в систему: анонимные пользователи должны войти в систему перед отправкой ответов
-
Один ответ на пользователя: каждый пользователь может отправить только один ответ на опрос
-
Права доступа к теме: пользователи должны иметь права на чтение темы, чтобы просматривать опросы
-
Права на публикацию: пользователи должны иметь права на публикацию в теме, чтобы отправлять ответы
-
Архивные темы: опросы в архивных темах не могут принимать новые ответы
-
Удаленные сообщения: опросы в удаленных сообщениях больше недоступны
Ограничения
-
Разрешен только один опрос в сообщении
-
Структуру опроса нельзя изменить после получения ответов
-
Вопросы всех полей опроса должны быть уникальными в рамках одного опроса
-
Вопросы полей опроса не могут быть пустыми
Технические детали
Схема базы данных
Плагин создает четыре основные таблицы базы данных:
-
surveys: основные записи опросов -
survey_fields: отдельные поля в опросах -
survey_field_options: варианты для полей с выбором -
survey_responses: ответы пользователей на поля опроса
Стилизация
Плагин включает адаптивный CSS, который адаптируется к вашей теме. Пользовательские стили можно добавить, используя следующие CSS-классы:
-
.survey— основной контейнер опроса -
.survey-field— обертка для отдельного поля -
.field-[type]— контейнеры для конкретных типов полей -
.submit-response— кнопка отправки




