ilSurveyParticipantsGUI Class Reference

Class ilSurveyParticipantsGUI. More...

Collaboration diagram for ilSurveyParticipantsGUI:

Public Member Functions
	getObject ()
	executeCommand ()
	maintenanceObject ()
	Participants maintenance. More...
	deleteAllUserDataObject ()
	Creates a confirmation form for delete all user data. More...
	confirmDeleteAllUserDataObject ()
	Deletes all user data of the survey after confirmation. More...
	cancelDeleteAllUserDataObject ()
	Cancels delete of all user data in maintenance. More...
	confirmDeleteSelectedUserDataObject ()
	Deletes all user data for the test object. More...
	cancelDeleteSelectedUserDataObject ()
	Cancels the deletion of all user data. More...
	deleteSingleUserResultsObject ()
	Asks for a confirmation to delete selected user data. More...
	setCodeLanguageObject ()
	Change survey language for direct access URL's. More...
	codesObject ()
	Display the survey access codes tab. More...
	editCodesObject ()
	updateCodesObject ()
	deleteCodesConfirmObject ()
	deleteCodesObject ()
	Delete a list of survey codes. More...
	exportCodesObject ()
	Exports a list of survey codes. More...
	exportAllCodesObject ()
	Exports all survey codes. More...
	createSurveyCodesObject ()
	Create access codes for the survey. More...
	insertSavedMessageObject ()
	deleteSavedMessageObject ()
	mailCodesObject ()
	sendCodesMailObject ()
	importExternalRecipientsFromTextObject ()
	addCodeForExternal (string $email, string $lastname, string $firstname)
	Add code for an external rater. More...
	importExternalRecipientsFromFileObject ()
	importExternalMailRecipientsFromFileFormObject ()
	importExternalMailRecipientsFromTextFormObject ()
	listAppraiseesObject ()
	addAppraisee (array $a_user_ids)
	confirmDeleteAppraiseesObject ()
	deleteAppraiseesObject ()
	handleRatersAccess ()
	editRatersObject ()
	addExternalRaterFormObject (ilPropertyFormGUI $a_form=null)
	addExternalRaterObject ()
	addRater (array $a_user_ids)
	confirmDeleteRatersObject ()
	deleteRatersObject ()
	addSelfAppraiseeObject ()
	initMailRatersForm (int $appr_id, array $rec_ids)
	mailRatersObject ()
	mailRatersObjectOld (ilPropertyFormGUI $a_form=null)
	mailRatersActionObject ()
	confirmAppraiseeCloseObject ()
	confirmAppraiseeCloseCancelObject ()
	appraiseeCloseObject ()
	confirmAdminAppraiseesCloseObject ()
	adminAppraiseesCloseObject ()
	inviteUsers (array $user_ids)

Protected Member Functions
	handleWriteAccess ()
	filterSurveyParticipantsByAccess (array $a_finished_ids=null)
	isAnonymousListActive ()
	setParticipantSubTabs (string $active)
	importAccessCodesObject ()
	Import codes from export codes file (upload form) More...
	importAccessCodesActionObject ()
	Import codes from export codes file. More...
	_convertCharset (string $a_string, string $a_from_charset="", string $a_to_charset="UTF-8")
	removeUTF8Bom (string $a_text)
	storeMailSent ()
	initExternalRaterForm (int $appr_id)
	listParticipantsObject ()

Protected Attributes
ILIAS Survey Mode FeatureConfig	$feature_config
ILIAS Survey Editing EditingGUIRequest	$edit_request
ILIAS Survey Editing EditManager	$edit_manager
ilCtrl	$ctrl
ilLanguage	$lng
ilGlobalTemplateInterface	$tpl
ilTabsGUI	$tabs
ilToolbarGUI	$toolbar
ilAccessHandler	$access
ilRbacSystem	$rbacsystem
ilObjUser	$user
ilLogger	$log
ilObjSurveyGUI	$parent_gui
ilObjSurvey	$object
int	$ref_id
bool	$has_write
Participants InvitationsManager	$invitation_manager
ILIAS Survey InternalService	$survey_service
ILIAS Survey Code CodeManager	$code_manager
ILIAS Survey InternalDataService	$data_manager

Detailed Description

Class ilSurveyParticipantsGUI.

Author

Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m @ilCtrl_Calls ilSurveyParticipantsGUI: ilRepositorySearchGUI, ilSurveyRaterGUI

Definition at line 26 of file class.ilSurveyParticipantsGUI.php.

Member Function Documentation

_convertCharset()

ilSurveyParticipantsGUI::_convertCharset ( string  $a_string, string  $a_from_charset = "", string  $a_to_charset = "UTF-8"  )

protected

Definition at line 964 of file class.ilSurveyParticipantsGUI.php.

     : string {
        if (extension_loaded("mbstring")) {
            if (!$a_from_charset) {
                mb_detect_order("UTF-8, ISO-8859-1, Windows-1252, ASCII");
                $a_from_charset = mb_detect_encoding($a_string);
            }
            if (strtoupper($a_from_charset) !== $a_to_charset) {
                return mb_convert_encoding($a_string, $a_to_charset, $a_from_charset);
            }
        }
        return $a_string;
    }

addAppraisee()

ilSurveyParticipantsGUI::addAppraisee

(

array

$a_user_ids

)

Definition at line 1168 of file class.ilSurveyParticipantsGUI.php.

     : void {
        if (count($a_user_ids)) {
            // #13319
            foreach (array_unique($a_user_ids) as $user_id) {
                $this->object->addAppraisee($user_id);
            }
 
            $this->tpl->setOnScreenMessage('success', $this->lng->txt("settings_saved"), true);
        }
        $this->ctrl->redirect($this, "listAppraisees");
    }

References ILIAS\Repository\lng().

Here is the call graph for this function:

addCodeForExternal()

ilSurveyParticipantsGUI::addCodeForExternal	(	string	$email,
		string	$lastname,
		string	$firstname
	)

Add code for an external rater.

Definition at line 949 of file class.ilSurveyParticipantsGUI.php.

     : int {
        $code = $this->data_manager->code("")
           ->withEmail($email)
           ->withLastName($lastname)
           ->withFirstName($firstname);
        $code_id = $this->code_manager->add($code);
        return $code_id;
    }

addExternalRaterFormObject()

ilSurveyParticipantsGUI::addExternalRaterFormObject

(

ilPropertyFormGUI

$a_form = null

)

Definition at line 1324 of file class.ilSurveyParticipantsGUI.php.

     : void {
        $ilTabs = $this->tabs;
        $ilAccess = $this->access;
 
        $appr_id = $this->handleRatersAccess();
        $this->ctrl->setParameter($this, "appr_id", $appr_id);
 
        $has_write = $ilAccess->checkAccess("write", "", $this->ref_id);
        if ($has_write) {
            $ilTabs->clearTargets();
            $ilTabs->setBackTarget(
                $this->lng->txt("btn_back"),
                $this->ctrl->getLinkTarget($this, "editRaters")
            );
        }
 
        if (!$a_form) {
            $a_form = $this->initExternalRaterForm($appr_id);
        }
 
        $this->tpl->setContent($a_form->getHTML());
    }

addExternalRaterObject()

ilSurveyParticipantsGUI::addExternalRaterObject

(

)

Definition at line 1375 of file class.ilSurveyParticipantsGUI.php.

                                            : void
    {
        $appr_id = $this->edit_request->getAppraiseeId();
        if (!$appr_id) {
            $this->ctrl->redirect($this, "listAppraisees");
        }
 
        $this->ctrl->setParameter($this, "appr_id", $appr_id);
 
        $form = $this->initExternalRaterForm($appr_id);
        if ($form->checkInput()) {
            $code_id = $this->addCodeForExternal(
                $form->getInput("email"),
                $form->getInput("lname"),
                $form->getInput("fname")
            );
 
            $this->object->addRater($appr_id, 0, $code_id);
 
            $this->tpl->setOnScreenMessage('success', $this->lng->txt("settings_saved"), true);
            $this->ctrl->setParameter($this, "appr_id", $appr_id);
            $this->ctrl->redirect($this, "editRaters");
        }
 
        $form->setValuesByPost();
        $this->addExternalRaterFormObject($form);
    }

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

Here is the call graph for this function:

addRater()

ilSurveyParticipantsGUI::addRater

(

array

$a_user_ids

)

Definition at line 1403 of file class.ilSurveyParticipantsGUI.php.

     : void {
        $ilAccess = $this->access;
        $ilUser = $this->user;
 
        $appr_id = $this->handleRatersAccess();
 
        if (count($a_user_ids)) {
            // #13319
            foreach (array_unique($a_user_ids) as $user_id) {
                if ($ilAccess->checkAccess("write", "", $this->ref_id) ||
                    $this->object->get360SelfEvaluation() ||
                    $user_id != $ilUser->getId()) {
                    if ($appr_id != $user_id) {
                        $this->object->addRater($appr_id, $user_id);
                        $this->tpl->setOnScreenMessage('success', $this->lng->txt("settings_saved"), true);
                    } else {
                        $this->tpl->setOnScreenMessage('failure', $this->lng->txt("svy_appraisses_cannot_be_raters"), true);
                    }
                }
            }
        }
 
        $this->ctrl->setParameter($this, "appr_id", $appr_id);
        $this->ctrl->redirect($this, "editRaters");
    }

addSelfAppraiseeObject()

ilSurveyParticipantsGUI::addSelfAppraiseeObject

(

)

Definition at line 1496 of file class.ilSurveyParticipantsGUI.php.

                                            : void
    {
        $ilUser = $this->user;
 
        if ($this->object->get360SelfAppraisee() &&
            !$this->object->isAppraisee($ilUser->getId())) {
            $this->object->addAppraisee($ilUser->getId());
        }
 
        $this->ctrl->redirect($this->parent_gui, "infoScreen");
    }

References $ilUser, ILIAS\Repository\ctrl(), and ILIAS\Repository\object().

Here is the call graph for this function:

adminAppraiseesCloseObject()

ilSurveyParticipantsGUI::adminAppraiseesCloseObject

(

)

Definition at line 1795 of file class.ilSurveyParticipantsGUI.php.

                                                : void
    {
        $this->handleWriteAccess();
 
        $appr_ids = $this->edit_request->getAppraiseeIds();
 
        if (count($appr_ids) === 0) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("select_one"), true);
            $this->ctrl->redirect($this, "listAppraisees");
        }
 
        $appr_data = $this->object->getAppraiseesData();
        foreach ($appr_ids as $appr_id) {
            if (isset($appr_data[$appr_id]) && !$appr_data[$appr_id]["closed"]) {
                $this->object->closeAppraisee($appr_id);
            }
        }
 
        $this->tpl->setOnScreenMessage('success', $this->lng->txt("survey_360_appraisee_close_action_success_admin"), true);
        $this->ctrl->redirect($this, "listAppraisees");
    }

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

Here is the call graph for this function:

appraiseeCloseObject()

ilSurveyParticipantsGUI::appraiseeCloseObject

(

)

Definition at line 1755 of file class.ilSurveyParticipantsGUI.php.

                                          : void
    {
        $ilUser = $this->user;
 
        if (!$this->object->isAppraisee($ilUser->getId())) {
            $this->ctrl->redirect($this->parent_gui, "infoScreen");
        }
 
        $this->object->closeAppraisee($ilUser->getId());
        $this->tpl->setOnScreenMessage('success', $this->lng->txt("survey_360_appraisee_close_action_success"), true);
        $this->ctrl->redirect($this->parent_gui, "infoScreen");
    }

References $ilUser, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

Here is the call graph for this function:

cancelDeleteAllUserDataObject()

ilSurveyParticipantsGUI::cancelDeleteAllUserDataObject

(

)

Cancels delete of all user data in maintenance.

Definition at line 401 of file class.ilSurveyParticipantsGUI.php.

                                                   : void
    {
        $this->ctrl->redirect($this, "maintenance");
    }

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

cancelDeleteSelectedUserDataObject()

ilSurveyParticipantsGUI::cancelDeleteSelectedUserDataObject

(

)

Cancels the deletion of all user data.

Definition at line 432 of file class.ilSurveyParticipantsGUI.php.

                                                        : void
    {
        $this->tpl->setOnScreenMessage('info', $this->lng->txt('msg_cancel'), true);
        $this->ctrl->redirect($this, "maintenance");
    }

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

Here is the call graph for this function:

codesObject()

ilSurveyParticipantsGUI::codesObject

(

)

Display the survey access codes tab.

Definition at line 490 of file class.ilSurveyParticipantsGUI.php.

                                 : void
    {
        $ilUser = $this->user;
        $ilToolbar = $this->toolbar;
 
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("codes");
 
        if ($this->object->isAccessibleWithoutCode()) {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt("survey_codes_no_anonymization"));
            return;
        }
 
        $default_lang = $ilUser->getPref("survey_code_language");
 
        // creation buttons
        $ilToolbar->setFormAction($this->ctrl->getFormAction($this));
 
        $si = new ilTextInputGUI($this->lng->txt("new_survey_codes"), "nrOfCodes");
        $si->setValue(1);
        $si->setSize(3);
        $ilToolbar->addInputItem($si, true);
 
        $button = ilSubmitButton::getInstance();
        $button->setCaption("create");
        $button->setCommand("createSurveyCodes");
        $ilToolbar->addButtonInstance($button);
 
        $ilToolbar->addSeparator();
 
        $button = ilSubmitButton::getInstance();
        $button->setCaption("import_from_file");
        $button->setCommand("importExternalMailRecipientsFromFileForm");
        $ilToolbar->addButtonInstance($button);
 
        $button = ilSubmitButton::getInstance();
        $button->setCaption("import_from_text");
        $button->setCommand("importExternalMailRecipientsFromTextForm");
        $ilToolbar->addButtonInstance($button);
 
        $ilToolbar->addSeparator();
 
        $button = ilSubmitButton::getInstance();
        $button->setCaption("svy_import_codes");
        $button->setCommand("importAccessCodes");
        $ilToolbar->addButtonInstance($button);
 
        $ilToolbar->addSeparator();
 
        $languages = $this->lng->getInstalledLanguages();
        $options = array();
        $this->lng->loadLanguageModule("meta");
        foreach ($languages as $lang) {
            $options[$lang] = $this->lng->txt("meta_l_" . $lang);
        }
        $si = new ilSelectInputGUI($this->lng->txt("survey_codes_lang"), "lang");
        $si->setOptions($options);
        $si->setValue($default_lang);
        $ilToolbar->addInputItem($si, true);
 
        $button = ilSubmitButton::getInstance();
        $button->setCaption("set");
        $button->setCommand("setCodeLanguage");
        $ilToolbar->addButtonInstance($button);
 
        $table_gui = new ilSurveyCodesTableGUI($this, 'codes');
        $survey_codes = $this->object->getSurveyCodesTableData(null, $default_lang);
        $table_gui->setData($survey_codes);
        $this->tpl->setContent($table_gui->getHTML());
    }

References $ilUser, $lang, ILIAS\Repository\ctrl(), ilSubmitButton\getInstance(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

Here is the call graph for this function:

confirmAdminAppraiseesCloseObject()

ilSurveyParticipantsGUI::confirmAdminAppraiseesCloseObject

(

)

Definition at line 1768 of file class.ilSurveyParticipantsGUI.php.

                                                       : void
    {
        $tpl = $this->tpl;
 
        $this->handleWriteAccess();
 
        $appr_ids = $this->edit_request->getAppraiseeIds();
 
        if (count($appr_ids) === 0) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("select_one"), true);
            $this->ctrl->redirect($this, "listAppraisees");
        }
 
        $cgui = new ilConfirmationGUI();
        $cgui->setHeaderText($this->lng->txt("survey_360_sure_appraisee_close_admin"));
 
        $cgui->setFormAction($this->ctrl->getFormAction($this, "adminAppraiseesClose"));
        $cgui->setCancel($this->lng->txt("cancel"), "listAppraisees");
        $cgui->setConfirm($this->lng->txt("confirm"), "adminAppraiseesClose");
 
        foreach ($appr_ids as $appr_id) {
            $cgui->addItem("appr_id[]", $appr_id, ilUserUtil::getNamePresentation($appr_id));
        }
 
        $tpl->setContent($cgui->getHTML());
    }

References $tpl, ILIAS\Repository\ctrl(), ilUserUtil\getNamePresentation(), and ILIAS\Repository\lng().

Here is the call graph for this function:

confirmAppraiseeCloseCancelObject()

ilSurveyParticipantsGUI::confirmAppraiseeCloseCancelObject

(

)

Definition at line 1750 of file class.ilSurveyParticipantsGUI.php.

                                                       : void
    {
        $this->ctrl->redirect($this->parent_gui, "infoScreen");
    }

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

confirmAppraiseeCloseObject()

ilSurveyParticipantsGUI::confirmAppraiseeCloseObject

(

)

Definition at line 1724 of file class.ilSurveyParticipantsGUI.php.

                                                 : void
    {
        $ilUser = $this->user;
        $tpl = $this->tpl;
        $ilTabs = $this->tabs;
 
        $ilTabs->clearTargets();
        $ilTabs->setBackTarget(
            $this->lng->txt("menuback"),
            $this->ctrl->getLinkTarget($this->parent_gui, "infoScreen")
        );
 
        if (!$this->object->isAppraisee($ilUser->getId())) {
            $this->ctrl->redirect($this->parent_gui, "infoScreen");
        }
 
        $cgui = new ilConfirmationGUI();
        $cgui->setHeaderText($this->lng->txt("survey_360_sure_appraisee_close"));
 
        $cgui->setFormAction($this->ctrl->getFormAction($this, "appraiseeClose"));
        $cgui->setCancel($this->lng->txt("cancel"), "confirmAppraiseeCloseCancel");
        $cgui->setConfirm($this->lng->txt("confirm"), "appraiseeClose");
 
        $tpl->setContent($cgui->getHTML());
    }

References $ilUser, $tpl, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and ilGlobalTemplateInterface\setContent().

Here is the call graph for this function:

confirmDeleteAllUserDataObject()

ilSurveyParticipantsGUI::confirmDeleteAllUserDataObject

(

)

Deletes all user data of the survey after confirmation.

Definition at line 378 of file class.ilSurveyParticipantsGUI.php.

                                                    : void
    {
        if ($this->access->checkAccess('write', '', $this->object->getRefId())) {
            $this->object->deleteAllUserData();
        } else {
            $participants = $this->filterSurveyParticipantsByAccess();
            foreach ($participants as $something => $participant_data) {
                $this->object->removeSelectedSurveyResults([$participant_data['active_id']]);
            }
        }
 
        // #11558 - re-open closed appraisees
        if ($this->object->get360Mode()) {
            $this->object->openAllAppraisees();
        }
 
        $this->tpl->setOnScreenMessage('success', $this->lng->txt("svy_all_user_data_deleted"), true);
        $this->ctrl->redirect($this, "maintenance");
    }

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

Here is the call graph for this function:

confirmDeleteAppraiseesObject()

ilSurveyParticipantsGUI::confirmDeleteAppraiseesObject

(

)

Definition at line 1182 of file class.ilSurveyParticipantsGUI.php.

                                                   : void
    {
        $ilTabs = $this->tabs;
 
        $appr_ids = $this->edit_request->getAppraiseeIds();
        if (count($appr_ids) === 0) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("select_one"), true);
            $this->ctrl->redirect($this, "listAppraisees");
        }
 
        $ilTabs->clearTargets();
        $ilTabs->setBackTarget(
            $this->lng->txt("btn_back"),
            $this->ctrl->getLinkTarget($this, "listAppraisees")
        );
 
        $cgui = new ilConfirmationGUI();
        $cgui->setHeaderText($this->lng->txt("survey_360_sure_delete_appraises"));
 
        $cgui->setFormAction($this->ctrl->getFormAction($this, "deleteAppraisees"));
        $cgui->setCancel($this->lng->txt("cancel"), "listAppraisees");
        $cgui->setConfirm($this->lng->txt("confirm"), "deleteAppraisees");
 
        $data = $this->object->getAppraiseesData();
 
        $count = 0;
        foreach ($appr_ids as $id) {
            if (isset($data[$id]) && !$data[$id]["closed"]) {
                $cgui->addItem("appr_id[]", $id, ilUserUtil::getNamePresentation($id));
                $count++;
            }
        }
 
        if (!$count) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("select_one"), true);
            $this->ctrl->redirect($this, "listAppraisees");
        }
 
        $this->tpl->setContent($cgui->getHTML());
    }

References $data, $id, ILIAS\Repository\ctrl(), ilUserUtil\getNamePresentation(), and ILIAS\Repository\lng().

Here is the call graph for this function:

confirmDeleteRatersObject()

ilSurveyParticipantsGUI::confirmDeleteRatersObject

(

)

Definition at line 1431 of file class.ilSurveyParticipantsGUI.php.

                                               : void
    {
        $ilTabs = $this->tabs;
 
        $rater_ids = $this->edit_request->getRaterIds();
        $appr_id = $this->handleRatersAccess();
        $this->ctrl->setParameter($this, "appr_id", $appr_id);
        if (count($rater_ids) === 0) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("select_one"), true);
            $this->ctrl->redirect($this, "editRaters");
        }
 
        $ilTabs->clearTargets();
        $ilTabs->setBackTarget(
            $this->lng->txt("btn_back"),
            $this->ctrl->getLinkTarget($this, "editRaters")
        );
 
        $cgui = new ilConfirmationGUI();
        $cgui->setHeaderText(sprintf(
            $this->lng->txt("survey_360_sure_delete_raters"),
            ilUserUtil::getNamePresentation($appr_id)
        ));
 
        $cgui->setFormAction($this->ctrl->getFormAction($this, "deleteRaters"));
        $cgui->setCancel($this->lng->txt("cancel"), "editRaters");
        $cgui->setConfirm($this->lng->txt("confirm"), "deleteRaters");
 
        $data = $this->object->getRatersData($appr_id);
 
        foreach ($rater_ids as $id) {
            if (isset($data[$id])) {
                $cgui->addItem("rtr_id[]", $id, $data[$id]["lastname"] . ", " .
                    $data[$id]["firstname"] . " (" . $data[$id]["email"] . ")");
            }
        }
 
        $this->tpl->setContent($cgui->getHTML());
    }

References $data, $id, ILIAS\Repository\ctrl(), ilUserUtil\getNamePresentation(), and ILIAS\Repository\lng().

Here is the call graph for this function:

confirmDeleteSelectedUserDataObject()

ilSurveyParticipantsGUI::confirmDeleteSelectedUserDataObject

(

)

Deletes all user data for the test object.

Definition at line 409 of file class.ilSurveyParticipantsGUI.php.

                                                         : void
    {
        $user_ids = $this->edit_request->getUserIds();
        if (count($user_ids) > 0) {
            $this->object->removeSelectedSurveyResults(array_filter($user_ids, static function ($i): bool {
                return is_numeric($i);
            }));
 
            $invitations = array_filter($user_ids, static function ($i): bool {
                return strpos($i, "inv") === 0;
            });
            foreach ($invitations as $i) {
                $this->invitation_manager->remove($this->object->getSurveyId(), (int) substr($i, 3));
            }
 
            $this->tpl->setOnScreenMessage('success', $this->lng->txt("svy_selected_user_data_deleted"), true);
        }
        $this->ctrl->redirect($this, "maintenance");
    }

References $i, ILIAS\Repository\ctrl(), ILIAS\Repository\int(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

Here is the call graph for this function:

createSurveyCodesObject()

ilSurveyParticipantsGUI::createSurveyCodesObject

(

)

Create access codes for the survey.

Definition at line 779 of file class.ilSurveyParticipantsGUI.php.

                                             : void
    {
        if ($this->edit_request->getNrOfCodes() > 0) {
            $ids = $this->code_manager->addCodes($this->edit_request->getNrOfCodes());
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('codes_created'), true);
            $this->ctrl->setParameter($this, "new_ids", implode(";", $ids));
            $this->ctrl->redirect($this, 'editCodes');
        } else {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("enter_valid_number_of_codes"), true);
            $this->ctrl->redirect($this, 'codes');
        }
    }

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

Here is the call graph for this function:

deleteAllUserDataObject()

ilSurveyParticipantsGUI::deleteAllUserDataObject

(

)

Creates a confirmation form for delete all user data.

Definition at line 365 of file class.ilSurveyParticipantsGUI.php.

                                             : void
    {
        $cgui = new ilConfirmationGUI();
        $cgui->setHeaderText($this->lng->txt("confirm_delete_all_user_data"));
        $cgui->setFormAction($this->ctrl->getFormAction($this, "deleteAllUserData"));
        $cgui->setCancel($this->lng->txt("cancel"), "cancelDeleteAllUserData");
        $cgui->setConfirm($this->lng->txt("confirm"), "confirmDeleteAllUserData");
        $this->tpl->setContent($cgui->getHTML());
    }

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

Here is the call graph for this function:

deleteAppraiseesObject()

ilSurveyParticipantsGUI::deleteAppraiseesObject

(

)

Definition at line 1223 of file class.ilSurveyParticipantsGUI.php.

                                            : void
    {
        $appr_ids = $this->edit_request->getAppraiseeIds();
        if (count($appr_ids) > 0) {
            $data = $this->object->getAppraiseesData();
 
            foreach ($appr_ids as $id) {
                // #11285
                if (isset($data[$id]) && !$data[$id]["closed"]) {
                    $this->object->deleteAppraisee($id);
                }
            }
 
            $this->tpl->setOnScreenMessage('success', $this->lng->txt("settings_saved"), true);
        }
 
        $this->ctrl->redirect($this, "listAppraisees");
    }

References $data, $id, ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

Here is the call graph for this function:

deleteCodesConfirmObject()

ilSurveyParticipantsGUI::deleteCodesConfirmObject

(

)

Definition at line 613 of file class.ilSurveyParticipantsGUI.php.

                                              : void
    {
        $codes = $this->edit_request->getCodes();
 
        $data = $this->object->getSurveyCodesTableData($codes);
        $data = array_filter($data, static function ($item): bool {
            return !$item["used"];
        });
        if (count($data) > 0) {
            $cgui = new ilConfirmationGUI();
            $cgui->setHeaderText($this->lng->txt("survey_code_delete_sure"));
 
            $cgui->setFormAction($this->ctrl->getFormAction($this));
            $cgui->setCancel($this->lng->txt("cancel"), "codes");
            $cgui->setConfirm($this->lng->txt("confirm"), "deleteCodes");
 
            foreach ($data as $item) {
                $title = array($item["code"]);
                $title[] = $item["email"] ?? "";
                $title[] = $item["last_name"] ?? "";
                $title[] = $item["first_name"] ?? "";
                $title = implode(", ", $title);
 
                $cgui->addItem("chb_code[]", $item["code"], $title);
            }
 
            $this->tpl->setContent($cgui->getHTML());
        } else {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('svy_please_select_unused_codes'), true);
            $this->ctrl->redirect($this, 'codes');
        }
    }

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

Here is the call graph for this function:

deleteCodesObject()

ilSurveyParticipantsGUI::deleteCodesObject

(

)

Delete a list of survey codes.

Definition at line 649 of file class.ilSurveyParticipantsGUI.php.

                                       : void
    {
        $codes = $this->edit_request->getCodes();
        if (count($codes) > 0) {
            foreach ($codes as $survey_code) {
                $this->object->deleteSurveyCode($survey_code);
            }
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('codes_deleted'), true);
        } else {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt('no_checkbox'), true);
        }
        $this->ctrl->redirect($this, 'codes');
    }

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

Here is the call graph for this function:

deleteRatersObject()

ilSurveyParticipantsGUI::deleteRatersObject

(

)

Definition at line 1471 of file class.ilSurveyParticipantsGUI.php.

                                        : void
    {
        $appr_id = $this->handleRatersAccess();
        $this->ctrl->setParameter($this, "appr_id", $appr_id);
 
        $rater_ids = $this->edit_request->getRaterIds();
        if (count($rater_ids) > 0) {
            $data = $this->object->getRatersData($appr_id);
 
            foreach ($rater_ids as $id) {
                if (isset($data[$id])) {
                    if (strpos($id, "u") === 0) {
                        $this->object->deleteRater($appr_id, substr($id, 1));
                    } else {
                        $this->object->deleteRater($appr_id, 0, substr($id, 1));
                    }
                }
            }
 
            $this->tpl->setOnScreenMessage('success', $this->lng->txt("settings_saved"), true);
        }
 
        $this->ctrl->redirect($this, "editRaters");
    }

References $data, $id, ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

Here is the call graph for this function:

deleteSavedMessageObject()

ilSurveyParticipantsGUI::deleteSavedMessageObject

(

)

Definition at line 815 of file class.ilSurveyParticipantsGUI.php.

                                              : void
    {
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("codes");
 
        $form_gui = new FormMailCodesGUI($this);
        $form_gui->setValuesByPost();
        try {
            if ($form_gui->getSavedMessages()->getValue() > 0) {
                $this->object->deleteUserSettings($form_gui->getSavedMessages()->getValue());
                $form_gui = new FormMailCodesGUI($this);
                $form_gui->setValuesByPost();
                $this->tpl->setOnScreenMessage('success', $this->lng->txt('msg_message_deleted'));
            } else {
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt('msg_no_message_deleted'));
            }
        } catch (Exception $e) {
            $ilLog = $this->log;
            $ilLog->write('Error: ' . $e->getMessage());
        }
        $this->tpl->setVariable("ADM_CONTENT", $form_gui->getHTML());
    }

References Vendor\Package\$e, $log, and ILIAS\Repository\lng().

Here is the call graph for this function:

deleteSingleUserResultsObject()

ilSurveyParticipantsGUI::deleteSingleUserResultsObject

(

)

Asks for a confirmation to delete selected user data.

Definition at line 441 of file class.ilSurveyParticipantsGUI.php.

                                                   : void
    {
        $this->handleWriteAccess();
 
        $user_ids = $this->edit_request->getUserIds();
        if (count($user_ids) === 0) {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt('no_checkbox'), true);
            $this->ctrl->redirect($this, "maintenance");
        }
 
        $this->tpl->setOnScreenMessage('question', $this->lng->txt("confirm_delete_single_user_data"));
        $table_gui = new ilSurveyMaintenanceTableGUI($this, 'maintenance', true);
        $total = $this->object->getSurveyParticipants(null, false, true);
        $data = array();
        foreach ($total as $user_data) {
            if (in_array(($user_data['active_id'] ?? null), $user_ids)
                || (($user_data['invited'] ?? false) && in_array("inv" . $user_data['usr_id'], $user_ids))) {
                $last_access = $this->object->getLastAccess($user_data["active_id"] ?? 0);
                $data[] = array(
                    'id' => $user_data["active_id"] ?? null,
                    'name' => $user_data["sortname"],
                    'login' => $user_data["login"] ?? null,
                    'last_access' => $last_access,
                    'finished' => $user_data["finished_tstamp"] ?? 0,
                    'usr_id' => $user_data["usr_id"] ?? null,
                    'invited' => $user_data["invited"] ?? null
                );
            }
        }
        $table_gui->setData($data);
        $this->tpl->setVariable('ADM_CONTENT', $table_gui->getHTML());
    }

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

Here is the call graph for this function:

editCodesObject()

ilSurveyParticipantsGUI::editCodesObject

(

)

Definition at line 561 of file class.ilSurveyParticipantsGUI.php.

                                     : void
    {
        $ids = $this->edit_request->getCodeIds();
        if (count($ids) === 0) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('no_checkbox'), true);
            $this->ctrl->redirect($this, 'codes');
        }
 
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("codes");
 
        $table_gui = new ilSurveyCodesEditTableGUI($this, 'editCodes');
        $table_gui->setData($this->object->getSurveyCodesTableData($ids));
        $this->tpl->setContent($table_gui->getHTML());
    }

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

Here is the call graph for this function:

editRatersObject()

ilSurveyParticipantsGUI::editRatersObject

(

)

Definition at line 1287 of file class.ilSurveyParticipantsGUI.php.

                                      : void
    {
        if ($this->edit_request->getReturnedFromMail() === 1) {
            $this->storeMailSent();
        }
 
        $ilTabs = $this->tabs;
        $ilToolbar = $this->toolbar;
        $ilAccess = $this->access;
        $ilTabs->activateTab("survey_360_edit_raters");
        $appr_id = $this->handleRatersAccess();
 
        $has_write = $ilAccess->checkAccess("write", "", $this->ref_id);
        if ($has_write) {
            $ilTabs->clearTargets();
            $ilTabs->setBackTarget(
                $this->lng->txt("btn_back"),
                $this->ctrl->getLinkTarget($this, "listAppraisees")
            );
        }
 
        $this->ctrl->setParameter($this, "appr_id", $appr_id);
        $this->ctrl->setParameter($this, "rate360", 1);
 
        $ilToolbar->addButton(
            $this->lng->txt("svy_add_rater"),
            $this->ctrl->getLinkTargetByClass("ilSurveyRaterGUI", "add")
        );
 
        // #13320
        $url = ilLink::_getStaticLink($this->object->getRefId());
 
        $tbl = new ilSurveyAppraiseesTableGUI($this, "editRaters", true, !$this->object->isAppraiseeClosed($appr_id), $url); // #11285
        $tbl->setData($this->object->getRatersData($appr_id));
        $this->tpl->setContent($tbl->getHTML());
    }

References $url, ilLink\_getStaticLink(), ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

Here is the call graph for this function:

executeCommand()

ilSurveyParticipantsGUI::executeCommand

(

)

Definition at line 113 of file class.ilSurveyParticipantsGUI.php.

                                    : void
    {
        $ilCtrl = $this->ctrl;
        $ilTabs = $this->tabs;
        $lng = $this->lng;
 
        $cmd = $ilCtrl->getCmd("maintenance");
        $next_class = $this->ctrl->getNextClass($this);
 
        switch ($next_class) {
            case 'ilrepositorysearchgui':
                $rep_search = new ilRepositorySearchGUI();
 
                if (!$this->edit_request->getAppr360() && !$this->edit_request->getRate360()) {
                    $ilTabs->clearTargets();
                    $ilTabs->setBackTarget(
                        $this->lng->txt("btn_back"),
                        $this->ctrl->getLinkTarget($this, "maintenance")
                    );
 
                    $rep_search->setCallback(
                        $this,
                        'inviteUsers',
                        array(
                            )
                    );
                    $rep_search->setTitle($lng->txt("svy_invite_participants"));
                    // Set tabs
                    $this->ctrl->setReturn($this, 'maintenance');
                    $this->ctrl->forwardCommand($rep_search);
                    $ilTabs->setTabActive('maintenance');
                } elseif ($this->edit_request->getRate360()) {
                    $ilTabs->clearTargets();
                    $ilTabs->setBackTarget(
                        $this->lng->txt("btn_back"),
                        $this->ctrl->getLinkTarget($this, "listAppraisees")
                    );
 
                    $this->ctrl->setParameter($this, "rate360", 1);
                    $this->ctrl->saveParameter($this, "appr_id");
 
                    $rep_search->setCallback(
                        $this,
                        'addRater',
                        array(
                            )
                    );
 
                    // Set tabs
                    $this->ctrl->setReturn($this, 'editRaters');
                    $this->ctrl->forwardCommand($rep_search);
                } else {
                    $ilTabs->activateTab("survey_360_appraisees");
                    $this->ctrl->setParameter($this, "appr360", 1);
 
                    $rep_search->setCallback(
                        $this,
                        'addAppraisee',
                        array(
                            )
                    );
 
                    // Set tabs
                    $this->ctrl->setReturn($this, 'listAppraisees');
                    $this->ctrl->forwardCommand($rep_search);
                }
                break;
 
            case 'ilsurveyratergui':
                $ilTabs->activateTab("survey_360_edit_raters");
                $rater_gui = new ilSurveyRaterGUI($this, $this->object);
                $this->ctrl->forwardCommand($rater_gui);
                break;
 
            default:
                $cmd .= "Object";
                $this->$cmd();
                break;
        }
    }

References $ctrl, $lng, $tabs, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ilLanguage\txt().

Here is the call graph for this function:

exportAllCodesObject()

ilSurveyParticipantsGUI::exportAllCodesObject

(

)

Exports all survey codes.

Definition at line 681 of file class.ilSurveyParticipantsGUI.php.

                                          : void
    {
        $export = $this->object->getSurveyCodesForExport();
        ilUtil::deliverData($export, ilFileUtils::getASCIIFilename($this->object->getTitle() . ".csv"));
    }

References ilUtil\deliverData(), ilFileUtils\getASCIIFilename(), and ILIAS\Repository\object().

Here is the call graph for this function:

exportCodesObject()

ilSurveyParticipantsGUI::exportCodesObject

(

)

Exports a list of survey codes.

Definition at line 666 of file class.ilSurveyParticipantsGUI.php.

                                       : void
    {
        $codes = $this->edit_request->getCodes();
        if (count($codes) > 0) {
            $export = $this->object->getSurveyCodesForExport(null, $codes);
            ilUtil::deliverData($export, ilFileUtils::getASCIIFilename($this->object->getTitle() . ".csv"));
        } else {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("no_checkbox"), true);
            $this->ctrl->redirect($this, 'codes');
        }
    }

References ILIAS\Repository\ctrl(), ilUtil\deliverData(), ilFileUtils\getASCIIFilename(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

Here is the call graph for this function:

filterSurveyParticipantsByAccess()

ilSurveyParticipantsGUI::filterSurveyParticipantsByAccess ( array  $a_finished_ids = null )

protected

Definition at line 194 of file class.ilSurveyParticipantsGUI.php.

     : array {
        $all_participants = $this->object->getSurveyParticipants($a_finished_ids, false, true);
        $participant_ids = [];
        foreach ($all_participants as $participant) {
            if (isset($participant['usr_id'])) {
                $participant_ids[] = $participant['usr_id'];
            }
        }
 
        $filtered_participant_ids = $this->access->filterUserIdsByRbacOrPositionOfCurrentUser(
            'read_results',
            'access_results',
            $this->object->getRefId(),
            $participant_ids
        );
 
        $participants = [];
        foreach ($all_participants as $username => $user_data) {
            if (!($user_data['usr_id'] ?? false)) {
                $participants[$username] = $user_data;
            }
            if (in_array(($user_data['usr_id'] ?? -1), $filtered_participant_ids)) {
                $participants[$username] = $user_data;
            }
        }
 
        return $participants;
    }

getObject()

ilSurveyParticipantsGUI::getObject

(

)

Definition at line 101 of file class.ilSurveyParticipantsGUI.php.

                               : ilObjSurvey
    {
        return $this->object;
    }

References $object.

handleRatersAccess()

ilSurveyParticipantsGUI::handleRatersAccess

(

)

Definition at line 1242 of file class.ilSurveyParticipantsGUI.php.

                                        : ?int
    {
        $ilAccess = $this->access;
        $ilUser = $this->user;
 
        if ($ilAccess->checkAccess("write", "", $this->ref_id)) {
            $appr_id = $this->edit_request->getAppraiseeId();
            if (!$appr_id) {
                $this->ctrl->redirect($this, "listAppraisees");
            }
            return $appr_id;
        } elseif ($this->feature_config->usesAppraisees() &&
            $this->object->get360SelfRaters() &&
            $this->object->isAppraisee($ilUser->getId()) &&
            !$this->object->isAppraiseeClosed($ilUser->getId())) {
            return $ilUser->getId();
        }
        $this->ctrl->redirect($this->parent_gui, "infoScreen");
        return null;
    }

References $ilUser, and ILIAS\Repository\ctrl().

Here is the call graph for this function:

handleWriteAccess()

ilSurveyParticipantsGUI::handleWriteAccess ( )

protected

Definition at line 106 of file class.ilSurveyParticipantsGUI.php.

                                          : void
    {
        if (!$this->has_write) {
            throw new ilSurveyException("Permission denied");
        }
    }

importAccessCodesActionObject()

ilSurveyParticipantsGUI::importAccessCodesActionObject ( )

protected

Import codes from export codes file.

Definition at line 722 of file class.ilSurveyParticipantsGUI.php.

                                                      : void
    {
        if (trim($_FILES['codes']['tmp_name'])) {
            $existing = array();
            foreach ($this->object->getSurveyCodesTableData() as $item) {
                $existing[$item["code"]] = $item["id"];
            }
 
            $reader = new ilCSVReader();
            $reader->open($_FILES['codes']['tmp_name']);
            foreach ($reader->getCsvAsArray() as $row) {
                // numeric check of used column due to #26176
                $code = $row[0] ?? "";
                if ($code === "") {
                    continue;
                }
                $email = $row[1] ?? "";
                if (!is_int(strpos($email, "@")) && $email !== "") {
                    continue;
                }
                $last_name = $row[2] ?? "";
                $first_name = $row[3] ?? "";
                $created = time();
 
                // unique code?
                if (!array_key_exists($code, $existing)) {
                    // could be date or datetime
                    /*try {
                        if (strlen($created) === 10) {
                            $created = new ilDate($created, IL_CAL_DATE);
                        } else {
                            $created = new ilDateTime($created, IL_CAL_DATETIME);
                        }
                        $created = $created->get(IL_CAL_UNIX);
                    } catch (Exception $e) {
                        $this->tpl->setOnScreenMessage('failure', $e->getMessage(), true);
                        $this->ctrl->redirect($this, 'codes');
                    }*/
 
                    $user_data = array(
                        "email" => $email
                        ,"lastname" => $last_name
                        ,"firstname" => $first_name
                    );
                    $this->object->importSurveyCode($code, $created, $user_data);
                }
            }
 
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('codes_created'), true);
        }
 
        $this->ctrl->redirect($this, 'codes');
    }

References ILIAS\LTI\ToolProvider\$created, $email, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

Here is the call graph for this function:

importAccessCodesObject()

ilSurveyParticipantsGUI::importAccessCodesObject ( )

protected

Import codes from export codes file (upload form)

Definition at line 690 of file class.ilSurveyParticipantsGUI.php.

                                                : void
    {
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("codes");
 
        $form_import_file = new ilPropertyFormGUI();
        $form_import_file->setFormAction($this->ctrl->getFormAction($this));
        $form_import_file->setTableWidth("100%");
        $form_import_file->setId("codes_import_file");
 
        $headerfile = new ilFormSectionHeaderGUI();
        $headerfile->setTitle($this->lng->txt("svy_import_codes"));
        $form_import_file->addItem($headerfile);
 
        $export_file = new ilFileInputGUI($this->lng->txt("codes"), "codes");
        $export_file->setInfo(sprintf(
            $this->lng->txt('svy_import_codes_info'),
            $this->lng->txt("export_all_survey_codes")
        ));
        $export_file->setSuffixes(array("csv"));
        $export_file->setRequired(true);
        $form_import_file->addItem($export_file);
 
        $form_import_file->addCommandButton("importAccessCodesAction", $this->lng->txt("import"));
        $form_import_file->addCommandButton("codes", $this->lng->txt("cancel"));
 
        $this->tpl->setContent($form_import_file->getHTML());
    }

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

Here is the call graph for this function:

importExternalMailRecipientsFromFileFormObject()

ilSurveyParticipantsGUI::importExternalMailRecipientsFromFileFormObject

(

)

Definition at line 1048 of file class.ilSurveyParticipantsGUI.php.

                                                                    : void
    {
        $ilAccess = $this->access;
 
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("mail_survey_codes");
 
        $form_import_file = new ilPropertyFormGUI();
        $form_import_file->setFormAction($this->ctrl->getFormAction($this));
        $form_import_file->setTableWidth("100%");
        $form_import_file->setId("codes_import_file");
 
        $headerfile = new ilFormSectionHeaderGUI();
        $headerfile->setTitle($this->lng->txt("import_from_file"));
        $form_import_file->addItem($headerfile);
 
        $externalmails = new ilFileInputGUI($this->lng->txt("externalmails"), "externalmails");
        $externalmails->setInfo($this->lng->txt('externalmails_info'));
        $externalmails->setRequired(true);
        $form_import_file->addItem($externalmails);
        if ($ilAccess->checkAccess("write", "", $this->edit_request->getRefId())) {
            $form_import_file->addCommandButton("importExternalRecipientsFromFile", $this->lng->txt("import"));
        }
        if ($ilAccess->checkAccess("write", "", $this->edit_request->getRefId())) {
            $form_import_file->addCommandButton("codes", $this->lng->txt("cancel"));
        }
 
        $this->tpl->setContent($form_import_file->getHTML());
    }

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

Here is the call graph for this function:

importExternalMailRecipientsFromTextFormObject()

ilSurveyParticipantsGUI::importExternalMailRecipientsFromTextFormObject

(

)

Definition at line 1078 of file class.ilSurveyParticipantsGUI.php.

                                                                    : void
    {
        $ilAccess = $this->access;
 
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("mail_survey_codes");
 
        $form_import_text = new ilPropertyFormGUI();
        $form_import_text->setFormAction($this->ctrl->getFormAction($this));
        $form_import_text->setTableWidth("100%");
        $form_import_text->setId("codes_import_text");
 
        $headertext = new ilFormSectionHeaderGUI();
        $headertext->setTitle($this->lng->txt("import_from_text"));
        $form_import_text->addItem($headertext);
 
        $inp = new ilTextAreaInputGUI($this->lng->txt('externaltext'), 'externaltext');
        $external_text = $this->edit_manager->getExternalText();
        if ($external_text !== "") {
            $inp->setValue($external_text);
        } else {
            // $this->lng->txt('mail_import_example1') #14897
            $inp->setValue("email;firstname;lastname\n" . $this->lng->txt('mail_import_example2') . "\n" . $this->lng->txt('mail_import_example3') . "\n");
        }
        $inp->setRequired(true);
        $inp->setCols(80);
        $inp->setRows(10);
        $inp->setInfo($this->lng->txt('externaltext_info'));
        $form_import_text->addItem($inp);
        $this->edit_manager->setExternalText("");
 
        if ($ilAccess->checkAccess("write", "", $this->edit_request->getRefId())) {
            $form_import_text->addCommandButton("importExternalRecipientsFromText", $this->lng->txt("import"));
        }
        if ($ilAccess->checkAccess("write", "", $this->edit_request->getRefId())) {
            $form_import_text->addCommandButton("codes", $this->lng->txt("cancel"));
        }
 
        $this->tpl->setContent($form_import_text->getHTML());
    }

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

Here is the call graph for this function:

importExternalRecipientsFromFileObject()

ilSurveyParticipantsGUI::importExternalRecipientsFromFileObject

(

)

Definition at line 988 of file class.ilSurveyParticipantsGUI.php.

                                                            : void
    {
        if (trim($_FILES['externalmails']['tmp_name'])) {
            $reader = new ilCSVReader();
            $reader->open($_FILES['externalmails']['tmp_name']);
            $data = $reader->getCsvAsArray();
            $fields = array_shift($data);
            foreach ($fields as $idx => $field) {
                $fields[$idx] = $this->removeUTF8Bom($field);
            }
            if (!in_array('email', $fields, true)) {
                $reader->close();
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt('err_external_rcp_no_email'), true);
                $this->ctrl->redirect($this, 'codes');
            }
            $existingdata = $this->object->getExternalCodeRecipients();
            $existingcolumns = array();
            if (count($existingdata)) {
                $first = array_shift($existingdata);
                foreach ($first as $key => $value) {
                    $existingcolumns[] = $key;
                }
            }
 
            $founddata = array();
            foreach ($data as $row) {
                if (count($row) === count($fields)) {
                    $dataset = array();
                    foreach ($fields as $idx => $fieldname) {
                        // #14811
                        $row[$idx] = $this->_convertCharset($row[$idx]);
 
                        if (count($existingcolumns)) {
                            if (array_key_exists($idx, $existingcolumns)) {
                                $dataset[$fieldname] = $row[$idx];
                            }
                        } else {
                            $dataset[$fieldname] = $row[$idx];
                        }
                    }
                    if ($dataset['email'] !== '') {
                        $founddata[] = $dataset;
                        $this->addCodeForExternal(
                            $dataset['email'],
                            $dataset['lastname'] ?? "",
                            $dataset['firstname'] ?? ""
                        );
                    }
                }
            }
            $reader->close();
 
            if (count($founddata)) {
                $this->tpl->setOnScreenMessage('success', $this->lng->txt('external_recipients_imported'), true);
            }
        }
 
        $this->ctrl->redirect($this, 'codes');
    }

References $data, ILIAS\LTI\ToolProvider\$key, ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

Here is the call graph for this function:

importExternalRecipientsFromTextObject()

ilSurveyParticipantsGUI::importExternalRecipientsFromTextObject

(

)

Definition at line 898 of file class.ilSurveyParticipantsGUI.php.

                                                            : void
    {
        if (trim($this->edit_request->getExternalText())) {
            $data = preg_split("/[\n\r]/", $this->edit_request->getExternalText());
            $fields = explode(";", array_shift($data));
            if (!in_array('email', $fields, true)) {
                $this->edit_manager->setExternalText($this->edit_request->getExternalText());
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt('err_external_rcp_no_email_column'), true);
                $this->ctrl->redirect($this, 'importExternalMailRecipientsFromTextForm');
            }
            $existingdata = $this->object->getExternalCodeRecipients();
            $existingcolumns = array();
            if (count($existingdata)) {
                $first = array_shift($existingdata);
                foreach ($first as $key => $value) {
                    $existingcolumns[] = $key;
                }
            }
            $founddata = array();
            foreach ($data as $datarow) {
                $row = explode(";", $datarow);
                if (count($row) === count($fields)) {
                    $dataset = array();
                    foreach ($fields as $idx => $fieldname) {
                        if (count($existingcolumns)) {
                            if (array_key_exists($idx, $existingcolumns)) {
                                $dataset[$fieldname] = $row[$idx];
                            }
                        } else {
                            $dataset[$fieldname] = $row[$idx];
                        }
                    }
                    if ($dataset['email'] !== '') {
                        $this->addCodeForExternal(
                            $dataset['email'],
                            $dataset['lastname'] ?? "",
                            $dataset['firstname'] ?? ""
                        );
                    }
                }
            }
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('external_recipients_imported'), true);
            $this->ctrl->redirect($this, 'codes');
        }
 
        $this->ctrl->redirect($this, 'importExternalMailRecipientsFromTextForm');
    }

References $data, ILIAS\LTI\ToolProvider\$key, ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

Here is the call graph for this function:

initExternalRaterForm()

ilSurveyParticipantsGUI::initExternalRaterForm ( int  $appr_id )

protected

Definition at line 1349 of file class.ilSurveyParticipantsGUI.php.

     : ilPropertyFormGUI {
        $form = new ilPropertyFormGUI();
        $form->setFormAction($this->ctrl->getFormAction($this, "addExternalRater"));
        $form->setTitle($this->lng->txt("survey_360_add_external_rater") .
            ": " . ilUserUtil::getNamePresentation($appr_id));
 
        $email = new ilEmailInputGUI($this->lng->txt("email"), "email");
        $email->setRequired(true);
        $form->addItem($email);
 
        $lname = new ilTextInputGUI($this->lng->txt("lastname"), "lname");
        $lname->setSize(30);
        $form->addItem($lname);
 
        $fname = new ilTextInputGUI($this->lng->txt("firstname"), "fname");
        $fname->setSize(30);
        $form->addItem($fname);
 
        $form->addCommandButton("addExternalRater", $this->lng->txt("save"));
        $form->addCommandButton("editRaters", $this->lng->txt("cancel"));
 
        return $form;
    }

initMailRatersForm()

ilSurveyParticipantsGUI::initMailRatersForm	(	int	$appr_id,
		array	$rec_ids
	)

Definition at line 1508 of file class.ilSurveyParticipantsGUI.php.

     : ilPropertyFormGUI {
        $form = new ilPropertyFormGUI();
        $form->setFormAction($this->ctrl->getFormAction($this, "mailRatersAction"));
        $form->setTitle($this->lng->txt('compose'));
 
        $all_data = $this->object->getRatersData($appr_id);
        $rec_data = array();
        foreach ($rec_ids as $rec_id) {
            if (isset($all_data[$rec_id])) {
                $rec_data[] = $all_data[$rec_id]["lastname"] . ", " .
                    $all_data[$rec_id]["firstname"] .
                    " (" . $all_data[$rec_id]["email"] . ")";
            }
        }
        sort($rec_data);
        $rec = new ilCustomInputGUI($this->lng->txt('recipients'));
        $rec->setHtml(implode("<br />", $rec_data));
        $form->addItem($rec);
 
        $subject = new ilTextInputGUI($this->lng->txt('subject'), 'subject');
        $subject->setSize(50);
        $subject->setRequired(true);
        $form->addItem($subject);
 
        $existingdata = $this->object->getExternalCodeRecipients();
        $existingcolumns = array();
        if (count($existingdata)) {
            $first = array_shift($existingdata);
            foreach ($first as $key => $value) {
                if (strcmp($key, 'code') !== 0 && strcmp($key, 'email') !== 0 && strcmp($key, 'sent') !== 0) {
                    $existingcolumns[] = '[' . $key . ']';
                }
            }
        }
 
        $mailmessage_u = new ilTextAreaInputGUI($this->lng->txt('survey_360_rater_message_content_registered'), 'message_u');
        $mailmessage_u->setRequired(true);
        $mailmessage_u->setCols(80);
        $mailmessage_u->setRows(10);
        $form->addItem($mailmessage_u);
 
        $mailmessage_a = new ilTextAreaInputGUI($this->lng->txt('survey_360_rater_message_content_anonymous'), 'message_a');
        $mailmessage_a->setRequired(true);
        $mailmessage_a->setCols(80);
        $mailmessage_a->setRows(10);
        $mailmessage_a->setInfo(sprintf($this->lng->txt('message_content_info'), implode(', ', $existingcolumns)));
        $form->addItem($mailmessage_a);
 
        $recf = new ilHiddenInputGUI("rater_id");
        $recf->setValue(implode(";", $rec_ids));
        $form->addItem($recf);
 
        $form->addCommandButton("mailRatersAction", $this->lng->txt("send"));
        $form->addCommandButton("editRaters", $this->lng->txt("cancel"));
 
        $subject->setValue(sprintf($this->lng->txt('survey_360_rater_subject_default'), $this->object->getTitle()));
        $mailmessage_u->setValue($this->lng->txt('survey_360_rater_message_content_registered_default'));
        $mailmessage_a->setValue($this->lng->txt('survey_360_rater_message_content_anonymous_default'));
 
        return $form;
    }

insertSavedMessageObject()

ilSurveyParticipantsGUI::insertSavedMessageObject

(

)

Definition at line 792 of file class.ilSurveyParticipantsGUI.php.

                                              : void
    {
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("codes");
 
        $form_gui = new FormMailCodesGUI($this);
        $form_gui->setValuesByPost();
        try {
            if ($form_gui->getSavedMessages()->getValue() > 0) {
                $ilUser = $this->user;
                $settings = $this->object->getUserSettings($ilUser->getId(), 'savemessage');
                $form_gui->getMailMessage()->setValue($settings[$form_gui->getSavedMessages()->getValue()]['value']);
                $this->tpl->setOnScreenMessage('success', $this->lng->txt('msg_message_inserted'));
            } else {
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt('msg_no_message_inserted'));
            }
        } catch (Exception $e) {
            $ilLog = $this->log;
            $ilLog->write('Error: ' . $e->getMessage());
        }
        $this->tpl->setVariable("ADM_CONTENT", $form_gui->getHTML());
    }

References Vendor\Package\$e, $ilUser, $log, ILIAS\LTI\ToolProvider\$settings, and ILIAS\Repository\lng().

Here is the call graph for this function:

inviteUsers()

ilSurveyParticipantsGUI::inviteUsers

(

array

$user_ids

)

Parameters

int[]

$user_ids

Exceptions

ilCtrlException

Definition at line 1842 of file class.ilSurveyParticipantsGUI.php.

                                                : void
    {
        $lng = $this->lng;
        $ctrl = $this->ctrl;
 
        foreach ($user_ids as $user_id) {
            $this->invitation_manager->add($this->object->getSurveyId(), $user_id);
        }
        $this->tpl->setOnScreenMessage('success', $lng->txt("svy_users_invited"), true);
        $ctrl->redirect($this, "maintenance");
    }

References $lng, ILIAS\Repository\object(), and ilCtrl\redirect().

Here is the call graph for this function:

isAnonymousListActive()

ilSurveyParticipantsGUI::isAnonymousListActive ( )

protected

Definition at line 300 of file class.ilSurveyParticipantsGUI.php.

                                              : bool
    {
        $surveySetting = new ilSetting("survey");
 
        if ($surveySetting->get("anonymous_participants", false) && $this->object->hasAnonymizedResults() &&
            $this->object->hasAnonymousUserList()) {
            $end = $this->object->getEndDate();
            if ($end && $end < date("YmdHis")) {
                $min = (int) $surveySetting->get("anonymous_participants_min", '0');
                $total = $this->object->getSurveyParticipants();
                if (!$min || count($total) >= $min) {
                    return true;
                }
            }
        }
        return false;
    }

References ILIAS\Repository\int().

Here is the call graph for this function:

listAppraiseesObject()

ilSurveyParticipantsGUI::listAppraiseesObject

(

)

Definition at line 1123 of file class.ilSurveyParticipantsGUI.php.

                                          : void
    {
        $ilToolbar = $this->toolbar;
        $lng = $this->lng;
        $ilCtrl = $this->ctrl;
 
        $this->handleWriteAccess();
 
        $this->ctrl->setParameter($this, "appr360", 1);
 
        ilRepositorySearchGUI::fillAutoCompleteToolbar(
            $this,
            $ilToolbar,
            array(
                'auto_complete_name' => $this->lng->txt('user'),
                'submit_name' => $this->lng->txt('add'),
                'add_search' => true,
                'add_from_container' => $this->ref_id
            )
        );
 
        // competence calculations
        $skmg_set = new ilSkillManagementSettings();
        if ($this->object->getSkillService() && $skmg_set->isActivated()) {
            $ilToolbar->addSeparator();
            $ilToolbar->addButton(
                $lng->txt("survey_calc_skills"),
                $ilCtrl->getLinkTargetByClass("ilsurveyskilldeterminationgui"),
                ""
            );
        }
 
        $ilToolbar->addSeparator();
        $ilToolbar->addButton(
            $this->lng->txt('svy_delete_all_user_data'),
            $this->ctrl->getLinkTarget($this, 'deleteAllUserData')
        );
 
        $this->ctrl->setParameter($this, "appr360", "");
 
        $tbl = new ilSurveyAppraiseesTableGUI($this, "listAppraisees");
        $tbl->setData($this->object->getAppraiseesData());
        $this->tpl->setContent($tbl->getHTML());
    }

References $lng, ILIAS\Repository\ctrl(), ilRepositorySearchGUI\fillAutoCompleteToolbar(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

Here is the call graph for this function:

listParticipantsObject()

ilSurveyParticipantsGUI::listParticipantsObject ( )

protected

Definition at line 1817 of file class.ilSurveyParticipantsGUI.php.

                                               : void
    {
        $ilToolbar = $this->toolbar;
 
        if (!$this->isAnonymousListActive()) {
            $this->ctrl->redirect($this, "maintenance");
        }
 
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("anon_participants");
 
        $button = ilLinkButton::getInstance();
        $button->setCaption("print");
        $button->setOnClick("window.print(); return false;");
        $button->setOmitPreventDoubleSubmission(true);
        $ilToolbar->addButtonInstance($button);
 
        $tbl = new ilSurveyParticipantsTableGUI($this, "listParticipants", $this->object);
        $this->tpl->setContent($tbl->getHTML());
    }

References ILIAS\Repository\ctrl(), and ilLinkButton\getInstance().

Here is the call graph for this function:

mailCodesObject()

ilSurveyParticipantsGUI::mailCodesObject

(

)

Definition at line 838 of file class.ilSurveyParticipantsGUI.php.

                                     : void
    {
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("mail_survey_codes");
 
        $mailData['m_subject'] =
            $this->edit_request->getCodeMailPart("subject")
            ?: sprintf($this->lng->txt('default_codes_mail_subject'), $this->object->getTitle());
        $mailData['m_message'] =
            $this->edit_request->getCodeMailPart("message")
                ?: $this->lng->txt('default_codes_mail_message');
        $mailData['m_notsent'] =
            $this->edit_request->getCodeMailPart("notsent")
                ?: '1';
 
        $form_gui = new FormMailCodesGUI($this);
        $form_gui->setValuesByArray($mailData);
        $this->tpl->setVariable("ADM_CONTENT", $form_gui->getHTML());
    }

References ILIAS\Repository\lng().

Here is the call graph for this function:

mailRatersActionObject()

ilSurveyParticipantsGUI::mailRatersActionObject

(

)

Definition at line 1651 of file class.ilSurveyParticipantsGUI.php.

                                            : void
    {
        $ilUser = $this->user;
        $appr_id = $this->handleRatersAccess();
        $this->ctrl->setParameter($this, "appr_id", $appr_id);
 
        $rec_ids = $this->edit_request->getRaterIds();
        if (count($rec_ids) === 0) {
            $this->ctrl->redirect($this, "editRaters");
        }
 
        $form = $this->initMailRatersForm($appr_id, $rec_ids);
        if ($form->checkInput()) {
            $txt_u = $form->getInput("message_u");
            $txt_a = $form->getInput("message_a");
            $subj = $form->getInput("subject");
 
            // #12743
            $sender_id = (trim($ilUser->getEmail()))
                ? $ilUser->getId()
                : ANONYMOUS_USER_ID;
 
            $all_data = $this->object->getRatersData($appr_id);
            foreach ($rec_ids as $rec_id) {
                if (isset($all_data[$rec_id])) {
                    $user = $all_data[$rec_id];
 
                    // anonymous
                    if (strpos($rec_id, "a") === 0) {
                        $mytxt = $txt_a;
                        $url = $user["href"];
                        $rcp = $user["email"];
                    }
                    // reg
                    else {
                        $mytxt = $txt_u;
                        $user["code"] = $this->lng->txt("survey_code_mail_on_demand");
                        $url = ilLink::_getStaticLink($this->object->getRefId());
                        $rcp = $user["login"]; // #15141
                    }
 
                    $mytxt = str_replace(
                        ["[lastname]", "[firstname]", "[url]", "[code]"],
                        [$user["lastname"], $user["firstname"], $url, $user["code"]],
                        $mytxt
                    );
 
                    $mail = new ilMail($sender_id);
                    $mail->enqueue(
                        $rcp, // to
                        "", // cc
                        "", // bcc
                        $subj, // subject
                        $mytxt, // message
                        array() // attachments
                    );
 
                    $this->object->set360RaterSent(
                        $appr_id,
                        (strpos($rec_id, "a") === 0) ? 0 : (int) substr($rec_id, 1),
                        (strpos($rec_id, "u") === 0) ? 0 : (int) substr($rec_id, 1)
                    );
                }
            }
 
            $this->tpl->setOnScreenMessage('success', $this->lng->txt("mail_sent"), true);
            $this->ctrl->redirect($this, "editRaters");
        }
 
        $form->setValuesByPost();
        $this->mailRatersObject();
    }

References $ilUser, $url, ilLink\_getStaticLink(), ANONYMOUS_USER_ID, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

Here is the call graph for this function:

mailRatersObject()

ilSurveyParticipantsGUI::mailRatersObject

(

)

Definition at line 1573 of file class.ilSurveyParticipantsGUI.php.

                                      : void
    {
        $appr_id = $this->handleRatersAccess();
        $all_data = $this->object->getRatersData($appr_id);
        $this->ctrl->setParameter($this, "appr_id", $appr_id);
 
        $raters = $this->edit_request->getRaterIds();
 
        $rec = [];
        $external_rater = false;
        $rater_id = "";
        foreach ($raters as $id) {
            if (isset($all_data[$id])) {
                if ($all_data[$id]["login"] != "") {
                    $rec[] = $all_data[$id]["login"];
                } elseif ($all_data[$id]["email"] != "") {
                    $rec[] = $all_data[$id]["email"];
                    $external_rater = true;
                    $rater_id = $all_data[$id]["user_id"];
                }
            }
        }
        if ($external_rater && count($rec) > 1) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("svy_only_max_one_external_rater"), true);
            $this->ctrl->redirect($this, "editRaters");
        }
 
        // $_POST["rtr_id"]
        ilMailFormCall::setRecipients($rec);
 
        $contextParameters = [
            'ref_id' => $this->object->getRefId(),
            'ts' => time(),
            'appr_id' => $appr_id,
            'rater_id' => $rater_id,
            ilMailFormCall::CONTEXT_KEY => "svy_rater_inv"
        ];
 
        $this->ctrl->redirectToURL(ilMailFormCall::getRedirectTarget(
            $this,
            'editRaters',
            [
                'recipients' => base64_encode(json_encode($rec, JSON_THROW_ON_ERROR)),
            ],
            [
                'type' => 'new',
                'sig' => rawurlencode(base64_encode("\n\n" . $this->lng->txt("svy_link_to_svy") . ": [SURVEY_LINK]"))
            ],
            $contextParameters
        ));
    }

References $id, ilMailFormCall\CONTEXT_KEY, ILIAS\Repository\ctrl(), ilMailFormCall\getRedirectTarget(), ILIAS\Repository\lng(), and ilMailFormCall\setRecipients().

Here is the call graph for this function:

mailRatersObjectOld()

ilSurveyParticipantsGUI::mailRatersObjectOld

(

ilPropertyFormGUI

$a_form = null

)

Definition at line 1625 of file class.ilSurveyParticipantsGUI.php.

     : void {
        $ilTabs = $this->tabs;
        $rater_ids = $this->edit_request->getRaterIds();
        if (!$a_form) {
            $appr_id = $this->handleRatersAccess();
            $this->ctrl->setParameter($this, "appr_id", $appr_id);
 
            if (count($rater_ids) === 0) {
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt("select_one"), true);
                $this->ctrl->redirect($this, "editRaters");
            }
 
            $a_form = $this->initMailRatersForm($appr_id, $rater_ids);
        }
 
        $ilTabs->clearTargets();
        $ilTabs->setBackTarget(
            $this->lng->txt("btn_back"),
            $this->ctrl->getLinkTarget($this, "editRaters")
        );
 
        $this->tpl->setContent($a_form->getHTML());
    }

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

Here is the call graph for this function:

maintenanceObject()

ilSurveyParticipantsGUI::maintenanceObject

(

)

Participants maintenance.

Definition at line 229 of file class.ilSurveyParticipantsGUI.php.

                                       : void
    {
        $ilToolbar = $this->toolbar;
 
        if ($this->object->get360Mode()) {
            $this->listAppraiseesObject();
            return;
        }
 
        //Btn Determine Competence Levels
        if ($this->object->getMode() === ilObjSurvey::MODE_SELF_EVAL) {
            $skmg_set = new ilSkillManagementSettings();
            if ($this->object->getSkillService() && $skmg_set->isActivated()) {
                $ilToolbar->addButton(
                    $this->lng->txt("survey_calc_skills"),
                    $this->ctrl->getLinkTargetByClass("ilsurveyskilldeterminationgui"),
                    ""
                );
            }
        }
 
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("overview");
 
        $ilToolbar->addButton(
            $this->lng->txt('svy_remove_all_participants'),
            $this->ctrl->getLinkTarget($this, 'deleteAllUserData')
        );
 
        $ilToolbar->addSeparator();
 
        if ($this->object->isAccessibleWithoutCode()) {
            $ilToolbar->addButton(
                $this->lng->txt("svy_invite_participants"),
                $this->ctrl->getLinkTargetByClass('ilRepositorySearchGUI', '')
            );
        }
 
        $table_gui = new ilSurveyMaintenanceTableGUI($this, 'maintenance');
 
        $total = $this->filterSurveyParticipantsByAccess();
        $data = array();
        foreach ($total as $user_data) {
            $finished = false;
            if ($user_data["finished"]) {
                $finished = $user_data["finished_tstamp"];
            }
            if (isset($user_data["active_id"])) {
                $wt = $this->object->getWorkingtimeForParticipant($user_data["active_id"]);
                $last_access = $this->object->getLastAccess($user_data["active_id"]);
                $active_id = $user_data["active_id"];
            } else {
                $wt = 0;
                $last_access = null;
                $active_id = 0;
            }
            $data[] = array(
                'id' => $active_id,
                'name' => $user_data["sortname"],
                'usr_id' => $user_data["usr_id"] ?? null,
                'login' => $user_data["login"],
                'last_access' => $last_access,
                'workingtime' => $wt,
                'finished' => $finished,
                'invited' => $user_data["invited"] ?? false
            );
        }
        $table_gui->setData($data);
        $this->tpl->setVariable('ADM_CONTENT', $table_gui->getHTML());
    }

References $data, ILIAS\Repository\lng(), ilObjSurvey\MODE_SELF_EVAL, and ILIAS\Repository\object().

Here is the call graph for this function:

removeUTF8Bom()

ilSurveyParticipantsGUI::removeUTF8Bom ( string  $a_text )

protected

Definition at line 982 of file class.ilSurveyParticipantsGUI.php.

                                                    : string
    {
        $bom = pack('H*', 'EFBBBF');
        return preg_replace('/^' . $bom . '/', '', $a_text);
    }

sendCodesMailObject()

ilSurveyParticipantsGUI::sendCodesMailObject

(

)

Definition at line 858 of file class.ilSurveyParticipantsGUI.php.

                                         : void
    {
        $ilUser = $this->user;
 
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("mail_survey_codes");
 
        $form_gui = new FormMailCodesGUI($this);
        if ($form_gui->checkInput()) {
            $url_exists = strpos($this->edit_request->getCodeMailPart("message"), '[url]') !== false;
            if (!$url_exists) {
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt('please_enter_mail_url'));
                $form_gui->setValuesByPost();
            } else {
                if ($this->edit_request->getSaveMessage() === 1) {
                    $ilUser = $this->user;
                    $title = ($this->edit_request->getSaveMessageTitle())
                        ?: ilStr::subStr($this->edit_request->getCodeMailPart("message"), 0, 40) . '...';
                    $this->object->saveUserSettings($ilUser->getId(), 'savemessage', $title, $this->edit_request->getCodeMailPart("message"));
                }
 
                $lang = $ilUser->getPref("survey_code_language");
                if (!$lang) {
                    $lang = $this->lng->getDefaultLanguage();
                }
                $this->object->sendCodes(
                    $this->edit_request->getCodeMailPart("notsent"),
                    $this->edit_request->getCodeMailPart("subject"),
                    nl2br($this->edit_request->getCodeMailPart("message")),
                    $lang
                );
                $this->tpl->setOnScreenMessage('success', $this->lng->txt('mail_sent'), true);
                $this->ctrl->redirect($this, 'mailCodes');
            }
        } else {
            $form_gui->setValuesByPost();
        }
        $this->tpl->setVariable("ADM_CONTENT", $form_gui->getHTML());
    }

References $ilUser, $lang, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ilStr\subStr().

Here is the call graph for this function:

setCodeLanguageObject()

ilSurveyParticipantsGUI::setCodeLanguageObject

(

)

Change survey language for direct access URL's.

Definition at line 477 of file class.ilSurveyParticipantsGUI.php.

                                           : void
    {
        if (strcmp($this->edit_request->getLang(), "-1") !== 0) {
            $ilUser = $this->user;
            $ilUser->writePref("survey_code_language", $this->edit_request->getLang());
        }
        $this->tpl->setOnScreenMessage('success', $this->lng->txt('language_changed'), true);
        $this->ctrl->redirect($this, 'codes');
    }

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

Here is the call graph for this function:

setParticipantSubTabs()

ilSurveyParticipantsGUI::setParticipantSubTabs ( string  $active )

protected

Definition at line 318 of file class.ilSurveyParticipantsGUI.php.

     : void {
        $ilTabs = $this->tabs;
 
        // not used in 360° mode
 
        // overview
        $ilTabs->addSubTab(
            "overview",
            $this->lng->txt("svy_part_overview"),
            $this->ctrl->getLinkTarget($this, 'maintenance')
        );
 
        if ($this->isAnonymousListActive()) {
            $ilTabs->addSubTab(
                "anon_participants",
                $this->lng->txt("svy_anonymous_participants_svy"),
                $this->ctrl->getLinkTarget($this, 'listParticipants')
            );
        }
 
        if (!$this->object->isAccessibleWithoutCode()) {
            $ilTabs->addSubTab(
                "codes",
                $this->lng->txt("svy_codes"),
                $this->ctrl->getLinkTarget($this, 'codes')
            );
        }
 
 
        $data = $this->object->getExternalCodeRecipients();
        if (count($data)) {
            $ilTabs->addSubTab(
                "mail_survey_codes",
                $this->lng->txt("mail_survey_codes"),
                $this->ctrl->getLinkTarget($this, "mailCodes")
            );
        }
 
        $ilTabs->activateSubTab($active);
    }

References ILIAS\Repository\lng().

Here is the call graph for this function:

storeMailSent()

ilSurveyParticipantsGUI::storeMailSent ( )

protected

Definition at line 1263 of file class.ilSurveyParticipantsGUI.php.

                                      : void
    {
        $appr_id = $this->handleRatersAccess();
        $all_data = $this->object->getRatersData($appr_id);
 
        $recs = json_decode(base64_decode($this->edit_request->getRecipients()));
        foreach ($all_data as $rec_id => $rater) {
            $sent = false;
            if (($rater["login"] != "" && in_array($rater["login"], $recs, true)) ||
                ($rater["email"] != "" && in_array($rater["email"], $recs, true))) {
                $sent = true;
            }
            if ($sent) {
                $this->object->set360RaterSent(
                    $appr_id,
                    strpos($rec_id, "a") === 0 ? 0 : (int) substr($rec_id, 1),
                    strpos($rec_id, "u") === 0 ? 0 : (int) substr($rec_id, 1)
                );
            }
        }
        $this->ctrl->setParameter($this, "appr_id", $appr_id);
        $this->ctrl->redirect($this, "editRaters");
    }

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

updateCodesObject()

ilSurveyParticipantsGUI::updateCodesObject

(

)

Definition at line 577 of file class.ilSurveyParticipantsGUI.php.

                                       : void
    {
        $codes = $this->edit_request->getCodes();
        $mails = $this->edit_request->getCodesPar("mail");
        $lnames = $this->edit_request->getCodesPar("lname");
        $fnames = $this->edit_request->getCodesPar("fname");
        $sents = $this->edit_request->getCodesPar("sent");
        if (count($codes) === 0) {
            $this->ctrl->redirect($this, 'codes');
        }
 
        $errors = array();
        $error_message = "";
        foreach ($codes as $id) {
            if (!$this->object->updateCode(
                $id,
                $mails[$id] ?? "",
                $lnames[$id] ?? "",
                $fnames[$id] ?? "",
                $sents[$id] ?? 0
            )) {
                $errors[] = array($mails[$id], $lnames[$id], $fnames[$id]);
            }
        }
        if (empty($errors)) {
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('settings_saved'), true);
        } else {
            foreach ($errors as $error) {
                $error_message .= sprintf($this->lng->txt("error_save_code"), $error[0], $error[1], $error[2]);
            }
            $this->tpl->setOnScreenMessage('failure', $error_message, true);
        }
 
        $this->ctrl->redirect($this, 'codes');
    }

References $errors, $id, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

Here is the call graph for this function:

Field Documentation

$access

ilAccessHandler ilSurveyParticipantsGUI::$access

protected

Definition at line 36 of file class.ilSurveyParticipantsGUI.php.

$code_manager

ILIAS Survey Code CodeManager ilSurveyParticipantsGUI::$code_manager

protected

Definition at line 46 of file class.ilSurveyParticipantsGUI.php.

$ctrl

ilCtrl ilSurveyParticipantsGUI::$ctrl

protected

Definition at line 31 of file class.ilSurveyParticipantsGUI.php.

Referenced by executeCommand().

$data_manager

ILIAS Survey InternalDataService ilSurveyParticipantsGUI::$data_manager

protected

Definition at line 47 of file class.ilSurveyParticipantsGUI.php.

$edit_manager

ILIAS Survey Editing EditManager ilSurveyParticipantsGUI::$edit_manager

protected

Definition at line 30 of file class.ilSurveyParticipantsGUI.php.

$edit_request

ILIAS Survey Editing EditingGUIRequest ilSurveyParticipantsGUI::$edit_request

protected

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

$feature_config

ILIAS Survey Mode FeatureConfig ilSurveyParticipantsGUI::$feature_config

protected

Definition at line 28 of file class.ilSurveyParticipantsGUI.php.

$has_write

bool ilSurveyParticipantsGUI::$has_write

protected

Definition at line 43 of file class.ilSurveyParticipantsGUI.php.

$invitation_manager

Participants InvitationsManager ilSurveyParticipantsGUI::$invitation_manager

protected

Definition at line 44 of file class.ilSurveyParticipantsGUI.php.

$lng

ilLanguage ilSurveyParticipantsGUI::$lng

protected

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

Referenced by executeCommand().

$log

ilLogger ilSurveyParticipantsGUI::$log

protected

Definition at line 39 of file class.ilSurveyParticipantsGUI.php.

$object

ilObjSurvey ilSurveyParticipantsGUI::$object

protected

Definition at line 41 of file class.ilSurveyParticipantsGUI.php.

Referenced by getObject().

$parent_gui

ilObjSurveyGUI ilSurveyParticipantsGUI::$parent_gui

protected

Definition at line 40 of file class.ilSurveyParticipantsGUI.php.

$rbacsystem

ilRbacSystem ilSurveyParticipantsGUI::$rbacsystem

protected

Definition at line 37 of file class.ilSurveyParticipantsGUI.php.

$ref_id

int ilSurveyParticipantsGUI::$ref_id

protected

Definition at line 42 of file class.ilSurveyParticipantsGUI.php.

$survey_service

ILIAS Survey InternalService ilSurveyParticipantsGUI::$survey_service

protected

Definition at line 45 of file class.ilSurveyParticipantsGUI.php.

$tabs

ilTabsGUI ilSurveyParticipantsGUI::$tabs

protected

Definition at line 34 of file class.ilSurveyParticipantsGUI.php.

Referenced by executeCommand().

$toolbar

ilToolbarGUI ilSurveyParticipantsGUI::$toolbar

protected

Definition at line 35 of file class.ilSurveyParticipantsGUI.php.

$tpl

ilGlobalTemplateInterface ilSurveyParticipantsGUI::$tpl

protected

Definition at line 33 of file class.ilSurveyParticipantsGUI.php.

$user

ilObjUser ilSurveyParticipantsGUI::$user

protected

Definition at line 38 of file class.ilSurveyParticipantsGUI.php.

---

The documentation for this class was generated from the following file:

• Modules/Survey/Participants/class.ilSurveyParticipantsGUI.php