# Инструкция по использованию Teest Classic (публичный кейс)
Дата: 26 марта 2026
Назначение: быстрый запуск на сайте для демонстрации кейса и поиска финансирования.
---
## 1. Что уже работает
- Создание и хранение тестов в `com_teest`.
- Прохождение теста на сайте через:
- пункт меню `com_teest`,
- модуль `mod_teest` (inline-режим).
- Подсчет баллов, процента, запись попытки в БД.
- Экспорт результата в TXT и кнопка "Поделиться" (для поддерживаемых браузеров).
- Комментарии к вопросам (если включен соответствующий флаг показа).
## 2. Сценарий "создать тест и сразу показать на сайте"
### Шаг 1. Создать тест в админке
1. Откройте: `Компоненты -> Teest -> Тесты`.
2. Нажмите "Создать".
3. Заполните:
- Название теста;
- Статус: "Опубликовано";
- Блок "Детали теста" (описание, инструкция, рекомендации, время);
- Блок "Лицензия" (номер, класс, сложность, регулятор, срок, статус).
4. Сохраните тест.
Важно: для прохождения на сайте статус лицензии должен быть `active` (Активна).
### Шаг 2. Добавить вопросы и ответы
1. Внутри теста добавьте вопросы.
2. Для каждого вопроса добавьте варианты ответов и баллы (`score`).
3. При необходимости добавьте "комментарий к вопросу" (подсказка/примечание).
4. Сохраните.
### Шаг 3. Показать тест на сайте
Есть два рабочих пути.
- Через **пункт меню** (подходит для постоянной страницы теста).
- Через **модуль** (подходит для размещения в позиции шаблона, рядом с другим контентом).
---
## 3. Управление через админ-панель: меню vs модуль
## 3.1 Вывод через пункт меню (`com_teest`)
Путь:
1. `Меню -> нужное меню -> Создать пункт`.
2. Тип пункта: `Teest -> Тест`.
3. Выберите нужный тест.
4. Настройте флаги отображения (кнопки "Подробнее", детали теста, комментарии и т.д.).
Когда использовать:
- нужна отдельная "чистая" страница теста;
- тест должен открываться по постоянному URL;
- удобно для SEO и прямых ссылок.
## 3.2 Вывод через модуль (`mod_teest`)
Путь:
1. `Расширения -> Модули -> Создать -> Teest`.
2. Укажите способ выбора теста (по test id / article id, в зависимости от текущей конфигурации).
3. Настройте:
- показывать/скрывать кнопки "Подробнее";
- показывать/скрывать текст материала;
- показывать/скрывать комментарии к вопросам;
- показывать/скрывать кнопку "Открыть тест";
- режим inline (тест прямо в модуле) или переход в компонент.
4. Назначьте позицию модуля и страницы меню.
Когда использовать:
- нужно быстро встроить тест в существующую страницу;
- нужны разные блоки тестов в разных позициях сайта;
- важно гибко управлять видом именно на уровне модуля.
---
## 4. Как устроены кнопки и флаги
## 4.1 Кнопки "Подробнее"
- "Подробнее о тесте" управляет левой информационной панелью.
- "Подробнее о лицензии" управляет правой информационной панелью.
- Эти кнопки можно отключать настройками (в меню или модуле).
## 4.2 Кнопка "Отправить"
- Активна только когда статус лицензии `active`.
- Если статус не `active`, тест можно просматривать, но отправка блокируется.
## 4.3 Галочка "Скачать результат после прохождения"
- Включает блок данных клиента (имя, контакт, комментарий).
- Данные попадают в текст выгрузки результата.
- После отправки теста появляются кнопки:
- "Скачать TXT",
- "Поделиться".
---
## 5. Что показывать в кейсе для инвестора/партнера
Рекомендуемый показ:
1. Открыть админку и показать создание теста (2 вопроса, 3-5 ответов).
2. Показать публикацию на сайте через:
- пункт меню,
- модуль.
3. Пройти тест на сайте, получить результат и скачать TXT.
4. Коротко показать, что попытка сохраняется в БД.
Эта связка наглядно подтверждает:
- продукт уже работает,
- архитектура расширяема,
- система пригодна для доработки под задачи заказчика.
---
## 6. Ограничения текущего релиза (честно)
- Часть режимов отображения еще в стадии стабилизации и донастройки.
- Интерфейс будет улучшаться, но базовый цикл уже рабочий:
`создать -> опубликовать -> пройти -> сохранить -> скачать`.
Именно этого достаточно для публичного пилотного кейса "версия сейчас, развитие по дорожной карте".
Категория - Teest Classic
Материалы категории "Teest Classic"
Материал и документ созданы: 18:49 Ленинградское время 26 марта 2026 года лагерь для беженцев Тер Апель Нидерланды СССР