Разработка:im/achievements — различия между версиями

Материал из DOF
Перейти к: навигация, поиск
(Панель управления достижениями)
(Рейтинг)
 
(не показано 15 промежуточных версий 2 участников)
Строка 12: Строка 12:
 
*Панель модерации достижений пользователей
 
*Панель модерации достижений пользователей
 
*Мое портфолио
 
*Мое портфолио
 
+
[[Изображение:Selection_011.png‎||350px|center|]]
 
=== Панель управления достижениями ===
 
=== Панель управления достижениями ===
 
Через данный интерфейс производится администрирование шаблонов достижений.  
 
Через данный интерфейс производится администрирование шаблонов достижений.  
Строка 22: Строка 22:
 
Добавленные разделы отображаются в виде таблицы, в первом столбце которой доступны операции по редактированию, удалению и блокировке раздела.
 
Добавленные разделы отображаются в виде таблицы, в первом столбце которой доступны операции по редактированию, удалению и блокировке раздела.
 
Перед самой таблицей имеется кнопка, включающая режим сортировки разделов. В режиме сортировки путем перетаскивания можно поменять порядок отображения разделов.
 
Перед самой таблицей имеется кнопка, включающая режим сортировки разделов. В режиме сортировки путем перетаскивания можно поменять порядок отображения разделов.
 
+
[[Изображение:Selection 012.png||900px|center|]]
 
Находясь в разделе имеется возможность добавлять шаблоны достижений при помощи кнопки “Добавить шаблон достижения”.
 
Находясь в разделе имеется возможность добавлять шаблоны достижений при помощи кнопки “Добавить шаблон достижения”.
 
Первым шагом добавления шаблона является настройка его основных характеристик таких как:
 
Первым шагом добавления шаблона является настройка его основных характеристик таких как:
Строка 43: Строка 43:
 
*список - пользователю будет необходимо выбрать пункт из выпадающего списка при создании достижения
 
*список - пользователю будет необходимо выбрать пункт из выпадающего списка при создании достижения
 
Все типы полей имеют возможность указания названия поля, выбора опции необходимости подтверждения поля модератором, коэффициента, на который будут умножены баллы достижения при заполнении поля. Выпадающий список имеет коэффициенты для каждого из пунктов.
 
Все типы полей имеют возможность указания названия поля, выбора опции необходимости подтверждения поля модератором, коэффициента, на который будут умножены баллы достижения при заполнении поля. Выпадающий список имеет коэффициенты для каждого из пунктов.
 
+
[[Изображение:Selection 115.png||900px|center|]]
 
=== Плагины портфолио ===
 
=== Плагины портфолио ===
 
Интерфейс встречает пользователя ссылками на подсистемы портфолио.
 
Интерфейс встречает пользователя ссылками на подсистемы портфолио.
Строка 50: Строка 50:
 
Интерфейс позволяет настраивать поля, по которым будет возможно отфильтровать пользователей на странице просмотра рейтинга и на странице модерации.  
 
Интерфейс позволяет настраивать поля, по которым будет возможно отфильтровать пользователей на странице просмотра рейтинга и на странице модерации.  
 
Среди полей будут отображаться дополнительные поля профилей типа “Выбор из списка” и “Переключатель”, а также поля достижений “Раздел” и “Дата создания достижения”.
 
Среди полей будут отображаться дополнительные поля профилей типа “Выбор из списка” и “Переключатель”, а также поля достижений “Раздел” и “Дата создания достижения”.
 +
Кроме того, в новой версии теперь доступна возможность фильтрации пользователей по ФИО.
 +
[[Изображение:Selection 014.png||900px|center|]]
 +
 
===== Блок информации о пользователе =====
 
===== Блок информации о пользователе =====
 
На странице портфолио может быть отображена информация о пользователе из его профиля СДО. Настройка отображаемых полей производится в этом интерфейсе путем отмечания галочками нужных пунктов.
 
На странице портфолио может быть отображена информация о пользователе из его профиля СДО. Настройка отображаемых полей производится в этом интерфейсе путем отмечания галочками нужных пунктов.
 +
[[Изображение:Selection 016.png||700px|center|]]
 +
=== Панель управления достижениями портфолио ===
 +
Подсистема позволяет просматривать количество подтвержденных и неподтвержденных достижений пользователей СДО с возможностью сортировки по ФИО, дате создания достижения и по разделу достижений.
 +
Если у пользователя отсутствует право модерации достижений, то колонка с неподтвержденными достижениями автоматически скрывается и пользователь видит только количество подтрвежденных достижений.
 +
 +
За доступ к модерации и к отображению колонки неподтвержденных достижений отвечает право im - achievements - moderate.
 +
[[Изображение:Selection 172.png||900px|center|Панель управления пользователями портфолио]]
 +
 +
Также система позволяет фильтровать достижения для точечного поиска пользователей.
  
=== Панель модерации достижений пользователей ===
+
[[Изображение:Selection 173.png||900px|center|Панель управления пользователями портфолио]]
Подсистема модерации по умолчанию отключена и ее можно включить в настройках подразделения, в котором расположено редактируемое портфолио. Название требуемой настройки: im - achievements - system_moderation_enabled.
 
В соответствии с фильтром (если доступен), в данном интерфейсе можно выбрать пользователей, у которых имеются достижения, требующие модерации. Список пользователей с указанием количества требующих модерации достижений, будет отображено в таблице с результатами фильтрации.
 
Для доступа к интерфейсу модерации у пользователя должно быть право im - achievements - moderate.
 
Для модерации самих достижений (процедура может быть осуществлена не только через этот интерфейс) у пользователя должно быть право im - achievements - achievementins/moderate.
 
  
 
=== Мое портфолио ===
 
=== Мое портфолио ===
Строка 63: Строка 71:
 
По умолчанию интерфейс отображает достижения пользователя, который в данный момент авторизован в системе, но он же может отобразить достижения другого пользователя, если передан параметр с идентификатором персоны деканата “personid”. Подобные ссылки на портфолио других пользователей доступны в рейтинге.
 
По умолчанию интерфейс отображает достижения пользователя, который в данный момент авторизован в системе, но он же может отобразить достижения другого пользователя, если передан параметр с идентификатором персоны деканата “personid”. Подобные ссылки на портфолио других пользователей доступны в рейтинге.
 
В интерфейсе будет отображена информация о пользователе, настроенная ранее в инструменте “Блок информации о пользователе”.
 
В интерфейсе будет отображена информация о пользователе, настроенная ранее в инструменте “Блок информации о пользователе”.
Чуть ниже - информация о рейтинге (количество баллов, место в рейтинге) и ссылка на рейтинг.
+
Чуть ниже - информация о рейтинге (количество баллов, место в рейтинге), сгруппированная по разделам достижений и ссылки на рейтинг.
 
Далее - форма добавления достижений и просмотр добавленных достижений с возможностью их фильтрации по разделу/шаблону, баллам и статусу.
 
Далее - форма добавления достижений и просмотр добавленных достижений с возможностью их фильтрации по разделу/шаблону, баллам и статусу.
 +
Добавленные достижения, при наличии соответствующих прав, можно комментировать. Для комментирования необходимо в колонке "действия" рядом с достижением кликнуть по иконке "комментарии". На открывшейся странице будет доступна стандартная форма комментирования электронного деканата с возможностью добавления новых комментариев, редактирования и удаления своих собственных комментариев, просмотра чужих комментариев.
 +
[[Изображение:Selection 018.png||900px|center|]]
  
 
=== Рейтинг ===
 
=== Рейтинг ===
Строка 70: Строка 80:
 
В начале страницы отображается форма фильтрации пользователей, участвующих в рейтинге, по полям, настроенным в описанном выше инструменте “Фильтрация пользователей”.
 
В начале страницы отображается форма фильтрации пользователей, участвующих в рейтинге, по полям, настроенным в описанном выше инструменте “Фильтрация пользователей”.
 
Ниже отображается таблица пользователей с указанием места в рейтинге и набранных баллов.
 
Ниже отображается таблица пользователей с указанием места в рейтинге и набранных баллов.
 +
При наличии права im-achievements-rating_export под фильтром также отображается кнопка, позволяющая экспортировать рейтинг портфолио в файл и скачать его.
 +
 +
Также система позволяет студенту выбор в участии в общем рейтинге. Если студент подтверждает участие, то он будет учитываться при формировании общего рейтинга, в ином случае он будет отсутствовать в общем рейтинге.
 +
 +
[[Изображение:Selection 174.png||900px|center|Личный кабинет пользователя портфолио]]
  
 
== API ==
 
== API ==

Текущая версия на 13:15, 30 ноября 2017

Плагин
Название achievements
Тип im


Портфолио достижений

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

Интерфейс достижений

Портфолио достижений встречает пользователей списком ссылок на доступные в соответствии с их правами инструменты. В этом списке могут быть представлены ссылки на:

  • Панель управления достижениями
  • Плагины портфолио
  • Панель модерации достижений пользователей
  • Мое портфолио
Selection 011.png

Панель управления достижениями

Через данный интерфейс производится администрирование шаблонов достижений. Имеется возможность создавать разделы при помощи кнопки “добавить раздел”, выстраивая нужную иерархию. Среди настроек раздела доступны:

  • Имя раздела
  • Родительский раздел
  • Доступность в рейтинге

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

Selection 012.png

Находясь в разделе имеется возможность добавлять шаблоны достижений при помощи кнопки “Добавить шаблон достижения”. Первым шагом добавления шаблона является настройка его основных характеристик таких как:

  • Название шаблона
  • Тип шаблона
  • Раздел
  • Баллы

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

Тип шаблона “Результаты заданий”

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

Тип шаблона “Критерий”

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

  • текст - пользователю будет необходимо ввести текст при создании достижения
  • дата - пользователю будет необходимо указать дату при создании достижения
  • файл - пользователю будет необходимо прикрепить файл при создании достижения
  • список - пользователю будет необходимо выбрать пункт из выпадающего списка при создании достижения

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

Selection 115.png

Плагины портфолио

Интерфейс встречает пользователя ссылками на подсистемы портфолио.

Фильтрация пользователей

Подсистема фильтрации по умолчанию отключена и ее можно включить в настройках подразделения, в котором расположено редактируемое портфолио. Название требуемой настройки: im - achievements - display_filter. Интерфейс позволяет настраивать поля, по которым будет возможно отфильтровать пользователей на странице просмотра рейтинга и на странице модерации. Среди полей будут отображаться дополнительные поля профилей типа “Выбор из списка” и “Переключатель”, а также поля достижений “Раздел” и “Дата создания достижения”. Кроме того, в новой версии теперь доступна возможность фильтрации пользователей по ФИО.

Selection 014.png
Блок информации о пользователе

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

Selection 016.png

Панель управления достижениями портфолио

Подсистема позволяет просматривать количество подтвержденных и неподтвержденных достижений пользователей СДО с возможностью сортировки по ФИО, дате создания достижения и по разделу достижений. Если у пользователя отсутствует право модерации достижений, то колонка с неподтвержденными достижениями автоматически скрывается и пользователь видит только количество подтрвежденных достижений.

За доступ к модерации и к отображению колонки неподтвержденных достижений отвечает право im - achievements - moderate.

Панель управления пользователями портфолио

Также система позволяет фильтровать достижения для точечного поиска пользователей.

Панель управления пользователями портфолио

Мое портфолио

Данный интерфейс предназначен для наполнения пользовательского портфолио достижениями и просмотра достижений пользователя. По умолчанию интерфейс отображает достижения пользователя, который в данный момент авторизован в системе, но он же может отобразить достижения другого пользователя, если передан параметр с идентификатором персоны деканата “personid”. Подобные ссылки на портфолио других пользователей доступны в рейтинге. В интерфейсе будет отображена информация о пользователе, настроенная ранее в инструменте “Блок информации о пользователе”. Чуть ниже - информация о рейтинге (количество баллов, место в рейтинге), сгруппированная по разделам достижений и ссылки на рейтинг. Далее - форма добавления достижений и просмотр добавленных достижений с возможностью их фильтрации по разделу/шаблону, баллам и статусу. Добавленные достижения, при наличии соответствующих прав, можно комментировать. Для комментирования необходимо в колонке "действия" рядом с достижением кликнуть по иконке "комментарии". На открывшейся странице будет доступна стандартная форма комментирования электронного деканата с возможностью добавления новых комментариев, редактирования и удаления своих собственных комментариев, просмотра чужих комментариев.

Selection 018.png

Рейтинг

Страница рейтинга по умолчанию отображает рейтинг по разделу достижений, указанный в настройках подразделения, в котором расположено редактируемое портфолио. Требуемая настройка: storage - achievementcats - default_achievementcat. Если раздел, указанный в настройке не доступен, будет предложен выбор раздела. В начале страницы отображается форма фильтрации пользователей, участвующих в рейтинге, по полям, настроенным в описанном выше инструменте “Фильтрация пользователей”. Ниже отображается таблица пользователей с указанием места в рейтинге и набранных баллов. При наличии права im-achievements-rating_export под фильтром также отображается кнопка, позволяющая экспортировать рейтинг портфолио в файл и скачать его.

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

Личный кабинет пользователя портфолио

API

delete_achievement

Удаление шаблона вместе со всеми пользовательскими достижениями, связанными с этим шаблоном

параметры:

  • $id - ID шаблона
  • $options - массив дополнительных опций удаления, не используется

возвращаемые значения:

  • массив ошибок, полученных во время удаления шаблонов
delete_achievementin

Удаление пользовательского достижения

параметры:

  • $id - ID достижения
  • $options - массив дополнительных опций удаления, не используется

возвращаемые значения:

  • массив ошибок, полученных во время удаления достижения
delete_achievementins_by_achievementid

Удаление пользовательских достижений по ID шаблона

параметры:

  • $id - ID шаблона для удаления его пользовательских достижений
  • $options - массив дополнительных опций удаления, не используется

возвращаемые значения:

  • $errors - массив ошибок, полученных во время удаления достижений
delete_achievements_by_categoryid

Удаление шаблонов по ID раздела

параметры:

  • $id - ID раздела для удаления его шаблонов
  • $options - массив параметров удаления

возвращаемые значения:

  • массив ошибок, полученных во время удаления шаблонов
delete_category

Удаление раздела вместе дочерними разделами, шаблонами, а также пользовательскими достижениями, связанными с этими шаблонами

параметры:

  • $id - ID раздела для удаления
  • $options - массив параметров удаления

возвращаемые значения:

  • массив ошибок, полученных во время удаления раздела
get_achievementcatstable

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

параметры:

  • $options - массив параметров для переопределения значений
  • ['addvars'] - Массив GET-параметров

возвращаемые значения:

  • HTML код таблицы
get_achievementins

Получение пользовательских достижений

параметры:

  • $options - массив параметров для переопределения значений
    • ['departmentid'] - ID подразделения
    • ['personid'] - ID персоны, для которой производится построение таблицы
    • ['sort'] - Поле , по которому происходит сортировка. Доступные значения:
      • 'points' - По баллу
      • 'status' - По статусу
    • ['dir'] - Направление сортировки

возвращаемые значения:

  • HTML код таблицы
get_achievementinstable

Сформировать таблицу пользовательских достижений

параметры:

  • $list - массив пользовательских достижений
  • $options - массив параметров для переопределения значений
    • ['addvars'] - Массив GET-параметров
    • ['personid'] - ID персоны, для которой производится построение таблицы
    • ['sort'] - Поле , по которому происходит сортировка. Доступные значения:
      • 'points' - По баллу
      • 'status' - По статусу
    • ['dir'] - Направление сортировки
    • ['limitnum'] - Число достижений в таблице
    • ['limitfrom'] - Смещение

возвращаемые значения:

  • HTML код таблицы
get_achievementstable

Получить таблицу управления шаблонами достижений

параметры:

  • $options - массив параметров для переопределения значений
    • ['addvars'] - Массив GET-параметров

возвращаемые значения:

  • HTML код таблицы
get_clear_myachievementstable

Получить таблицу достижений пользователя

параметры:

  • $personid - ID персоны
  • $options - массив дополнительных параметров
    • ['limitnum'] - Число выводимых записей

возвращаемые значения:

  • HTML код таблицы
get_moderation_data

Получить список персон, у которых есть достижения, требующие модерации

параметры:

  • $options - массив параметров для переопределения значений
    • ['addvars'] - Массив GET-параметров

возвращаемые значения:

  • массив с данными по пользователям. В качестве ключей передаются идентификаторы пользователей, а в качестве значений - количество непроверенных достижений
get_moderation_table

Получить таблицу достижений, требующих модерации

параметры:

  • $personachievements - Данные пользователей. В качестве ключей ожидаются идентификаторы пользователей, а в качестве значений - количество непроверенных достижений
  • $options - массив параметров для переопределения значений
    • ['addvars'] - Массив GET-параметров

возвращаемые значения:

  • HTML код таблицы
get_my_rating_block

Получить блок рейтинга пользователя

параметры:

  • $id - ID целевого пользователя или текущего, если NULL
  • $addvars - Массив GET-параметров для ссылки

возвращаемые значения:

  • HTML-код блока
get_ratingtable

Получить таблицу рейтинга

параметры:

  • $options - массив параметров для переопределения значений
    • ['addvars'] - Массив GET-параметров,
    • ['page'] - Страница,
    • ['limit'] - Число записей на странице

возвращаемые значения:

  • HTML код таблицы
get_user_info

Получить информацию о пользователе

параметры:

  • $personid - ID персоны
  • $addvars - массив GET-параметров с идентификатором подразделения

возвращаемые значения:

  • HTML код с информацией о пользователе
get_userrating_info

Получить информацию о рейтинге пользователя

параметры:

  • $personid - опционально, ID персоны
  • $achievementids - опционально, ID шаблонов достижения или массив шаблонов, по которым будет строиться рейтинг

возвращаемые значения:

  • Объект с информацией о рейтинге пользователя
points_format

Форматирование значения рейтинга

параметры:

  • $points - Значение рейтинга пользователя

возвращаемые значения:

  • Отформатированное число