Разработка:im/plans

im/plans - Учебно-тематическое планирование

Интерфейс редактирования параметров тематического планирования. Работает в паре с модулем storage/plans. Позволяет создавать и редактировать различные атрибуты тематического планирования.

Тематическое планирование

На странице отображается список тем для указанного объекта привязки, отсортированных по крайнему сроку сдачи темы. Обязательными параметрами являются type (тип привязки) и id (id привязки). Если они не указаны, или указаны неверно, выводится сообщение об ошибке. Также можно указать дополнительный параметр status, который отображает темы с указанным статусом. При отсутствии тем с данными параметрами выводится сообщение, что темы не найдены. Сейчас любой параметр является необязательным. При отсутствии всех параметров выводится общий список КТ.

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

Вверху списка отображается ссылка на создание темы в планировании. Также со страницы можно перейти на страницу просмотра или редактирования темы (в зависимости от прав).

Просмотр темы

На этой странице выводится одна строка таблицы одной темы. Отсюда можно перейти на страницу редактирования темы или на страницу тематического планирования.

Создание/изменение параметров темы

На этой странице отображается форма, в которой можно определить параметры темы.

Назначение полей:

• Связан с - Объект привязки. Возможны только три варианта: Предмет, Период и Учебный поток. Ниже выводится название объекта привязки - выбирается из списка названий объекта. Обязательное поле.
• Родительская тема - указывается если тема наследуется от стандартной или является дополнительной. Отображает список тем. По-умолчинию - Нет.
• Название - Название темы в плане. Обязательное поле.
• Дата сдачи - Срок сдачи темы. Обязательное поле.
• Крайний срок сдачи - Крайний срок сдачи темы. Не может быть указана ранее даты сдачи. Обязательное поле.
• Шкала - через запятую указывается какие возможные оценки за тему. Пустая строка - оценка не предусмотрена.
• Тип темы - очный урок/лекция, дистанционный урок/лекция, семинар, лабораторная работа, практическая работа, контрольная работа, промежуточная атестация. Обязательное поле.
• Синхранизация с Moodle
• Курс в Moodle

При заполнении полей следует учитывать определенные правила:

• Крайний срок сдачи не может быть назначен ранее даты сдачи. Могут совпадать друг с другом.

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

Страница создания и редактирования темы содержит обязательный параметр planid.

• Если он передан - то редактируется группа с переданным id
• Если он не передан (или передана строка), то будет создана новая группа с указанными параметрами
• Если передан номер не существующей в БД записи - то будет выведено сообщение об ошибке

API

show($obj)

Возвращает html-код отображения информации о теме в планировании в виде таблицы.

• Входные параметры:
  • $obj - объект, запись из таблицы plans
• Возвращаемые значения:
  • html-код таблицы или
  • false в случае ошибки.

show_id($id)

Возвращает html-код отображения информации о теме в планировании в виде таблицы по id.

• Входные параметры:
  • $id - id записи из таблицы plans;
• Возвращаемые значения:
  • html-код таблицы или
  • false в случае ошибки

showlist($list)

Возвращает html-код отображения информации о планировании в виде таблицы.

• Входные параметры:
  • $list - массив объектов. Каждый объект - это запись из таблицы plans.
• Возвращаемые значения:
  • html-код таблицы или
  • false в случае ошибки.

form($id=NULL)

Возвращает html-код формы создания новой или редактирования существующей темы.

• Входные переменные:
  • $id - id записи из таблицы plans (по умолчанию NULL). Значения этой записи будут использованы для заполнения полей формы значениями по умолчанию. Если $id = NULL, то поля формы остаются пустыми.
• Возвращаемые значения:
  • html-код или
  • false в случае ошибки.

get_listing($limitfrom, $limitnum, $conds)

Возвращает список тем, выбранных по заданным критериям.

• Входные переменные:
  • $limitfrom - порядковый номер записи в общем списке записей, удовлетворяющих критериям выборки. Эта запись будет первой в возвращаемом списке.
  • $limitnum - количество записей, которые нужно вернуть.
  • $conds - объект - список параметров для выборки записей. Название свойства объекта - это название поля в таблице plans.
• Выходные значения:
  • массив записей из таблицы plans или
  • false в случае ошибки.

get_select_listing($inputconds)

Возвращает фрагмент sql-запроса после слова WHERE.

• Входные переменные:
  • $inputconds - объект. Содержит критерии выборки для формирования запроса. Свойство объекта - название поля в таблице plans.
• Возвращаемые значения:
  • фрагмент строки запроса, который будет вставлен в запрос после слова WHERE.

Список карточек:

• Инициализация плагина
• Редактирование страницы просмотра одной темы
• Редактирование страницы просмотра планирования
  • добавляется фильтрация по обьекту привязки
• Редактирование интерфейса формы
• Редактирование обработчика формы