Info screen wrapper for the survey. More...

Collaboration diagram for ILIAS\Survey\InfoScreen\InfoScreenGUI:

Public Member Functions
	getInfoScreenGUI ()

Protected Member Functions
	addStartResumeSection (\ilInfoScreenGUI $info, string $anonymous_code, $output_gui)
	Add start/resume buttons or appraisee list to info screen. More...

	addPrivacyInfo (\ilInfoScreenGUI $info)

	addAppraiseeInfo (\ilInfoScreenGUI $info)

	displayNotStartableReasons (\ilInfoScreenGUI $info)

Protected Attributes
ILIAS DI UIServices	$ui

ilObjSurvey	$survey

ilObjUser	$user

ilToolbarGUI	$toolbar

ilObjSurveyGUI	$survey_gui

Participants StatusManager	$status_manager

Access AccessManager	$access_manager

Execution RunManager	$run_manager

ServerRequestInterface	$request

string	$requested_code

ILIAS Survey Mode FeatureConfig	$feature_config

ilLanguage	$lng

ilCtrl	$ctrl

Private Attributes
ilGlobalTemplateInterface	$main_tpl

Detailed Description

Info screen wrapper for the survey.

The screen currently acts as a start screen, too.

Author: Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

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

Member Function Documentation

◆ addAppraiseeInfo()

ILIAS\Survey\InfoScreen\InfoScreenGUI::addAppraiseeInfo ( \ilInfoScreenGUI $info )

protected

Definition at line 335 of file class.InfoScreenGUI.php.

References ILIAS\Survey\InfoScreen\InfoScreenGUI\$survey, $txt, ILIAS\Survey\InfoScreen\InfoScreenGUI\addPrivacyInfo(), ilInfoScreenGUI\addProperty(), ilInfoScreenGUI\addSection(), ILIAS\Repository\ctrl(), ilDatePresentation\formatDate(), ilLinkButton\getInstance(), IL_CAL_UNIX, ILIAS\Repository\lng(), ilDatePresentation\setUseRelativeDates(), and ILIAS\Repository\user().

Referenced by ILIAS\Survey\InfoScreen\InfoScreenGUI\getInfoScreenGUI().

      : void {
         $survey = $this->survey;
         if ($this->status_manager->isAppraisee()) {
             $info->addSection($this->lng->txt("survey_360_appraisee_info"));
 
             $this->addPrivacyInfo($info);
 
             $appr_data = $survey->getAppraiseesData();
             $appr_data = $appr_data[$this->user->getId()];
             $info->addProperty($this->lng->txt("survey_360_raters_status_info"), $appr_data["finished"]);
 
             if ($survey->get360Mode()) {
                 if (!$appr_data["closed"]) {
                     $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 ($survey->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)
                         )
                     );
                 }
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addPrivacyInfo()

ILIAS\Survey\InfoScreen\InfoScreenGUI::addPrivacyInfo ( \ilInfoScreenGUI $info )

protected

Definition at line 324 of file class.InfoScreenGUI.php.

References ILIAS\Survey\InfoScreen\InfoScreenGUI\$survey, ilInfoScreenGUI\addProperty(), ILIAS\Repository\lng(), ilObjSurvey\RESULTS_360_ALL, and ilObjSurvey\RESULTS_360_OWN.

Referenced by ILIAS\Survey\InfoScreen\InfoScreenGUI\addAppraiseeInfo(), and ILIAS\Survey\InfoScreen\InfoScreenGUI\addStartResumeSection().

      : void {
         $survey = $this->survey;
         $privacy_info = $this->lng->txt("svy_rater_see_app_info");
         if (in_array($survey->get360Results(), [\ilObjSurvey::RESULTS_360_OWN, \ilObjSurvey::RESULTS_360_ALL], true)) {
             $privacy_info .= " " . $this->lng->txt("svy_app_see_rater_info");
         }
         $info->addProperty($this->lng->txt("svy_privacy_info"), $privacy_info);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addStartResumeSection()

ILIAS\Survey\InfoScreen\InfoScreenGUI::addStartResumeSection	(	\ilInfoScreenGUI	$info,
		string	$anonymous_code,
			$output_gui
	)

protected

Add start/resume buttons or appraisee list to info screen.

Parameters

object | string $output_gui

Exceptions

Definition at line 218 of file class.InfoScreenGUI.php.

References ILIAS\Survey\InfoScreen\InfoScreenGUI\$status_manager, ILIAS\Survey\InfoScreen\InfoScreenGUI\$survey, ilInfoScreenGUI\addHiddenElement(), ILIAS\Survey\InfoScreen\InfoScreenGUI\addPrivacyInfo(), ilInfoScreenGUI\addProperty(), ilInfoScreenGUI\addSection(), ANONYMOUS_USER_ID, ILIAS\Repository\ctrl(), ilSubmitButton\getInstance(), ilLinkButton\getInstance(), ilUserUtil\getNamePresentation(), ILIAS\Repository\lng(), ILIAS\Repository\toolbar(), and ILIAS\Repository\user().

Referenced by ILIAS\Survey\InfoScreen\InfoScreenGUI\getInfoScreenGUI().

      : void {
         $survey = $this->survey;
 
         $status_manager = $this->status_manager;
         if ($this->access_manager->canStartSurvey() &&
             !$status_manager->mustEnterCode($anonymous_code)) {
             if (!$this->feature_config->usesAppraisees()) {
                 if ($anonymous_code) {
                     $info->addHiddenElement("anonymous_id", $anonymous_code);
                 }
                 $big_button = false;
                 if ($this->run_manager->hasStarted() &&
                     !$this->run_manager->hasFinished()) {
                     $big_button = array("resume", $this->lng->txt("resume_survey"));
                 } elseif (!$this->run_manager->hasStarted()) {
                     $big_button = array("start", $this->lng->txt("start_survey"));
                 }
                 if ($big_button) {
                     $button = \ilSubmitButton::getInstance();
                     $button->setCaption($big_button[1], false);
                     $button->setCommand($big_button[0]);
                     $button->setPrimary(true);
                     $this->toolbar->addButtonInstance($button);
                 }
             } else {
 
                 // list appraisees
                 $appr_ids = array();
 
                 // use given code (if proper external one)
                 if ($anonymous_code) {
                     $anonymous_id = $survey->getAnonymousIdByCode($anonymous_code);
                     if ($anonymous_id) {
                         $appr_ids = $survey->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 && $this->user->getId() !== ANONYMOUS_USER_ID) {
                     $appr_ids = $survey->getAppraiseesToRate($this->user->getId());
                 }
 
                 if (count($appr_ids)) {
                     // map existing runs to appraisees
                     $active_appraisees = array();
                     foreach ($this->run_manager
                                  ->getRunsForUser($this->user->getId(), $anonymous_code) as $item) {
                         $active_appraisees[$item->getAppraiseeId()] = $item->getFinished();
                     }
 
                     $list = array();
                     foreach ($appr_ids as $appr_id) {
                         if ($survey->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"));
 
                     if (!$this->status_manager->isAppraisee()) {
                         $this->addPrivacyInfo($info);
                     }
 
                     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", "");
 
                             $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 (!$status_manager->isAppraisee()) {
                     $this->main_tpl->setOnScreenMessage('failure', $this->lng->txt("survey_360_no_appraisees"));
                 }
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ displayNotStartableReasons()

ILIAS\Survey\InfoScreen\InfoScreenGUI::displayNotStartableReasons ( \ilInfoScreenGUI $info )

protected

Definition at line 382 of file class.InfoScreenGUI.php.

References $messages, ILIAS\Survey\InfoScreen\InfoScreenGUI\$survey, ILIAS\Repository\ctrl(), ilDatePresentation\formatDate(), IL_CAL_TIMESTAMP, ILIAS\Repository\lng(), ilInfoScreenGUI\setMessageBox(), and ILIAS\Repository\ui().

Referenced by ILIAS\Survey\InfoScreen\InfoScreenGUI\getInfoScreenGUI().

                                                                          : void
     {
         $survey = $this->survey;
 
         $links = [];
 
         if (!$this->access_manager->canStartSurvey() &&
             $this->access_manager->canEditSettings()) {
             $messages = [];
 
             if (!$survey->hasStarted()) {
                 $messages[] = $this->lng->txt('start_date_not_reached') . ' (' .
                     \ilDatePresentation::formatDate(new \ilDateTime(
                         $survey->getStartDate(),
                         IL_CAL_TIMESTAMP
                     )) . ")";
             }
 
             if ($survey->hasEnded()) {
                 $messages[] = $this->lng->txt('end_date_reached') . ' (' .
                     \ilDatePresentation::formatDate(new \ilDateTime($survey->getEndDate(), IL_CAL_TIMESTAMP)) . ")";
             }
 
             if ($survey->getOfflineStatus()) {
                 $messages[] = $this->lng->txt("survey_is_offline");
             }
 
             if (count($messages) > 0) {
                 $links[] = $this->ui->factory()->link()->standard(
                     $this->lng->txt("survey_edit_settings"),
                     $this->ctrl->getLinkTarget($this->survey_gui, "properties")
                 );
                 $mbox = $this->ui->factory()->messageBox()->info(implode("<br />", $messages));
                 if (count($links) > 0) {
                     $mbox = $mbox->withLinks($links);
                 }
                 $info->setMessageBox($mbox);
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getInfoScreenGUI()

ILIAS\Survey\InfoScreen\InfoScreenGUI::getInfoScreenGUI ( )

Definition at line 81 of file class.InfoScreenGUI.php.

References Vendor\Package\$e, ILIAS\Survey\InfoScreen\InfoScreenGUI\$status_manager, ILIAS\Survey\InfoScreen\InfoScreenGUI\$survey, ILIAS\Survey\InfoScreen\InfoScreenGUI\$toolbar, ILIAS\Survey\InfoScreen\InfoScreenGUI\$user, ILIAS\Survey\InfoScreen\InfoScreenGUI\addAppraiseeInfo(), ILIAS\Survey\InfoScreen\InfoScreenGUI\addStartResumeSection(), ILIAS\Repository\ctrl(), ILIAS\Survey\InfoScreen\InfoScreenGUI\displayNotStartableReasons(), ilSubmitButton\getInstance(), ilLinkButton\getInstance(), and ILIAS\Repository\lng().

                                       : \ilInfoScreenGUI
     {
         $user = $this->user;
         $toolbar = $this->toolbar;
         $status_manager = $this->status_manager;
         $survey = $this->survey;
 
         $external_rater = $status_manager->isExternalRater();
 
         $output_gui = new \ilSurveyExecutionGUI($survey);
 
         $info = new \ilInfoScreenGUI($this->survey_gui);
         $info->enablePrivateNotes();
 
         // appraisee infos
         $this->addAppraiseeInfo($info);
 
         // handle (anonymous) code
 
         try {
             $this->run_manager->initSession($this->requested_code);
         } catch (\ilWrongSurveyCodeException $e) {
             $this->main_tpl->setOnScreenMessage("failure", $e->getMessage(), true);
             $this->ctrl->redirect($this->survey_gui, "infoScreen");
         }
         $anonymous_code = $this->run_manager->getCode();
 
         // completed message
         if ($this->status_manager->cantStartAgain()) {
             $this->main_tpl->setOnScreenMessage('info', $this->lng->txt("already_completed_survey"));
         }
 
         $separator = false;
 
         // view results button
         if ($this->status_manager->canViewUserResults()) {
             $button = \ilLinkButton::getInstance();
             $button->setCaption("svy_view_own_results");
             $button->setUrl($this->ctrl->getLinkTarget($this->survey_gui, "viewUserResults"));
             $toolbar->addButtonInstance($button);
             $separator = true;
         }
 
         // confirmation mail button / input
         if ($this->status_manager->canMailUserResults()) {
             if ($separator) {
                 $toolbar->addSeparator();
             }
 
             if (!$user->getEmail()) {
                 $mail = new \ilTextInputGUI($this->lng->txt("email"), "mail");
                 $mail->setSize(25);
                 $mail->setValue($user->getEmail());
                 $toolbar->addInputItem($mail, true);
             }
 
             $toolbar->setFormAction($this->ctrl->getFormAction($this->survey_gui, "mailUserResults"));
 
             $button = \ilSubmitButton::getInstance();
             $button->setCaption("svy_mail_send_confirmation");
             $button->setCommand("mailUserResults");
             $toolbar->addButtonInstance($button);
         }
 
         $this->displayNotStartableReasons($info);
 
         if ($status_manager->mustEnterCode($anonymous_code)) {
             $info->setFormAction($this->ctrl->getFormAction($this->survey_gui, "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);
         }
 
         // display start / resume links/buttons
         $this->addStartResumeSection($info, $anonymous_code, $output_gui);
 
         if ($status_manager->canAddItselfAsAppraisee()) { // #14968
             $link = $this->ctrl->getLinkTargetByClass("ilsurveyparticipantsgui", "addSelfAppraisee");
             $toolbar->addButton(
                 $this->lng->txt("survey_360_add_self_appraisee"),
                 $link
             );
         }
 
         //if ($big_button) {
         /*
         $toolbar->setFormAction($this->ctrl->getFormAction($output_gui, "infoScreen"));
 
         $toolbar->setCloseFormTag(false);
         $info->setOpenFormTag(false);*/
         //}
         /* #12016
         else
         {
             $info->setFormAction($this->ctrl->getFormAction($output_gui, "infoScreen"));
         }
         */
         $toolbar->setFormAction($this->ctrl->getFormAction($output_gui, "infoScreen"));
 
         // introduction
         if ($survey->getIntroduction() !== '') {
             $introduction = $survey->getIntroduction();
             $info->addSection($this->lng->txt("introduction"));
             $info->addProperty("", $survey->prepareTextareaOutput($introduction) .
                 "<br />" . $info->getHiddenToggleButton());
         } else {
             $info->addSection($this->lng->txt("show_details"));
             $info->addProperty("", $info->getHiddenToggleButton());
         }
 
         $info->hideFurtherSections(false);
 
         if (!$this->feature_config->usesAppraisees()) {
             $info->addSection($this->lng->txt("svy_general_properties"));
 
             $info->addProperty(
                 $this->lng->txt("survey_results_anonymization"),
                 !$survey->hasAnonymizedResults()
                     ? $this->lng->txt("survey_results_personalized_info")
                     : $this->lng->txt("survey_results_anonymized_info")
             );
 
             if ($this->access_manager->canAccessEvaluation()) {
                 $info->addProperty($this->lng->txt("evaluation_access"), $this->lng->txt("evaluation_access_info"));
             }
         }
 
         $info->addMetaDataSections($survey->getId(), 0, $survey->getType());
 
         return $info;
     }

Here is the call graph for this function:

Field Documentation

◆ $access_manager

Access AccessManager ILIAS\Survey\InfoScreen\InfoScreenGUI::$access_manager

protected

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

◆ $ctrl

ilCtrl ILIAS\Survey\InfoScreen\InfoScreenGUI::$ctrl

protected

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

◆ $feature_config

ILIAS Survey Mode FeatureConfig ILIAS\Survey\InfoScreen\InfoScreenGUI::$feature_config

protected

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

◆ $lng

ilLanguage ILIAS\Survey\InfoScreen\InfoScreenGUI::$lng

protected

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

◆ $main_tpl

ilGlobalTemplateInterface ILIAS\Survey\InfoScreen\InfoScreenGUI::$main_tpl

private

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

◆ $request

ServerRequestInterface ILIAS\Survey\InfoScreen\InfoScreenGUI::$request

protected

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

◆ $requested_code

string ILIAS\Survey\InfoScreen\InfoScreenGUI::$requested_code

protected

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

◆ $run_manager

Execution RunManager ILIAS\Survey\InfoScreen\InfoScreenGUI::$run_manager

protected

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

◆ $status_manager

Participants StatusManager ILIAS\Survey\InfoScreen\InfoScreenGUI::$status_manager

protected

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

Referenced by ILIAS\Survey\InfoScreen\InfoScreenGUI\addStartResumeSection(), and ILIAS\Survey\InfoScreen\InfoScreenGUI\getInfoScreenGUI().

◆ $survey

ilObjSurvey ILIAS\Survey\InfoScreen\InfoScreenGUI::$survey

protected

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

Referenced by ILIAS\Survey\InfoScreen\InfoScreenGUI\addAppraiseeInfo(), ILIAS\Survey\InfoScreen\InfoScreenGUI\addPrivacyInfo(), ILIAS\Survey\InfoScreen\InfoScreenGUI\addStartResumeSection(), ILIAS\Survey\InfoScreen\InfoScreenGUI\displayNotStartableReasons(), and ILIAS\Survey\InfoScreen\InfoScreenGUI\getInfoScreenGUI().

◆ $survey_gui

ilObjSurveyGUI ILIAS\Survey\InfoScreen\InfoScreenGUI::$survey_gui

protected

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

◆ $toolbar

ilToolbarGUI ILIAS\Survey\InfoScreen\InfoScreenGUI::$toolbar

protected

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

Referenced by ILIAS\Survey\InfoScreen\InfoScreenGUI\getInfoScreenGUI().

◆ $ui

ILIAS DI UIServices ILIAS\Survey\InfoScreen\InfoScreenGUI::$ui

protected

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

◆ $user

ilObjUser ILIAS\Survey\InfoScreen\InfoScreenGUI::$user

protected

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

Referenced by ILIAS\Survey\InfoScreen\InfoScreenGUI\getInfoScreenGUI().

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

Modules/Survey/InfoScreen/class.InfoScreenGUI.php

Public Member Functions

Protected Member Functions

Protected Attributes

Private Attributes

Detailed Description

Member Function Documentation

◆ addAppraiseeInfo()

◆ addPrivacyInfo()

◆ addStartResumeSection()

◆ displayNotStartableReasons()

◆ getInfoScreenGUI()

Field Documentation

◆ $access_manager

◆ $ctrl

◆ $feature_config

◆ $lng

◆ $main_tpl

◆ $request

◆ $requested_code

◆ $run_manager

◆ $status_manager

◆ $survey

◆ $survey_gui

◆ $toolbar

◆ $ui

◆ $user