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

Материал из DOF
Версия от 15:46, 8 октября 2009; Johnleft (обсуждение | вклад) (get_listing($limitfrom, $limitnum, $conds): описана функция.)
Перейти к: навигация, поиск

im/agroups - Группы

Модуль редактирования параметров академической группы, (или класса в средней школе). Работает в паре с модулем storage/agroups. Позволяет создавать и редактировать различные атрибуты группы - название, код и т.п.

Список групп

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

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

Кроме того на этой странице присутствует форма поиска группы. Искать можно по названию или по коду группы. В первом случае в поле поиска можно ввести фрагмент имени.

С этой страницы можно перейти на страницу создания группы или редактирования ее параметров.

Страница группы

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

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

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

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

  • название группы - цифры, русские и латинские буквы в любом регистре, тире.
  • код группы - цифры, латинские буквы в нижнем регистре, тире.

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

API

show($obj)

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

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

show_id($id)

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

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

showlist($list)

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

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

form($id=NULL)

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

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

get_listing($limitfrom, $limitnum, $conds)

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

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

get_select_listing($inputconds)

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

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