ilObjSurveyGUI Class Reference

Class ilObjSurveyGUI. More...

Inheritance diagram for ilObjSurveyGUI:

Collaboration diagram for ilObjSurveyGUI:

Public Member Functions
	__construct ()
	executeCommand ()
	evaluationObject ()
	Redirects the evaluation object call to the ilSurveyEvaluationGUI class. More...
	afterSave (ilObject $a_new_object)
	save object public More...
	getTabs ()
	adds tabs to tab gui object More...
	savePropertiesObject ()
	Save the survey properties. More...
	initPropertiesForm ()
	Init survey settings form. More...
	addSubTabs ($a_section)
	Add subtabs for tabs. More...
	propertiesObject (ilPropertyFormGUI $a_form=null)
	Display and fill the properties form of the test. More...
	doAutoCompleteObject ()
	confirmResetTemplateObject ()
	Enable all settings - Confirmation. More...
	resetTemplateObject ()
	Enable all settings - remove template. More...
	importSurveyObject ()
	form for new survey object import More...
	infoScreenObject ()
	this one is called from the info button in the repository not very nice to set cmdClass/Cmd manually, if everything works through ilCtrl in the future this may be changed More...
	infoScreen ()
	show information screen More...
	addLocatorItems ()
	getUserResultsTable ($a_active_id)
	sendUserResultsMail ($a_active_id, $a_recipient)
	mailUserResultsObject ()
Public Member Functions inherited from ilObjectGUI
	executeCommand ()
	execute command More...
	withReferences ()
	determines wether objects are referenced or not (got ref ids or not) More...
	setCreationMode ($a_mode=true)
	if true, a creation screen is displayed the current $_GET[ref_id] don't belong to the current class! the mode is determined in ilrepositorygui More...
	getCreationMode ()
	get creation mode More...
	prepareOutput ($a_show_subobjects=true)
	prepare output More...
	getAdminTabs ()
	administration tabs show only permissions and trash folder More...
	getHTML ()
	confirmedDeleteObject ()
	confirmed deletion of object -> objects are moved to trash or deleted immediately, if trash is disabled More...
	cancelDeleteObject ()
	cancel deletion of object More...
	cancelObject ()
	cancel action and go back to previous page public More...
	createObject ()
	create new object form More...
	cancelCreation ()
	cancel create action and go back to repository parent More...
	saveObject ()
	save object More...
	getDidacticTemplateVar ($a_type)
	Get didactic template setting from creation screen. More...
	putObjectInTree (ilObject $a_obj, $a_parent_node_id=null)
	Add object to tree at given position. More...
	editObject ()
	edit object More...
	addExternalEditFormCustom (ilPropertyFormGUI $a_form)
	updateObject ()
	updates object entry in object_data More...
	getFormAction ($a_cmd, $a_formaction="")
	get form action for command (command is method name without "Object", e.g. More...
	isVisible ($a_ref_id, $a_type)
	viewObject ()
	list childs of current object More...
	deleteObject ($a_error=false)
	Display deletion confirmation screen. More...
	cloneAllObject ()
	Clone single (not container object) Method is overwritten in ilContainerGUI. More...
	redirectAfterCreation ()
	Redirect after creation, see https://docu.ilias.de/goto_docu_wiki_wpage_5035_1357.html. More...

Static Public Member Functions
static	_goto ($a_target, $a_access_code="")
	redirect script More...
Static Public Member Functions inherited from ilObjectGUI
static	_gotoRepositoryRoot ($a_raise_error=false)
	Goto repository root. More...
static	_gotoRepositoryNode ($a_ref_id, $a_cmd="frameset")
	Goto repository root. More...

Protected Member Functions
	addDidacticTemplateOptions (array &$a_options)
	initImportForm ($a_new_type)
	viewUserResultsObject ()
	getUserResultsPlain ($a_active_id)
	checkRbacOrPositionPermission ($a_rbac_permission, $a_position_permission)
	Check rbac or position permission. More...
Protected Member Functions inherited from ilObjectGUI
	getObjectService ()
	Get object service. More...
	assignObject ()
	setTitleAndDescription ()
	called by prepare output More...
	initHeaderAction ($a_sub_type=null, $a_sub_id=null)
	Add header action menu. More...
	insertHeaderAction ($a_list_gui)
	Insert header action into main template. More...
	addHeaderAction ()
	Add header action menu. More...
	redrawHeaderActionObject ()
	Ajax call: redraw action header only. More...
	showMountWebfolderIcon ()
	setTabs ()
	set admin tabs public More...
	setAdminTabs ()
	set admin tabs public More...
	setLocator ()
	set Locator More...
	addLocatorItems ()
	should be overwritten to add object specific items (repository items are preloaded) More...
	omitLocator ($a_omit=true)
	addAdminLocatorItems ($a_do_not_add_object=false)
	should be overwritten to add object specific items (repository items are preloaded) More...
	initCreationForms ($a_new_type)
	Init creation froms. More...
	getCreationFormsHTML (array $a_forms)
	Get HTML for creation forms (accordion) More...
	initCreateForm ($a_new_type)
	Init object creation form. More...
	initDidacticTemplate (ilPropertyFormGUI $form)
	Show didactic template types. More...
	addDidacticTemplateOptions (array &$a_options)
	Add custom templates. More...
	afterSave (ilObject $a_new_object)
	Post (successful) object creation hook. More...
	initEditForm ()
	Init object edit form. More...
	initEditCustomForm (ilPropertyFormGUI $a_form)
	Add custom fields to update form. More...
	getEditFormValues ()
	Get values for edit form. More...
	getEditFormCustomValues (array &$a_values)
	Add values to custom edit fields. More...
	validateCustom (ilPropertyFormGUI $a_form)
	Validate custom values (if not possible with checkInput()) More...
	updateCustom (ilPropertyFormGUI $a_form)
	Insert custom update form values into object. More...
	afterUpdate ()
	Post (successful) object update hook. More...
	initImportForm ($a_new_type)
	Init object import form. More...
	importFileObject ($parent_id=null, $a_catch_errors=true)
	Import. More...
	afterImport (ilObject $a_new_object)
	Post (successful) object import hook. More...
	setFormAction ($a_cmd, $a_formaction)
	set specific form action for command More...
	getReturnLocation ($a_cmd, $a_location="")
	get return location for command (command is method name without "Object", e.g. More...
	setReturnLocation ($a_cmd, $a_location)
	set specific return location for command More...
	getTargetFrame ($a_cmd, $a_target_frame="")
	get target frame for command (command is method name without "Object", e.g. More...
	setTargetFrame ($a_cmd, $a_target_frame)
	set specific target frame for command More...
	showPossibleSubObjects ()
	show possible subobjects (pulldown menu) More...
	getTemplateFile ($a_cmd, $a_type="")
	get a template blockfile format: tpl. More...
	getTabs ()
	get tabs abstract method. More...
	__showButton ($a_cmd, $a_text, $a_target='')
	hitsperpageObject ()
&	__initTableGUI ()
	__setTableGUIBasicData (&$tbl, &$result_set, $a_from="")
	standard implementation for tables use 'from' variable use different initial setting of table More...
	redirectToRefId ($a_ref_id, $a_cmd="")
	redirects to (repository) view per ref id usually to a container and usually used at the end of a save/import method where the object gui type (of the new object) doesn't match with the type of the current $_GET["ref_id"] value More...
	fillCloneTemplate ($a_tpl_varname, $a_type)
	Fill object clone template This method can be called from any object GUI class that wants to offer object cloning. More...
	getCenterColumnHTML ()
	Get center column. More...
	getRightColumnHTML ()
	Display right column. More...
	setColumnSettings (ilColumnGUI $column_gui)
	May be overwritten in subclasses. More...
	checkPermission ($a_perm, $a_cmd="", $a_type="", $a_ref_id=null)
	Check permission and redirect on error. More...
	checkPermissionBool ($a_perm, $a_cmd="", $a_type="", $a_ref_id=null)
	Check permission. More...
	enableDragDropFileUpload ()
	Enables the file upload into this object by dropping files. More...
	handleAutoRating (ilObject $a_new_obj)
	Activate rating automatically if parent container setting. More...

Protected Attributes
	$nav_history
	$tabs
	$help
	$rbacsystem
	$log
Protected Attributes inherited from ilObjectGUI
	$ilErr
	$locator
	$user
	$access
	$settings
	$rbacreview
	$toolbar
	$tmp_import_dir
	$tabs_gui = null
	$ctrl
	$object_service

Additional Inherited Members
Data Fields inherited from ilObjectGUI
const	COPY_WIZARD_NEEDS_PAGE = 1
	$objDefinition
	$tpl
	$tree
	$lng
	$data
	$object
	$ref_id
	$obj_id
	$maxcount
	$formaction
	$return_location
	$target_frame
	$tab_target_script
	$actions
	$sub_objects
	$omit_locator = false
const	CFORM_NEW = 1
const	CFORM_IMPORT = 2
const	CFORM_CLONE = 3

Detailed Description

Class ilObjSurveyGUI.

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$

ilObjSurveyGUI: ilSurveyEvaluationGUI, ilSurveyExecutionGUI ilObjSurveyGUI: ilObjectMetaDataGUI, ilPermissionGUI ilObjSurveyGUI: ilInfoScreenGUI, ilObjectCopyGUI ilObjSurveyGUI: ilSurveySkillDeterminationGUI ilObjSurveyGUI: ilCommonActionDispatcherGUI, ilSurveySkillGUI ilObjSurveyGUI: ilSurveyEditorGUI, ilSurveyConstraintsGUI ilObjSurveyGUI: ilSurveyParticipantsGUI, ilLearningProgressGUI ilObjSurveyGUI: ilExportGUI, ilLTIProviderObjectSettingGUI

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

Constructor & Destructor Documentation

__construct()

ilObjSurveyGUI::__construct

(

)

Definition at line 51 of file class.ilObjSurveyGUI.php.

References $_GET, $DIC, $ilCtrl, ilObjectGUI\$lng, ilLoggerFactory\getLogger(), and user().

    {
        global $DIC;

        $this->lng = $DIC->language();
        $this->nav_history = $DIC["ilNavigationHistory"];
        $this->tabs = $DIC->tabs();
        $this->user = $DIC->user();
        $this->help = $DIC["ilHelp"];
        $this->rbacsystem = $DIC->rbac()->system();
        $this->tree = $DIC->repositoryTree();
        $this->tpl = $DIC["tpl"];
        $this->toolbar = $DIC->toolbar();
        $this->access = $DIC->access();
        $this->locator = $DIC["ilLocator"];
        $lng = $DIC->language();
        $ilCtrl = $DIC->ctrl();

        $this->type = "svy";
        $lng->loadLanguageModule("survey");
        $lng->loadLanguageModule("svy");
        $this->ctrl = $ilCtrl;
        $this->ctrl->saveParameter($this, "ref_id");

        $this->log = ilLoggerFactory::getLogger("svy");

        parent::__construct("", (int) $_GET["ref_id"], true, false);
    }

Here is the call graph for this function:

Member Function Documentation

_goto()

static ilObjSurveyGUI::_goto (   $a_target,   $a_access_code = ""  )

static

redirect script

Parameters

string

$a_target

Definition at line 2025 of file class.ilObjSurveyGUI.php.

References $_GET, $_SESSION, $DIC, ilObjectGUI\$lng, ilObjectGUI\_gotoRepositoryRoot(), ilObject\_lookupObjId(), ilObject\_lookupTitle(), exit, and ilUtil\sendFailure().

    {
        global $DIC;

        $ilAccess = $DIC->access();
        $lng = $DIC->language();
        
        // see ilObjSurveyAccess::_checkGoto()
        if (strlen($a_access_code)) {
            $_SESSION["anonymous_id"][ilObject::_lookupObjId($a_target)] = $a_access_code;
            $_GET["baseClass"] = "ilObjSurveyGUI";
            $_GET["cmd"] = "infoScreen";
            $_GET["ref_id"] = $a_target;
            include("ilias.php");
            exit;
        }
        
        if ($ilAccess->checkAccess("visible", "", $a_target) ||
            $ilAccess->checkAccess("read", "", $a_target)) {
            $_GET["baseClass"] = "ilObjSurveyGUI";
            $_GET["cmd"] = "infoScreen";
            $_GET["ref_id"] = $a_target;
            include("ilias.php");
            exit;
        } elseif ($ilAccess->checkAccess("read", "", ROOT_FOLDER_ID)) {
            ilUtil::sendFailure(sprintf(
                $lng->txt("msg_no_perm_read_item"),
                ilObject::_lookupTitle(ilObject::_lookupObjId($a_target))
            ), true);
            ilObjectGUI::_gotoRepositoryRoot();
        }
    }

Here is the call graph for this function:

addDidacticTemplateOptions()

ilObjSurveyGUI::addDidacticTemplateOptions ( array &  $a_options )

protected

Definition at line 296 of file class.ilObjSurveyGUI.php.

References ilSettingsTemplate\getAllSettingsTemplates().

    {
        include_once "Services/Administration/classes/class.ilSettingsTemplate.php";
        $templates = ilSettingsTemplate::getAllSettingsTemplates("svy");
        if ($templates) {
            foreach ($templates as $item) {
                $a_options["svytpl_" . $item["id"]] = array($item["title"],
                    nl2br(trim($item["description"])));
            }
        }
        
        // JF, 2013-06-10
        $a_options["svy360_1"] = array($this->lng->txt("survey_360_mode"),
            $this->lng->txt("survey_360_mode_info"));

        //Self evaluation only
        $a_options["svyselfeval_1"] = array($this->lng->txt("svy_self_ev_mode"),
            $this->lng->txt("svy_self_ev_info"));
    }

Here is the call graph for this function:

addLocatorItems()

ilObjSurveyGUI::addLocatorItems

(

)

Definition at line 1972 of file class.ilObjSurveyGUI.php.

References $_GET, ilObjectGUI\$locator, SurveyQuestion\_getQuestionType(), and SurveyQuestion\_getTitle().

    {
        $ilLocator = $this->locator;
        switch ($this->ctrl->getCmd()) {
            case "next":
            case "previous":
            case "start":
            case "resume":
            case "redirectQuestion":
                $ilLocator->addItem($this->object->getTitle(), $this->ctrl->getLinkTarget($this, "infoScreen"), "", $_GET["ref_id"]);
                break;
            case "evaluation":
            case "checkEvaluationAccess":
            case "evaluationdetails":
            case "evaluationuser":
                $ilLocator->addItem($this->object->getTitle(), $this->ctrl->getLinkTargetByClass("ilsurveyevaluationgui", "evaluation"), "", $_GET["ref_id"]);
                break;
            case "create":
            case "save":
            case "cancel":
            case "importSurvey":
            case "cloneAll":
                break;
            case "infoScreen":
                $ilLocator->addItem($this->object->getTitle(), $this->ctrl->getLinkTarget($this, "infoScreen"), "", $_GET["ref_id"]);
                break;
        default:
                $ilLocator->addItem($this->object->getTitle(), $this->ctrl->getLinkTarget($this, "infoScreen"), "", $_GET["ref_id"]);
                        
                // this has to be done here because ilSurveyEditorGUI is called after finalizing the locator
                if ((int) $_GET["q_id"] && !(int) $_REQUEST["new_for_survey"]) {
                    // not on create
                    // see ilObjSurveyQuestionPool::addLocatorItems
                    $q_id = (int) $_GET["q_id"];
                    include_once "./Modules/SurveyQuestionPool/classes/class.SurveyQuestion.php";
                    $q_type = SurveyQuestion::_getQuestionType($q_id) . "GUI";
                    $this->ctrl->setParameterByClass($q_type, "q_id", $q_id);
                    $ilLocator->addItem(
                        SurveyQuestion::_getTitle($q_id),
                        $this->ctrl->getLinkTargetByClass(array("ilSurveyEditorGUI", $q_type), "editQuestion")
                    );
                }
                break;
        }
    }

Here is the call graph for this function:

addSubTabs()

ilObjSurveyGUI::addSubTabs

(

$a_section

)

Add subtabs for tabs.

Parameters

type

$a_section

Definition at line 1400 of file class.ilObjSurveyGUI.php.

Referenced by executeCommand(), and propertiesObject().

    {
        if ($a_section == 'settings') {
            $this->tabs_gui->addSubTabTarget(
                "settings",
                $this->ctrl->getLinkTarget($this, 'properties')
            );
            
            $lti_settings = new ilLTIProviderObjectSettingGUI($this->object->getRefId());
            if ($lti_settings->hasSettingsAccess()) {
                $this->tabs_gui->addSubTabTarget(
                    'lti_provider',
                    $this->ctrl->getLinkTargetByClass(ilLTIProviderObjectSettingGUI::class)
                );
            }
        }
    }

Here is the caller graph for this function:

afterSave()

ilObjSurveyGUI::afterSave

(

ilObject

$a_new_object

)

save object public

Definition at line 320 of file class.ilObjSurveyGUI.php.

References ilObjectGUI\$tpl, ilObjSurvey\ANONYMIZE_CODE_ALL, ilObjSurvey\EVALUATION_ACCESS_PARTICIPANTS, ilObjectGUI\getDidacticTemplateVar(), ilObject\getRefId(), ilObjSurvey\MODE_360, ilObjSurvey\MODE_SELF_EVAL, and ilUtil\redirect().

    {
        // #16446
        $a_new_object->loadFromDb();
        
        $tpl = $this->getDidacticTemplateVar("svytpl");
        if ($tpl) {
            $a_new_object->applySettingsTemplate($tpl);
        } else {
            //set the mode depending on didactic template
            if ($this->getDidacticTemplateVar("svy360")) {
                $a_new_object->setMode(ilObjSurvey::MODE_360);
            } elseif ($this->getDidacticTemplateVar("svyselfeval")) {
                $a_new_object->setMode(ilObjSurvey::MODE_SELF_EVAL);
            }
        }

        $svy_mode = $a_new_object->getMode();
        if ($svy_mode == ilObjSurvey::MODE_360) {
            // this should rather be ilObjSurvey::ANONYMIZE_ON - see ilObjSurvey::getUserDataFromActiveId()
            $a_new_object->setAnonymize(ilObjSurvey::ANONYMIZE_CODE_ALL);
            $a_new_object->setEvaluationAccess(ilObjSurvey::EVALUATION_ACCESS_PARTICIPANTS);
        } elseif ($svy_mode == ilObjSurvey::MODE_SELF_EVAL) {
            $a_new_object->setEvaluationAccess(ilObjSurvey::EVALUATION_ACCESS_PARTICIPANTS);
        }
        $a_new_object->saveToDB();

        // always send a message
        ilUtil::sendSuccess($this->lng->txt("object_added"), true);
        ilUtil::redirect("ilias.php?baseClass=ilObjSurveyGUI&ref_id=" .
            $a_new_object->getRefId() . "&cmd=properties");
    }

Here is the call graph for this function:

checkRbacOrPositionPermission()

ilObjSurveyGUI::checkRbacOrPositionPermission (   $a_rbac_permission,   $a_position_permission  )

protected

Check rbac or position permission.

Parameters

string	$a_rbac_permission
string	$a_position_permission

Returns

bool

Definition at line 2296 of file class.ilObjSurveyGUI.php.

References ilObjectGUI\$access, and $GLOBALS.

Referenced by executeCommand(), and getTabs().

    {
        $access = $GLOBALS['DIC']->access();
        return $access->checkRbacOrPositionPermissionAccess(
            $a_rbac_permission,
            $a_position_permission,
            $this->object->getRefId()
        );
    }

Here is the caller graph for this function:

confirmResetTemplateObject()

ilObjSurveyGUI::confirmResetTemplateObject

(

)

Enable all settings - Confirmation.

Definition at line 1482 of file class.ilObjSurveyGUI.php.

References ilUtil\sendQuestion().

    {
        ilUtil::sendQuestion($this->lng->txt("survey_confirm_template_reset"));
        $this->tpl->addBlockFile("ADM_CONTENT", "adm_content", "tpl.il_svy_svy_confirm_resettemplate.html", "Modules/Survey");
        $this->tpl->setCurrentBlock("adm_content");
        $this->tpl->setVariable("BTN_CONFIRM_REMOVE", $this->lng->txt("confirm"));
        $this->tpl->setVariable("BTN_CANCEL_REMOVE", $this->lng->txt("cancel"));
        $this->tpl->setVariable("FORM_ACTION", $this->ctrl->getFormAction($this, "resetTemplateObject"));
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

doAutoCompleteObject()

ilObjSurveyGUI::doAutoCompleteObject

(

)

Definition at line 1460 of file class.ilObjSurveyGUI.php.

References exit, ilUserAutoComplete\MAX_ENTRIES, and ilUtil\stripSlashes().

    {
        $fields = array('login','firstname','lastname','email');
                
        include_once './Services/User/classes/class.ilUserAutoComplete.php';
        $auto = new ilUserAutoComplete();
        $auto->setSearchFields($fields);
        $auto->setResultField('login');
        $auto->enableFieldSearchableCheck(true);
        $auto->setMoreLinkAvailable(true);

        if (($_REQUEST['fetchall'])) {
            $auto->setLimit(ilUserAutoComplete::MAX_ENTRIES);
        }

        echo $auto->getList(ilUtil::stripSlashes($_REQUEST['term']));
        exit();
    }

Here is the call graph for this function:

evaluationObject()

ilObjSurveyGUI::evaluationObject

(

)

Redirects the evaluation object call to the ilSurveyEvaluationGUI class.

Coming from ListGUI...

private

Definition at line 288 of file class.ilObjSurveyGUI.php.

    {
        include_once("./Modules/Survey/classes/class.ilSurveyEvaluationGUI.php");
        $eval_gui = new ilSurveyEvaluationGUI($this->object);
        $this->ctrl->setCmdClass(get_class($eval_gui));
        $this->ctrl->redirect($eval_gui, "evaluation");
    }

executeCommand()

ilObjSurveyGUI::executeCommand

(

)

Definition at line 80 of file class.ilObjSurveyGUI.php.

References $_GET, $_SESSION, $GLOBALS, $info, $nav_history, $tabs, ilObjectGUI\addHeaderAction(), addSubTabs(), ilObjectGUI\checkPermission(), ilObjectGUI\checkPermissionBool(), checkRbacOrPositionPermission(), ilObjectGUI\getCreationMode(), ilCommonActionDispatcherGUI\getInstanceFromAjaxCall(), ilUtil\getStyleSheetLocation(), infoScreen(), ilLearningProgressBaseGUI\LP_CONTEXT_REPOSITORY, ilObjSurvey\MODE_SELF_EVAL, ilObjSurvey\MODE_STANDARD, ilObjectGUI\prepareOutput(), ilLTIProviderObjectSettingGUI\setCustomRolesForSelection(), and ilObjSurvey\validateExternalRaterCode().

    {
        $ilNavigationHistory = $this->nav_history;
        $ilTabs = $this->tabs;

        $this->external_rater_360 = false;
        if (!$this->creation_mode &&
            $this->object->get360Mode() &&
            $_SESSION["anonymous_id"][$this->object->getId()] &&
            ilObjSurvey::validateExternalRaterCode(
                $this->object->getRefId(),
                $_SESSION["anonymous_id"][$this->object->getId()]
            )) {
            $this->external_rater_360 = true;
        }
        
        if (!$this->external_rater_360) {
            if (!$this->checkPermissionBool("visible") &&
                !$this->checkPermissionBool("read")) {
                $this->checkPermission("read");
            }

            // add entry to navigation history
            if (!$this->getCreationMode() &&
                $this->checkPermissionBool("read")) {
                $this->ctrl->setParameterByClass("ilobjsurveygui", "ref_id", $this->ref_id);
                $link = $this->ctrl->getLinkTargetByClass("ilobjsurveygui", "");
                $ilNavigationHistory->addItem($this->ref_id, $link, "svy");
            }
        }

        $cmd = $this->ctrl->getCmd("properties");
        
        // workaround for bug #6288, needs better solution
        if ($cmd == "saveTags") {
            $this->ctrl->setCmdClass("ilinfoscreengui");
        }
        
        // deep link from repository - "redirect" to page view
        if (!$this->ctrl->getCmdClass() && $cmd == "questionsrepo") {
            $_REQUEST["pgov"] = 1;
            $this->ctrl->setCmd("questions");
            $this->ctrl->setCmdClass("ilsurveyeditorgui");
        }
        
        $next_class = $this->ctrl->getNextClass($this);
        $this->ctrl->setReturn($this, "properties");
        $this->tpl->addCss(ilUtil::getStyleSheetLocation("output", "survey.css", "Modules/Survey"), "screen");
        $this->prepareOutput();

        $this->log->debug("next_class= $next_class");
        switch ($next_class) {
            case 'illtiproviderobjectsettinggui':
                $this->addSubTabs('settings');
                $ilTabs->activateTab("settings");
                $ilTabs->activateSubTab('lti_provider');
                $lti_gui = new ilLTIProviderObjectSettingGUI($this->object->getRefId());
                $lti_gui->setCustomRolesForSelection($GLOBALS['DIC']->rbac()->review()->getLocalRoles($this->object->getRefId()));
                $lti_gui->offerLTIRolesForSelection(false);
                $this->ctrl->forwardCommand($lti_gui);
                break;
            
            
            case "ilinfoscreengui":
                if (!in_array(
                    $this->ctrl->getCmdClass(),
                    array('ilpublicuserprofilegui', 'ilobjportfoliogui')
                )) {
                    $this->addHeaderAction();
                    $this->infoScreen(); // forwards command
                } else {
                    // #16891
                    $ilTabs->clearTargets();
                    include_once("./Services/InfoScreen/classes/class.ilInfoScreenGUI.php");
                    $info = new ilInfoScreenGUI($this);
                    $this->ctrl->forwardCommand($info);
                }
                break;
            
            case 'ilobjectmetadatagui':
                $this->checkPermission("write");
                $ilTabs->activateTab("meta_data");
                $this->addHeaderAction();
                include_once 'Services/Object/classes/class.ilObjectMetaDataGUI.php';
                $md_gui = new ilObjectMetaDataGUI($this->object);
                $this->ctrl->forwardCommand($md_gui);
                break;
            
            case "ilsurveyevaluationgui":
                $ilTabs->activateTab("svy_results");
                $this->addHeaderAction();
                include_once("./Modules/Survey/classes/class.ilSurveyEvaluationGUI.php");
                $eval_gui = new ilSurveyEvaluationGUI($this->object);
                $this->ctrl->forwardCommand($eval_gui);
                break;

            case "ilsurveyexecutiongui":
                $ilTabs->clearTargets();
                include_once("./Modules/Survey/classes/class.ilSurveyExecutionGUI.php");
                $exec_gui = new ilSurveyExecutionGUI($this->object);
                $this->ctrl->forwardCommand($exec_gui);
                break;
                
            case 'ilpermissiongui':
                $ilTabs->activateTab("perm_settings");
                $this->addHeaderAction();
                include_once("Services/AccessControl/classes/class.ilPermissionGUI.php");
                $perm_gui = new ilPermissionGUI($this);
                $this->ctrl->forwardCommand($perm_gui);
                break;
                
            case 'ilobjectcopygui':
                include_once './Services/Object/classes/class.ilObjectCopyGUI.php';
                $cp = new ilObjectCopyGUI($this);
                $cp->setType('svy');
                $this->ctrl->forwardCommand($cp);
                break;

            case "ilcommonactiondispatchergui":
                include_once("Services/Object/classes/class.ilCommonActionDispatcherGUI.php");
                $gui = ilCommonActionDispatcherGUI::getInstanceFromAjaxCall();
                $this->ctrl->forwardCommand($gui);
                break;
                
            // 360, skill service
            case 'ilsurveyskillgui':
                $ilTabs->activateTab("survey_competences");
                include_once("./Modules/Survey/classes/class.ilSurveySkillGUI.php");
                $gui = new ilSurveySkillGUI($this->object);
                $this->ctrl->forwardCommand($gui);
                break;

            case 'ilsurveyskilldeterminationgui':
                $ilTabs->activateTab("maintenance");
                include_once("./Modules/Survey/classes/class.ilSurveySkillDeterminationGUI.php");
                $gui = new ilSurveySkillDeterminationGUI($this->object);
                $this->ctrl->forwardCommand($gui);
                break;
            
            case 'ilsurveyeditorgui':
                $this->checkPermission("write");
                $ilTabs->activateTab("survey_questions");
                include_once("./Modules/Survey/classes/class.ilSurveyEditorGUI.php");
                $gui = new ilSurveyEditorGUI($this);
                $this->ctrl->forwardCommand($gui);
                break;
            
            case 'ilsurveyconstraintsgui':
                $this->checkPermission("write");
                $ilTabs->activateTab("constraints");
                include_once("./Modules/Survey/classes/class.ilSurveyConstraintsGUI.php");
                $gui = new ilSurveyConstraintsGUI($this);
                $this->ctrl->forwardCommand($gui);
                break;
            
            case 'ilsurveyparticipantsgui':
                if ($this->object->getMode() == ilObjSurvey::MODE_STANDARD || $this->object->getMode() == ilObjSurvey::MODE_SELF_EVAL) {
                    $ilTabs->activateTab("maintenance");
                } else {
                    $ilTabs->activateTab("survey_360_appraisees");
                }
                include_once("./Modules/Survey/classes/class.ilSurveyParticipantsGUI.php");
                //$gui = new ilSurveyParticipantsGUI($this, $this->checkPermissionBool("write"));
                $gui = new ilSurveyParticipantsGUI($this, $this->checkRbacOrPositionPermission('read_results', 'access_results'));
                $this->ctrl->forwardCommand($gui);
                break;
                
            case "illearningprogressgui":
                $ilTabs->activateTab("learning_progress");
                include_once("./Services/Tracking/classes/class.ilLearningProgressGUI.php");
                $new_gui = new ilLearningProgressGUI(
                    ilLearningProgressBaseGUI::LP_CONTEXT_REPOSITORY,
                    $this->object->getRefId()
                );
                $this->ctrl->forwardCommand($new_gui);
                break;
            
            case 'ilexportgui':
                $ilTabs->activateTab("export");
                include_once("./Services/Export/classes/class.ilExportGUI.php");
                $exp_gui = new ilExportGUI($this);
                $exp_gui->addFormat("xml");
                $this->ctrl->forwardCommand($exp_gui);
                break;

            default:
                $this->addHeaderAction();
                $cmd .= "Object";

                $this->log->debug("Default cmd= $cmd");

                $this->$cmd();
                break;
        }

        if (strtolower($_GET["baseClass"]) != "iladministrationgui" &&
            $this->getCreationMode() != true) {
            $this->tpl->show();
        }
    }

Here is the call graph for this function:

getTabs()

ilObjSurveyGUI::getTabs

(

)

adds tabs to tab gui object

Parameters

object

$tabs_gui

ilTabsGUI object

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

References $help, $ilUser, $template, ilObjectGUI\$user, ilObjSurveyAccess\_hasEvaluationAccess(), ilLearningProgressAccess\checkAccess(), ilObjectGUI\checkPermissionBool(), checkRbacOrPositionPermission(), ilObjSurvey\MODE_360, ilObjSurvey\MODE_SELF_EVAL, and ilObjSurvey\MODE_STANDARD.

    {
        $ilUser = $this->user;
        $ilHelp = $this->help;
        
        if ($this->object instanceof ilObjSurveyQuestionPool) {
            return true;
        }
        
        $ilHelp->setScreenIdComponent("svy");

        $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();
        }
        
        if ($this->checkPermissionBool("write")) {
            $this->tabs_gui->addTab(
                "survey_questions",
                $this->lng->txt("survey_questions"),
                $this->ctrl->getLinkTargetByClass(array("ilsurveyeditorgui", "ilsurveypagegui"), "renderPage")
            );
        }
        
        if ($this->checkPermissionBool("read")) {
            $this->tabs_gui->addTab(
                "info_short",
                $this->lng->txt("info_short"),
                $this->ctrl->getLinkTarget($this, 'infoScreen')
            );
        }
                            
        // properties
        if ($this->checkPermissionBool("write")) {
            $this->tabs_gui->addTab(
                "settings",
                $this->lng->txt("settings"),
                $this->ctrl->getLinkTarget($this, 'properties')
            );
        } elseif ($this->checkPermissionBool("read")) {
            if ($this->object->get360Mode() &&
                $this->object->get360SelfRaters() &&
                $this->object->isAppraisee($ilUser->getId()) &&
                !$this->object->isAppraiseeClosed($ilUser->getId())) {
                $this->tabs_gui->addTab(
                    "survey_360_edit_raters",
                    $this->lng->txt("survey_360_edit_raters"),
                    $this->ctrl->getLinkTargetByClass('ilsurveyparticipantsgui', 'editRaters')
                );
                
                // :TODO: mail to raters
            }
        }

        // questions
        if ($this->checkPermissionBool("write") &&
            !in_array("constraints", $hidden_tabs) &&
            $this->object->getMode() == ilObjSurvey::MODE_STANDARD) {
            // constraints (tab called routing)
            $this->tabs_gui->addTab(
                "constraints",
                $this->lng->txt("constraints"),
                $this->ctrl->getLinkTargetByClass("ilsurveyconstraintsgui", "constraints")
            );
        }

        if ($this->checkPermissionBool("write")) {
            switch ($this->object->getMode()) {
                case ilObjSurvey::MODE_360:
                    // 360 mode + competence service
                    include_once("./Services/Skill/classes/class.ilSkillManagementSettings.php");
                    $skmg_set = new ilSkillManagementSettings();
                    if ($this->object->getSkillService() && $skmg_set->isActivated()) {
                        $this->tabs_gui->addTab(
                            "survey_competences",
                            $this->lng->txt("survey_competences"),
                            $this->ctrl->getLinkTargetByClass("ilsurveyskillgui", "listQuestionAssignment")
                        );
                    }
                    $this->tabs_gui->addTab(
                        "survey_360_appraisees",
                        $this->lng->txt("survey_360_appraisees"),
                        $this->ctrl->getLinkTargetByClass('ilsurveyparticipantsgui', 'listAppraisees')
                    );
                    break;

                case ilObjSurvey::MODE_SELF_EVAL:
                    include_once("./Services/Skill/classes/class.ilSkillManagementSettings.php");
                    $skmg_set = new ilSkillManagementSettings();
                    if ($this->object->getSkillService() && $skmg_set->isActivated()) {
                        $this->tabs_gui->addTab(
                            "survey_competences",
                            $this->lng->txt("survey_competences"),
                            $this->ctrl->getLinkTargetByClass("ilsurveyskillgui", "listQuestionAssignment")
                        );
                    }
                    $this->tabs_gui->addTab(
                        "maintenance",
                        $this->lng->txt("maintenance"),
                        $this->ctrl->getLinkTargetByClass('ilsurveyparticipantsgui', 'maintenance')
                    );
                    break;

                default:
                    // maintenance (tab called participants)
                    $this->tabs_gui->addTab(
                        "maintenance",
                        $this->lng->txt("maintenance"),
                        $this->ctrl->getLinkTargetByClass('ilsurveyparticipantsgui', 'maintenance')
                    );
                    break;
            }
        }

        include_once "./Modules/Survey/classes/class.ilObjSurveyAccess.php";
        if (
            $this->checkRbacOrPositionPermission('read_results', 'access_results') ||
            ilObjSurveyAccess::_hasEvaluationAccess($this->object->getId(), $ilUser->getId())) {
            // evaluation
            $this->tabs_gui->addTab(
                "svy_results",
                $this->lng->txt("svy_results"),
                $this->ctrl->getLinkTargetByClass("ilsurveyevaluationgui", "evaluation")
            );
        }
        
        // learning progress
        include_once "./Services/Tracking/classes/class.ilLearningProgressAccess.php";
        if (ilLearningProgressAccess::checkAccess($this->object->getRefId())) {
            $this->tabs_gui->addTarget(
                "learning_progress",
                $this->ctrl->getLinkTargetByClass(array("ilobjsurveygui", "illearningprogressgui"), ""),
                "",
                array("illplistofobjectsgui", "illplistofsettingsgui", "illearningprogressgui", "illplistofprogressgui")
            );
        }

        if ($this->checkPermissionBool("write")) {
            if (!in_array("meta_data", $hidden_tabs)) {
                // meta data
                include_once "Services/Object/classes/class.ilObjectMetaDataGUI.php";
                $mdgui = new ilObjectMetaDataGUI($this->object);
                $mdtab = $mdgui->getTab();
                if ($mdtab) {
                    $this->tabs_gui->addTab(
                        "meta_data",
                        $this->lng->txt("meta_data"),
                        $mdtab
                    );
                }
            }

            if (!in_array("export", $hidden_tabs)) {
                // export
                $this->tabs_gui->addTab(
                    "export",
                    $this->lng->txt("export"),
                    $this->ctrl->getLinkTargetByClass("ilexportgui", "")
                );
            }
        }

        if ($this->checkPermissionBool("edit_permission")) {
            // permissions
            $this->tabs_gui->addTab(
                "perm_settings",
                $this->lng->txt("perm_settings"),
                $this->ctrl->getLinkTargetByClass(array(get_class($this),'ilpermissiongui'), "perm")
            );
        }
    }

Here is the call graph for this function:

getUserResultsPlain()

ilObjSurveyGUI::getUserResultsPlain (   $a_active_id )

protected

Definition at line 2129 of file class.ilObjSurveyGUI.php.

References $res, $text, and $type.

Referenced by sendUserResultsMail().

    {
        $res = array();
        
        $show_titles = (bool) $this->object->getShowQuestionTitles();
        
        foreach ($this->object->getSurveyPages() as $page) {
            if (count($page) > 0) {
                $res[] = "\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n";
                
                // question block
                if (count($page) > 1) {
                    if ((bool) $page[0]["questionblock_show_blocktitle"]) {
                        $res[$this->lng->txt("questionblock")] = trim($page[0]["questionblock_title"]) . "\n";
                    }
                }
                
                // questions
                
                $page_res = array();
                
                foreach ($page as $question) {
                    $question_gui = $this->object->getQuestionGUI($question["type_tag"], $question["question_id"]);
                    if (is_object($question_gui)) {
                        $question_parts = array();
                        
                        // heading
                        if (strlen($question["heading"])) {
                            $question_parts[$this->lng->txt("heading")] = trim($question["heading"]);
                        }
                        
                        if ($show_titles) {
                            $question_parts[$this->lng->txt("title")] = trim($question["title"]);
                        }
                        
                        if ((bool) $question["questionblock_show_questiontext"]) {
                            $question_parts[$this->lng->txt("question")] = trim(strip_tags($question_gui->object->getQuestionText()));
                        }
                        
                        $answers = $question_gui->getParsedAnswers(
                            $this->object->loadWorkingData($question["question_id"], $a_active_id),
                            true
                        );
                        
                        if (sizeof($answers)) {
                            $multiline = false;
                            if (sizeof($answers) > 1 ||
                                get_class($question_gui) == "SurveyTextQuestionGUI") {
                                $multiline = true;
                            }
                            
                            $parts = array();
                            foreach ($answers as $answer) {
                                $text = null;
                                if ($answer["textanswer"]) {
                                    $text = ' ("' . $answer["textanswer"] . '")';
                                }
                                if (!isset($answer["cols"])) {
                                    if (isset($answer["title"])) {
                                        $parts[] = $answer["title"] . $text;
                                    } elseif (isset($answer["value"])) {
                                        $parts[] = $answer["value"];
                                    } elseif ($text) {
                                        $parts[] = substr($text, 2, -1);
                                    }
                                }
                                // matrix
                                else {
                                    $tmp = array();
                                    foreach ($answer["cols"] as $col) {
                                        $tmp[] = $col["title"];
                                    }
                                    $parts[] = $answer["title"] . ": " . implode(", ", $tmp) . $text;
                                }
                            }
                            $question_parts[$this->lng->txt("answer")] =
                                ($multiline ? "\n" : "") . implode("\n", $parts);
                        }
                        
                        $tmp = array();
                        foreach ($question_parts as $type => $value) {
                            $tmp[] = $type . ": " . $value;
                        }
                        $page_res[] = implode("\n", $tmp);
                    }
                }
                
                $res[] = implode("\n\n-------------------------------\n\n", $page_res);
            }
        }
        
        $res[] = "\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n";
        
        return implode("\n", $res);
    }

Here is the caller graph for this function:

getUserResultsTable()

ilObjSurveyGUI::getUserResultsTable

(

$a_active_id

)

Definition at line 2058 of file class.ilObjSurveyGUI.php.

Referenced by viewUserResultsObject().

    {
        $rtpl = new ilTemplate("tpl.svy_view_user_results.html", true, true, "Modules/Survey");
        
        $show_titles = (bool) $this->object->getShowQuestionTitles();
        
        foreach ($this->object->getSurveyPages() as $page) {
            if (count($page) > 0) {
                // question block
                if (count($page) > 1) {
                    if ((bool) $page[0]["questionblock_show_blocktitle"]) {
                        $rtpl->setVariable("BLOCK_TITLE", trim($page[0]["questionblock_title"]));
                    }
                }
                
                // questions
                foreach ($page as $question) {
                    $question_gui = $this->object->getQuestionGUI($question["type_tag"], $question["question_id"]);
                    if (is_object($question_gui)) {
                        $rtpl->setCurrentBlock("question_bl");
                        
                        // heading
                        if (strlen($question["heading"])) {
                            $rtpl->setVariable("HEADING", trim($question["heading"]));
                        }
                        
                        $rtpl->setVariable(
                            "QUESTION_DATA",
                            $question_gui->getPrintView(
                                $show_titles,
                                (bool) $question["questionblock_show_questiontext"],
                                $this->object->getId(),
                                $this->object->loadWorkingData($question["question_id"], $a_active_id)
                            )
                        );
                        
                        $rtpl->parseCurrentBlock();
                    }
                }
                
                $rtpl->setCurrentBlock("block_bl");
                $rtpl->parseCurrentBlock();
            }
        }
        
        return $rtpl->get();
    }

Here is the caller graph for this function:

importSurveyObject()

ilObjSurveyGUI::importSurveyObject

(

)

form for new survey object import

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

References $_GET, $form, ilObjectGUI\$tpl, ilObjectGUI\checkPermission(), ilSettingsTemplate\getAllSettingsTemplates(), initImportForm(), ilObjectGUI\putObjectInTree(), ilUtil\redirect(), and ilUtil\sendFailure().

    {
        $tpl = $this->tpl;

        $parent_id = $_GET["ref_id"];
        $new_type = $_REQUEST["new_type"];

        // create permission is already checked in createObject. This check here is done to prevent hacking attempts
        $this->checkPermission("create", "", $new_type);

        $this->lng->loadLanguageModule($new_type);
        $this->ctrl->setParameter($this, "new_type", $new_type);

        $form = $this->initImportForm($new_type);
        if ($form->checkInput()) {
            include_once("./Modules/Survey/classes/class.ilObjSurvey.php");
            $newObj = new ilObjSurvey();
            $newObj->setType($new_type);
            $newObj->setTitle("dummy");
            $newObj->create(true);
            $this->putObjectInTree($newObj);

            // copy uploaded file to import directory

            $this->log->debug("form->getInput(spl) = " . $form->getInput("spl"));

            $error = $newObj->importObject($_FILES["importfile"], $form->getInput("spl"));
            if (strlen($error)) {
                $newObj->delete();
                ilUtil::sendFailure($error);
                return;
            }

            ilUtil::sendSuccess($this->lng->txt("object_imported"), true);
            ilUtil::redirect("ilias.php?ref_id=" . $newObj->getRefId() .
                "&baseClass=ilObjSurveyGUI");

            // using template?
            include_once "Services/Administration/classes/class.ilSettingsTemplate.php";
            $templates = ilSettingsTemplate::getAllSettingsTemplates("svy");
            if ($templates) {
                $tpl = $this->tpl;
                $tpl->addJavaScript("./Modules/Scorm2004/scripts/questions/jquery.js");
                // $tpl->addJavaScript("./Modules/Scorm2004/scripts/questions/jquery-ui-min.js");

                $this->tpl->setCurrentBlock("template_option");
                $this->tpl->setVariable("VAL_TEMPLATE_OPTION", "");
                $this->tpl->setVariable("TXT_TEMPLATE_OPTION", $this->lng->txt("none"));
                $this->tpl->parseCurrentBlock();

                foreach ($templates as $item) {
                    $this->tpl->setCurrentBlock("template_option");
                    $this->tpl->setVariable("VAL_TEMPLATE_OPTION", $item["id"]);
                    $this->tpl->setVariable("TXT_TEMPLATE_OPTION", $item["title"]);
                    $this->tpl->parseCurrentBlock();

                    $desc = str_replace("\n", "", nl2br($item["description"]));
                    $desc = str_replace("\r", "", $desc);

                    $this->tpl->setCurrentBlock("js_data");
                    $this->tpl->setVariable("JS_DATA_ID", $item["id"]);
                    $this->tpl->setVariable("JS_DATA_TEXT", $desc);
                    $this->tpl->parseCurrentBlock();
                }

                $this->tpl->setCurrentBlock("templates");
                $this->tpl->setVariable("TXT_TEMPLATE", $this->lng->txt("svy_settings_template"));
                $this->tpl->parseCurrentBlock();
            }
        }
        
        // display form to correct errors
        $form->setValuesByPost();
        $tpl->setContent($form->getHtml());
    }

Here is the call graph for this function:

infoScreen()

ilObjSurveyGUI::infoScreen

(

)

show information screen

Definition at line 1639 of file class.ilObjSurveyGUI.php.

References $_POST, $_SESSION, ilObjectGUI\$access, $ilUser, $info, $list, $tabs, ilObjectGUI\$toolbar, $txt, ilObjectGUI\$user, ilObjSurveyAccess\_hasEvaluationAccess(), ilObjectGUI\checkPermission(), ilObjectGUI\checkPermissionBool(), ilDatePresentation\formatDate(), ilSubmitButton\getInstance(), ilLinkButton\getInstance(), ilUserUtil\getNamePresentation(), IL_CAL_UNIX, ilUtil\sendFailure(), ilUtil\sendInfo(), ilTextInputGUI\setSize(), and ilDatePresentation\setUseRelativeDates().

Referenced by executeCommand(), and infoScreenObject().

    {
        $ilTabs = $this->tabs;
        $ilUser = $this->user;
        $ilToolbar = $this->toolbar;
        $ilAccess = $this->access;
        
        if (!$this->external_rater_360) {
            if (!$this->checkPermissionBool("read")) {
                $this->checkPermission("visible");
            }
        }
        
        $ilTabs->activateTab("info_short");
        
        include_once "./Modules/Survey/classes/class.ilSurveyExecutionGUI.php";
        $output_gui = new ilSurveyExecutionGUI($this->object);
        
        include_once("./Services/InfoScreen/classes/class.ilInfoScreenGUI.php");
        $info = new ilInfoScreenGUI($this);
        $info->enablePrivateNotes();
        
        
        $is_appraisee = false;
        
        // 360° - appraisee infos
        if ($this->object->get360Mode() &&
            $this->object->isAppraisee($ilUser->getId())) {
            $is_appraisee = true;

            $info->addSection($this->lng->txt("survey_360_appraisee_info"));

            $appr_data = $this->object->getAppraiseesData();
            $appr_data = $appr_data[$ilUser->getId()];
            $info->addProperty($this->lng->txt("survey_360_raters_status_info"), $appr_data["finished"]);

            if (!$appr_data["closed"]) {
                include_once "Services/UIComponent/Button/classes/class.ilLinkButton.php";
                $button = ilLinkButton::getInstance();
                $button->setCaption("survey_360_appraisee_close_action");
                $button->setUrl($this->ctrl->getLinkTargetByClass("ilsurveyparticipantsgui", "confirmappraiseeclose"));
                $close_button_360 = '<div>' . $button->render() . '</div>';

                $txt = "survey_360_appraisee_close_action_info";
                if ($this->object->getSkillService()) {
                    $txt .= "_skill";
                }
                $info->addProperty(
                    $this->lng->txt("status"),
                    $close_button_360 . $this->lng->txt($txt)
                );
            } else {
                ilDatePresentation::setUseRelativeDates(false);

                $dt = new ilDateTime($appr_data["closed"], IL_CAL_UNIX);
                $info->addProperty(
                    $this->lng->txt("status"),
                    sprintf(
                        $this->lng->txt("survey_360_appraisee_close_action_status"),
                        ilDatePresentation::formatDate($dt)
                    )
                );
            }
        }
        
        
        // handle (anonymous) code

        // validate incoming
        $code_input = false;
        $anonymous_code = $_POST["anonymous_id"];
        if ($anonymous_code) {
            $code_input = true;
            // if(!$this->object->isUnusedCode($anonymous_code, $ilUser->getId()))
            if (!$this->object->checkSurveyCode($anonymous_code)) { // #15031 - valid as long survey is not finished
                $anonymous_code = null;
            } else {
                // #15860
                $this->object->bindSurveyCodeToUser($ilUser->getId(), $anonymous_code);
            }
        }
        if ($anonymous_code) {
            $_SESSION["anonymous_id"][$this->object->getId()] = $anonymous_code;
        } else {
            $anonymous_code = $_SESSION["anonymous_id"][$this->object->getId()];
            if ($anonymous_code) {
                $code_input = true;
            }
        }

        // try to find code for current (registered) user from existing run
        if ($this->object->getAnonymize() && !$anonymous_code) {
            $anonymous_code = $this->object->findCodeForUser($ilUser->getId());
        }

        // get existing runs for current user, might generate code
        $participant_status = $this->object->getUserSurveyExecutionStatus($anonymous_code);
        if ($participant_status) {
            $anonymous_code = $participant_status["code"];
            $participant_status = $participant_status["runs"];
        }

        // (final) check for proper anonymous code
        if (!$this->object->isAccessibleWithoutCode() &&
            !$is_appraisee &&
            $code_input && // #11346
            (!$anonymous_code || !$this->object->isAnonymousKey($anonymous_code))) {
            $anonymous_code = null;
            ilUtil::sendInfo($this->lng->txt("wrong_survey_code_used"));
        }

        // :TODO: really save in session?
        $_SESSION["anonymous_id"][$this->object->getId()] = $anonymous_code;

        $survey_started = $this->object->isSurveyStarted($ilUser->getId(), $anonymous_code);

        $showButtons = $big_button = false;

        // already finished?
        if (!$this->object->get360Mode() &&
                ($survey_started === 1 &&                                                                                       // survey finished
                !(!$this->object->isAccessibleWithoutCode() && !$anonymous_code && $ilUser->getId() == ANONYMOUS_USER_ID))) {   // not code accessible an no anonymous code and anonymous user (see #0020333)
            ilUtil::sendInfo($this->lng->txt("already_completed_survey"));
            
            if ($ilUser->getId() != ANONYMOUS_USER_ID) {
                if ($this->object->hasViewOwnResults()) {
                    include_once "Services/UIComponent/Button/classes/class.ilLinkButton.php";
                    $button = ilLinkButton::getInstance();
                    $button->setCaption("svy_view_own_results");
                    $button->setUrl($this->ctrl->getLinkTarget($this, "viewUserResults"));
                    $ilToolbar->addButtonInstance($button);
                }

                // see ilSurveyExecutionGUI
                if ($this->object->hasMailConfirmation()) {
                    if ($this->object->hasViewOwnResults()) {
                        $ilToolbar->addSeparator();
                    }

                    if ($ilUser->getId() == ANONYMOUS_USER_ID ||
                        !$ilUser->getEmail()) {
                        require_once "Services/Form/classes/class.ilTextInputGUI.php";
                        $mail = new ilTextInputGUI($this->lng->txt("email"), "mail");
                        $mail->setSize(25);
                        $mail->setValue($ilUser->getEmail());
                        $ilToolbar->addInputItem($mail, true);
                    }

                    $ilToolbar->setFormAction($this->ctrl->getFormAction($this, "mailUserResults"));

                    include_once "Services/UIComponent/Button/classes/class.ilSubmitButton.php";
                    $button = ilSubmitButton::getInstance();
                    $button->setCaption("svy_mail_send_confirmation");
                    $button->setCommand("mailUserResults");
                    $ilToolbar->addButtonInstance($button);
                }
            }
        } else {
            // "active" survey?
            $canStart = $this->object->canStartSurvey(null, $this->external_rater_360);

            $showButtons = $canStart["result"];
            if (!$showButtons) {
                if ($canStart["edit_settings"] &&
                    $ilAccess->checkAccess("write", "", $this->ref_id)) {
                    $canStart["messages"][] = "<a href=\"" . $this->ctrl->getLinkTarget($this, "properties") . "\">&raquo; " .
                        $this->lng->txt("survey_edit_settings") . "</a>";
                }
                ilUtil::sendInfo(implode("<br />", $canStart["messages"]));
            }
        }
        
        if ($showButtons) {
            // code is mandatory and not given yet
            if (!$is_appraisee &&
                !$anonymous_code &&
                !$this->object->isAccessibleWithoutCode()) {
                $info->setFormAction($this->ctrl->getFormAction($this, "infoScreen"));
                $info->addSection($this->lng->txt("anonymization"));
                $info->addProperty("", $this->lng->txt("anonymize_anonymous_introduction"));
                $info->addPropertyTextinput($this->lng->txt("enter_anonymous_id"), "anonymous_id", "", 8, "infoScreen", $this->lng->txt("submit"), true);
            } else {
                // trunk/default
                if (!$this->object->get360Mode()) {
                    if ($anonymous_code) {
                        $info->addHiddenElement("anonymous_id", $anonymous_code);
                    }
                    if ($survey_started === 0) {
                        $big_button = array("resume", $this->lng->txt("resume_survey"));
                    } elseif ($survey_started === false) {
                        $big_button = array("start", $this->lng->txt("start_survey"));
                    }
                }
                // 360°
                else {
                    $appr_ids = array();
                    
                    // use given code (if proper external one)
                    if ($anonymous_code) {
                        $anonymous_id = $this->object->getAnonymousIdByCode($anonymous_code);
                        if ($anonymous_id) {
                            $appr_ids = $this->object->getAppraiseesToRate(0, $anonymous_id);
                        }
                    }
                    
                    // registered user
                    // if an auto-code was generated, we still have to check for the original user id
                    if (!$appr_ids && $ilUser->getId() != ANONYMOUS_USER_ID) {
                        $appr_ids = $this->object->getAppraiseesToRate($ilUser->getId());
                    }
                    
                    if (sizeof($appr_ids)) {
                        // map existing runs to appraisees
                        $active_appraisees = array();
                        if ($participant_status) {
                            foreach ($participant_status as $item) {
                                $active_appraisees[$item["appr_id"]] = $item["finished"];
                            }
                        }
                        
                        $list = array();

                        foreach ($appr_ids as $appr_id) {
                            if ($this->object->isAppraiseeClosed($appr_id)) {
                                // closed
                                $list[$appr_id] = $this->lng->txt("survey_360_appraisee_is_closed");
                            } elseif (array_key_exists($appr_id, $active_appraisees)) {
                                // already done
                                if ($active_appraisees[$appr_id]) {
                                    $list[$appr_id] = $this->lng->txt("already_completed_survey");
                                }
                                // resume
                                else {
                                    $list[$appr_id] = array("resume", $this->lng->txt("resume_survey"));
                                }
                            } else {
                                // start
                                $list[$appr_id] = array("start", $this->lng->txt("start_survey"));
                            }
                        }

                        $info->addSection($this->lng->txt("survey_360_rate_other_appraisees"));
                        
                        include_once "Services/User/classes/class.ilUserUtil.php";
                        foreach ($list as $appr_id => $item) {
                            $appr_name = ilUserUtil::getNamePresentation($appr_id, false, false, "", true);
                            
                            if (!is_array($item)) {
                                $info->addProperty($appr_name, $item);
                            } else {
                                $this->ctrl->setParameter($output_gui, "appr_id", $appr_id);
                                $href = $this->ctrl->getLinkTarget($output_gui, $item[0]);
                                $this->ctrl->setParameter($output_gui, "appr_id", "");
                                
                                include_once "Services/UIComponent/Button/classes/class.ilLinkButton.php";
                                $button = ilLinkButton::getInstance();
                                $button->setCaption($item[1], false);
                                $button->setUrl($href);
                                $big_button_360 = '<div>' . $button->render() . '</div>';

                                $info->addProperty($appr_name, $big_button_360);
                            }
                        }
                    } elseif (!$is_appraisee) {
                        ilUtil::sendFailure($this->lng->txt("survey_360_no_appraisees"));
                    }
                }
            }
            
            if ($this->object->get360Mode() &&
                $this->object->get360SelfAppraisee() &&
                !$this->object->isAppraisee($ilUser->getId()) &&
                $ilUser->getId() != ANONYMOUS_USER_ID) { // #14968
                $link = $this->ctrl->getLinkTargetByClass("ilsurveyparticipantsgui", "addSelfAppraisee");
                $link = '<a href="' . $link . '">' . $this->lng->txt("survey_360_add_self_appraisee") . '</a>';
                $info->addProperty("&nbsp;", $link);
            }
        }
        
        if ($big_button) {
            $ilToolbar->setFormAction($this->ctrl->getFormAction($output_gui, "infoScreen"));
            
            include_once "Services/UIComponent/Button/classes/class.ilSubmitButton.php";
            $button = ilSubmitButton::getInstance();
            $button->setCaption($big_button[1], false);
            $button->setCommand($big_button[0]);
            $button->setPrimary(true);
            $ilToolbar->addButtonInstance($button);
            
            $ilToolbar->setCloseFormTag(false);
            $info->setOpenFormTag(false);
        }
        /* #12016
        else
        {
            $info->setFormAction($this->ctrl->getFormAction($output_gui, "infoScreen"));
        }
        */
        
        if (strlen($this->object->getIntroduction())) {
            $introduction = $this->object->getIntroduction();
            $info->addSection($this->lng->txt("introduction"));
            $info->addProperty("", $this->object->prepareTextareaOutput($introduction) .
                "<br />" . $info->getHiddenToggleButton());
        } else {
            $info->addSection("");
            $info->addProperty("", $info->getHiddenToggleButton());
        }

        $info->hideFurtherSections(false);
                        
        if (!$this->object->get360Mode()) {
            $info->addSection($this->lng->txt("svy_general_properties"));
            
            $info->addProperty(
                $this->lng->txt("survey_results_anonymization"),
                !$this->object->hasAnonymizedResults()
                    ? $this->lng->txt("survey_results_personalized_info")
                    : $this->lng->txt("survey_results_anonymized_info")
            );
                    
            include_once "./Modules/Survey/classes/class.ilObjSurveyAccess.php";
            if ($this->checkPermissionBool("write") ||
                ilObjSurveyAccess::_hasEvaluationAccess($this->object->getId(), $ilUser->getId())) {
                $info->addProperty($this->lng->txt("evaluation_access"), $this->lng->txt("evaluation_access_info"));
            }
        }
        
        $info->addMetaDataSections($this->object->getId(), 0, $this->object->getType());
        
        $this->ctrl->forwardCommand($info);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

infoScreenObject()

ilObjSurveyGUI::infoScreenObject

(

)

this one is called from the info button in the repository not very nice to set cmdClass/Cmd manually, if everything works through ilCtrl in the future this may be changed

Definition at line 1629 of file class.ilObjSurveyGUI.php.

References infoScreen().

    {
        $this->ctrl->setCmd("showSummary");
        $this->ctrl->setCmdClass("ilinfoscreengui");
        $this->infoScreen();
    }

Here is the call graph for this function:

initImportForm()

ilObjSurveyGUI::initImportForm (   $a_new_type )

protected

Definition at line 1511 of file class.ilObjSurveyGUI.php.

References $form, ilSelectInputGUI\setOptions(), and ilFileInputGUI\setSuffixes().

Referenced by importSurveyObject().

    {
        include_once("Services/Form/classes/class.ilPropertyFormGUI.php");
        $form = new ilPropertyFormGUI();
        $form->setTarget("_top");
        $form->setFormAction($this->ctrl->getFormAction($this));
        $form->setTitle($this->lng->txt("import_svy"));

        include_once("./Services/Form/classes/class.ilFileInputGUI.php");
        $fi = new ilFileInputGUI($this->lng->txt("import_file"), "importfile");
        $fi->setSuffixes(array("zip"));
        $fi->setRequired(true);
        $form->addItem($fi);

        include_once("./Modules/Survey/classes/class.ilObjSurvey.php");
        $svy = new ilObjSurvey();
        $questionspools = $svy->getAvailableQuestionpools(true, true, true);

        $pools = new ilSelectInputGUI($this->lng->txt("select_questionpool_short"), "spl");
        $pools->setOptions(array("" => $this->lng->txt("dont_use_questionpool")) + $questionspools);
        $pools->setRequired(false);
        $form->addItem($pools);

        $form->addCommandButton("importSurvey", $this->lng->txt("import"));
        $form->addCommandButton("cancel", $this->lng->txt("cancel"));

        return $form;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

initPropertiesForm()

ilObjSurveyGUI::initPropertiesForm

(

)

Init survey settings form.

Returns

ilPropertyFormGUI

Definition at line 805 of file class.ilObjSurveyGUI.php.

References $end, $form, $header, $id, $info, ilObjectGUI\$object_service, $results, $section, $start, $template, $title, ilObjectGUI\$tree, $txt, ilObject\_getAllReferences(), ilObjAdvancedEditing\_getUsedHTMLTags(), ilObjSurvey\_hasDatasets(), ilObjUser\_lookupName(), ilSubEnabledFormPropertyGUI\addSubItem(), ilObjSurvey\EVALUATION_ACCESS_ALL, ilObjSurvey\EVALUATION_ACCESS_OFF, ilObjSurvey\EVALUATION_ACCESS_PARTICIPANTS, ilMD\getGeneral(), ilOrgUnitGlobalSettings\getInstance(), IL_CAL_TIMESTAMP, IL_CAL_UNIX, ilObjectServiceSettingsGUI\initServiceSettingsForm(), ilObjSurvey\MODE_360, ilObjSurvey\MODE_SELF_EVAL, ilObjSurvey\NOTIFICATION_APPRAISEES, ilObjSurvey\NOTIFICATION_APPRAISEES_AND_RATERS, ilObjSurvey\NOTIFICATION_INVITED_USERS, ilObjSurvey\NOTIFICATION_PARENT_COURSE, ilObjSurvey\NOTIFICATION_RATERS, ilObjectServiceSettingsGUI\ORGU_POSITION_ACCESS, ilObjSurvey\RESULTS_360_ALL, ilObjSurvey\RESULTS_360_NONE, ilObjSurvey\RESULTS_360_OWN, ilObjSurvey\RESULTS_SELF_EVAL_ALL, ilObjSurvey\RESULTS_SELF_EVAL_NONE, ilObjSurvey\RESULTS_SELF_EVAL_OWN, ilCheckboxInputGUI\setChecked(), ilTextAreaInputGUI\setCols(), ilTextInputGUI\setDataSource(), ilDateTimeInputGUI\setDate(), ilRadioOption\setInfo(), ilFormPropertyGUI\setInfo(), ilCheckboxInputGUI\setOptionTitle(), ilFormPropertyGUI\setRequired(), ilDateTimeInputGUI\setShowTime(), ilDateDurationInputGUI\setShowTime(), ilTextInputGUI\setValue(), ilCheckboxInputGUI\setValue(), ilRadioGroupInputGUI\setValue(), ilNonEditableValueGUI\setValue(), and ilTextAreaInputGUI\setValue().

Referenced by propertiesObject(), and savePropertiesObject().

    {
        $obj_service = $this->object_service;

        $template_settings = $hide_rte_switch = null;
        $template = $this->object->getTemplate();
        if ($template) {
            include_once "Services/Administration/classes/class.ilSettingsTemplate.php";
            $template = new ilSettingsTemplate($template);

            $template_settings = $template->getSettings();
            $hide_rte_switch = $template_settings["rte_switch"]["hide"];
        }
        
        include_once("./Services/Form/classes/class.ilPropertyFormGUI.php");
        $form = new ilPropertyFormGUI();
        $form->setFormAction($this->ctrl->getFormAction($this));
        $form->setTableWidth("100%");
        $form->setId("survey_properties");

        // general properties
        $header = new ilFormSectionHeaderGUI();
        $header->setTitle($this->lng->txt("settings"));
        $form->addItem($header);
        
        
        // title & description (meta data)
        
        include_once 'Services/MetaData/classes/class.ilMD.php';
        $md_obj = new ilMD($this->object->getId(), 0, "svy");
        $md_section = $md_obj->getGeneral();

        $title = new ilTextInputGUI($this->lng->txt("title"), "title");
        $title->setRequired(true);
        $title->setValue($md_section->getTitle());
        $form->addItem($title);

        $ids = $md_section->getDescriptionIds();
        if ($ids) {
            $desc_obj = $md_section->getDescription(array_pop($ids));

            $desc = new ilTextAreaInputGUI($this->lng->txt("description"), "description");
            $desc->setCols(50);
            $desc->setRows(4);
            $desc->setValue($desc_obj->getDescription());
            $form->addItem($desc);
        }
                    
        // pool usage
        $pool_usage = new ilRadioGroupInputGUI($this->lng->txt("survey_question_pool_usage"), "use_pool");
        $opt = new ilRadioOption($this->lng->txt("survey_question_pool_usage_active"), 1);
        $opt->setInfo($this->lng->txt("survey_question_pool_usage_active_info"));
        $pool_usage->addOption($opt);
        $opt = new ilRadioOption($this->lng->txt("survey_question_pool_usage_inactive"), 0);
        $opt->setInfo($this->lng->txt("survey_question_pool_usage_inactive_info"));
        $pool_usage->addOption($opt);
        $pool_usage->setValue($this->object->getPoolUsage());
        $form->addItem($pool_usage);
        
        // 360°: appraisees
        if ($this->object->get360Mode()) {
            $self_eval = new ilCheckboxInputGUI($this->lng->txt("survey_360_self_evaluation"), "self_eval");
            $self_eval->setInfo($this->lng->txt("survey_360_self_evaluation_info"));
            $self_eval->setChecked($this->object->get360SelfEvaluation());
            $form->addItem($self_eval);

            $self_rate = new ilCheckboxInputGUI($this->lng->txt("survey_360_self_raters"), "self_rate");
            $self_rate->setInfo($this->lng->txt("survey_360_self_raters_info"));
            $self_rate->setChecked($this->object->get360SelfRaters());
            $form->addItem($self_rate);

            $self_appr = new ilCheckboxInputGUI($this->lng->txt("survey_360_self_appraisee"), "self_appr");
            $self_appr->setInfo($this->lng->txt("survey_360_self_appraisee_info"));
            $self_appr->setChecked($this->object->get360SelfAppraisee());
            $form->addItem($self_appr);
        }
        
        
        // activation
        
        include_once "Services/Object/classes/class.ilObjectActivation.php";
        $this->lng->loadLanguageModule('rep');
        
        $section = new ilFormSectionHeaderGUI();
        $section->setTitle($this->lng->txt('rep_activation_availability'));
        $form->addItem($section);
        
        // additional info only with multiple references
        $act_obj_info = $act_ref_info = "";
        if (sizeof(ilObject::_getAllReferences($this->object->getId())) > 1) {
            $act_obj_info = ' ' . $this->lng->txt('rep_activation_online_object_info');
            $act_ref_info = $this->lng->txt('rep_activation_access_ref_info');
        }
        
        $online = new ilCheckboxInputGUI($this->lng->txt('rep_activation_online'), 'online');
        $online->setInfo($this->lng->txt('svy_activation_online_info') . $act_obj_info);
        $online->setChecked(!$this->object->getOfflineStatus());
        $form->addItem($online);
        
        include_once "Services/Form/classes/class.ilDateDurationInputGUI.php";
        $dur = new ilDateDurationInputGUI($this->lng->txt('rep_visibility_until'), "access_period");
        $dur->setShowTime(true);
        $date = $this->object->getActivationStartDate();
        $dur->setStart($date
            ? new ilDateTime($date, IL_CAL_UNIX)
            : null);
        $date = $this->object->getActivationEndDate();
        $dur->setEnd($date
            ? new ilDateTime($date, IL_CAL_UNIX)
            : null);
        $form->addItem($dur);

        $visible = new ilCheckboxInputGUI($this->lng->txt('rep_activation_limited_visibility'), 'access_visiblity');
        $visible->setInfo($this->lng->txt('svy_activation_limited_visibility_info'));
        $visible->setChecked($this->object->getActivationVisibility());
        $dur->addSubItem($visible);

        // presentation
        $section = new ilFormSectionHeaderGUI();
        $section->setTitle($this->lng->txt('obj_presentation'));
        $form->addItem($section);

        // tile image
        $obj_service->commonSettings()->legacyForm($form, $this->object)->addTileImage();
                                                                        
        // before start
        
        $section = new ilFormSectionHeaderGUI();
        $section->setTitle($this->lng->txt('svy_settings_section_before_start'));
        $form->addItem($section);
        
        // introduction
        $intro = new ilTextAreaInputGUI($this->lng->txt("introduction"), "introduction");
        $intro->setValue($this->object->prepareTextareaOutput($this->object->getIntroduction()));
        $intro->setRows(10);
        $intro->setCols(80);
        $intro->setUseRte(true);
        $intro->setInfo($this->lng->txt("survey_introduction_info"));
        include_once "./Services/AdvancedEditing/classes/class.ilObjAdvancedEditing.php";
        $intro->setRteTags(ilObjAdvancedEditing::_getUsedHTMLTags("survey"));
        $intro->addPlugin("latex");
        $intro->addButton("latex");
        $intro->addButton("pastelatex");
        $intro->setRTESupport($this->object->getId(), "svy", "survey", null, $hide_rte_switch);
        $form->addItem($intro);

        
        // access
        
        $section = new ilFormSectionHeaderGUI();
        $section->setTitle($this->lng->txt('svy_settings_section_access'));
        $form->addItem($section);
        
        // enable start date
        $start = $this->object->getStartDate();
        // start date
        $startingtime = new ilDateTimeInputGUI($this->lng->txt("start_date"), 'start_date');
        $startingtime->setShowTime(true);
        if ($start) {
            $startingtime->setDate(new ilDate($start, IL_CAL_TIMESTAMP));
        }
        $form->addItem($startingtime);

        // enable end date
        $end = $this->object->getEndDate();
        // end date
        $endingtime = new ilDateTimeInputGUI($this->lng->txt("end_date"), 'end_date');
        $endingtime->setShowTime(true);
        if ($end) {
            $endingtime->setDate(new ilDate($end, IL_CAL_TIMESTAMP));
        }
        $form->addItem($endingtime);
                            
        // anonymization
        if (!$this->object->get360Mode()) {
            $codes = new ilCheckboxInputGUI($this->lng->txt("survey_access_codes"), "acc_codes");
            $codes->setInfo($this->lng->txt("survey_access_codes_info"));
            $codes->setChecked(!$this->object->isAccessibleWithoutCode());
            $form->addItem($codes);
                
            if (ilObjSurvey::_hasDatasets($this->object->getSurveyId())) {
                $codes->setDisabled(true);
            }
        }
        
        
        // question behaviour
        
        $section = new ilFormSectionHeaderGUI();
        $section->setTitle($this->lng->txt('svy_settings_section_question_behaviour'));
        $form->addItem($section);
        
        // show question titles
        $show_question_titles = new ilCheckboxInputGUI($this->lng->txt("svy_show_questiontitles"), "show_question_titles");
        $show_question_titles->setValue(1);
        $show_question_titles->setChecked($this->object->getShowQuestionTitles());
        $form->addItem($show_question_titles);
        
        
        // finishing
        
        $info = new ilFormSectionHeaderGUI();
        $info->setTitle($this->lng->txt("svy_settings_section_finishing"));
        $form->addItem($info);
                            
        $view_own = new ilCheckboxInputGUI($this->lng->txt("svy_results_view_own"), "view_own");
        $view_own->setInfo($this->lng->txt("svy_results_view_own_info"));
        $view_own->setChecked($this->object->hasViewOwnResults());
        $form->addItem($view_own);
        
        $mail_confirm = new ilCheckboxInputGUI($this->lng->txt("svy_results_mail_confirm"), "mail_confirm");
        $mail_confirm->setInfo($this->lng->txt("svy_results_mail_confirm_info"));
        $mail_confirm->setChecked($this->object->hasMailConfirmation());
        $form->addItem($mail_confirm);

        $mail_own = new ilCheckboxInputGUI($this->lng->txt("svy_results_mail_own"), "mail_own");
        $mail_own->setInfo($this->lng->txt("svy_results_mail_own_info"));
        $mail_own->setChecked($this->object->hasMailOwnResults());
        $mail_confirm->addSubItem($mail_own);
        
        // final statement
        $finalstatement = new ilTextAreaInputGUI($this->lng->txt("outro"), "outro");
        $finalstatement->setValue($this->object->prepareTextareaOutput($this->object->getOutro()));
        $finalstatement->setRows(10);
        $finalstatement->setCols(80);
        $finalstatement->setUseRte(true);
        $finalstatement->setRteTags(ilObjAdvancedEditing::_getUsedHTMLTags("survey"));
        $finalstatement->addPlugin("latex");
        $finalstatement->addButton("latex");
        $finalstatement->addButton("pastelatex");
        $finalstatement->setRTESupport($this->object->getId(), "svy", "survey", null, $hide_rte_switch);
        $form->addItem($finalstatement);
        
        // mail notification
        $mailnotification = new ilCheckboxInputGUI($this->lng->txt("mailnotification"), "mailnotification");
        // $mailnotification->setOptionTitle($this->lng->txt("activate"));
        $mailnotification->setInfo($this->lng->txt("svy_result_mail_notification_info")); // #11762
        $mailnotification->setValue(1);
        $mailnotification->setChecked($this->object->getMailNotification());

        // addresses
        $mailaddresses = new ilTextInputGUI($this->lng->txt("mailaddresses"), "mailaddresses");
        $mailaddresses->setValue($this->object->getMailAddresses());
        $mailaddresses->setSize(80);
        $mailaddresses->setInfo($this->lng->txt('mailaddresses_info'));
        $mailaddresses->setRequired(true);

        // participant data
        $participantdata = new ilTextAreaInputGUI($this->lng->txt("mailparticipantdata"), "mailparticipantdata");
        $participantdata->setValue($this->object->getMailParticipantData());
        $participantdata->setRows(6);
        $participantdata->setCols(80);
        $participantdata->setUseRte(false);
        $participantdata->setInfo($this->lng->txt("mailparticipantdata_info"));
        
        // #12755 - because of privacy concerns we restrict user data to a minimum
        $placeholders = array(
            "FIRST_NAME" => "firstname",
            "LAST_NAME" => "lastname",
            "LOGIN" => "login"
        );
        $txt = array();
        foreach ($placeholders as $placeholder => $caption) {
            $txt[] = "[" . strtoupper($placeholder) . "]: " . $this->lng->txt($caption);
        }
        $txt = implode("<br />", $txt);
        $participantdatainfo = new ilNonEditableValueGUI($this->lng->txt("mailparticipantdata_placeholder"), "", true);
        $participantdatainfo->setValue($txt);

        $mailnotification->addSubItem($mailaddresses);
        $mailnotification->addSubItem($participantdata);
        $mailnotification->addSubItem($participantdatainfo);
        $form->addItem($mailnotification);
    
        // tutor notification - currently not available for 360°
        if (!$this->object->get360Mode()) {
            // parent course?
            $tree = $this->tree;
            $has_parent = $tree->checkForParentType($this->object->getRefId(), "grp");
            if (!$has_parent) {
                $has_parent = $tree->checkForParentType($this->object->getRefId(), "crs");
            }
            $num_inv = sizeof($this->object->getInvitedUsers());
            
            // notification
            $tut = new ilCheckboxInputGUI($this->lng->txt("survey_notification_tutor_setting"), "tut");
            $tut->setChecked($this->object->getTutorNotificationStatus());
            $form->addItem($tut);

            $tut_logins = array();
            $tuts = $this->object->getTutorNotificationRecipients();
            if ($tuts) {
                foreach ($tuts as $tut_id) {
                    $tmp = ilObjUser::_lookupName($tut_id);
                    if ($tmp["login"]) {
                        $tut_logins[] = $tmp["login"];
                    }
                }
            }
            $tut_ids = new ilTextInputGUI($this->lng->txt("survey_notification_tutor_recipients"), "tut_ids");
            $tut_ids->setDataSource($this->ctrl->getLinkTarget($this, "doAutoComplete", "", true));
            $tut_ids->setRequired(true);
            $tut_ids->setMulti(true);
            $tut_ids->setMultiValues($tut_logins);
            $tut_ids->setValue(array_shift($tut_logins));
            $tut->addSubItem($tut_ids);

            $tut_grp = new ilRadioGroupInputGUI($this->lng->txt("survey_notification_target_group"), "tut_grp");
            $tut_grp->setRequired(true);
            $tut_grp->setValue($this->object->getTutorNotificationTarget());
            $tut->addSubItem($tut_grp);

            $tut_grp_crs = new ilRadioOption(
                $this->lng->txt("survey_notification_target_group_parent_course"),
                ilObjSurvey::NOTIFICATION_PARENT_COURSE
            );
            if (!$has_parent) {
                $tut_grp_crs->setInfo($this->lng->txt("survey_notification_target_group_parent_course_inactive"));
            } else {
                $tut_grp_crs->setInfo(sprintf(
                    $this->lng->txt("survey_notification_target_group_invited_info"),
                    count($this->object->getNotificationTargetUserIds(false))
                ));
            }
            $tut_grp->addOption($tut_grp_crs);

            $tut_grp_inv = new ilRadioOption(
                $this->lng->txt("survey_notification_target_group_invited"),
                ilObjSurvey::NOTIFICATION_INVITED_USERS
            );
            $tut_grp_inv->setInfo(sprintf($this->lng->txt("survey_notification_target_group_invited_info"), $num_inv));
            $tut_grp->addOption($tut_grp_inv);
        }
        
        
        // reminders
        
        $info = new ilFormSectionHeaderGUI();
        $info->setTitle($this->lng->txt("svy_settings_section_reminders"));
        $form->addItem($info);

        $rmd = new ilCheckboxInputGUI($this->lng->txt("survey_reminder_setting"), "rmd");
        $rmd->setChecked($this->object->getReminderStatus());
        $form->addItem($rmd);

        $rmd_start = new ilDateTimeInputGUI($this->lng->txt("survey_reminder_start"), "rmd_start");
        $rmd_start->setRequired(true);
        $start = $this->object->getReminderStart();
        if ($start) {
            $rmd_start->setDate($start);
        }
        $rmd->addSubItem($rmd_start);

        $end = $this->object->getReminderEnd();
        $rmd_end = new ilDateTimeInputGUI($this->lng->txt("survey_reminder_end"), "rmd_end");
        if ($end) {
            $rmd_end->setDate($end);
        }
        $rmd->addSubItem($rmd_end);

        $rmd_freq = new ilNumberInputGUI($this->lng->txt("survey_reminder_frequency"), "rmd_freq");
        $rmd_freq->setRequired(true);
        $rmd_freq->setSize(3);
        $rmd_freq->setSuffix($this->lng->txt("survey_reminder_frequency_days"));
        $rmd_freq->setValue($this->object->getReminderFrequency());
        $rmd_freq->setMinValue(1);
        $rmd->addSubItem($rmd_freq);


        if (!$this->object->get360Mode()) {
            $rmd_grp = new ilRadioGroupInputGUI($this->lng->txt("survey_notification_target_group"), "rmd_grp");
            $rmd_grp->setRequired(true);
            $rmd_grp->setValue($this->object->getReminderTarget());
            $rmd->addSubItem($rmd_grp);

            $rmd_grp_crs = new ilRadioOption(
                $this->lng->txt("survey_notification_target_group_parent_course"),
                ilObjSurvey::NOTIFICATION_PARENT_COURSE
            );
            if (!$has_parent) {
                $rmd_grp_crs->setInfo($this->lng->txt("survey_notification_target_group_parent_course_inactive"));
            } else {
                $rmd_grp_crs->setInfo(sprintf(
                    $this->lng->txt("survey_notification_target_group_invited_info"),
                    count($this->object->getNotificationTargetUserIds(false))
                ));
            }
            $rmd_grp->addOption($rmd_grp_crs);

            $rmd_grp_inv = new ilRadioOption(
                $this->lng->txt("survey_notification_target_group_invited"),
                ilObjSurvey::NOTIFICATION_INVITED_USERS
            );
            $rmd_grp_inv->setInfo(sprintf($this->lng->txt("survey_notification_target_group_invited_info"), $num_inv));
            $rmd_grp->addOption($rmd_grp_inv);

            $mtmpl = $this->object->getReminderMailTemplates();
            if ($mtmpl) {
                $rmdt = new ilRadioGroupInputGUI($this->lng->txt("svy_reminder_mail_template"), "rmdt");
                $rmdt->setRequired(true);
                $rmdt->addOption(new ilRadioOption($this->lng->txt("svy_reminder_mail_template_none"), -1));
                foreach ($mtmpl as $mtmpl_id => $mtmpl_caption) {
                    $option = new ilRadioOption($mtmpl_caption, $mtmpl_id);
                    $rmdt->addOption($option);
                }

                $reminderTemplateValue = -1;
                if ($this->object->getReminderTemplate()) {
                    $reminderTemplateValue = $this->object->getReminderTemplate();
                }
                $rmdt->setValue($reminderTemplateValue);
                $rmd->addSubItem($rmdt);
            }
        } else {
            // remind appraisees
            $cb = new ilCheckboxInputGUI($this->lng->txt("survey_notification_target_group"), "remind_appraisees");
            $cb->setOptionTitle($this->lng->txt("survey_360_appraisees"));
            $cb->setInfo($this->lng->txt("survey_360_appraisees_remind_info"));
            $cb->setValue("1");
            $cb->setChecked(in_array(
                $this->object->getReminderTarget(),
                array(ilObjSurvey::NOTIFICATION_APPRAISEES, ilObjSurvey::NOTIFICATION_APPRAISEES_AND_RATERS)
            ));
            $rmd->addSubItem($cb);

            // remind raters
            $cb = new ilCheckboxInputGUI("", "remind_raters");
            $cb->setOptionTitle($this->lng->txt("survey_360_raters"));
            $cb->setInfo($this->lng->txt("survey_360_raters_remind_info"));
            $cb->setValue("1");
            $cb->setChecked(in_array(
                $this->object->getReminderTarget(),
                array(ilObjSurvey::NOTIFICATION_RATERS, ilObjSurvey::NOTIFICATION_APPRAISEES_AND_RATERS)
            ));
            $rmd->addSubItem($cb);
        }

        
        // results
        
        $results = new ilFormSectionHeaderGUI();
        $results->setTitle($this->lng->txt("results"));
        $form->addItem($results);

        // evaluation access
        switch ($this->object->getMode()) {
            case ilObjSurvey::MODE_360:
                $ts_results = new ilRadioGroupInputGUI($this->lng->txt("survey_360_results"), "ts_res");
                $ts_results->setValue($this->object->get360Results());

                $option = new ilRadioOption($this->lng->txt("survey_360_results_none"), ilObjSurvey::RESULTS_360_NONE);
                $option->setInfo($this->lng->txt("survey_360_results_none_info"));
                $ts_results->addOption($option);

                $option = new ilRadioOption($this->lng->txt("survey_360_results_own"), ilObjSurvey::RESULTS_360_OWN);
                $option->setInfo($this->lng->txt("survey_360_results_own_info"));
                $ts_results->addOption($option);

                $option = new ilRadioOption($this->lng->txt("survey_360_results_all"), ilObjSurvey::RESULTS_360_ALL);
                $option->setInfo($this->lng->txt("survey_360_results_all_info"));
                $ts_results->addOption($option);

                $form->addItem($ts_results);
                break;

            case ilObjSurvey::MODE_SELF_EVAL:
                //check the names of these vars
                $evaluation_access = new ilRadioGroupInputGUI($this->lng->txt('evaluation_access'), "self_eval_res");
                $evaluation_access->setValue($this->object->getSelfEvaluationResults());

                $option = new ilRadioOption($this->lng->txt("svy_self_ev_access_results_none"), ilObjSurvey::RESULTS_SELF_EVAL_NONE);
                $evaluation_access->addOption($option);

                $option = new ilRadioOption($this->lng->txt("svy_self_ev_access_results_own"), ilObjSurvey::RESULTS_SELF_EVAL_OWN);
                $evaluation_access->addOption($option);

                $option = new ilRadioOption($this->lng->txt("svy_self_ev_access_results_all"), ilObjSurvey::RESULTS_SELF_EVAL_ALL);
                $evaluation_access->addOption($option);

                $form->addItem($evaluation_access);
                break;

            default:
                $evaluation_access = new ilRadioGroupInputGUI($this->lng->txt('evaluation_access'), "evaluation_access");

                $option = new ilCheckboxOption($this->lng->txt("evaluation_access_off"), ilObjSurvey::EVALUATION_ACCESS_OFF, '');
                $option->setInfo($this->lng->txt("svy_evaluation_access_off_info"));
                $evaluation_access->addOption($option);

                $option = new ilCheckboxOption($this->lng->txt("evaluation_access_all"), ilObjSurvey::EVALUATION_ACCESS_ALL, '');
                $option->setInfo($this->lng->txt("svy_evaluation_access_all_info"));
                $evaluation_access->addOption($option);

                $option = new ilCheckboxOption($this->lng->txt("evaluation_access_participants"), ilObjSurvey::EVALUATION_ACCESS_PARTICIPANTS, '');
                $option->setInfo($this->lng->txt("svy_evaluation_access_participants_info"));
                $evaluation_access->addOption($option);

                $evaluation_access->setValue($this->object->getEvaluationAccess());
                $form->addItem($evaluation_access);

                $anonymization_options = new ilRadioGroupInputGUI($this->lng->txt("survey_results_anonymization"), "anonymization_options");

                $option = new ilCheckboxOption($this->lng->txt("survey_results_personalized"), "statpers");
                $option->setInfo($this->lng->txt("survey_results_personalized_info"));
                $anonymization_options->addOption($option);

                $option = new ilCheckboxOption($this->lng->txt("survey_results_anonymized"), "statanon");
                $option->setInfo($this->lng->txt("survey_results_anonymized_info"));
                $anonymization_options->addOption($option);
                $anonymization_options->setValue($this->object->hasAnonymizedResults()
                    ? "statanon"
                    : "statpers");
                $form->addItem($anonymization_options);

                $surveySetting = new ilSetting("survey");
                if ($surveySetting->get("anonymous_participants", false)) {
                    $min = "";
                    if ($surveySetting->get("anonymous_participants_min", 0)) {
                        $min = " (" . $this->lng->txt("svy_anonymous_participants_min") . ": " .
                            $surveySetting->get("anonymous_participants_min") . ")";
                    }

                    $anon_list = new ilCheckboxInputGUI($this->lng->txt("svy_anonymous_participants_svy"), "anon_list");
                    $anon_list->setInfo($this->lng->txt("svy_anonymous_participants_svy_info") . $min);
                    $anon_list->setChecked($this->object->hasAnonymousUserList());
                    $option->addSubItem($anon_list);
                }

                if ($this->object->_hasDatasets($this->object->getSurveyId())) {
                    $anonymization_options->setDisabled(true);
                    if ($anon_list) {
                        $anon_list->setDisabled(true);
                    }
                }
                break;
        }
            
        // competence service activation for 360 mode
        
        include_once("./Services/Skill/classes/class.ilSkillManagementSettings.php");
        $skmg_set = new ilSkillManagementSettings();
        $svy_mode = $this->object->getMode();
        if (($svy_mode == ilObjSurvey::MODE_360 || $svy_mode == ilObjSurvey::MODE_SELF_EVAL) && $skmg_set->isActivated()) {
            $other = new ilFormSectionHeaderGUI();
            $other->setTitle($this->lng->txt("other"));
            $form->addItem($other);
            
            $skill_service = new ilCheckboxInputGUI($this->lng->txt("survey_activate_skill_service"), "skill_service");
            $skill_service->setInfo($this->lng->txt("survey_activate_skill_service_info"));
            $skill_service->setChecked($this->object->getSkillService());
            $form->addItem($skill_service);
        }
                
        $position_settings = ilOrgUnitGlobalSettings::getInstance()
            ->getObjectPositionSettingsByType($this->object->getType());

        if ($position_settings->isActive()) {
            // add additional feature section
            $feat = new ilFormSectionHeaderGUI();
            $feat->setTitle($this->lng->txt('obj_features'));
            $form->addItem($feat);

            // add orgunit settings
            ilObjectServiceSettingsGUI::initServiceSettingsForm(
                $this->object->getId(),
                $form,
                array(
                        ilObjectServiceSettingsGUI::ORGU_POSITION_ACCESS
                    )
            );
        }
        
        $form->addCommandButton("saveProperties", $this->lng->txt("save"));

        // remove items when using template
        if ($template_settings) {
            foreach ($template_settings as $id => $item) {
                if ($item["hide"]) {
                    if ($id == "enabled_end_date") {
                        $id = "end_date";
                    }
                    if ($id == "enabled_start_date") {
                        $id = "start_date";
                    }
                    $form->removeItemByPostVar($id, true);
                }
            }
        }
        return $form;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

mailUserResultsObject()

ilObjSurveyGUI::mailUserResultsObject

(

)

Definition at line 2265 of file class.ilObjSurveyGUI.php.

References $_POST, $_SESSION, $ilUser, ilObjectGUI\$user, ilUtil\is_email(), and sendUserResultsMail().

    {
        $ilUser = $this->user;
        
        $anonymous_code = $_SESSION["anonymous_id"][$this->object->getId()];
        $active_id = $this->object->getActiveID($ilUser->getId(), $anonymous_code, 0);
        if ($this->object->isSurveyStarted($ilUser->getId(), $anonymous_code) !== 1 ||
            !$active_id) {
            $this->ctrl->redirect($this, "infoScreen");
        }
        
        $recipient = $_POST["mail"];
        if (!$recipient) {
            $recipient = $ilUser->getEmail();
        }
        if (!ilUtil::is_email($recipient)) {
            $this->ctrl->redirect($this, "infoScreen");
        }
        
        $this->sendUserResultsMail($active_id, $recipient);
        
        ilUtil::sendSuccess($this->lng->txt("mail_sent"), true);
        $this->ctrl->redirect($this, "infoScreen");
    }

Here is the call graph for this function:

propertiesObject()

ilObjSurveyGUI::propertiesObject

(

ilPropertyFormGUI

$a_form = null

)

Display and fill the properties form of the test.

public

Definition at line 1424 of file class.ilObjSurveyGUI.php.

References $help, $message, $tabs, addSubTabs(), ilObjectGUI\checkPermission(), initPropertiesForm(), and ilSettingsTemplate\lookupTitle().

Referenced by savePropertiesObject().

    {
        $ilTabs = $this->tabs;
        $ilHelp = $this->help;
        
        $this->checkPermission("write");
        
        $this->addSubTabs('settings');
        $ilTabs->activateTab("settings");
        $ilTabs->activateSubTab('settings');
        
        if ($this->object->get360Mode()) {
            $ilHelp->setScreenId("settings_360");
        }
        
        if (!$a_form) {
            $a_form = $this->initPropertiesForm();
        }
        
        // using template?
        $message = "";
        if ($this->object->getTemplate()) {
            $link = $this->ctrl->getLinkTarget($this, "confirmResetTemplate");
            $link = "<a href=\"" . $link . "\">" . $this->lng->txt("survey_using_template_link") . "</a>";
            $message = "<div style=\"margin-top:10px\">" .
                $this->tpl->getMessageHTML(sprintf(
                    $this->lng->txt("survey_using_template"),
                    ilSettingsTemplate::lookupTitle($this->object->getTemplate()),
                    $link
                ), "info") . // #10651
                "</div>";
        }
    
        $this->tpl->setContent($a_form->getHTML() . $message);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

resetTemplateObject()

ilObjSurveyGUI::resetTemplateObject

(

)

Enable all settings - remove template.

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

    {
        $this->object->setTemplate(null);
        $this->object->saveToDB();

        ilUtil::sendSuccess($this->lng->txt("survey_template_reset"), true);
        $this->ctrl->redirect($this, "properties");
    }

savePropertiesObject()

ilObjSurveyGUI::savePropertiesObject

(

)

Save the survey properties.

Save the survey properties

private

Definition at line 545 of file class.ilObjSurveyGUI.php.

References $_POST, $_SESSION, $current, $end, $form, ilObjectGUI\$object_service, $rbacsystem, $start, $template, $valid, ilObjSurvey\_hasDatasets(), ilObjUser\_lookupId(), ilObjSurvey\ANONYMIZE_CODE_ALL, ilObjSurvey\ANONYMIZE_FREEACCESS, ilObjSurvey\ANONYMIZE_OFF, ilObjSurvey\ANONYMIZE_ON, ilMD\getGeneral(), IL_CAL_DATETIME, IL_CAL_UNIX, initPropertiesForm(), ilObjSurvey\MODE_360, ilObjSurvey\MODE_SELF_EVAL, ilObjSurvey\NOTIFICATION_APPRAISEES, ilObjSurvey\NOTIFICATION_APPRAISEES_AND_RATERS, ilObjSurvey\NOTIFICATION_RATERS, ilObjectServiceSettingsGUI\ORGU_POSITION_ACCESS, propertiesObject(), ilUtil\sendFailure(), ilUtil\stripSlashes(), ilMDBase\update(), and ilObjectServiceSettingsGUI\updateServiceSettingsForm().

    {
        $rbacsystem = $this->rbacsystem;
        $obj_service = $this->object_service;
        
        $form = $this->initPropertiesForm();
        if ($form->checkInput()) {
            $valid = true;
                        
            if (!$this->object->get360Mode()) {
                if ($form->getInput("tut")) {
                    // check if given "tutors" have write permission
                    $tut_ids = array();
                    $tut_logins = $form->getInput("tut_ids");
                    foreach ($tut_logins as $tut_login) {
                        $tut_id = ilObjUser::_lookupId($tut_login);
                        if ($tut_id && $rbacsystem->checkAccessOfUser($tut_id, "write", $this->object->getRefId())) {
                            $tut_ids[] = $tut_id;
                        }
                    }
                    if (!$tut_ids) {
                        $tut_ids = $form->getItemByPostVar("tut_ids");
                        $tut_ids->setAlert($this->lng->txt("survey_notification_tutor_recipients_invalid"));
                        $valid = false;
                    }
                }
            }
            
            if ($valid) {
                if ($form->getInput("rmd")) {
                    $rmd_start = $form->getItemByPostVar("rmd_start")->getDate();
                    $rmd_end = $form->getItemByPostVar("rmd_end")->getDate();
                    if ($rmd_end) {
                        if ($rmd_start->get(IL_CAL_UNIX) > $rmd_end->get(IL_CAL_UNIX)) {
                            $tmp = $rmd_start;
                            $rmd_start = $rmd_end;
                            $rmd_end = $tmp;
                        }
                    }
                    $this->object->setReminderStatus(true);
                    $this->object->setReminderStart($rmd_start);
                    $this->object->setReminderEnd($rmd_end);
                    $this->object->setReminderFrequency($form->getInput("rmd_freq"));
                    if (!$this->object->get360Mode()) {
                        $this->object->setReminderTarget($form->getInput("rmd_grp"));
                        $this->object->setReminderTemplate(($form->getInput("rmdt") > 0)
                            ? $form->getInput("rmdt")
                            : null);
                    } else {
                        if ($form->getInput("remind_appraisees") && $form->getInput("remind_raters")) {
                            $this->object->setReminderTarget(ilObjSurvey::NOTIFICATION_APPRAISEES_AND_RATERS);
                        } elseif ($form->getInput("remind_appraisees")) {
                            $this->object->setReminderTarget(ilObjSurvey::NOTIFICATION_APPRAISEES);
                        } elseif ($form->getInput("remind_raters")) {
                            $this->object->setReminderTarget(ilObjSurvey::NOTIFICATION_RATERS);
                        } else {
                            $this->object->setReminderTarget(0);
                        }
                    }
                } else {
                    $this->object->setReminderStatus(false);
                }

                if (!$this->object->get360Mode()) {
                    if ($form->getInput("tut")) {
                        $this->object->setTutorNotificationStatus(true);
                        $this->object->setTutorNotificationRecipients($tut_ids); // see above
                        $this->object->setTutorNotificationTarget($form->getInput("tut_grp"));
                    } else {
                        $this->object->setTutorNotificationStatus(false);
                    }
                }
            
                // #10055
                if ($_POST['online'] && count($this->object->questions) == 0) {
                    $_POST['online'] = null;
                    ilUtil::sendFailure($this->lng->txt("cannot_switch_to_online_no_questions"), true);
                }

                $template_settings = null;
                $template = $this->object->getTemplate();
                if ($template) {
                    include_once "Services/Administration/classes/class.ilSettingsTemplate.php";
                    $template = new ilSettingsTemplate($template);
                    $template_settings = $template->getSettings();
                }

                include_once 'Services/MetaData/classes/class.ilMD.php';
                $md_obj = new ilMD($this->object->getId(), 0, "svy");
                $md_section = $md_obj->getGeneral();

                // title
                $md_section->setTitle(ilUtil::stripSlashes($_POST['title']));
                $md_section->update();

                // Description
                $md_desc_ids = $md_section->getDescriptionIds();
                if ($md_desc_ids) {
                    $md_desc = $md_section->getDescription(array_pop($md_desc_ids));
                    $md_desc->setDescription(ilUtil::stripSlashes($_POST['description']));
                    $md_desc->update();
                }
                
                $this->object->setViewOwnResults($_POST["view_own"]);
                $this->object->setMailOwnResults($_POST["mail_own"]);
                $this->object->setMailConfirmation($_POST["mail_confirm"]);

                // both are saved in object, too
                $this->object->setTitle(ilUtil::stripSlashes($_POST['title']));
                $this->object->setDescription(ilUtil::stripSlashes($_POST['description']));
                $this->object->setOfflineStatus((bool) !$_POST['online']);
                $this->object->update();

                // activation
                $period = $form->getItemByPostVar("access_period");
                if ($period->getStart() && $period->getEnd()) {
                    $this->object->setActivationLimited(true);
                    $this->object->setActivationVisibility($_POST["access_visiblity"]);
                    $this->object->setActivationStartDate($period->getStart()->get(IL_CAL_UNIX));
                    $this->object->setActivationEndDate($period->getEnd()->get(IL_CAL_UNIX));
                } else {
                    $this->object->setActivationLimited(false);
                }

                // tile image
                $obj_service->commonSettings()->legacyForm($form, $this->object)->saveTileImage();


                if (!$template_settings["enabled_start_date"]["hide"]) {
                    $start = $form->getItemByPostVar("start_date");
                    if ($start->getDate()) {
                        $datetime = explode(" ", $start->getDate()->get(IL_CAL_DATETIME));
                        $this->object->setStartDateAndTime($datetime[0], $datetime[1]);
                    } else {
                        $this->object->setStartDate(null);
                    }
                }

                if (!$template_settings["enabled_end_date"]["hide"]) {
                    $end = $form->getItemByPostVar("end_date");
                    if ($end->getDate()) {
                        $datetime = explode(" ", $end->getDate()->get(IL_CAL_DATETIME));
                        $this->object->setEndDateAndTime($datetime[0], $datetime[1]);
                    } else {
                        $this->object->setEndDate(null);
                    }
                }

                
                include_once "./Services/AdvancedEditing/classes/class.ilObjAdvancedEditing.php";
                $introduction = $_POST["introduction"];
                $this->object->setIntroduction($introduction);
                $outro = $_POST["outro"];
                $this->object->setOutro($outro);

                if (!$template_settings["show_question_titles"]["hide"]) {
                    $this->object->setShowQuestionTitles($_POST["show_question_titles"]);
                }

                if (!$template_settings["use_pool"]["hide"]) {
                    $this->object->setPoolUsage($_POST["use_pool"]);
                }

                $this->object->setMailNotification($_POST['mailnotification']);
                $this->object->setMailAddresses($_POST['mailaddresses']);
                $this->object->setMailParticipantData($_POST['mailparticipantdata']);

                switch ($this->object->getMode()) {
                    case ilObjSurvey::MODE_360:
                        $this->object->set360SelfEvaluation((bool) $_POST["self_eval"]);
                        $this->object->set360SelfAppraisee((bool) $_POST["self_appr"]);
                        $this->object->set360SelfRaters((bool) $_POST["self_rate"]);
                        $this->object->set360Results((int) $_POST["ts_res"]);;
                        $this->object->setSkillService((int) $_POST["skill_service"]);
                        break;
                    case ilObjSurvey::MODE_SELF_EVAL:
                        $this->object->setSelfEvaluationResults($_POST["self_eval_res"]);
                        $this->object->setSkillService((int) $_POST["skill_service"]);
                        break;
                    default:
                        if (!$template_settings["evaluation_access"]["hide"]) {
                            $this->object->setEvaluationAccess($_POST["evaluation_access"]);
                        }

                        $hasDatasets = ilObjSurvey::_hasDatasets($this->object->getSurveyId());
                        if (!$hasDatasets) {
                            $hide_codes = $template_settings["acc_codes"]["hide"];
                            $hide_anon = $template_settings["anonymization_options"]["hide"];
                            if (!$hide_codes || !$hide_anon) {
                                $current = $this->object->getAnonymize();

                                // get current setting if property is hidden
                                if (!$hide_codes) {
                                    $codes = (bool) $_POST["acc_codes"];
                                } else {
                                    $codes = ($current == ilObjSurvey::ANONYMIZE_CODE_ALL ||
                                        $current == ilObjSurvey::ANONYMIZE_ON);
                                }
                                if (!$hide_anon) {
                                    $anon = ((string) $_POST["anonymization_options"] == "statanon");
                                } else {
                                    $anon = ($current == ilObjSurvey::ANONYMIZE_FREEACCESS ||
                                        $current == ilObjSurvey::ANONYMIZE_ON);
                                }

                                // parse incoming values
                                if (!$anon) {
                                    if (!$codes) {
                                        $this->object->setAnonymize(ilObjSurvey::ANONYMIZE_OFF);
                                    } else {
                                        $this->object->setAnonymize(ilObjSurvey::ANONYMIZE_CODE_ALL);
                                    }
                                } else {
                                    if ($codes) {
                                        $this->object->setAnonymize(ilObjSurvey::ANONYMIZE_ON);
                                    } else {
                                        $this->object->setAnonymize(ilObjSurvey::ANONYMIZE_FREEACCESS);
                                    }

                                    $this->object->setAnonymousUserList($_POST["anon_list"]);
                                }

                                // if settings were changed get rid of existing code
                                unset($_SESSION["anonymous_id"][$this->object->getId()]);
                            }
                        }
                        break;
                }

                $this->object->saveToDb();

                ilObjectServiceSettingsGUI::updateServiceSettingsForm(
                    $this->object->getId(),
                    $form,
                    array(
                        ilObjectServiceSettingsGUI::ORGU_POSITION_ACCESS
                    )
                );

                if (strcmp($_SESSION["info"], "") != 0) {
                    ilUtil::sendSuccess($_SESSION["info"] . "<br />" . $this->lng->txt("settings_saved"), true);
                } else {
                    ilUtil::sendSuccess($this->lng->txt("settings_saved"), true);
                }
                $this->ctrl->redirect($this, "properties");
            } else {
                // #16714
                ilUtil::sendFailure($this->lng->txt("form_input_not_valid"));
            }
        }
        
        $form->setValuesByPost();
        $this->propertiesObject($form);
    }

Here is the call graph for this function:

sendUserResultsMail()

ilObjSurveyGUI::sendUserResultsMail	(		$a_active_id,
			$a_recipient
	)

Definition at line 2225 of file class.ilObjSurveyGUI.php.

References $ilUser, ilObjectGUI\$user, ilMail\_getInstallationSignature(), ilLink\_getLink(), ilDatePresentation\formatDate(), ilMail\getSalutation(), getUserResultsPlain(), and IL_CAL_UNIX.

Referenced by mailUserResultsObject().

    {
        $ilUser = $this->user;
        
        $finished = $this->object->getSurveyParticipants(array($a_active_id));
        $finished = array_pop($finished);
        $finished = ilDatePresentation::formatDate(new ilDateTime($finished["finished_tstamp"], IL_CAL_UNIX));
                
        require_once "Services/Mail/classes/class.ilMail.php";
        require_once "Services/Link/classes/class.ilLink.php";
                
        $body = ilMail::getSalutation($ilUser->getId()) . "\n\n";
        $body .= $this->lng->txt("svy_mail_own_results_body") . "\n";
        $body .= "\n" . $this->lng->txt("obj_svy") . ": " . $this->object->getTitle() . "\n";
        $body .= ilLink::_getLink($this->object->getRefId(), "svy") . "\n";
        $body .= "\n" . $this->lng->txt("survey_results_finished") . ": " . $finished . "\n\n";
        
        if ($this->object->hasMailOwnResults()) {
            $subject = "svy_mail_own_results_subject";
            $body .= $this->getUserResultsPlain($a_active_id);
        } else {
            $subject = "svy_mail_confirmation_subject";
        }
        
        // $body .= ilMail::_getAutoGeneratedMessageString($this->lng);
        $body .= ilMail::_getInstallationSignature();
                
        require_once "Services/Mail/classes/class.ilMail.php";
        $mail = new ilMail(ANONYMOUS_USER_ID);
        $mail->sendMimeMail(
            $a_recipient,
            null,
            null,
            sprintf($this->lng->txt($subject), $this->object->getTitle()),
            $body,
            null,
            true
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

viewUserResultsObject()

ilObjSurveyGUI::viewUserResultsObject ( )

protected

Definition at line 2106 of file class.ilObjSurveyGUI.php.

References $_SESSION, $html, $ilUser, $tabs, ilObjectGUI\$tpl, ilObjectGUI\$user, and getUserResultsTable().

    {
        $ilUser = $this->user;
        $tpl = $this->tpl;
        $ilTabs = $this->tabs;
        
        $anonymous_code = $_SESSION["anonymous_id"][$this->object->getId()];
        $active_id = $this->object->getActiveID($ilUser->getId(), $anonymous_code, 0);
        if ($this->object->isSurveyStarted($ilUser->getId(), $anonymous_code) !== 1 ||
            !$active_id) {
            $this->ctrl->redirect($this, "infoScreen");
        }
        
        $ilTabs->clearTargets();
        $ilTabs->setBackTarget(
            $this->lng->txt("btn_back"),
            $this->ctrl->getLinkTarget($this, "infoScreen")
        );
        
        $html = $this->getUserResultsTable($active_id);
        $tpl->setContent($html);
    }

Here is the call graph for this function:

Field Documentation

$help

ilObjSurveyGUI::$help

protected

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

Referenced by getTabs(), and propertiesObject().

$log

ilObjSurveyGUI::$log

protected

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

$nav_history

ilObjSurveyGUI::$nav_history

protected

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

Referenced by executeCommand().

$rbacsystem

ilObjSurveyGUI::$rbacsystem

protected

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

Referenced by savePropertiesObject().

$tabs

ilObjSurveyGUI::$tabs

protected

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

Referenced by executeCommand(), infoScreen(), propertiesObject(), and viewUserResultsObject().

---

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

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