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

Материал из DOF
Версия от 22:35, 11 февраля 2010; Ilya (обсуждение | вклад) (Добавлено описание смены статусов через экран просмотра)
Перейти к: навигация, поиск
Плагин
Название ages
Тип im


Учебные периоды

Этот интерфейс позволяет просматривать и редактировать информацию об учебных периодах.

Список учебных программ

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

Таблица содержит следующие поля: Название

  • Начало периода
  • Конец периода
  • Количество недель - количество учебных недель в периоде
  • Подразделение - к какому подразделению принадлежит этот период
  • Предыдущий период - какой период предшествовал этому периоду
  • Статус - список возможных статусов указан в плагине ages
  • Действия - ссылки на просмотр и редактирование данных об учебном периоде

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

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

Просмотр одного учебного периода

Эта страница предоставляет информацию об одном учебном периоде.

При просмотре периода имеется возможность изменить его статус. Форма для этого показывается только пользователям, имеющим право "setstatus". При изменении статуса выводится сообщение "статус успешно изменен", либо "не удалось изменить статус" - в случае ошибки. Если статус является конечным - форма сообщает об этом, и не дает его изменить. Подробнее о статусах периода можно посмотреть в разделе: workflows/ages .

Создание и редактирование

Это действие доступно только для пользователей с правом редактирования учебного периода.

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

  • Название - название учебного периода
  • Начало периода - дата начала периода
  • Конец периода - дата окончания периода
  • Количество недель - количество учебных недель
  • Подразделение - подразделение, которому принадлежит период
  • Предыдущий период - какой период является предыдущим для создаваемого. Можно создать период не указывая предыдущий, но в таком случае они не будут между собой связаны.

API

Здесь описаны функции для работы со списком учебных периодов.

get_listing()

Параметры:

  • $limitfrom - с какой записи начинать вывод
  • $limitnum - сколько записей выводить на одной странице
  • $conds - Обьект, содержащий данные с условиями выборки, в формате поле_БД->значение по умолчанию пустой массив

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

  • (array) массив записей из базы, или false в случае ошибки
form()

Возвращает форму создания/редактирования учебного периода с начальными данными

Параметры:

  • $id - id учебного периода в таблице ages, для редактирования которой вызывается форма. По умолчанию NULL (создается новый учебный период).

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

  • moodleQuickForm object - объект формы, с загруженными в нее исходными данными.
showlist()

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

Параметры:

  • $list - массив записей из таблицы ages для отображения.

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

  • (string|bool) - html-код или false в случае ошибки
show_id()

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

Параметры:

  • $id - id записи в таблице ages

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

  • (string) - html-код или false в случае ошибки