ilSurveyParticipantsGUI Class Reference

Class ilSurveyParticipantsGUI. More...

Collaboration diagram for ilSurveyParticipantsGUI:

Public Member Functions
	__construct (ilObjSurveyGUI $a_parent_gui, $a_has_write_access)
	executeCommand ()
	maintenanceObject ()
	Participants maintenance. More...
	setCodesSubtabs ()
	Set the tabs for the access codes section. More...
	disinviteUserGroupObject ()
	Disinvite users or groups from a survey. More...
	inviteUserGroupObject ($a_user_ids=array())
	Invite users or groups to a survey. More...
	saveInvitationStatusObject ()
	Saves the status of the invitation tab. More...
	inviteObject ()
	Creates the output for user/group invitation to a survey. 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 for the test object. More...
	deleteSingleUserResultsObject ()
	Asks for a confirmation to delete selected user data of the test object. 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 ()
	importExternalRecipientsFromFileObject ()
	importExternalMailRecipientsFromFileFormObject ()
	importExternalMailRecipientsFromTextFormObject ()
	listAppraiseesObject ()
	addAppraisee ($a_user_ids)
	confirmDeleteAppraiseesObject ()
	deleteAppraiseesObject ()
	handleRatersAccess ()
	editRatersObject ()
	addExternalRaterFormObject (ilPropertyFormGUI $a_form=null)
	addExternalRaterObject ()
	addRater ($a_user_ids)
	confirmDeleteRatersObject ()
	deleteRatersObject ()
	addSelfAppraiseeObject ()
	initMailRatersForm ($appr_id, array $rec_ids)
	mailRatersObject (ilPropertyFormGUI $a_form=null)
	mailRatersActionObject ()
	confirmAppraiseeCloseObject ()
	confirmAppraiseeCloseCancelObject ()
	appraiseeCloseObject ()
	confirmAdminAppraiseesCloseObject ()
	adminAppraiseesCloseObject ()
	getObject ()

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

Protected Attributes
	$ctrl
	$lng
	$tpl
	$tabs
	$toolbar
	$access
	$rbacsystem
	$user
	$log
	$parent_gui
	$object
	$ref_id
	$has_write

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

Version

Id

class.ilObjSurveyGUI.php 43670 2013-07-26 08:41:31Z jluetzen

@ilCtrl_Calls ilSurveyParticipantsGUI: ilRepositorySearchGUI

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

Constructor & Destructor Documentation

__construct()

ilSurveyParticipantsGUI::__construct	(	ilObjSurveyGUI	$a_parent_gui,
			$a_has_write_access
	)

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

    {
        global $DIC;
 
        $this->tabs = $DIC->tabs();
        $this->toolbar = $DIC->toolbar();
        $this->access = $DIC->access();
        $this->rbacsystem = $DIC->rbac()->system();
        $this->user = $DIC->user();
        $this->log = $DIC["ilLog"];
        $ilCtrl = $DIC->ctrl();
        $lng = $DIC->language();
        $tpl = $DIC["tpl"];
        
        $this->parent_gui = $a_parent_gui;
        $this->object = $this->parent_gui->object;
        $this->ref_id = $this->object->getRefId();
        $this->has_write = (bool) $a_has_write_access;
        
        $this->ctrl = $ilCtrl;
        $this->lng = $lng;
        $this->tpl = $tpl;
    }

References $DIC, $ilCtrl, $lng, $tpl, and user().

Here is the call graph for this function:

Member Function Documentation

_convertCharset()

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

protected

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

    {
        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;
    }

Referenced by importExternalRecipientsFromFileObject().

Here is the caller graph for this function:

addAppraisee()

ilSurveyParticipantsGUI::addAppraisee

(

$a_user_ids

)

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

    {
        if (sizeof($a_user_ids)) {
            // #13319
            foreach (array_unique($a_user_ids) as $user_id) {
                $this->object->addAppraisee($user_id);
            }
 
            ilUtil::sendSuccess($this->lng->txt("settings_saved"), true);
        }
        $this->ctrl->redirect($this, "listAppraisees");
    }

addExternalRaterFormObject()

ilSurveyParticipantsGUI::addExternalRaterFormObject

(

ilPropertyFormGUI

$a_form = null

)

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

    {
        $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());
    }

References $access, $has_write, $tabs, handleRatersAccess(), and initExternalRaterForm().

Referenced by addExternalRaterObject().

Here is the call graph for this function:

Here is the caller graph for this function:

addExternalRaterObject()

ilSurveyParticipantsGUI::addExternalRaterObject

(

)

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

    {
        $appr_id = $_REQUEST["appr_id"];
        if (!$appr_id) {
            $this->ctrl->redirect($this, "listAppraisees");
        }
        
        $this->ctrl->setParameter($this, "appr_id", $appr_id);
        
        $form = $this->initExternalRaterForm($appr_id);
        if ($form->checkInput()) {
            $data = array(
                "email" => $form->getInput("email"),
                "lastname" => $form->getInput("lname"),
                "firstname" => $form->getInput("fname")
            );
            $anonymous_id = $this->object->createSurveyCodesForExternalData(array($data));
            $anonymous_id = array_pop($anonymous_id);
            
            $this->object->addRater($appr_id, 0, $anonymous_id);
            
            ilUtil::sendSuccess($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 $data, $form, addExternalRaterFormObject(), and initExternalRaterForm().

Here is the call graph for this function:

addRater()

ilSurveyParticipantsGUI::addRater

(

$a_user_ids

)

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

    {
        $ilAccess = $this->access;
        $ilUser = $this->user;
        
        $appr_id = $this->handleRatersAccess();
        
        if (sizeof($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);
                        ilUtil::sendSuccess($this->lng->txt("settings_saved"), true);
                    } else {
                        ilUtil::sendFailure($this->lng->txt("svy_appraisses_cannot_be_raters"), true);
                    }
                }
            }
        }
        
        $this->ctrl->setParameter($this, "appr_id", $appr_id);
        $this->ctrl->redirect($this, "editRaters");
    }

References $access, $ilUser, $user, handleRatersAccess(), and ilUtil\sendFailure().

Here is the call graph for this function:

addSelfAppraiseeObject()

ilSurveyParticipantsGUI::addSelfAppraiseeObject

(

)

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

    {
        $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, and $user.

adminAppraiseesCloseObject()

ilSurveyParticipantsGUI::adminAppraiseesCloseObject

(

)

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

    {
        $this->handleWriteAccess();
        
        $appr_ids = $_POST["appr_id"];
        
        if (!sizeof($appr_ids)) {
            ilUtil::sendFailure($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);
            }
        }
        
        ilUtil::sendSuccess($this->lng->txt("survey_360_appraisee_close_action_success_admin"), true);
        $this->ctrl->redirect($this, "listAppraisees");
    }

References $_POST, handleWriteAccess(), and ilUtil\sendFailure().

Here is the call graph for this function:

appraiseeCloseObject()

ilSurveyParticipantsGUI::appraiseeCloseObject

(

)

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

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

References $ilUser, and $user.

cancelDeleteAllUserDataObject()

ilSurveyParticipantsGUI::cancelDeleteAllUserDataObject

(

)

Cancels delete of all user data in maintenance.

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

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

cancelDeleteSelectedUserDataObject()

ilSurveyParticipantsGUI::cancelDeleteSelectedUserDataObject

(

)

Cancels the deletion of all user data for the test object.

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

    {
        ilUtil::sendInfo($this->lng->txt('msg_cancel'), true);
        $this->ctrl->redirect($this, "maintenance");
    }

References ilUtil\sendInfo().

Here is the call graph for this function:

codesObject()

ilSurveyParticipantsGUI::codesObject

(

)

Display the survey access codes tab.

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

    {
        $ilUser = $this->user;
        $ilToolbar = $this->toolbar;
        
        $this->handleWriteAccess();
        $this->setCodesSubtabs();
        
        if ($this->object->isAccessibleWithoutCode()) {
            return ilUtil::sendInfo($this->lng->txt("survey_codes_no_anonymization"));
        }
 
        $default_lang = $ilUser->getPref("survey_code_language");
 
        // creation buttons
        $ilToolbar->setFormAction($this->ctrl->getFormAction($this));
        
        include_once("./Services/Form/classes/class.ilTextInputGUI.php");
        $si = new ilTextInputGUI($this->lng->txt("new_survey_codes"), "nrOfCodes");
        $si->setValue(1);
        $si->setSize(3);
        $ilToolbar->addInputItem($si, true);
        
        include_once "Services/UIComponent/Button/classes/class.ilSubmitButton.php";
        
        $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);
        }
        include_once("./Services/Form/classes/class.ilSelectInputGUI.php");
        $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);
    
        include_once "./Modules/Survey/classes/tables/class.ilSurveyCodesTableGUI.php";
        $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, $languages, PHPMailer\PHPMailer\$options, $si, $toolbar, $user, ilSubmitButton\getInstance(), handleWriteAccess(), ilUtil\sendInfo(), and setCodesSubtabs().

Here is the call graph for this function:

confirmAdminAppraiseesCloseObject()

ilSurveyParticipantsGUI::confirmAdminAppraiseesCloseObject

(

)

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

    {
        $tpl = $this->tpl;
       
        $this->handleWriteAccess();
       
        $appr_ids = $_POST["appr_id"];
 
        if (!sizeof($appr_ids)) {
            ilUtil::sendFailure($this->lng->txt("select_one"), true);
            $this->ctrl->redirect($this, "listAppraisees");
        }
 
        include_once("./Services/Utilities/classes/class.ilConfirmationGUI.php");
        $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");
 
        include_once "Services/User/classes/class.ilUserUtil.php";
        foreach ($appr_ids as $appr_id) {
            $cgui->addItem("appr_id[]", $appr_id, ilUserUtil::getNamePresentation($appr_id));
        }
 
        $tpl->setContent($cgui->getHTML());
    }

References $_POST, $tpl, ilUserUtil\getNamePresentation(), handleWriteAccess(), and ilUtil\sendFailure().

Here is the call graph for this function:

confirmAppraiseeCloseCancelObject()

ilSurveyParticipantsGUI::confirmAppraiseeCloseCancelObject

(

)

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

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

confirmAppraiseeCloseObject()

ilSurveyParticipantsGUI::confirmAppraiseeCloseObject

(

)

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

    {
        $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");
        }
       
        include_once("./Services/Utilities/classes/class.ilConfirmationGUI.php");
        $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, $tabs, $tpl, and $user.

confirmDeleteAllUserDataObject()

ilSurveyParticipantsGUI::confirmDeleteAllUserDataObject

(

)

Deletes all user data of the survey after confirmation.

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

    {
        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();
        }
        
        ilUtil::sendSuccess($this->lng->txt("svy_all_user_data_deleted"), true);
        $this->ctrl->redirect($this, "maintenance");
    }

References filterSurveyParticipantsByAccess().

Here is the call graph for this function:

confirmDeleteAppraiseesObject()

ilSurveyParticipantsGUI::confirmDeleteAppraiseesObject

(

)

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

    {
        $ilTabs = $this->tabs;
        
        if (!sizeof($_POST["appr_id"])) {
            ilUtil::sendFailure($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")
        );
        
        include_once("./Services/Utilities/classes/class.ilConfirmationGUI.php");
        $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;
        include_once "Services/User/classes/class.ilUserUtil.php";
        foreach ($_POST["appr_id"] as $id) {
            if (isset($data[$id]) && !$data[$id]["closed"]) {
                $cgui->addItem("appr_id[]", $id, ilUserUtil::getNamePresentation($id));
                $count++;
            }
        }
        
        if (!$count) {
            ilUtil::sendFailure($this->lng->txt("select_one"), true);
            $this->ctrl->redirect($this, "listAppraisees");
        }
 
        $this->tpl->setContent($cgui->getHTML());
    }

References $_POST, $data, $id, $tabs, ilUserUtil\getNamePresentation(), and ilUtil\sendFailure().

Here is the call graph for this function:

confirmDeleteRatersObject()

ilSurveyParticipantsGUI::confirmDeleteRatersObject

(

)

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

    {
        $ilTabs = $this->tabs;
        
        $appr_id = $this->handleRatersAccess();
        $this->ctrl->setParameter($this, "appr_id", $appr_id);
        if (!sizeof($_POST["rtr_id"])) {
            ilUtil::sendFailure($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")
        );
                
        include_once "Services/User/classes/class.ilUserUtil.php";
        include_once("./Services/Utilities/classes/class.ilConfirmationGUI.php");
        $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 ($_POST["rtr_id"] 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 $_POST, $data, $id, $tabs, ilUserUtil\getNamePresentation(), handleRatersAccess(), and ilUtil\sendFailure().

Here is the call graph for this function:

confirmDeleteSelectedUserDataObject()

ilSurveyParticipantsGUI::confirmDeleteSelectedUserDataObject

(

)

Deletes all user data for the test object.

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

    {
        $this->object->removeSelectedSurveyResults($_POST["chbUser"]);
        ilUtil::sendSuccess($this->lng->txt("svy_selected_user_data_deleted"), true);
        $this->ctrl->redirect($this, "maintenance");
    }

References $_POST.

createSurveyCodesObject()

ilSurveyParticipantsGUI::createSurveyCodesObject

(

)

Create access codes for the survey.

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

    {
        if (is_numeric($_POST["nrOfCodes"])) {
            $ids = $this->object->createSurveyCodes($_POST["nrOfCodes"]);
            ilUtil::sendSuccess($this->lng->txt('codes_created'), true);
            $this->ctrl->setParameter($this, "new_ids", implode(";", $ids));
            $this->ctrl->redirect($this, 'editCodes');
        } else {
            ilUtil::sendFailure($this->lng->txt("enter_valid_number_of_codes"), true);
            $this->ctrl->redirect($this, 'codes');
        }
    }

References $_POST, and ilUtil\sendFailure().

Here is the call graph for this function:

deleteAllUserDataObject()

ilSurveyParticipantsGUI::deleteAllUserDataObject

(

)

Creates a confirmation form for delete all user data.

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

    {
        include_once "Services/Utilities/classes/class.ilConfirmationGUI.php";
        $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());
    }

deleteAppraiseesObject()

ilSurveyParticipantsGUI::deleteAppraiseesObject

(

)

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

    {
        if (sizeof($_POST["appr_id"])) {
            $data = $this->object->getAppraiseesData();
 
            foreach ($_POST["appr_id"] as $id) {
                // #11285
                if (isset($data[$id]) && !$data[$id]["closed"]) {
                    $this->object->deleteAppraisee($id);
                }
            }
            
            ilUtil::sendSuccess($this->lng->txt("settings_saved"), true);
        }
        
        $this->ctrl->redirect($this, "listAppraisees");
    }

References $_POST, $data, and $id.

deleteCodesConfirmObject()

ilSurveyParticipantsGUI::deleteCodesConfirmObject

(

)

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

    {
        if (is_array($_POST["chb_code"]) && (count($_POST["chb_code"]) > 0)) {
            include_once("./Services/Utilities/classes/class.ilConfirmationGUI.php");
            $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");
            
            $data = $this->object->getSurveyCodesTableData($_POST["chb_code"]);
 
            foreach ($data as $item) {
                if ($item["used"]) {
                    continue;
                }
                
                $title = array($item["code"]);
                $item["email"] ? $title[] = $item["email"] : null;
                $item["last_name"] ? $title[] = $item["last_name"] : null;
                $item["first_name"] ? $title[] = $item["first_name"] : null;
                $title = implode(", ", $title);
                                
                $cgui->addItem("chb_code[]", $item["code"], $title);
            }
 
            $this->tpl->setContent($cgui->getHTML());
        } else {
            ilUtil::sendFailure($this->lng->txt('no_checkbox'), true);
            $this->ctrl->redirect($this, 'codes');
        }
    }

References $_POST, $data, $title, and ilUtil\sendFailure().

Here is the call graph for this function:

deleteCodesObject()

ilSurveyParticipantsGUI::deleteCodesObject

(

)

Delete a list of survey codes.

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

    {
        if (is_array($_POST["chb_code"]) && (count($_POST["chb_code"]) > 0)) {
            foreach ($_POST["chb_code"] as $survey_code) {
                $this->object->deleteSurveyCode($survey_code);
            }
            ilUtil::sendSuccess($this->lng->txt('codes_deleted'), true);
        } else {
            ilUtil::sendInfo($this->lng->txt('no_checkbox'), true);
        }
        $this->ctrl->redirect($this, 'codes');
    }

References $_POST, and ilUtil\sendInfo().

Here is the call graph for this function:

deleteRatersObject()

ilSurveyParticipantsGUI::deleteRatersObject

(

)

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

    {
        $appr_id = $this->handleRatersAccess();
        $this->ctrl->setParameter($this, "appr_id", $appr_id);
        
        if (sizeof($_POST["rtr_id"])) {
            $data = $this->object->getRatersData($appr_id);
 
            foreach ($_POST["rtr_id"] as $id) {
                if (isset($data[$id])) {
                    if (substr($id, 0, 1) == "u") {
                        $this->object->deleteRater($appr_id, substr($id, 1));
                    } else {
                        $this->object->deleteRater($appr_id, 0, substr($id, 1));
                    }
                }
            }
            
            ilUtil::sendSuccess($this->lng->txt("settings_saved"), true);
        }
 
        $this->ctrl->redirect($this, "editRaters");
    }

References $_POST, $data, $id, and handleRatersAccess().

Here is the call graph for this function:

deleteSavedMessageObject()

ilSurveyParticipantsGUI::deleteSavedMessageObject

(

)

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

    {
        $this->handleWriteAccess();
        $this->setCodesSubtabs();
 
        include_once("./Modules/Survey/classes/forms/FormMailCodesGUI.php");
        $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();
                ilUtil::sendSuccess($this->lng->txt('msg_message_deleted'));
            } else {
                ilUtil::sendFailure($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 $ilLog, $log, handleWriteAccess(), ilUtil\sendFailure(), and setCodesSubtabs().

Here is the call graph for this function:

deleteSingleUserResultsObject()

ilSurveyParticipantsGUI::deleteSingleUserResultsObject

(

)

Asks for a confirmation to delete selected user data of the test object.

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

    {
        $this->handleWriteAccess();
        
        if (!is_array($_POST["chbUser"]) || count($_POST["chbUser"]) == 0) {
            ilUtil::sendInfo($this->lng->txt('no_checkbox'), true);
            $this->ctrl->redirect($this, "maintenance");
        }
 
        ilUtil::sendQuestion($this->lng->txt("confirm_delete_single_user_data"));
        include_once "./Modules/Survey/classes/tables/class.ilSurveyMaintenanceTableGUI.php";
        $table_gui = new ilSurveyMaintenanceTableGUI($this, 'maintenance', true);
        $total = &$this->object->getSurveyParticipants();
        $data = array();
        foreach ($total as $user_data) {
            if (in_array($user_data['active_id'], $_POST['chbUser'])) {
                $last_access = $this->object->getLastAccess($user_data["active_id"]);
                array_push($data, array(
                    'id' => $user_data["active_id"],
                    'name' => $user_data["sortname"],
                    'login' => $user_data["login"],
                    'last_access' => $last_access
                ));
            }
        }
        $table_gui->setData($data);
        $this->tpl->setVariable('ADM_CONTENT', $table_gui->getHTML());
    }

References $_POST, $data, $total, handleWriteAccess(), ilUtil\sendInfo(), and ilUtil\sendQuestion().

Here is the call graph for this function:

disinviteUserGroupObject()

ilSurveyParticipantsGUI::disinviteUserGroupObject

(

)

Disinvite users or groups from a survey.

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

    {
        // disinvite users
        if (is_array($_POST["user_select"])) {
            foreach ($_POST["user_select"] as $user_id) {
                $this->object->disinviteUser($user_id);
            }
        }
        ilUtil::sendSuccess($this->lng->txt('msg_users_disinvited'), true);
        $this->ctrl->redirect($this, "invite");
    }

References $_POST.

editCodesObject()

ilSurveyParticipantsGUI::editCodesObject

(

)

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

    {
        if (isset($_GET["new_ids"])) {
            $ids = explode(";", $_GET["new_ids"]);
        } else {
            $ids = (array) $_POST["chb_code"];
        }
        if (!$ids) {
            ilUtil::sendFailure($this->lng->txt('no_checkbox'), true);
            $this->ctrl->redirect($this, 'codes');
        }
    
        $this->handleWriteAccess();
        $this->setCodesSubtabs();
        
        include_once "./Modules/Survey/classes/tables/class.ilSurveyCodesEditTableGUI.php";
        $table_gui = new ilSurveyCodesEditTableGUI($this, 'editCodes');
        $table_gui->setData($this->object->getSurveyCodesTableData($ids));
        $this->tpl->setContent($table_gui->getHTML());
    }

References $_GET, $_POST, handleWriteAccess(), ilUtil\sendFailure(), and setCodesSubtabs().

Here is the call graph for this function:

editRatersObject()

ilSurveyParticipantsGUI::editRatersObject

(

)

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

    {
        $ilTabs = $this->tabs;
        $ilToolbar = $this->toolbar;
        $ilAccess = $this->access;
        
        $appr_id = $_REQUEST["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);
        
        include_once './Services/Search/classes/class.ilRepositorySearchGUI.php';
        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
            )
        );
        
        $this->ctrl->setParameter($this, "rate360", "");
        
        $ilToolbar->addSeparator();
        
        $ilToolbar->addButton(
            $this->lng->txt("survey_360_add_external_rater"),
            $this->ctrl->getLinkTarget($this, "addExternalRaterForm")
        );
        
        // #13320
        require_once "Services/Link/classes/class.ilLink.php";
        $url = ilLink::_getStaticLink($this->object->getRefId());
        
        include_once "Modules/Survey/classes/tables/class.ilSurveyAppraiseesTableGUI.php";
        $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 $access, $has_write, $tabs, $tbl, $toolbar, $url, ilLink\_getStaticLink(), ilRepositorySearchGUI\fillAutoCompleteToolbar(), and handleRatersAccess().

Here is the call graph for this function:

executeCommand()

ilSurveyParticipantsGUI::executeCommand

(

)

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

    {
        $ilCtrl = $this->ctrl;
        $ilTabs = $this->tabs;
        
        $cmd = $ilCtrl->getCmd("maintenance");
        $next_class = $this->ctrl->getNextClass($this);
        
        switch ($next_class) {
            case 'ilrepositorysearchgui':
                include_once('./Services/Search/classes/class.ilRepositorySearchGUI.php');
                $rep_search = new ilRepositorySearchGUI();
                
                if (!$_REQUEST["appr360"] && !$_REQUEST["rate360"]) {
                    $ilTabs->clearTargets();
                    $ilTabs->setBackTarget(
                        $this->lng->txt("btn_back"),
                        $this->ctrl->getLinkTarget($this, "invite")
                    );
                    
                    $rep_search->setCallback(
                        $this,
                        'inviteUserGroupObject',
                        array(
                            )
                    );
 
                    // Set tabs
                    $this->ctrl->setReturn($this, 'invite');
                    $this->ctrl->forwardCommand($rep_search);
                    $ilTabs->setTabActive('invitation');
                } elseif ($_REQUEST["rate360"]) {
                    $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;
                
            default:
                $cmd .= "Object";
                $this->$cmd();
                break;
        }
    }

References $ctrl, $ilCtrl, and $tabs.

exportAllCodesObject()

ilSurveyParticipantsGUI::exportAllCodesObject

(

)

Exports all survey codes.

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

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

References ilUtil\deliverData(), and ilUtil\getASCIIFilename().

Here is the call graph for this function:

exportCodesObject()

ilSurveyParticipantsGUI::exportCodesObject

(

)

Exports a list of survey codes.

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

    {
        if (is_array($_POST["chb_code"]) && (count($_POST["chb_code"]) > 0)) {
            $export = $this->object->getSurveyCodesForExport(null, $_POST["chb_code"]);
            ilUtil::deliverData($export, ilUtil::getASCIIFilename($this->object->getTitle() . ".csv"));
        } else {
            ilUtil::sendFailure($this->lng->txt("no_checkbox"), true);
            $this->ctrl->redirect($this, 'codes');
        }
    }

References $_POST, ilUtil\deliverData(), ilUtil\getASCIIFilename(), and ilUtil\sendFailure().

Here is the call graph for this function:

filterSurveyParticipantsByAccess()

ilSurveyParticipantsGUI::filterSurveyParticipantsByAccess (   $a_finished_ids = null )

protected

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

    {
        $all_participants = $this->object->getSurveyParticipants($a_finished_ids);
        $participant_ids = [];
        foreach ($all_participants as $participant) {
            $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']) {
                $participants[$username] = $user_data;
            }
            if (in_array($user_data['usr_id'], $filtered_participant_ids)) {
                $participants[$username] = $user_data;
            }
        }
        return $participants;
    }

Referenced by confirmDeleteAllUserDataObject(), and maintenanceObject().

Here is the caller graph for this function:

getObject()

ilSurveyParticipantsGUI::getObject

(

)

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

    {
        return $this->object;
    }

References $object.

handleRatersAccess()

ilSurveyParticipantsGUI::handleRatersAccess

(

)

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

    {
        $ilAccess = $this->access;
        $ilUser = $this->user;
        
        if ($ilAccess->checkAccess("write", "", $this->ref_id)) {
            $appr_id = $_REQUEST["appr_id"];
            if (!$appr_id) {
                $this->ctrl->redirect($this, "listAppraisees");
            }
            return $appr_id;
        } elseif ($this->object->get360Mode() &&
            $this->object->get360SelfRaters() &&
            $this->object->isAppraisee($ilUser->getId()) &&
            !$this->object->isAppraiseeClosed($ilUser->getId())) {
            return $ilUser->getId();
        }
        $this->ctrl->redirect($this->parent_gui, "infoScreen");
    }

References $access, $ilUser, and $user.

Referenced by addExternalRaterFormObject(), addRater(), confirmDeleteRatersObject(), deleteRatersObject(), editRatersObject(), mailRatersActionObject(), and mailRatersObject().

Here is the caller graph for this function:

handleWriteAccess()

ilSurveyParticipantsGUI::handleWriteAccess ( )

protected

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

    {
        if (!$this->has_write) {
            include_once "Modules/Survey/exceptions/class.ilSurveyException.php";
            throw new ilSurveyException("Permission denied");
        }
    }

Referenced by adminAppraiseesCloseObject(), codesObject(), confirmAdminAppraiseesCloseObject(), deleteSavedMessageObject(), deleteSingleUserResultsObject(), editCodesObject(), importAccessCodesObject(), importExternalMailRecipientsFromFileFormObject(), importExternalMailRecipientsFromTextFormObject(), insertSavedMessageObject(), inviteObject(), listAppraiseesObject(), listParticipantsObject(), mailCodesObject(), maintenanceObject(), and sendCodesMailObject().

Here is the caller graph for this function:

importAccessCodesActionObject()

ilSurveyParticipantsGUI::importAccessCodesActionObject ( )

protected

Import codes from export codes file.

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

    {
        if (trim($_FILES['codes']['tmp_name'])) {
            $existing = array();
            foreach ($this->object->getSurveyCodesTableData() as $item) {
                $existing[$item["code"]] = $item["id"];
            }
            
            include_once "./Services/Utilities/classes/class.ilCSVReader.php";
            $reader = new ilCSVReader();
            $reader->open($_FILES['codes']['tmp_name']);
            foreach ($reader->getDataArrayFromCSVFile() as $row) {
                // numeric check of used column due to #26176
                if (sizeof($row) == 8 && is_numeric($row[5])) {
                    // used/sent/url are not relevant when importing
                    list($code, $email, $last_name, $first_name, $created, $used, $sent, $url) = $row;
                    
                    // unique code?
                    if (!array_key_exists($code, $existing)) {
                        // could be date or datetime
                        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);
                        
                        $user_data = array(
                            "email" => $email
                            ,"lastname" => $last_name
                            ,"firstname" => $first_name
                        );
                        $this->object->importSurveyCode($code, $created, $user_data);
                    }
                }
            }
            
            ilUtil::sendSuccess($this->lng->txt('codes_created'), true);
        }
        
        $this->ctrl->redirect($this, 'codes');
    }

References $code, $email, $reader, $row, $url, IL_CAL_DATE, IL_CAL_DATETIME, and IL_CAL_UNIX.

importAccessCodesObject()

ilSurveyParticipantsGUI::importAccessCodesObject ( )

protected

Import codes from export codes file (upload form)

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

    {
        $this->handleWriteAccess();
        $this->setCodesSubtabs();
        
        include_once("./Services/Form/classes/class.ilPropertyFormGUI.php");
        $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 handleWriteAccess(), and setCodesSubtabs().

Here is the call graph for this function:

importExternalMailRecipientsFromFileFormObject()

ilSurveyParticipantsGUI::importExternalMailRecipientsFromFileFormObject

(

)

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

    {
        $ilAccess = $this->access;
        
        $this->handleWriteAccess();
        $this->setCodesSubtabs();
        
        include_once("./Services/Form/classes/class.ilPropertyFormGUI.php");
        $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", "", $_GET["ref_id"])) {
            $form_import_file->addCommandButton("importExternalRecipientsFromFile", $this->lng->txt("import"));
        }
        if ($ilAccess->checkAccess("write", "", $_GET["ref_id"])) {
            $form_import_file->addCommandButton("codes", $this->lng->txt("cancel"));
        }
 
        $this->tpl->setContent($form_import_file->getHTML());
    }

References $_GET, $access, handleWriteAccess(), and setCodesSubtabs().

Here is the call graph for this function:

importExternalMailRecipientsFromTextFormObject()

ilSurveyParticipantsGUI::importExternalMailRecipientsFromTextFormObject

(

)

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

    {
        $ilAccess = $this->access;
        
        $this->handleWriteAccess();
        $this->setCodesSubtabs();
        
        include_once("./Services/Form/classes/class.ilPropertyFormGUI.php");
        $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');
        if (array_key_exists('externaltext', $_SESSION) && strlen($_SESSION['externaltext'])) {
            $inp->setValue($_SESSION['externaltext']);
        } 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);
        unset($_SESSION['externaltext']);
 
        if ($ilAccess->checkAccess("write", "", $_GET["ref_id"])) {
            $form_import_text->addCommandButton("importExternalRecipientsFromText", $this->lng->txt("import"));
        }
        if ($ilAccess->checkAccess("write", "", $_GET["ref_id"])) {
            $form_import_text->addCommandButton("codes", $this->lng->txt("cancel"));
        }
 
        $this->tpl->setContent($form_import_text->getHTML());
    }

References $_GET, $_SESSION, $access, handleWriteAccess(), and setCodesSubtabs().

Here is the call graph for this function:

importExternalRecipientsFromFileObject()

ilSurveyParticipantsGUI::importExternalRecipientsFromFileObject

(

)

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

    {
        if (trim($_FILES['externalmails']['tmp_name'])) {
            include_once "./Services/Utilities/classes/class.ilCSVReader.php";
            $reader = new ilCSVReader();
            $reader->open($_FILES['externalmails']['tmp_name']);
            $data = $reader->getDataArrayFromCSVFile();
            $fields = array_shift($data);
            foreach ($fields as $idx => $field) {
                $fields[$idx] = $this->removeUTF8Bom($field);
            }
            if (!in_array('email', $fields)) {
                $reader->close();
                ilUtil::sendFailure($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) {
                    array_push($existingcolumns, $key);
                }
            }
            
            include_once "Services/Utilities/classes/class.ilStr.php";
            
            $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 (strlen($dataset['email'])) {
                        array_push($founddata, $dataset);
                    }
                }
            }
            $reader->close();
            
            if (sizeof($founddata)) {
                $this->object->createSurveyCodesForExternalData($founddata);
                ilUtil::sendSuccess($this->lng->txt('external_recipients_imported'), true);
            }
        }
        
        $this->ctrl->redirect($this, 'codes');
    }

References $data, $key, $reader, $row, _convertCharset(), removeUTF8Bom(), and ilUtil\sendFailure().

Here is the call graph for this function:

importExternalRecipientsFromTextObject()

ilSurveyParticipantsGUI::importExternalRecipientsFromTextObject

(

)

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

    {
        if (trim($_POST['externaltext'])) {
            $data = preg_split("/[\n\r]/", $_POST['externaltext']);
            $fields = preg_split("/;/", array_shift($data));
            if (!in_array('email', $fields)) {
                $_SESSION['externaltext'] = $_POST['externaltext'];
                ilUtil::sendFailure($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) {
                    array_push($existingcolumns, $key);
                }
            }
            $founddata = array();
            foreach ($data as $datarow) {
                $row = preg_split("/;/", $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 (strlen($dataset['email'])) {
                        array_push($founddata, $dataset);
                    }
                }
            }
            $this->object->createSurveyCodesForExternalData($founddata);
            ilUtil::sendSuccess($this->lng->txt('external_recipients_imported'), true);
            $this->ctrl->redirect($this, 'codes');
        }
        
        $this->ctrl->redirect($this, 'importExternalMailRecipientsFromTextForm');
    }

References $_POST, $_SESSION, $data, $key, $row, and ilUtil\sendFailure().

Here is the call graph for this function:

initExternalRaterForm()

ilSurveyParticipantsGUI::initExternalRaterForm (   $appr_id )

protected

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

    {
        include_once "Services/User/classes/class.ilUserUtil.php";
        include_once("./Services/Form/classes/class.ilPropertyFormGUI.php");
        $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;
    }

References $email, $form, and ilUserUtil\getNamePresentation().

Referenced by addExternalRaterFormObject(), and addExternalRaterObject().

Here is the call graph for this function:

Here is the caller graph for this function:

initMailRatersForm()

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

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

    {
        include_once("./Services/Form/classes/class.ilPropertyFormGUI.php");
        $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) {
                    array_push($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'), join(', ', $existingcolumns)));
        $form->addItem($mailmessage_a);
        
        $recf = new ilHiddenInputGUI("rtr_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;
    }

References $form, and $key.

Referenced by mailRatersActionObject(), and mailRatersObject().

Here is the caller graph for this function:

insertSavedMessageObject()

ilSurveyParticipantsGUI::insertSavedMessageObject

(

)

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

    {
        $this->handleWriteAccess();
        $this->setCodesSubtabs();
 
        include_once("./Modules/Survey/classes/forms/FormMailCodesGUI.php");
        $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']);
                ilUtil::sendSuccess($this->lng->txt('msg_message_inserted'));
            } else {
                ilUtil::sendFailure($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 $ilLog, $ilUser, $log, $user, handleWriteAccess(), ilUtil\sendFailure(), and setCodesSubtabs().

Here is the call graph for this function:

inviteObject()

ilSurveyParticipantsGUI::inviteObject

(

)

Creates the output for user/group invitation to a survey.

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

    {
        $ilAccess = $this->access;
        $rbacsystem = $this->rbacsystem;
        $ilToolbar = $this->toolbar;
        $lng = $this->lng;
        
        $this->handleWriteAccess();
        $this->setCodesSubtabs();
 
        include_once("./Services/Form/classes/class.ilPropertyFormGUI.php");
        $form = new ilPropertyFormGUI();
        $form->setFormAction($this->ctrl->getFormAction($this));
        $form->setTableWidth("500");
        $form->setId("invite");
 
        // invitation
        $header = new ilFormSectionHeaderGUI();
        $header->setTitle($this->lng->txt("invitation"));
        $form->addItem($header);
        
        // invitation mode
        $invitation = new ilRadioGroupInputGUI($this->lng->txt('invitation_mode'), "invitation");
        $invitation->setInfo($this->lng->txt('invitation_mode_desc'));
        $invitation->addOption(new ilRadioOption($this->lng->txt("invitation_off"), 0, ''));
        $surveySetting = new ilSetting("survey");
        if ($surveySetting->get("unlimited_invitation")) {
            $invitation->addOption(new ilRadioOption($this->lng->txt("unlimited_users"), 1, ''));
        }
        $invitation->addOption(new ilRadioOption($this->lng->txt("predefined_users"), 2, ''));
        $inv = 0;
        if ($this->object->getInvitation()) {
            $inv = $this->object->getInvitationMode() + 1;
        }
        $invitation->setValue($inv);
        $form->addItem($invitation);
        
        $form->addCommandButton("saveInvitationStatus", $this->lng->txt("save"));
 
        $this->tpl->addBlockFile("ADM_CONTENT", "adm_content", "tpl.il_svy_svy_invite.html", "Modules/Survey");
        $this->tpl->setVariable("INVITATION_TABLE", $form->getHTML());
 
        if ($this->object->getInvitation() && $this->object->getInvitationMode() == 1) {
            // search button
            include_once './Services/Search/classes/class.ilRepositorySearchGUI.php';
            ilRepositorySearchGUI::fillAutoCompleteToolbar(
                $this,
                $tb,
                array(
                    'auto_complete_name' => $lng->txt('user'),
                    'submit_name' => $lng->txt('svy_invite_action')
                )
            );
 
            $ilToolbar->addSpacer();
 
            $ilToolbar->addButton(
                $this->lng->txt("svy_search_users"),
                $this->ctrl->getLinkTargetByClass('ilRepositorySearchGUI', '')
            );
 
            $this->tpl->setVariable("ADM_CONTENT", $form->getHTML());
 
            $invited_users = $this->object->getUserData($this->object->getInvitedUsers());
            include_once "./Modules/Survey/classes/tables/class.ilSurveyInvitedUsersTableGUI.php";
            $table_gui = new ilSurveyInvitedUsersTableGUI($this, 'invite');
            $table_gui->setData($invited_users);
            $this->tpl->setVariable('TBL_INVITED_USERS', $table_gui->getHTML());
        }
    }

References $access, $form, $header, $lng, $rbacsystem, $toolbar, ilRepositorySearchGUI\fillAutoCompleteToolbar(), handleWriteAccess(), and setCodesSubtabs().

Here is the call graph for this function:

inviteUserGroupObject()

ilSurveyParticipantsGUI::inviteUserGroupObject

(

$a_user_ids = array()

)

Invite users or groups to a survey.

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

    {
        $invited = 0;
        // add users to invitation
        if (is_array($a_user_ids)) {
            foreach ($a_user_ids as $user_id) {
                $this->object->inviteUser($user_id);
                $invited++;
            }
        }
        if ($invited == 0) {
            ilUtil::sendFailure($this->lng->txt('no_user_invited'), true);
            return false;
        } else {
            ilUtil::sendSuccess(sprintf($this->lng->txt('users_invited'), $invited), true);
            return false;
        }
        $this->ctrl->redirect($this, "invite");
    }

References ilUtil\sendFailure().

Here is the call graph for this function:

isAnonymousListActive()

ilSurveyParticipantsGUI::isAnonymousListActive ( )

protected

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

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

References $end, and $total.

Referenced by listParticipantsObject(), and setCodesSubtabs().

Here is the caller graph for this function:

listAppraiseesObject()

ilSurveyParticipantsGUI::listAppraiseesObject

(

)

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

    {
        $ilToolbar = $this->toolbar;
        $lng = $this->lng;
        $ilCtrl = $this->ctrl;
        
        $this->handleWriteAccess();
        
        $this->ctrl->setParameter($this, "appr360", 1);
        
        include_once './Services/Search/classes/class.ilRepositorySearchGUI.php';
        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
        include_once("./Services/Skill/classes/class.ilSkillManagementSettings.php");
        $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", "");
        
        include_once "Modules/Survey/classes/tables/class.ilSurveyAppraiseesTableGUI.php";
        $tbl = new ilSurveyAppraiseesTableGUI($this, "listAppraisees");
        $tbl->setData($this->object->getAppraiseesData());
        $this->tpl->setContent($tbl->getHTML());
    }

References $ctrl, $ilCtrl, $lng, $tbl, $toolbar, ilRepositorySearchGUI\fillAutoCompleteToolbar(), and handleWriteAccess().

Referenced by maintenanceObject().

Here is the call graph for this function:

Here is the caller graph for this function:

listParticipantsObject()

ilSurveyParticipantsGUI::listParticipantsObject ( )

protected

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

    {
        $ilToolbar = $this->toolbar;
        
        if (!$this->isAnonymousListActive()) {
            $this->ctrl->redirect($this, "maintenance");
        }
       
        $this->handleWriteAccess();
        $this->setCodesSubtabs();
        
        include_once "Services/UIComponent/Button/classes/class.ilLinkButton.php";
        $button = ilLinkButton::getInstance();
        $button->setCaption("print");
        $button->setOnClick("window.print(); return false;");
        $button->setOmitPreventDoubleSubmission(true);
        $ilToolbar->addButtonInstance($button);
        
        include_once "Modules/Survey/classes/tables/class.ilSurveyParticipantsTableGUI.php";
        $tbl = new ilSurveyParticipantsTableGUI($this, "listParticipants", $this->object);
        $this->tpl->setContent($tbl->getHTML());
    }

References $tbl, $toolbar, ilLinkButton\getInstance(), handleWriteAccess(), isAnonymousListActive(), and setCodesSubtabs().

Here is the call graph for this function:

mailCodesObject()

ilSurveyParticipantsGUI::mailCodesObject

(

)

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

    {
        $this->handleWriteAccess();
        $this->setCodesSubtabs();
 
        $mailData['m_subject'] = (array_key_exists('m_subject', $_POST)) ? $_POST['m_subject'] : sprintf($this->lng->txt('default_codes_mail_subject'), $this->object->getTitle());
        $mailData['m_message'] = (array_key_exists('m_message', $_POST)) ? $_POST['m_message'] : $this->lng->txt('default_codes_mail_message');
        $mailData['m_notsent'] = (array_key_exists('m_notsent', $_POST)) ? $_POST['m_notsent'] : '1';
 
        include_once("./Modules/Survey/classes/forms/FormMailCodesGUI.php");
        $form_gui = new FormMailCodesGUI($this);
        $form_gui->setValuesByArray($mailData);
        $this->tpl->setVariable("ADM_CONTENT", $form_gui->getHTML());
    }

References $_POST, handleWriteAccess(), and setCodesSubtabs().

Here is the call graph for this function:

mailRatersActionObject()

ilSurveyParticipantsGUI::mailRatersActionObject

(

)

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

    {
        $ilUser = $this->user;
        
        $appr_id = $this->handleRatersAccess();
        $this->ctrl->setParameter($this, "appr_id", $appr_id);
        
        $rec_ids = explode(";", $_POST["rtr_id"]);
        if (!sizeof($rec_ids)) {
            $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;
                
            include_once "./Services/Mail/classes/class.ilMail.php";
 
            $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 (substr($rec_id, 0, 1) == "a") {
                        $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]", $user["lastname"], $mytxt);
                    $mytxt = str_replace("[firstname]", $user["firstname"], $mytxt);
                    $mytxt = str_replace("[url]", $url, $mytxt);
                    $mytxt = str_replace("[code]", $user["code"], $mytxt);
                    
                    $mail = new ilMail($sender_id);
                    $mail->sendMail(
                        $rcp, // to
                        "", // cc
                        "", // bcc
                        $subj, // subject
                        $mytxt, // message
                        array(), // attachments
                        array('normal') // type
                    );
                    
                    $this->object->set360RaterSent(
                        $appr_id,
                        (substr($rec_id, 0, 1) == "a") ? 0 : (int) substr($rec_id, 1),
                        (substr($rec_id, 0, 1) == "u") ? 0 : (int) substr($rec_id, 1)
                    );
                }
            }
            
            ilUtil::sendSuccess($this->lng->txt("mail_sent"), true);
            $this->ctrl->redirect($this, "editRaters");
        }
        
        $form->setValuesByPost();
        $this->mailRatersObject($form);
    }

References $_POST, $form, $ilUser, $url, $user, ilLink\_getStaticLink(), handleRatersAccess(), initMailRatersForm(), and mailRatersObject().

Here is the call graph for this function:

mailRatersObject()

ilSurveyParticipantsGUI::mailRatersObject

(

ilPropertyFormGUI

$a_form = null

)

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

    {
        $ilTabs = $this->tabs;
        
        if (!$a_form) {
            $appr_id = $this->handleRatersAccess();
            $this->ctrl->setParameter($this, "appr_id", $appr_id);
        
            if (!sizeof($_POST["rtr_id"])) {
                ilUtil::sendFailure($this->lng->txt("select_one"), true);
                $this->ctrl->redirect($this, "editRaters");
            }
        
            $a_form = $this->initMailRatersForm($appr_id, $_POST["rtr_id"]);
        }
                
        $ilTabs->clearTargets();
        $ilTabs->setBackTarget(
            $this->lng->txt("btn_back"),
            $this->ctrl->getLinkTarget($this, "editRaters")
        );
        
        $this->tpl->setContent($a_form->getHTML());
    }

References $_POST, $tabs, handleRatersAccess(), initMailRatersForm(), and ilUtil\sendFailure().

Referenced by mailRatersActionObject().

Here is the call graph for this function:

Here is the caller graph for this function:

maintenanceObject()

ilSurveyParticipantsGUI::maintenanceObject

(

)

Participants maintenance.

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

    {
        $ilToolbar = $this->toolbar;
        
        if ($this->object->get360Mode()) {
            return $this->listAppraiseesObject();
        }
        
        //Btn Determine Competence Levels
        if ($this->object->getMode() == ilObjSurvey::MODE_SELF_EVAL) {
            include_once("./Services/Skill/classes/class.ilSkillManagementSettings.php");
            $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->setCodesSubtabs();
 
        $ilToolbar->addButton(
            $this->lng->txt('svy_delete_all_user_data'),
            $this->ctrl->getLinkTarget($this, 'deleteAllUserData')
        );
 
        include_once "./Modules/Survey/classes/tables/class.ilSurveyMaintenanceTableGUI.php";
        $table_gui = new ilSurveyMaintenanceTableGUI($this, 'maintenance');
        
        //$total =& $this->object->getSurveyParticipants();
        $total = $this->filterSurveyParticipantsByAccess();
        $data = array();
        foreach ($total as $user_data) {
            $finished = false;
            if ((bool) $user_data["finished"]) {
                $finished = $user_data["finished_tstamp"];
            }
            $wt = $this->object->getWorkingtimeForParticipant($user_data["active_id"]);
            $last_access = $this->object->getLastAccess($user_data["active_id"]);
            array_push($data, array(
                'id' => $user_data["active_id"],
                'name' => $user_data["sortname"],
                'login' => $user_data["login"],
                'last_access' => $last_access,
                'workingtime' => $wt,
                'finished' => $finished
            ));
        }
        $table_gui->setData($data);
        $this->tpl->setVariable('ADM_CONTENT', $table_gui->getHTML());
    }

References $data, $toolbar, $total, filterSurveyParticipantsByAccess(), handleWriteAccess(), listAppraiseesObject(), ilObjSurvey\MODE_SELF_EVAL, and setCodesSubtabs().

Here is the call graph for this function:

removeUTF8Bom()

ilSurveyParticipantsGUI::removeUTF8Bom (   $a_text )

protected

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

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

Referenced by importExternalRecipientsFromFileObject().

Here is the caller graph for this function:

saveInvitationStatusObject()

ilSurveyParticipantsGUI::saveInvitationStatusObject

(

)

Saves the status of the invitation tab.

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

    {
        $mode = $_POST['invitation'];
        switch ($mode) {
            case 0:
                $this->object->setInvitation(ilObjSurvey::INVITATION_OFF);
                break;
            case 1:
                $this->object->setInvitationAndMode(ilObjSurvey::INVITATION_ON, ilObjSurvey::MODE_UNLIMITED);
                break;
            case 2:
                $this->object->setInvitationAndMode(ilObjSurvey::INVITATION_ON, ilObjSurvey::MODE_PREDEFINED_USERS);
                break;
        }
        $this->object->saveToDb();
        ilUtil::sendSuccess($this->lng->txt('msg_obj_modified'), true);
        $this->ctrl->redirect($this, "invite");
    }

References $_POST, ilObjSurvey\INVITATION_OFF, ilObjSurvey\INVITATION_ON, ilObjSurvey\MODE_PREDEFINED_USERS, and ilObjSurvey\MODE_UNLIMITED.

sendCodesMailObject()

ilSurveyParticipantsGUI::sendCodesMailObject

(

)

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

    {
        $ilUser = $this->user;
        
        $this->handleWriteAccess();
        $this->setCodesSubtabs();
 
        include_once("./Modules/Survey/classes/forms/FormMailCodesGUI.php");
        $form_gui = new FormMailCodesGUI($this);
        if ($form_gui->checkInput()) {
            $url_exists = strpos($_POST['m_message'], '[url]') !== false;
            if (!$url_exists) {
                ilUtil::sendFailure($this->lng->txt('please_enter_mail_url'));
                $form_gui->setValuesByPost();
            } else {
                if ($_POST['savemessage'] == 1) {
                    $ilUser = $this->user;
                    $title = (strlen($_POST['savemessagetitle'])) ? $_POST['savemessagetitle'] : ilStr::substr($_POST['m_message'], 0, 40) . '...';
                    $this->object->saveUserSettings($ilUser->getId(), 'savemessage', $title, $_POST['m_message']);
                }
                
                $lang = $ilUser->getPref("survey_code_language");
                if (!$lang) {
                    $lang = $this->lng->getDefaultLanguage();
                }
                $this->object->sendCodes($_POST['m_notsent'], $_POST['m_subject'], nl2br($_POST['m_message']), $lang);
                ilUtil::sendSuccess($this->lng->txt('mail_sent'), true);
                $this->ctrl->redirect($this, 'mailCodes');
            }
        } else {
            $form_gui->setValuesByPost();
        }
        $this->tpl->setVariable("ADM_CONTENT", $form_gui->getHTML());
    }

References $_POST, $ilUser, $lang, $title, $user, handleWriteAccess(), ilUtil\sendFailure(), and setCodesSubtabs().

Here is the call graph for this function:

setCodeLanguageObject()

ilSurveyParticipantsGUI::setCodeLanguageObject

(

)

Change survey language for direct access URL's.

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

    {
        if (strcmp($_POST["lang"], "-1") != 0) {
            $ilUser = $this->user;
            $ilUser->writePref("survey_code_language", $_POST["lang"]);
        }
        ilUtil::sendSuccess($this->lng->txt('language_changed'), true);
        $this->ctrl->redirect($this, 'codes');
    }

References $_POST, $ilUser, and $user.

setCodesSubtabs()

ilSurveyParticipantsGUI::setCodesSubtabs

(

)

Set the tabs for the access codes section.

@access private

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

    {
        $ilTabs = $this->tabs;
        
        // not used in 360° mode
    
        // maintenance
        $ilTabs->addSubTabTarget(
            "sub_tab_dashboard",
            $this->ctrl->getLinkTarget($this, 'maintenance'),
            array("maintenance", "deleteAllUserData"),
            ""
        );
        
        if ($this->isAnonymousListActive()) {
            $ilTabs->addSubTabTarget(
                "svy_anonymous_participants_svy",
                $this->ctrl->getLinkTarget($this, 'listParticipants'),
                array("listParticipants"),
                ""
            );
        }
 
        if (!$this->object->isAccessibleWithoutCode()) {
            $ilTabs->addSubTabTarget(
                "codes",
                $this->ctrl->getLinkTarget($this, 'codes'),
                array("codes", "editCodes", "createSurveyCodes", "setCodeLanguage", "deleteCodes", "exportCodes",
                    "importExternalMailRecipientsFromFileForm", "importExternalMailRecipientsFromTextForm"),
                ""
            );
        }
        
        $hidden_tabs = array();
        $template = $this->object->getTemplate();
        if ($template) {
            include_once "Services/Administration/classes/class.ilSettingsTemplate.php";
            $template = new ilSettingsTemplate($template);
            $hidden_tabs = $template->getHiddenTabs();
        }
 
        // #12277 - invite
        if (!in_array("invitation", $hidden_tabs)) {
            if ($this->access->checkAccess('write', '', $this->object->getRefId())) {
                $ilTabs->addSubTabTarget(
                    "invitation",
                    $this->ctrl->getLinkTarget($this, 'invite'),
                    array("invite", "saveInvitationStatus",
                 "inviteUserGroup", "disinviteUserGroup"),
                    ""
                );
            }
        }
        
        $data = $this->object->getExternalCodeRecipients();
        if (count($data)) {
            $ilTabs->addSubTabTarget(
                "mail_survey_codes",
                $this->ctrl->getLinkTarget($this, "mailCodes"),
                array("mailCodes", "sendCodesMail", "insertSavedMessage", "deleteSavedMessage"),
                ""
            );
        }
    }

References $data, $tabs, $template, and isAnonymousListActive().

Referenced by codesObject(), deleteSavedMessageObject(), editCodesObject(), importAccessCodesObject(), importExternalMailRecipientsFromFileFormObject(), importExternalMailRecipientsFromTextFormObject(), insertSavedMessageObject(), inviteObject(), listParticipantsObject(), mailCodesObject(), maintenanceObject(), and sendCodesMailObject().

Here is the call graph for this function:

Here is the caller graph for this function:

updateCodesObject()

ilSurveyParticipantsGUI::updateCodesObject

(

)

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

    {
        if (!is_array($_POST["chb_code"])) {
            $this->ctrl->redirect($this, 'codes');
        }
 
        $errors = array();
        $error_message = "";
        foreach ($_POST["chb_code"] as $id) {
            if (!$this->object->updateCode(
                $id,
                $_POST["chb_mail"][$id],
                $_POST["chb_lname"][$id],
                $_POST["chb_fname"][$id],
                $_POST["chb_sent"][$id]
            )) {
                array_push($errors, array($_POST["chb_mail"][$id], $_POST["chb_lname"][$id], $_POST["chb_fname"][$id]));
            };
        }
        if (empty($errors)) {
            ilUtil::sendSuccess($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]);
            }
            ilUtil::sendFailure($error_message, true);
        }
 
        $this->ctrl->redirect($this, 'codes');
    }

References $_POST, $errors, $id, and ilUtil\sendFailure().

Here is the call graph for this function:

Field Documentation

$access

ilSurveyParticipantsGUI::$access

protected

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

Referenced by addExternalRaterFormObject(), addRater(), editRatersObject(), handleRatersAccess(), importExternalMailRecipientsFromFileFormObject(), importExternalMailRecipientsFromTextFormObject(), and inviteObject().

$ctrl

ilSurveyParticipantsGUI::$ctrl

protected

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

Referenced by executeCommand(), and listAppraiseesObject().

$has_write

ilSurveyParticipantsGUI::$has_write

protected

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

Referenced by addExternalRaterFormObject(), and editRatersObject().

$lng

ilSurveyParticipantsGUI::$lng

protected

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

Referenced by __construct(), inviteObject(), and listAppraiseesObject().

$log

ilSurveyParticipantsGUI::$log

protected

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

Referenced by deleteSavedMessageObject(), and insertSavedMessageObject().

$object

ilSurveyParticipantsGUI::$object

protected

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

Referenced by getObject().

$parent_gui

ilSurveyParticipantsGUI::$parent_gui

protected

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

$rbacsystem

ilSurveyParticipantsGUI::$rbacsystem

protected

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

Referenced by inviteObject().

$ref_id

ilSurveyParticipantsGUI::$ref_id

protected

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

$tabs

ilSurveyParticipantsGUI::$tabs

protected

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

Referenced by addExternalRaterFormObject(), confirmAppraiseeCloseObject(), confirmDeleteAppraiseesObject(), confirmDeleteRatersObject(), editRatersObject(), executeCommand(), mailRatersObject(), and setCodesSubtabs().

$toolbar

ilSurveyParticipantsGUI::$toolbar

protected

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

Referenced by codesObject(), editRatersObject(), inviteObject(), listAppraiseesObject(), listParticipantsObject(), and maintenanceObject().

$tpl

ilSurveyParticipantsGUI::$tpl

protected

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

Referenced by __construct(), confirmAdminAppraiseesCloseObject(), and confirmAppraiseeCloseObject().

$user

ilSurveyParticipantsGUI::$user

protected

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

Referenced by addRater(), addSelfAppraiseeObject(), appraiseeCloseObject(), codesObject(), confirmAppraiseeCloseObject(), handleRatersAccess(), insertSavedMessageObject(), mailRatersActionObject(), sendCodesMailObject(), and setCodeLanguageObject().

---

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

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