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

Материал из DOF
Перейти к: навигация, поиск
м
(CRON)
 
(не показаны 3 промежуточные версии 2 участников)
Строка 4: Строка 4:
 
}}
 
}}
  
Работа с курсами moodle
+
Работа с курсами moodle.
 +
Плагин отлавливает события создания/обновления дисциплины/учебного процесса, проверяет флаг создания курса в Moodle и создает, если это необходимо.
  
== API ==
+
= Конфиги =
 +
Список конфигов плагина.
  
=== get_course ===
+
* (string)mdlcategoryvarname - название переменной конфига в плагине sync/mcategories, куда будут добавляться новый курсы Moodle
Получить объект курса moodle по его id
+
* (int)mdlcourseid_template - идентификатор шаблона курса, на основании которого будут создаваться новые курсы в Moodle
  
=== get_course_link ===
+
= CRON =
Получить ссылку на курс moodle
+
Задачи, которые выполняются по крону.
  
=== course_exists_quiet ===
+
* Починка неправильно созданных дисциплин (если был параметр создания курса в Moodle, но он не был создан)
Аккуратно проверить существование курса в moodle, не создавая ошибок print_error
+
* Починка неправильно созданных учебных процессов (если был параметр создания курса в Moodle, но он не был создан)
 
 
=== create_backup ===
 
Создание резервной копии курса
 
 
 
=== restore_backup ===
 
Восстановление курса из резервной копии
 
 
 
=== backup_exists ===
 
Проверка существования резервной копии курса
 
 
 
=== create_course ===
 
Создание курса мудл
 
  
 
=События=
 
=События=
Строка 71: Строка 61:
 
* notificationresult - массив с результатами отправки уведомлений  
 
* notificationresult - массив с результатами отправки уведомлений  
 
  | Мастер-курс отклонен
 
  | Мастер-курс отклонен
 +
|-
 +
| storage
 +
| programmitems
 +
| insert
 +
|
 +
|
 +
| Добавление дисциплины
 +
|-
 +
| storage
 +
| programmitems
 +
| update
 +
|
 +
|
 +
| Обновление дисциплины
 +
|-
 +
| storage
 +
| cstreams
 +
| insert
 +
|
 +
|
 +
| Добавление учебного процесса
 +
|-
 +
| storage
 +
| cstreams
 +
| update
 +
|
 +
|
 +
| Обновление учебного процесса
 
  |}
 
  |}
 +
 +
 +
== API ==
 +
 +
===='''get_course($id)'''====
 +
Получить объект курса moodle по его id
 +
 +
''Аргументы:''
 +
* int $id - id курса в moodle
 +
''Возвращаемые значения:''
 +
* object|bool - объект курса или false
 +
 +
===='''get_course_link($id)'''====
 +
Получить ссылку на курс moodle
 +
 +
''Аргументы:''
 +
* int $id - id курса в moodle
 +
''Возвращаемые значения:''
 +
* string|bool - строка для ссылки на курс или false если такого курса нет
 +
 +
===='''course_exists_quiet($id)'''====
 +
Аккуратно проверить существование курса в moodle, не создавая ошибок print_error
 +
 +
''Аргументы:''
 +
* int $id - id курса в moodle
 +
''Возвращаемые значения:''
 +
* bool - true, если курс существует; false, если курс не существует
 +
 +
===='''create_backup($courseid, $backupoptions = [], $fileoptions = [])'''====
 +
Создание резервной копии курса
 +
 +
''Аргументы:''
 +
* int $courseid - id курса в moodle
 +
* array $backupoptions
 +
* array $fileoptions
 +
''Возвращаемые значения:''
 +
* boolean
 +
 +
===='''restore_backup($courseid, $restoreoptions = [], $fileoptions = [], $courseoptions = [])'''====
 +
Восстановление курса из резервной копии
 +
 +
''Аргументы:''
 +
* int $courseid - id курса в moodle
 +
* int $courseid
 +
* array $restoreoptions
 +
* array $fileoptions
 +
* array $courseoptions
 +
''Возвращаемые значения:''
 +
* int
 +
 +
===='''backup_exists($courseid, $fileoptions = [])'''====
 +
Проверка существования резервной копии курса
 +
 +
''Аргументы:''
 +
* int $courseid - id курса в moodle
 +
* array $fileoptions
 +
''Возвращаемые значения:''
 +
* boolean
 +
 +
===='''create_course(stdClass $courseobj)'''====
 +
Создание курса мудл
 +
 +
''Аргументы:''
 +
* stdClass $courseobj
 +
''Возвращаемые значения:''
 +
* int
 +
 +
===='''clone_course($mdlcourseid, stdClass $courseobj)'''====
 +
Создание курса на основе существующего курса в Moodle
 +
 +
''Аргументы:''
 +
* int $mdlcourseid - id курса в moodle
 +
* stdClass $courseobj
 +
 +
''Возвращаемые значения:''
 +
* int | false - идентификатора курса вслучае успеха и false в остальных случаях

Текущая версия на 11:37, 2 марта 2018

Плагин
Название mcourses
Тип sync


Работа с курсами moodle. Плагин отлавливает события создания/обновления дисциплины/учебного процесса, проверяет флаг создания курса в Moodle и создает, если это необходимо.

Конфиги

Список конфигов плагина.

  • (string)mdlcategoryvarname - название переменной конфига в плагине sync/mcategories, куда будут добавляться новый курсы Moodle
  • (int)mdlcourseid_template - идентификатор шаблона курса, на основании которого будут создаваться новые курсы в Moodle

CRON

Задачи, которые выполняются по крону.

  • Починка неправильно созданных дисциплин (если был параметр создания курса в Moodle, но он не был создан)
  • Починка неправильно созданных учебных процессов (если был параметр создания курса в Moodle, но он не был создан)

События

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

Перехватываемые события

Таблица событий, которые перехватывает этот плагин
Тип плагина Код плагина Код события Идентификтаор Доп. данные Пояснение
storage programmitems coursedata_verification_requested идентификатор курса массив с данными:
  • initiator - пользователь, запросивший согласование
  • course - наименование курса
  • discipline - наименование дисциплины
  • notificationresult - массив с результатами отправки уведомлений
Запрошено согласование мастер-курса
storage programmitems coursedata_accepted идентификатор курса массив с данными:
  • course - наименование курса
  • discipline - наименование дисциплины
  • notificationresult - массив с результатами отправки уведомлений
Мастер-курс одобрен
storage programmitems coursedata_declined идентификатор курса массив с данными:
  • course - наименование курса
  • discipline - наименование дисциплины
  • notificationresult - массив с результатами отправки уведомлений
Мастер-курс отклонен
storage programmitems insert Добавление дисциплины
storage programmitems update Обновление дисциплины
storage cstreams insert Добавление учебного процесса
storage cstreams update Обновление учебного процесса


API

get_course($id)

Получить объект курса moodle по его id

Аргументы:

  • int $id - id курса в moodle

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

  • object|bool - объект курса или false

get_course_link($id)

Получить ссылку на курс moodle

Аргументы:

  • int $id - id курса в moodle

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

  • string|bool - строка для ссылки на курс или false если такого курса нет

course_exists_quiet($id)

Аккуратно проверить существование курса в moodle, не создавая ошибок print_error

Аргументы:

  • int $id - id курса в moodle

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

  • bool - true, если курс существует; false, если курс не существует

create_backup($courseid, $backupoptions = [], $fileoptions = [])

Создание резервной копии курса

Аргументы:

  • int $courseid - id курса в moodle
  • array $backupoptions
  • array $fileoptions

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

  • boolean

restore_backup($courseid, $restoreoptions = [], $fileoptions = [], $courseoptions = [])

Восстановление курса из резервной копии

Аргументы:

  • int $courseid - id курса в moodle
  • int $courseid
  • array $restoreoptions
  • array $fileoptions
  • array $courseoptions

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

  • int

backup_exists($courseid, $fileoptions = [])

Проверка существования резервной копии курса

Аргументы:

  • int $courseid - id курса в moodle
  • array $fileoptions

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

  • boolean

create_course(stdClass $courseobj)

Создание курса мудл

Аргументы:

  • stdClass $courseobj

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

  • int

clone_course($mdlcourseid, stdClass $courseobj)

Создание курса на основе существующего курса в Moodle

Аргументы:

  • int $mdlcourseid - id курса в moodle
  • stdClass $courseobj

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

  • int | false - идентификатора курса вслучае успеха и false в остальных случаях