Общая информация

Документация по модулю для веб-версии

Модуль также доступен в веб-версии портала. Документация по работе с модулем в веб-версии находится на странице https://motivityy.atlassian.net/wiki/spaces/Documentation/pages/5735267

Бизнес-роли

Ограничение при недостатке баллов

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

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

Как работать с модулем в приложении

Как просмотреть список всех доступных записей в блоге

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

Перейти на этот экран можно через боковое меню или пуш-уведомление.

Open

Главный экран модуля Блоги

Если в модуле нет ни одной записи, доступной для просмотра пользователю, отображается заглушка об отсутствии записей.

Open

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

Записи с отложенной датой публикации (значение в поле Дата публикации еще не наступила), автором которых является текущий пользователь, отображаются с затемнением и подписью Запись не опубликована

Выбор категории записей

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

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

По умолчанию первой (активной) вкладкой выводится вкладка Все, которая включает все записи категорий и все записи без указания категории.

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

Механика сортировки записей

Для выбора необходимого способа сортировки записей в блоге, требуется воспользоваться кнопкой Сортировка в правом верхнем углу экрана.

По нажатию на кнопку, в нижней части экрана открывается перечень опций, доступных для сортировки:

• Сбросить сортировку - сбрасывает сортировку на вариант по умолчанию

• По дате добавления

• По количеству просмотров

• По популярности

По умолчанию карточки отсортированы По дате добавления ↓ (по убыванию, от новых к старым).

Для каждого варианта сортировки предусмотрено два направления — по убыванию ↓ и по возрастанию ↑. Переключение происходит по повторному тапу на опцию.

Карточки с одинаковым количеством просмотров/лайков сортируются по дате публикации записи:

• Если выбрано направление по убыванию ↓ — от новых к старым

• Если выбрано по возрастанию ↑ — от старых к новым

Из чего состоит карточка записи

Для каждой записи на главном экране модуля выводится следующая информация:

• Аватар, имя, фамилия автора записи - кликабельно, ведёт на личный кабинет блогера

• Время, дата публикации записи

• Название категории записи (при наличии) - некликабельно

• Кебаб-меню для вызова настроек записи

• Изображение-превью (при наличии)

• Заголовок

• Маркер-точка перед заголовком для непросмотренных записей

• Краткое описание

• Количество лайков к записи с возможностью лайкнуть/дизлайкнуть запись

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

• Количество просмотров записи

Как отфильтровать записи по автору

Чтобы отфильтровать в общем списке все записи по одному блогеру, необходимо на записи этого блогера вызвать настройки через кебаб-меню и выбрать опцию Все записи

Если вы являетесь блогером, то чтобы отфильтровать общий список по своим записям, необходимо на своей записи вызвать настройки через кебаб-меню и выбрать опцию Мои записи

При выборе опции Все записи / Мои записи:

• На экране остаются только записи выбранного блогера, доступные для просмотра

• Текст “Блоги” вверху экрана заменяется на имя, фамилия автора записи

• На вкладках остаются только те категории, в которых есть хотя бы одна запись выбранного пользователя

Возврат к общему списку всех записей происходит по нажатию на кнопку “назад“

Фильтрация по блогеру сохраняется при просмотре записей на экране модуля Блоги и сбрасывается при переходе в другие разделы приложения с помощью меню.

Как подписаться на записи автора

Чтобы подписаться на новые записи блогера, необходимо на записи этого блогера вызвать настройки через кебаб-меню и выбрать опцию Подписаться

Как отписаться от автора

Чтобы отписаться от блогера, необходимо на записи этого блогера вызвать настройки через кебаб-меню и выбрать опцию Отписаться

Как просмотреть полный текст записи блога

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

Полный текст записи содержит:

• Контент с форматированием, который был добавлен пользователем при создании записи:

  • Текст с форматированием

    • Нажатие на ссылки из текста записи приводит к загрузке страницы во встроенном браузере приложения

  • Изображения и видео

    • Видео, которое пользователь вставил в тело записи на этапе ее формирования, имеет вид видеоплеера, когда запись уже загружена в ленту

    • При нажатии на видео открывается полноэкранный режим просмотра и видео начинает проигрываться

• Галерея изображений – по нажатию открываются в полноэкранном режиме просмотра

• Прикреплённые файлы – по нажатию файл скачивается

• Теги – по нажатию на тег происходит переход на экран Поиск, на котором будет отображена поисковая выдача со всеми записями, к которым прикреплён этот тег

• Внизу экрана расположен блок со счётчиками лайков и комментариев:

  • Счётчик лайков работает как кнопка и нажав на неё пользователь может выразить своё одобрение

  • Нажатие на счётчик комментариев вызывает переход на экран просмотра комментариев с формой отправки комментария

Просматривая полный текст записи блога, также доступна возможность отфильтровать записи по автору и возможность подписаться/отписаться от автора (см. разделы выше).

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

При просмотре записи с отложенной датой публикации (значение в поле Дата публикации еще не наступила), автором который вы являетесь, в верхней части выводится надпись Запись не опубликована

Как создать запись

Создание записей доступно пользователям, у которых в соответствии с ролевой моделью имеется доступ к разрешению Блоги → Создание записей (см. ).

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

Экран создания записи

Поля Заголовок, Краткое описание и Текст – обязательны для заполнения. Если эти обязательные поля не заполнены, кнопка Опубликовать будет неактивна.

Ограничения по количеству символов:

• Поле Заголовок – до 80 символов

• Поле Краткое описание – до 240 символов

• Поле Текст – ограничений по символам нет

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

Загружать файлы и изображения можно, но это необязательно для создания записи.

Поле Дата публикации позволяет указать дату, на которую произойдет публикация записи. Если не заполнено при создании записи, датой публикации считается текущее время и дата публикации.

Поле Теги позволяет добавить к записи теги (без возможности создать свой тег):

• Отображается только если есть доступные для выбора теги

• По нажатию на поле, в нижней части экрана открывается панель с поиском и выбором ранее созданных в административной панели тегов (см. )

• По нажатию на кнопку Применить, выбранные теги добавляются в запись

Чек-бокс Запись доступна к просмотру указывает на видимость публикуемой записи. При деактивации чек-бокса запись будет опубликована как Скрытая.

В поле Текст вносится контент записи. В поле доступны следующие возможности текстового редактора TinyMCE.

• Общие:

  • Ввод многострочного текста

  • В поле доступно упоминание пользователя портала:

    • После ввода символа @ и нескольких символов имени пользователя появляется подсказка с подходящими под запрос пользователями. При выборе нужного пользователя из списка упоминание о нём выводится в поле в формате: id + (Имя Фамилия)

    • Если совпадений не найдено, то подсказка не выводятся

• Выпадающий список форматирования текста:

  • Заголовки — c H2 по H6

  • Абзацы — по клику добавляется пустой блок соответствующего типа:

    • Важное

    • Цитата

• Удалить форматирование

• Иконки управления стилем текста:

  • Полужирный

  • Курсив

  • Подчёрнутый

• Иконки списков — по клику добавляется соответствующий вид списка:

  • Маркированный

  • Нумерованный

• Иконка ссылки — по клику выводится стандартный поп-ап TinyMCE управления ссылкой

• Иконка изображения — по клику выводится стандартный поп-ап TinyMCE добавления изображения. Изображение добавляется в тело записи.

  • Форматы: стандартные форматы, поддерживаемые TinyMCE

  • Размер одного файла изображения: не должен превышать 10 Мб

• Иконка видео — по клику выводится стандартный поп-ап TinyMCE добавления видео. Видео добавляется в тело записи.

  • Форматы: стандартные форматы, поддерживаемые TinyMCE

  • Размер одного видео: не должен превышать 1 Гб.

• Горизонтальная линия — по клику в текст добавляется горизонтальный разделитель

• Иконка эмодзи — по клику выводится стандартный поп-ап TinyMCE выбора эмодзи.

• Кнопки:

  • Отменить — отменяет последнее действие

  • Вернуть — возвращает последнее отменённое действие

Как отредактировать созданную запись

Для того чтобы перейти на экран редактирования записи, необходимо на карточке записи в общем списке или на странице самой записи вызвать настройки через кебаб-меню и выбрать опцию Редактировать

Экран редактирования записи аналогичен экрану создания записи. Отличие заключается в том, что:

• При редактировании некоторые поля на странице уже заполнены текущими значениями

• Текст в верхней части экрана имеет значение Редактировать запись

Как скрыть созданную запись

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

Скрыть запись также возможно на экране редактирования записи, деактивировав чек-бокс Запись доступна к просмотру

Для того чтобы сделать запись снова видимой, необходимо на карточке записи в общем списке или на странице самой записи вызвать настройки через кебаб-меню и выбрать опцию Опубликовать или на экране редактирования записи активировать чек-бокс Запись доступна к просмотру

Как удалить созданную запись

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

Какие пуш-уведомления настроены для модуля

События, для которых отправляются уведомления, описаны в соответствующем разделе документации по пуш-уведомлениям в приложении.