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

Плагин
Название	ages
Тип	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 в случае ошибки