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...
	getAccessCodeImportForm ()
	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 ()
	getImportExternalMailRecipientsFromFileForm ()
	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 InternalGUIService	$gui
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 27 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 979 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 1196 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 $user_id, and 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 964 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 1352 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 1403 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 1431 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 1524 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, "run");
    }

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

Here is the call graph for this function:

adminAppraiseesCloseObject()

ilSurveyParticipantsGUI::adminAppraiseesCloseObject

(

)

Definition at line 1822 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 1782 of file class.ilSurveyParticipantsGUI.php.

                                          : void
    {
        $ilUser = $this->user;
 
        if (!$this->object->isAppraisee($ilUser->getId())) {
            $this->ctrl->redirect($this->parent_gui, "run");
        }
 
        $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, "run");
    }

References 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 404 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 435 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 493 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);
 
        $this->gui->button(
            $this->lng->txt("create"),
            "createSurveyCodes"
        )->submit()->toToolbar();
 
        $ilToolbar->addSeparator();
 
        $this->gui->button(
            $this->lng->txt("import_from_file"),
            "importExternalMailRecipientsFromFileForm"
        )->submit()->toToolbar();
 
        $this->gui->button(
            $this->lng->txt("import_from_text"),
            "importExternalMailRecipientsFromTextForm"
        )->submit()->toToolbar();
 
        $ilToolbar->addSeparator();
 
        $this->gui->button(
            $this->lng->txt("svy_import_codes"),
            "importAccessCodes"
        )->submit()->toToolbar();
 
        $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);
 
        $this->gui->button(
            $this->lng->txt("set"),
            "setCodeLanguage"
        )->submit()->toToolbar();
 
 
        $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 $lang, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

Here is the call graph for this function:

confirmAdminAppraiseesCloseObject()

ilSurveyParticipantsGUI::confirmAdminAppraiseesCloseObject

(

)

Definition at line 1795 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 ILIAS\Repository\ctrl(), ilUserUtil\getNamePresentation(), ILIAS\Repository\lng(), and ILIAS\UICore\GlobalTemplate\setContent().

Here is the call graph for this function:

confirmAppraiseeCloseCancelObject()

ilSurveyParticipantsGUI::confirmAppraiseeCloseCancelObject

(

)

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

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

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

confirmAppraiseeCloseObject()

ilSurveyParticipantsGUI::confirmAppraiseeCloseObject

(

)

Definition at line 1751 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, "run")
        );
 
        if (!$this->object->isAppraisee($ilUser->getId())) {
            $this->ctrl->redirect($this->parent_gui, "run");
        }
 
        $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 ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and ILIAS\UICore\GlobalTemplate\setContent().

Here is the call graph for this function:

confirmDeleteAllUserDataObject()

ilSurveyParticipantsGUI::confirmDeleteAllUserDataObject

(

)

Deletes all user data of the survey after confirmation.

Definition at line 381 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 1210 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 1459 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 412 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 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 794 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 368 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 1251 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 617 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 653 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 1499 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 830 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 444 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 565 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 1315 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 116 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 685 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 670 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 197 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;
    }

getAccessCodeImportForm()

ilSurveyParticipantsGUI::getAccessCodeImportForm

(

)

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

                                             : ilPropertyFormGUI
    {
        $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"));
 
        return $form_import_file;
    }

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

Here is the call graph for this function:

getImportExternalMailRecipientsFromFileForm()

ilSurveyParticipantsGUI::getImportExternalMailRecipientsFromFileForm

(

)

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

                                                                 : ilPropertyFormGUI
    {
        $ilAccess = $this->access;
 
        $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"));
        }
        return $form_import_file;
    }

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

Here is the call graph for this function:

getObject()

ilSurveyParticipantsGUI::getObject

(

)

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

                               : ilObjSurvey
    {
        return $this->object;
    }

References $object.

handleRatersAccess()

ilSurveyParticipantsGUI::handleRatersAccess

(

)

Definition at line 1270 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 ILIAS\Repository\ctrl().

Here is the call graph for this function:

handleWriteAccess()

ilSurveyParticipantsGUI::handleWriteAccess ( )

protected

Definition at line 109 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 731 of file class.ilSurveyParticipantsGUI.php.

                                                      : void
    {
        $form = $this->getAccessCodeImportForm();
 
        if ($form->checkInput()) {
            $existing = array();
            foreach ($this->object->getSurveyCodesTableData() as $item) {
                $existing[$item["code"]] = $item["id"];
            }
 
            $reader = new CSVReader();
            $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');
        } else {
            $form->setValuesByPost();
            $this->handleWriteAccess();
            $this->setParticipantSubTabs("codes");
            $this->tpl->setContent($form->getHTML());
        }
    }

References 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 694 of file class.ilSurveyParticipantsGUI.php.

                                                : void
    {
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("codes");
        $form_import_file = $this->getAccessCodeImportForm();
        $this->tpl->setContent($form_import_file->getHTML());
    }

importExternalMailRecipientsFromFileFormObject()

ilSurveyParticipantsGUI::importExternalMailRecipientsFromFileFormObject

(

)

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

                                                                    : void
    {
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("codes");
        $form = $this->getImportExternalMailRecipientsFromFileForm();
        $this->tpl->setContent($form->getHTML());
    }

importExternalMailRecipientsFromTextFormObject()

ilSurveyParticipantsGUI::importExternalMailRecipientsFromTextFormObject

(

)

Definition at line 1106 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 1003 of file class.ilSurveyParticipantsGUI.php.

                                                            : void
    {
        $this->handleWriteAccess();
        $form = $this->getImportExternalMailRecipientsFromFileForm();
 
        if (!$form->checkInput()) {
            $this->setParticipantSubTabs("codes");
            $this->tpl->setContent($form->getHTML());
            return;
        }
 
        if (trim($_FILES['externalmails']['tmp_name'])) {
            $reader = new CSVReader();
            $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\Repository\ctrl(), and ILIAS\Repository\lng().

Here is the call graph for this function:

importExternalRecipientsFromTextObject()

ilSurveyParticipantsGUI::importExternalRecipientsFromTextObject

(

)

Definition at line 913 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\Repository\ctrl(), and ILIAS\Repository\lng().

Here is the call graph for this function:

initExternalRaterForm()

ilSurveyParticipantsGUI::initExternalRaterForm ( int  $appr_id )

protected

Definition at line 1377 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 1536 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 807 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, $log, 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 1868 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, $user_id, ILIAS\Repository\object(), and ilCtrl\redirect().

Here is the call graph for this function:

isAnonymousListActive()

ilSurveyParticipantsGUI::isAnonymousListActive ( )

protected

Definition at line 303 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 1151 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 1844 of file class.ilSurveyParticipantsGUI.php.

                                               : void
    {
        $ilToolbar = $this->toolbar;
 
        if (!$this->isAnonymousListActive()) {
            $this->ctrl->redirect($this, "maintenance");
        }
 
        $this->handleWriteAccess();
        $this->setParticipantSubTabs("anon_participants");
 
        $this->gui->button(
            $this->lng->txt("print"),
            "#"
        )->onClick("window.print(); return false;")->toToolbar();
 
        $tbl = new ilSurveyParticipantsTableGUI($this, "listParticipants", $this->object);
        $this->tpl->setContent($tbl->getHTML());
    }

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

Here is the call graph for this function:

mailCodesObject()

ilSurveyParticipantsGUI::mailCodesObject

(

)

Definition at line 853 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 1678 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 $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 1601 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");
        }
 
        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 1652 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 232 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 997 of file class.ilSurveyParticipantsGUI.php.

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

sendCodesMailObject()

ilSurveyParticipantsGUI::sendCodesMailObject

(

)

Definition at line 873 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 $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 480 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 ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

Here is the call graph for this function:

setParticipantSubTabs()

ilSurveyParticipantsGUI::setParticipantSubTabs ( string  $active )

protected

Definition at line 321 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 1291 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 581 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 $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 38 of file class.ilSurveyParticipantsGUI.php.

$code_manager

ILIAS Survey Code CodeManager ilSurveyParticipantsGUI::$code_manager

protected

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

$ctrl

ilCtrl ilSurveyParticipantsGUI::$ctrl

protected

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

Referenced by executeCommand().

$data_manager

ILIAS Survey InternalDataService ilSurveyParticipantsGUI::$data_manager

protected

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

$edit_manager

ILIAS Survey Editing EditManager ilSurveyParticipantsGUI::$edit_manager

protected

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

$edit_request

ILIAS Survey Editing EditingGUIRequest ilSurveyParticipantsGUI::$edit_request

protected

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

$feature_config

ILIAS Survey Mode FeatureConfig ilSurveyParticipantsGUI::$feature_config

protected

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

$gui

ILIAS Survey InternalGUIService ilSurveyParticipantsGUI::$gui

protected

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

$has_write

bool ilSurveyParticipantsGUI::$has_write

protected

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

$invitation_manager

Participants InvitationsManager ilSurveyParticipantsGUI::$invitation_manager

protected

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

$lng

ilLanguage ilSurveyParticipantsGUI::$lng

protected

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

Referenced by executeCommand().

$log

ilLogger ilSurveyParticipantsGUI::$log

protected

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

$object

ilObjSurvey ilSurveyParticipantsGUI::$object

protected

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

Referenced by getObject().

$parent_gui

ilObjSurveyGUI ilSurveyParticipantsGUI::$parent_gui

protected

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

$rbacsystem

ilRbacSystem ilSurveyParticipantsGUI::$rbacsystem

protected

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

$ref_id

int ilSurveyParticipantsGUI::$ref_id

protected

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

$survey_service

ILIAS Survey InternalService ilSurveyParticipantsGUI::$survey_service

protected

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

$tabs

ilTabsGUI ilSurveyParticipantsGUI::$tabs

protected

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

Referenced by executeCommand().

$toolbar

ilToolbarGUI ilSurveyParticipantsGUI::$toolbar

protected

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

$tpl

ilGlobalTemplateInterface ilSurveyParticipantsGUI::$tpl

protected

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

$user

ilObjUser ilSurveyParticipantsGUI::$user

protected

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

---

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

• components/ILIAS/Survey/Participants/class.ilSurveyParticipantsGUI.php