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

Материал из DOF
Версия от 23:34, 4 февраля 2010; Ilya (обсуждение | вклад) (Описание плагина im\ages)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к: навигация, поиск
Плагин
Название programms
Тип im


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

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

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

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

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

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

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

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

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

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

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

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

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 в случае ошибки