Submission team. More...

Collaboration diagram for ilExSubmissionTeamGUI:

Public Member Functions
	executeCommand ()

	returnToParentObject ()

	submissionScreenTeamObject ()
	Displays a form which allows members to manage team uploads. More...

	addTeamMemberActionObject (array $a_user_ids=array())

	confirmDeleteTeamObject ()

	confirmRemoveTeamMemberObject (bool $a_full_delete=false)

	removeTeamMemberObject (bool $a_full_delete=false)

	submissionScreenTeamLogObject ()

	createSingleMemberTeamObject ()

	showTeamLogObject ()

	getAdoptForm ()
	Get Adopt form. More...

	createTeamObject ()

	createAdoptedTeamObject ()

	addUserFromAutoCompleteObject ()
	Add user as member. More...

Static Public Member Functions
static	getOverviewContent (ilInfoScreenGUI $a_info, ilExSubmission $a_submission)

static	handleTabs ()

Protected Member Functions
	canEditTeam ()

Protected Attributes
ilCtrl	$ctrl

ilTabsGUI	$tabs_gui

ilLanguage	$lng

ilGlobalTemplateInterface	$tpl

ilToolbarGUI	$toolbar

ilObjUser	$user

ilObjExercise	$exercise

ilExAssignment	$assignment

ilExSubmission	$submission

ilExAssignmentTeam	$team = null

array	$requested_team_ids = []

GUIRequest	$request

Detailed Description

Submission team.

Author: Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om; Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

@ilCtrl_Calls ilExSubmissionTeamGUI: ilRepositorySearchGUI

Definition at line 29 of file class.ilExSubmissionTeamGUI.php.

Member Function Documentation

◆ addTeamMemberActionObject()

ilExSubmissionTeamGUI::addTeamMemberActionObject ( array $a_user_ids = array() )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 263 of file class.ilExSubmissionTeamGUI.php.

     : void {
        if (!$this->canEditTeam()) {
            $this->ctrl->redirect($this, "submissionScreenTeam");
        }
 
        if ($a_user_ids === []) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("no_checkbox"));
            return;
        }
 
        $new_users = [];
 
        foreach ($a_user_ids as $user_id) {
            if ($this->team->addTeamMember($user_id, $this->exercise->getRefId())) {
                $new_users[] = $user_id;
 
                // #14277
                if (!$this->exercise->members_obj->isAssigned($user_id)) {
                    $this->exercise->members_obj->assignMember($user_id);
                }
            } else {
                // #11959
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt("exc_members_already_assigned_team"), true);
            }
        }
 
        if ($new_users !== []) {
            // re-evaluate complete team, as new member could have already submitted
            $this->exercise->processExerciseStatus(
                $this->assignment,
                $this->team->getMembers(),
                $this->submission->hasSubmitted(),
                $this->submission->validatePeerReviews()
            );
            // :TODO: notification?
            $this->tpl->setOnScreenMessage('success', $this->lng->txt("settings_saved"), true);
        }
 
        $this->ctrl->redirect($this, "submissionScreenTeam");
    }

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

◆ addUserFromAutoCompleteObject()

ilExSubmissionTeamGUI::addUserFromAutoCompleteObject ( )

Add user as member.

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 580 of file class.ilExSubmissionTeamGUI.php.

                                                   : void
    {
        $user_login = $this->request->getUserLogin();
        if ($user_login == "") {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('msg_no_search_string'));
            $this->submissionScreenTeamObject();
            return;
        }
 
        $users = explode(',', $user_login);
 
        $user_ids = array();
        foreach ($users as $user) {
            $user_id = ilObjUser::_lookupId($user);
 
            if (!$user_id) {
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt('user_not_known'));
                $this->submissionScreenTeamObject();
                return;
            }
 
            $user_ids[] = $user_id;
        }
 
        $this->addTeamMemberActionObject($user_ids);
    }

References ilObjUser\_lookupId(), and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ canEditTeam()

ilExSubmissionTeamGUI::canEditTeam ( )

protected

Definition at line 212 of file class.ilExSubmissionTeamGUI.php.

                                    : bool
    {
        return (($this->submission->canSubmit() &&
            !$this->submission->getAssignment()->getTeamTutor()) ||
            $this->submission->isTutor());
    }

◆ confirmDeleteTeamObject()

ilExSubmissionTeamGUI::confirmDeleteTeamObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 309 of file class.ilExSubmissionTeamGUI.php.

                                             : void
    {
        $this->confirmRemoveTeamMemberObject(true);
    }

◆ confirmRemoveTeamMemberObject()

ilExSubmissionTeamGUI::confirmRemoveTeamMemberObject ( bool $a_full_delete = false )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 317 of file class.ilExSubmissionTeamGUI.php.

     : void {
        $ilUser = $this->user;
        $tpl = $this->tpl;
 
        if (!$this->submission->isTutor()) {
            $ids = $a_full_delete ? $this->team->getMembers() : $this->requested_team_ids;
 
            if ([] === $ids && !$this->canEditTeam()) {
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt("select_one"), true);
                $this->ctrl->redirect($this, "submissionScreenTeam");
            }
        } else {
            $ids = $this->requested_team_ids;
            if ([] === $ids) {
                $this->returnToParentObject();
            }
        }
 
        $members = $this->team->getMembers();
        if (count($members) <= count($ids)) {
            if (count($members) == 1 && $members[0] == $ilUser->getId()) {
                // direct team deletion - no confirmation
                $this->removeTeamMemberObject($a_full_delete);
                return;
            } else {
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt("exc_team_at_least_one"), true);
                $this->ctrl->redirect($this, "submissionScreenTeam");
            }
        }
 
        $cgui = new ilConfirmationGUI();
        $cgui->setFormAction($this->ctrl->getFormAction($this));
        $cgui->setHeaderText($this->lng->txt("exc_team_member_remove_sure"));
        $cgui->setConfirm($this->lng->txt("remove"), "removeTeamMember");
        $cgui->setCancel($this->lng->txt("cancel"), $this->submission->isTutor()
            ? "returnToParent"
            : "submissionScreenTeam");
 
        $files = $this->submission->getFiles();
 
        foreach ($ids as $id) {
            $details = array();
            foreach ($files as $file) {
                if ($file["owner_id"] == $id) {
                    $details[] = $file["filetitle"];
                }
            }
            $uname = ilUserUtil::getNamePresentation($id);
            if ($details !== []) {
                $uname .= ": " . implode(", ", $details);
            }
            $cgui->addItem("id[]", $id, $uname);
        }
 
        $tpl->setContent($cgui->getHTML());
    }

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

Here is the call graph for this function:

◆ createAdoptedTeamObject()

ilExSubmissionTeamGUI::createAdoptedTeamObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 554 of file class.ilExSubmissionTeamGUI.php.

                                             : void
    {
        $ilCtrl = $this->ctrl;
        $ilUser = $this->user;
        $lng = $this->lng;
 
        $form = $this->getAdoptForm();
        $form->checkInput();
        if ($this->submission->canSubmit()) {
            $src_ass_id = $form->getInput("ass_adpt");
            if ($src_ass_id > 0) {
                ilExAssignmentTeam::adoptTeams($src_ass_id, $this->assignment->getId(), $ilUser->getId(), $this->exercise->getRefId());
            } else {
                ilExAssignmentTeam::getTeamId($this->assignment->getId(), $ilUser->getId(), true);
            }
 
            $this->tpl->setOnScreenMessage('success', $lng->txt("settings_saved"), true);
        }
 
        $ilCtrl->redirect($this, "returnToParent");
    }

References $ilUser, $lng, ilExAssignmentTeam\adoptTeams(), and ilExAssignmentTeam\getTeamId().

Here is the call graph for this function:

◆ createSingleMemberTeamObject()

ilExSubmissionTeamGUI::createSingleMemberTeamObject ( )

Definition at line 456 of file class.ilExSubmissionTeamGUI.php.

                                                  : void
    {
        ilExAssignmentTeam::getTeamId(
            $this->assignment->getId(),
            $this->submission->getUserId(),
            true
        );
        $this->tpl->setOnScreenMessage('success', $this->lng->txt("settings_saved"), true);
        $this->returnToParentObject();
    }

References ilExAssignmentTeam\getTeamId(), and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ createTeamObject()

ilExSubmissionTeamGUI::createTeamObject ( )

Definition at line 524 of file class.ilExSubmissionTeamGUI.php.

                                      : void
    {
        $ilCtrl = $this->ctrl;
        $ilUser = $this->user;
        $tpl = $this->tpl;
 
        if ($this->submission->canSubmit()) {
            $options = ilExAssignmentTeam::getAdoptableTeamAssignments($this->assignment->getExerciseId(), $this->assignment->getId(), $ilUser->getId());
            if ($options !== []) {
                $form = $this->getAdoptForm();
                $tpl->setContent($form->getHTML());
                return;
            }
 
            ilExAssignmentTeam::getTeamId($this->assignment->getId(), $ilUser->getId(), true);
 
            // #18046
            if (!$this->exercise->members_obj->isAssigned($ilUser->getId())) {
                $this->exercise->members_obj->assignMember($ilUser->getId());
            }
 
            $this->tpl->setOnScreenMessage('success', $this->lng->txt("settings_saved"), true);
        }
 
        $ilCtrl->redirect($this, "returnToParent");
    }

References $ilUser, $tpl, ilExAssignmentTeam\getAdoptableTeamAssignments(), ilExAssignmentTeam\getTeamId(), and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ executeCommand()

ilExSubmissionTeamGUI::executeCommand ( )

Exceptions

ilCtrlException

Definition at line 78 of file class.ilExSubmissionTeamGUI.php.

                                    : void
    {
        $ilCtrl = $this->ctrl;
 
        $class = $ilCtrl->getNextClass($this);
        $cmd = $ilCtrl->getCmd("submissionScreenTeam");
 
        if (!$this->assignment->hasTeam() ||
            !$this->submission->canView()) {
            return;
        }
        $this->team = $this->submission->getTeam();
 
        if (!$this->submission->isTutor()) {
            self::handleTabs();
            $this->tabs_gui->activateTab("team");
        }
 
        switch ($class) {
            case 'ilrepositorysearchgui':
                $this->ctrl->setReturn($this, 'submissionScreenTeam');
                $rep_search = new ilRepositorySearchGUI();
                if (!$this->submission->isTutor()) {
                    $rep_search->setPrivacyMode(ilUserAutoComplete::PRIVACY_MODE_RESPECT_USER_SETTING);
                }
                $rep_search->setTitle($this->lng->txt("exc_team_member_add"));
                $rep_search->setCallback($this, 'addTeamMemberActionObject');
                $this->ctrl->forwardCommand($rep_search);
                break;
 
            default:
                $this->{$cmd . "Object"}();
                break;
        }
    }

References $ctrl, ILIAS\Repository\ctrl(), ilCtrl\getNextClass(), handleTabs(), ILIAS\Repository\lng(), and ilUserAutoComplete\PRIVACY_MODE_RESPECT_USER_SETTING.

Here is the call graph for this function:

◆ getAdoptForm()

ilExSubmissionTeamGUI::getAdoptForm ( )

Get Adopt form.

Definition at line 476 of file class.ilExSubmissionTeamGUI.php.

                                  : ilPropertyFormGUI
    {
        $ctrl = $this->ctrl;
        $lng = $this->lng;
        $ilUser = $this->user;
 
        $form = new ilPropertyFormGUI();
        $form->setTitle($lng->txt("exc_team_assignment_adopt_user"));
        $form->setFormAction($ctrl->getFormAction($this, "createAdoptedTeam"));
 
        $teams = new ilRadioGroupInputGUI($lng->txt("exc_assignment"), "ass_adpt");
        $teams->setValue(-1);
 
        $teams->addOption(new ilRadioOption($lng->txt("exc_team_assignment_adopt_none_user"), -1));
 
        $current_map = ilExAssignmentTeam::getAssignmentTeamMap($this->assignment->getId());
 
        $options = ilExAssignmentTeam::getAdoptableTeamAssignments($this->assignment->getExerciseId(), $this->assignment->getId(), $ilUser->getId());
        foreach ($options as $id => $item) {
            $members = array();
            $free = false;
            foreach ($item["user_team"] as $user_id) {
                $members[$user_id] = ilUserUtil::getNamePresentation($user_id);
 
                if (array_key_exists($user_id, $current_map)) {
                    $members[$user_id] .= " (" . $lng->txt("exc_team_assignment_adopt_already_assigned") . ")";
                } else {
                    $free = true;
                }
            }
            asort($members);
            $members = implode("<br />", $members);
            $option = new ilRadioOption($item["title"], $id);
            $option->setInfo($members);
            if (!$free) {
                $option->setDisabled(true);
            }
            $teams->addOption($option);
        }
 
        $form->addItem($teams);
 
        $form->addCommandButton("createAdoptedTeam", $lng->txt("save"));
        $form->addCommandButton("returnToParent", $lng->txt("cancel"));
 
        return $form;
    }

References $id, $ilUser, $lng, ilExAssignmentTeam\getAdoptableTeamAssignments(), ilExAssignmentTeam\getAssignmentTeamMap(), ilCtrl\getFormAction(), and ilUserUtil\getNamePresentation().

Here is the call graph for this function:

◆ getOverviewContent()

static ilExSubmissionTeamGUI::getOverviewContent	(	ilInfoScreenGUI	$a_info,
		ilExSubmission	$a_submission
	)

static

Definition at line 114 of file class.ilExSubmissionTeamGUI.php.

     : void {
        global $DIC;
 
        $lng = $DIC->language();
        $ilCtrl = $DIC->ctrl();
 
        if (!$a_submission->getAssignment()->hasTeam()) {
            return;
        }
 
        $state = ilExcAssMemberState::getInstanceByIds($a_submission->getAssignment()->getId(), $a_submission->getUserId());
 
        $team_members = $a_submission->getTeam()->getMembers();
        if ($team_members !== []) {                                                                     // we have a team
            $team = array();
            foreach ($team_members as $member_id) {
                //$team[] = ilObjUser::_lookupFullname($member_id);
                $team[] = ilUserUtil::getNamePresentation($member_id, false, false, "", false);
            }
            $team = implode("; ", $team);
 
            if (!$a_submission->getAssignment()->getTeamTutor()) {
                #23685
                // any team member upload?
                if (!$a_submission->getLastSubmission()) {
                    $button = ilLinkButton::getInstance();
                    $button->setCaption("exc_delete_team");
                    $button->setUrl($ilCtrl->getLinkTargetByClass(array("ilExSubmissionGUI", "ilExSubmissionTeamGUI"), "confirmDeleteTeam"));
                    $team .= " " . $button->render();
                }
                $button = ilLinkButton::getInstance();
                $button->setCaption("exc_manage_team");
                $button->setUrl($ilCtrl->getLinkTargetByClass(array("ilExSubmissionGUI", "ilExSubmissionTeamGUI"), "submissionScreenTeam"));
            } else {
                $button = ilLinkButton::getInstance();
                $button->setCaption("exc_team_log");
                $button->setUrl($ilCtrl->getLinkTargetByClass(array("ilExSubmissionGUI", "ilExSubmissionTeamGUI"), "submissionScreenTeamLog"));
            }
            $team .= "<br><br>" . $button->render();
 
            $a_info->addProperty($lng->txt("exc_team_members"), $team);
        } else {
            //if($a_submission->getAssignment()->beforeDeadline())              // this was "for all users"
            if (!$state->hasSubmissionEnded()) {                                                        // this is for current user/team -> no team creation, if no submission possible
                if (!$a_submission->hasSubmitted()) {
                    $team_info = $lng->txt("exc_no_team_yet_notice");
                } else {
                    $team_info = '<span class="warning">' . $lng->txt("exc_no_team_yet_notice") . '</span>';
                }
 
                if (!$a_submission->getAssignment()->getTeamTutor()) {
                    $button = ilLinkButton::getInstance();
                    $button->setPrimary(true);
                    $button->setCaption("exc_create_team");             // team creation
                    $button->setUrl($ilCtrl->getLinkTargetByClass(array("ilExSubmissionGUI", "ilExSubmissionTeamGUI"), "createTeam"));
                    $team_info .= " " . $button->render();
 
                    $team_info .= '<div class="ilFormInfo">' . $lng->txt("exc_no_team_yet_info") . '</div>';
                } else {
                    $team_info .= '<div class="ilFormInfo">' . $lng->txt("exc_no_team_yet_info_tutor") . '</div>';
                }
            } else {
                $team_info = $lng->txt("exc_create_team_times_up_warning");
            }
 
            $a_info->addProperty($lng->txt("exc_team_members"), $team_info);
        }
    }

◆ handleTabs()

static ilExSubmissionTeamGUI::handleTabs ( )

static

Definition at line 191 of file class.ilExSubmissionTeamGUI.php.

                                       : void
    {
        global $DIC;
 
        $ilTabs = $DIC->tabs();
        $ilCtrl = $DIC->ctrl();
        $lng = $DIC->language();
 
        $ilTabs->addTab(
            "team",
            $lng->txt("exc_team"),
            $ilCtrl->getLinkTargetByClass("ilExSubmissionTeamGUI", "submissionScreenTeam")
        );
 
        $ilTabs->addTab(
            "log",
            $lng->txt("exc_team_log"),
            $ilCtrl->getLinkTargetByClass("ilExSubmissionTeamGUI", "submissionScreenTeamLog")
        );
    }

References $DIC, and $lng.

Referenced by executeCommand(), and ilExSubmissionBaseGUI\handleTabs().

Here is the caller graph for this function:

◆ removeTeamMemberObject()

ilExSubmissionTeamGUI::removeTeamMemberObject ( bool $a_full_delete = false )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 379 of file class.ilExSubmissionTeamGUI.php.

     : void {
        $ilUser = $this->user;
 
        $cancel_cmd = $this->submission->isTutor()
            ? "returnToParent"
            : "submissionScreenTeam";
 
        $ids = [];
        if ($a_full_delete) {
            $ids = $this->team->getMembers();
        } else {
            $ids = $this->requested_team_ids;
        }
        $ids = array_filter(array_map('intval', $ids));
 
        if ([] === $ids && !$this->canEditTeam()) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("select_one"), true);
            $this->ctrl->redirect($this, $cancel_cmd);
        }
 
        $team_deleted = $a_full_delete;
        if (!$team_deleted) {
            $members = $this->team->getMembers();
            if (count($members) <= count($ids)) {
                if (count($members) == 1 && $members[0] == $ilUser->getId()) {
                    $team_deleted = true;
                } else {
                    $this->tpl->setOnScreenMessage('failure', $this->lng->txt("exc_team_at_least_one"), true);
                    $this->ctrl->redirect($this, $cancel_cmd);
                }
            }
        }
 
        foreach ($ids as $user_id) {
            $this->team->removeTeamMember($user_id, $this->exercise->getRefId());
        }
 
        // reset ex team members, as any submission is not valid without team
        $this->exercise->processExerciseStatus(
            $this->assignment,
            $ids,
            false
        );
 
        if (!$team_deleted) {
            // re-evaluate complete team, as removed member might have had submitted
            $this->exercise->processExerciseStatus(
                $this->assignment,
                $this->team->getMembers(),
                $this->submission->hasSubmitted(),
                $this->submission->validatePeerReviews()
            );
        }
 
        $this->tpl->setOnScreenMessage('success', $this->lng->txt("settings_saved"), true);
        if (!$team_deleted) {
            $this->ctrl->redirect($this, $cancel_cmd);
        } else {
            $this->ctrl->redirect($this, "returnToParent");
        }
    }

◆ returnToParentObject()

ilExSubmissionTeamGUI::returnToParentObject ( )

Definition at line 186 of file class.ilExSubmissionTeamGUI.php.

                                          : void
    {
        $this->ctrl->returnToParent($this);
    }

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

◆ showTeamLogObject()

ilExSubmissionTeamGUI::showTeamLogObject ( )

Definition at line 467 of file class.ilExSubmissionTeamGUI.php.

                                       : void
    {
        $tbl = new ilExAssignmentTeamLogTableGUI($this, "showTeamLog", $this->team);
        $this->tpl->setContent($tbl->getHTML());
    }

◆ submissionScreenTeamLogObject()

ilExSubmissionTeamGUI::submissionScreenTeamLogObject ( )

Definition at line 443 of file class.ilExSubmissionTeamGUI.php.

                                                   : void
    {
        $this->tabs_gui->activateTab("log");
 
        $tbl = new ilExAssignmentTeamLogTableGUI(
            $this,
            "submissionScreenTeamLog",
            $this->team
        );
 
        $this->tpl->setContent($tbl->getHTML());
    }

◆ submissionScreenTeamObject()

ilExSubmissionTeamGUI::submissionScreenTeamObject ( )

Displays a form which allows members to manage team uploads.

Definition at line 222 of file class.ilExSubmissionTeamGUI.php.

                                                : void
    {
        $ilToolbar = $this->toolbar;
 
        // #13414
        $read_only = !$this->canEditTeam();
 
        if ($this->submission->getAssignment()->afterDeadlineStrict(false)) {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt("exercise_time_over"));
        } elseif (!$read_only) {
            $add_search = $this->submission->isTutor();
            // add member
            ilRepositorySearchGUI::fillAutoCompleteToolbar(
                $this,
                $ilToolbar,
                array(
                    'auto_complete_name' => $this->lng->txt('user'),
                    'submit_name' => $this->lng->txt('add'),
                    'add_search' => $add_search,
                    'add_from_container' => $this->exercise->getRefId()
                )
            );
        } elseif ($this->submission->getAssignment()->getTeamTutor()) {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt("exc_no_team_yet_info_tutor"));
        }
 
        $tbl = new ilExAssignmentTeamTableGUI(
            $this,
            "submissionScreenTeam",
            ilExAssignmentTeamTableGUI::MODE_EDIT,
            $this->exercise->getRefId(),
            $this->team,
            $read_only
        );
 
        $this->tpl->setContent($tbl->getHTML());
    }