/**
* Set the tabs for the evaluation output
*
* @access private
*/
function setEvalSubtabs()
{
global $ilTabs;
global $ilAccess;
include_once "./Services/Skill/classes/class.ilSkillManagementSettings.php";
$skmg_set = new ilSkillManagementSettings();
if ($this->object->get360SkillService() && $skmg_set->isActivated()) {
$ilTabs->addSubTabTarget("svy_eval_competences", $this->ctrl->getLinkTarget($this, "competenceEval"), array("competenceEval"));
}
$ilTabs->addSubTabTarget("svy_eval_cumulated", $this->ctrl->getLinkTarget($this, "evaluation"), array("evaluation", "checkEvaluationAccess"));
$ilTabs->addSubTabTarget("svy_eval_detail", $this->ctrl->getLinkTarget($this, "evaluationdetails"), array("evaluationdetails"));
if ($ilAccess->checkAccess("write", "", $this->object->getRefId())) {
$ilTabs->addSubTabTarget("svy_eval_user", $this->ctrl->getLinkTarget($this, "evaluationuser"), array("evaluationuser"));
}
}
public static function isSkillManagementGloballyActivated()
{
if (self::$isSkillManagementGloballyActivated === null) {
include_once 'Services/Skill/classes/class.ilSkillManagementSettings.php';
$skmgSet = new ilSkillManagementSettings();
self::$isSkillManagementGloballyActivated = $skmgSet->isActivated();
}
return self::$isSkillManagementGloballyActivated;
}
/**
* Init survey settings form
*
* @return ilPropertyFormGUI
*/
function initPropertiesForm()
{
$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->isOnline());
$form->addItem($online);
$act_type = new ilCheckboxInputGUI($this->lng->txt('rep_visibility_until'), 'access_type');
// $act_type->setInfo($this->lng->txt('svy_availability_until_info'));
$act_type->setChecked($this->object->isActivationLimited());
$this->tpl->addJavaScript('./Services/Form/js/date_duration.js');
include_once "Services/Form/classes/class.ilDateDurationInputGUI.php";
$dur = new ilDateDurationInputGUI($this->lng->txt('rep_time_period'), "access_period");
$dur->setShowTime(true);
$date = $this->object->getActivationStartDate();
$dur->setStart(new ilDateTime($date ? $date : time(), IL_CAL_UNIX));
$dur->setStartText($this->lng->txt('rep_activation_limited_start'));
$date = $this->object->getActivationEndDate();
$dur->setEnd(new ilDateTime($date ? $date : time(), IL_CAL_UNIX));
$dur->setEndText($this->lng->txt('rep_activation_limited_end'));
$act_type->addSubItem($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());
$act_type->addSubItem($visible);
$form->addItem($act_type);
// 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();
$enablestartingtime = new ilCheckboxInputGUI($this->lng->txt("start_date"), "enabled_start_date");
$enablestartingtime->setValue(1);
// $enablestartingtime->setOptionTitle($this->lng->txt("enabled"));
$enablestartingtime->setChecked($start);
// start date
$startingtime = new ilDateTimeInputGUI('', 'start_date');
$startingtime->setShowTime(true);
if ($start) {
$startingtime->setDate(new ilDate($start, IL_CAL_TIMESTAMP));
}
$enablestartingtime->addSubItem($startingtime);
$form->addItem($enablestartingtime);
// enable end date
$end = $this->object->getEndDate();
$enableendingtime = new ilCheckboxInputGUI($this->lng->txt("end_date"), "enabled_end_date");
$enableendingtime->setValue(1);
// $enableendingtime->setOptionTitle($this->lng->txt("enabled"));
$enableendingtime->setChecked($end);
// end date
$endingtime = new ilDateTimeInputGUI('', 'end_date');
$endingtime->setShowTime(true);
if ($end) {
$endingtime->setDate(new ilDate($end, IL_CAL_TIMESTAMP));
}
$enableendingtime->addSubItem($endingtime);
$form->addItem($enableendingtime);
// 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 ($this->object->_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_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());
$form->addItem($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?
global $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"));
}
$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
// reminder - currently not available for 360°
if (!$this->object->get360Mode()) {
$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");
$rmd_end->enableDateActivation("", "rmd_end_tgl", (bool) $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);
$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"));
}
$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);
}
// results
$results = new ilFormSectionHeaderGUI();
$results->setTitle($this->lng->txt("results"));
$form->addItem($results);
// evaluation access
if (!$this->object->get360Mode()) {
$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);
if ($this->object->_hasDatasets($this->object->getSurveyId())) {
$anonymization_options->setDisabled(true);
}
} else {
$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);
}
// competence service activation for 360 mode
include_once "./Services/Skill/classes/class.ilSkillManagementSettings.php";
$skmg_set = new ilSkillManagementSettings();
if ($this->object->get360Mode() && $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->get360SkillService());
$form->addItem($skill_service);
}
$form->addCommandButton("saveProperties", $this->lng->txt("save"));
// remove items when using template
if ($template_settings) {
foreach ($template_settings as $id => $item) {
if ($item["hide"]) {
$form->removeItemByPostVar($id);
}
}
}
return $form;
}
function closeAppraisee($a_user_id)
{
global $ilDB;
// close the appraisee
$ilDB->manipulate("UPDATE svy_360_appr" . " SET has_closed = " . $ilDB->quote(time(), "integer") . " WHERE obj_id = " . $ilDB->quote($this->getSurveyId(), "integer") . " AND user_id = " . $ilDB->quote($a_user_id, "integer"));
// write competences
include_once "./Services/Skill/classes/class.ilSkillManagementSettings.php";
$skmg_set = new ilSkillManagementSettings();
if ($this->get360SkillService() && $skmg_set->isActivated()) {
include_once "./Modules/Survey/classes/class.ilSurveySkill.php";
$sskill = new ilSurveySkill($this);
$sskill->writeAppraiseeSkills($a_user_id);
}
}
/**
* Save skill management settings
*/
public function saveSettings()
{
global $ilCtrl, $ilSetting;
include_once "./Services/Skill/classes/class.ilSkillManagementSettings.php";
$skmg_set = new ilSkillManagementSettings();
$skmg_set->activate((int) $_POST["enable_skmg"]);
ilUtil::sendSuccess($this->lng->txt("settings_saved"), true);
$ilCtrl->redirect($this, "editSettings");
}
public function listAppraiseesObject()
{
global $ilToolbar, $lng, $ilCtrl;
$this->parent_gui->handleWriteAccess();
$this->ctrl->setParameter($this, "appr360", 1);
include_once './Services/Search/classes/class.ilRepositorySearchGUI.php';
ilRepositorySearchGUI::fillAutoCompleteToolbar($this, $ilToolbar, array('auto_complete_name' => $this->lng->txt('user'), 'submit_name' => $this->lng->txt('add'), 'add_search' => true, 'add_from_container' => $this->ref_id));
// competence calculations
include_once "./Services/Skill/classes/class.ilSkillManagementSettings.php";
$skmg_set = new ilSkillManagementSettings();
if ($this->object->get360SkillService() && $skmg_set->isActivated()) {
$ilToolbar->addSeparator();
$ilToolbar->addButton($lng->txt("survey_calc_skills"), $ilCtrl->getLinkTargetByClass("ilsurveyskilldeterminationgui"), "");
}
$this->ctrl->setParameter($this, "appr360", "");
include_once "Modules/Survey/classes/tables/class.ilSurveyAppraiseesTableGUI.php";
$tbl = new ilSurveyAppraiseesTableGUI($this, "listAppraisees");
$tbl->setData($this->object->getAppraiseesData());
$this->tpl->setContent($tbl->getHTML());
}