Collaboration diagram for ilObjCourseGroupingGUI:

Public Member Functions
	__construct (ilObject $content_obj, int $a_obj_id=0)

	executeCommand ()

	__initGroupingObject ()

	getContentType ()

	listGroupings ()

	handleGroupingTableAction ()

	askDeleteGrouping (int ... $grouping_ids)

	deleteGrouping ()

	create (?ilPropertyFormGUI $a_form=null)

	initForm (bool $a_create)

	add ()

	edit (?ilPropertyFormGUI $a_form=null)

	update ()

	selectCourse ()

	handleAssignmentTableAction ()

	assignCourse (int ... $ref_ids)

Protected Member Functions
	showSelectCourse ()

Protected Attributes
ilGlobalTemplateInterface	$tpl

ilCtrlInterface	$ctrl

ilLanguage	$lng

ilErrorHandling	$error

ilAccessHandler	$access

ilTabsGUI	$tabs

ilToolbarGUI	$toolbar

GlobalHttpState	$http

RefineryFactory	$refinery

UIRenderer	$ui_renderer

GroupingTableHandler	$grouping_table_handler

AssignmentTableHandler	$assignment_table_handler

Private Attributes
ilObjCourseGrouping	$grp_obj

int	$id

ilObject	$content_obj

string	$content_type = ''

Detailed Description

Class ilObjCourseGroupingGUI.

Author: your name <your email>

Definition at line 32 of file class.ilObjCourseGroupingGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilObjCourseGroupingGUI::__construct	(	ilObject	$content_obj,
		int	$a_obj_id = `0`
	)

Definition at line 53 of file class.ilObjCourseGroupingGUI.php.

    {
        global $DIC;
 
        $this->tpl = $DIC->ui()->mainTemplate();
        $this->ctrl = $DIC->ctrl();
        $this->lng = $DIC->language();
        $this->access = $DIC->access();
        $this->error = $DIC['ilErr'];
        $this->tabs = $DIC->tabs();
        $this->toolbar = $DIC->toolbar();
        $this->http = $DIC->http();
        $this->ui_renderer = $DIC->ui()->renderer();
        $this->refinery = $DIC->refinery();
 
        $this->content_obj = $content_obj;
        $this->content_type = ilObject::_lookupType($this->content_obj->getId());
 
        $this->id = $a_obj_id;
        $this->ctrl->saveParameter($this, 'obj_id');
        $this->__initGroupingObject();
 
        $data_factory = new DataFactory();
        $this->grouping_table_handler = new GroupingTableHandler(
            $this->ctrl->getLinkTarget($this, 'handleGroupingTableAction'),
            $this->content_obj->getId(),
            $this->lng,
            $DIC->ui()->factory(),
            $data_factory,
            $this->http,
            $this->refinery,
            $DIC['static_url']
        );
        $this->assignment_table_handler = new AssignmentTableHandler(
            $this->ctrl->getLinkTarget($this, 'handleAssignmentTableAction'),
            $this->content_obj->getId(),
            $this->grp_obj,
            $this->lng,
            $DIC->ui()->factory(),
            $data_factory,
            $this->http,
            $this->refinery,
            $DIC->user(),
            $DIC->repositoryTree()
        );
    }

References $content_obj, $DIC, __initGroupingObject(), ilObject\_lookupType(), ILIAS\Repository\access(), ILIAS\Repository\ctrl(), error(), ILIAS\FileDelivery\http(), ILIAS\Repository\lng(), ILIAS\Repository\refinery(), ILIAS\Repository\tabs(), and ILIAS\Repository\toolbar().

Here is the call graph for this function:

Member Function Documentation

◆ __initGroupingObject()

ilObjCourseGroupingGUI::__initGroupingObject ( )

Definition at line 110 of file class.ilObjCourseGroupingGUI.php.

                                          : void
    {
        $this->grp_obj = new ilObjCourseGrouping($this->id);
    }

Referenced by __construct().

Here is the caller graph for this function:

◆ add()

ilObjCourseGroupingGUI::add ( )

Definition at line 270 of file class.ilObjCourseGroupingGUI.php.

                         : void
    {
        $form = $this->initForm(true);
        if ($form->checkInput()) {
            $this->grp_obj->setTitle($form->getInput('title'));
            $this->grp_obj->setDescription($form->getInput('description'));
            $this->grp_obj->setUniqueField($form->getInput('unique'));
 
            $this->grp_obj->create($this->content_obj->getRefId(), $this->content_obj->getId());
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('crs_grp_added_grouping'), true);
            $this->ctrl->redirect($this, 'listGroupings');
        }
        $form->setValuesByPost();
        $this->create($form);
    }

References create(), ILIAS\Repository\ctrl(), initForm(), and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ askDeleteGrouping()

ilObjCourseGroupingGUI::askDeleteGrouping ( int ... $grouping_ids )

Definition at line 150 of file class.ilObjCourseGroupingGUI.php.

                                                           : void
    {
        if (!$this->access->checkAccess('write', '', $this->content_obj->getRefId())) {
            $this->error->raiseError($this->lng->txt('permission_denied'), $this->error->MESSAGE);
        }
 
        if (!count($grouping_ids)) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('crs_grouping_select_one'));
            $this->listGroupings();
            return;
        }
 
        // display confirmation message
        $cgui = new ilConfirmationGUI();
        $cgui->setFormAction($this->ctrl->getFormAction($this));
        $cgui->setHeaderText($this->lng->txt("crs_grouping_delete_sure"));
        $cgui->setCancel($this->lng->txt("cancel"), "listGroupings");
        $cgui->setConfirm($this->lng->txt("delete"), "deleteGrouping");
 
        // list objects that should be deleted
        foreach ($grouping_ids as $grouping_id) {
            $tmp_obj = new ilObjCourseGrouping($grouping_id);
            $cgui->addItem("grouping[]", $grouping_id, $tmp_obj->getTitle());
        }
        $this->tpl->setContent($cgui->getHTML());
    }

References ILIAS\Repository\access(), ILIAS\Repository\ctrl(), error(), listGroupings(), and ILIAS\Repository\lng().

Referenced by handleGroupingTableAction().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ assignCourse()

ilObjCourseGroupingGUI::assignCourse ( int ... $ref_ids )

Definition at line 367 of file class.ilObjCourseGroupingGUI.php.

                                                 : void
    {
        if (!$this->access->checkAccess('write', '', $this->content_obj->getRefId())) {
            $this->error->raiseError($this->lng->txt('permission_denied'), $this->error->MESSAGE);
        }
 
        if (!$this->id) {
            $this->listGroupings();
            return;
        }
 
        // add assignments of not selected items that were assigned
        // add assignments for selected items that were not assigned
        $grouping = new ilObjCourseGrouping($this->id);
        $assigned = $grouping->getAssignedItems();
        $old_assigned_ref_ids = [];
        foreach ($assigned as $item) {
            $old_assigned_ref_ids[] = $item['target_ref_id'];
        }
        $new_assigned_ref_ids = array_merge(
            array_diff($old_assigned_ref_ids, $ref_ids),
            array_diff($ref_ids, $old_assigned_ref_ids)
        );
 
        // delete all existing conditions
        $condh = new ilConditionHandler();
        $condh->deleteByObjId($this->id);
 
        foreach ($new_assigned_ref_ids as $ref_id) {
            $tmp_crs = ilObjectFactory::getInstanceByRefId($ref_id);
            $tmp_condh = new ilConditionHandler();
            $tmp_condh->enableAutomaticValidation(false);
 
            $tmp_condh->setTargetRefId($ref_id);
            $tmp_condh->setTargetObjId($tmp_crs->getId());
            $tmp_condh->setTargetType($this->getContentType());
            $tmp_condh->setTriggerRefId(0);
            $tmp_condh->setTriggerObjId($this->id);
            $tmp_condh->setTriggerType('crsg');
            $tmp_condh->setOperator('not_member');
            $tmp_condh->setValue($this->grp_obj->getUniqueField());
 
            if (!$tmp_condh->checkExists()) {
                $tmp_condh->storeCondition();
            }
        }
 
        $this->tpl->setOnScreenMessage('success', $this->lng->txt('settings_saved'), true);
        $this->ctrl->redirect($this, 'edit');
    }

References $ref_id, ILIAS\Repository\access(), ILIAS\Repository\ctrl(), error(), getContentType(), ilObjectFactory\getInstanceByRefId(), listGroupings(), and ILIAS\Repository\lng().

Referenced by handleAssignmentTableAction().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ create()

ilObjCourseGroupingGUI::create ( ?ilPropertyFormGUI $a_form = null )

Definition at line 201 of file class.ilObjCourseGroupingGUI.php.

                                                             : void
    {
        if (!$this->access->checkAccess('write', '', $this->content_obj->getRefId())) {
            $this->error->raiseError($this->lng->txt('permission_denied'), $this->error->MESSAGE);
        }
 
        if (!$a_form) {
            $a_form = $this->initForm(true);
        }
 
        $this->tpl->setContent($a_form->getHTML());
    }

References ILIAS\Repository\access(), error(), initForm(), and ILIAS\Repository\lng().

Referenced by add().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteGrouping()

ilObjCourseGroupingGUI::deleteGrouping ( )

Definition at line 177 of file class.ilObjCourseGroupingGUI.php.

                                    : void
    {
        if (!$this->access->checkAccess('write', '', $this->content_obj->getRefId())) {
            $this->error->raiseError($this->lng->txt('permission_denied'), $this->error->MESSAGE);
        }
        $grouping = [];
        if ($this->http->wrapper()->post()->has('grouping')) {
            $grouping = $this->http->wrapper()->post()->retrieve(
                'grouping',
                $this->refinery->kindlyTo()->listOf(
                    $this->refinery->kindlyTo()->int()
                )
            );
        }
 
        foreach ($grouping as $grouping_id) {
            $tmp_obj = new ilObjCourseGrouping((int) $grouping_id);
            $tmp_obj->delete();
        }
 
        $this->tpl->setOnScreenMessage('success', $this->lng->txt('crs_grouping_deleted'), true);
        $this->ctrl->redirect($this, 'listGroupings');
    }

References ILIAS\Repository\access(), ILIAS\Repository\ctrl(), error(), ILIAS\FileDelivery\http(), ILIAS\Repository\lng(), and ILIAS\Repository\refinery().

Here is the call graph for this function:

◆ edit()

ilObjCourseGroupingGUI::edit ( ?ilPropertyFormGUI $a_form = null )

Definition at line 286 of file class.ilObjCourseGroupingGUI.php.

                                                           : void
    {
        if (!$this->access->checkAccess('write', '', $this->content_obj->getRefId())) {
            $this->error->raiseError($this->lng->txt('permission_denied'), $this->error->MESSAGE);
        }
        if (!$a_form) {
            $a_form = $this->initForm(false);
        }
        $this->tpl->setContent($a_form->getHTML());
    }

References ILIAS\Repository\access(), error(), initForm(), and ILIAS\Repository\lng().

Referenced by update().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ executeCommand()

ilObjCourseGroupingGUI::executeCommand ( )

Definition at line 100 of file class.ilObjCourseGroupingGUI.php.

                                    : void
    {
        $this->tabs->setTabActive('crs_groupings');
        $cmd = $this->ctrl->getCmd();
        if (!$cmd = $this->ctrl->getCmd()) {
            $cmd = "edit";
        }
        $this->$cmd();
    }

References ILIAS\Repository\ctrl(), and ILIAS\Repository\tabs().

Here is the call graph for this function:

◆ getContentType()

ilObjCourseGroupingGUI::getContentType ( )

Definition at line 115 of file class.ilObjCourseGroupingGUI.php.

                                    : string
    {
        return $this->content_type;
    }

References $content_type.

Referenced by assignCourse().

Here is the caller graph for this function:

◆ handleAssignmentTableAction()

ilObjCourseGroupingGUI::handleAssignmentTableAction ( )

Definition at line 358 of file class.ilObjCourseGroupingGUI.php.

                                                 : void
    {
        switch ($this->assignment_table_handler->getSelectedTableAction()) {
            case AssignmentTableHandler::ACTION_TOGGLE_ASSIGNMENT:
                $this->assignCourse(...$this->assignment_table_handler->getSelectedRefIDs());
                break;
        }
    }

References assignCourse().

Here is the call graph for this function:

◆ handleGroupingTableAction()

ilObjCourseGroupingGUI::handleGroupingTableAction ( )

Definition at line 135 of file class.ilObjCourseGroupingGUI.php.

                                               : void
    {
        switch ($this->grouping_table_handler->getSelectedTableAction()) {
            case GroupingTableHandler::ACTION_EDIT:
                $selected = $this->grouping_table_handler->getSelectedGroupingIDs()[0] ?? 0;
                $this->ctrl->setParameter($this, 'obj_id', $selected);
                $this->ctrl->redirect($this, 'edit');
                break;
 
            case GroupingTableHandler::ACTION_DELETE:
                $this->askDeleteGrouping(...$this->grouping_table_handler->getSelectedGroupingIDs());
                break;
        }
    }

References askDeleteGrouping(), and ILIAS\Repository\ctrl().

Here is the call graph for this function:

◆ initForm()

ilObjCourseGroupingGUI::initForm ( bool $a_create )

Definition at line 214 of file class.ilObjCourseGroupingGUI.php.

                                            : ilPropertyFormGUI
    {
        $form = new ilPropertyFormGUI();
        $form->setFormAction($this->ctrl->getFormAction($this));
 
        $title = new ilTextInputGUI($this->lng->txt('title'), 'title');
        $title->setRequired(true);
        $form->addItem($title);
 
        $desc = new ilTextAreaInputGUI($this->lng->txt('description'), 'description');
        $form->addItem($desc);
 
        $options = array('login' => 'login',
                         'email' => 'email',
                         'matriculation' => 'matriculation'
        );
 
        foreach ($options as $value => $caption) {
            $options[$value] = $this->lng->txt($caption);
        }
        $uniq = new ilSelectInputGUI($this->lng->txt('unambiguousness'), 'unique');
        $uniq->setRequired(true);
        $uniq->setOptions($options);
        $form->addItem($uniq);
 
        if ($a_create) {
            $form->setTitle($this->lng->txt('crs_add_grouping'));
            $form->addCommandButton('add', $this->lng->txt('btn_add'));
        } else {
            $grouping = new ilObjCourseGrouping($this->id);
            $title->setValue($grouping->getTitle());
            $desc->setValue($grouping->getDescription());
            $uniq->setValue($grouping->getUniqueField());
 
            $ass = new ilCustomInputGUI($this->lng->txt('groupings_assigned_obj_' . $this->getContentType()));
            $form->addItem($ass);
 
            // assignments
            $items = array();
            foreach ($grouping->getAssignedItems() as $cond_data) {
                $items[] = ilObject::_lookupTitle($cond_data['target_obj_id']);
            }
            if ($items !== []) {
                $ass->setHtml(implode("<br />", $items));
            } else {
                $ass->setHtml($this->lng->txt('crs_grp_no_courses_assigned'));
            }
 
            $form->setTitle($this->lng->txt('edit_grouping'));
            $form->addCommandButton('update', $this->lng->txt('save'));
            $form->addCommandButton('selectCourse', $this->lng->txt('grouping_change_assignment'));
        }
        $form->addCommandButton('listGroupings', $this->lng->txt('cancel'));
        return $form;
    }

References ILIAS\UI\Implementation\Component\Input\Field\$options, ilObject\_lookupTitle(), ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

Referenced by add(), create(), edit(), and update().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ listGroupings()

ilObjCourseGroupingGUI::listGroupings ( )

Definition at line 120 of file class.ilObjCourseGroupingGUI.php.

                                   : void
    {
        if (!$this->access->checkAccess('write', '', $this->content_obj->getRefId())) {
            $this->error->raiseError($this->lng->txt('permission_denied'), $this->error->MESSAGE);
        }
 
        $this->toolbar->addButton(
            $this->lng->txt('crs_add_grouping'),
            $this->ctrl->getLinkTarget($this, 'create')
        );
 
        $table = $this->grouping_table_handler->getTable();
        $this->tpl->setContent($this->ui_renderer->render($table));
    }

References ILIAS\Repository\access(), error(), ILIAS\Repository\lng(), and ILIAS\Repository\toolbar().

Referenced by askDeleteGrouping(), assignCourse(), and showSelectCourse().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ selectCourse()

ilObjCourseGroupingGUI::selectCourse ( )

Definition at line 348 of file class.ilObjCourseGroupingGUI.php.

                                  : void
    {
        /*
         * Since this is triggered from a form command button,
         * the actual cmd in the URL is 'post', which is a problem
         * for data table view control. This redirect solves this.
         */
        $this->ctrl->redirect($this, 'showSelectCourse');
    }

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

◆ showSelectCourse()

ilObjCourseGroupingGUI::showSelectCourse ( )

protected

Definition at line 326 of file class.ilObjCourseGroupingGUI.php.

                                         : void
    {
        if (!$this->access->checkAccess('write', '', $this->content_obj->getRefId())) {
            $this->error->raiseError($this->lng->txt('permission_denied'), $this->error->MESSAGE);
        }
 
        if (!$this->id) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('crs_grp_no_grouping_id_given'));
            $this->listGroupings();
            return;
        }
 
        $this->tabs->clearTargets();
        $this->tabs->setBackTarget(
            $this->lng->txt('back'),
            $this->ctrl->getLinkTarget($this, 'edit')
        );
 
        $table = $this->assignment_table_handler->getTable();
        $this->tpl->setContent($this->ui_renderer->render($table));
    }

References ILIAS\Repository\access(), error(), listGroupings(), ILIAS\Repository\lng(), and ILIAS\Repository\tabs().

Here is the call graph for this function:

◆ update()

ilObjCourseGroupingGUI::update ( )

Definition at line 297 of file class.ilObjCourseGroupingGUI.php.

                            : void
    {
        if (!$this->access->checkAccess('write', '', $this->content_obj->getRefId())) {
            $this->error->raiseError($this->lng->txt('permission_denied'), $this->error->MESSAGE);
        }
 
        $obj_id = 0;
        if ($this->http->wrapper()->query()->has('obj_id')) {
            $obj_id = $this->http->wrapper()->query()->retrieve(
                'obj_id',
                $this->refinery->kindlyTo()->int()
            );
        }
        $form = $this->initForm(false);
        if ($form->checkInput()) {
            $tmp_grouping = new ilObjCourseGrouping($obj_id);
            $tmp_grouping->setTitle($form->getInput('title'));
            $tmp_grouping->setDescription($form->getInput('description'));
            $tmp_grouping->setUniqueField($form->getInput('unique'));
            $tmp_grouping->update();
 
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('settings_saved'), true);
            $this->ctrl->redirect($this, 'listGroupings');
        }
 
        $form->setValuesByPost();
        $this->edit($form);
    }