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.

     : 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)
                        )
                    );
                }
            }
        }
    }

References $txt, 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().

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.

     : 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);
    }

References ILIAS\Repository\lng().

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

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

ilCtrlException

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

     : 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"));
                }
            }
        }
    }

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(), ilObjSurvey\getAnonymousIdByCode(), ilObjSurvey\getAppraiseesToRate(), ilLinkButton\getInstance(), ilSubmitButton\getInstance(), ilUserUtil\getNamePresentation(), ILIAS\Survey\Participants\StatusManager\isAppraisee(), ilObjSurvey\isAppraiseeClosed(), ILIAS\Repository\lng(), ILIAS\Repository\toolbar(), and ILIAS\Repository\user().

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

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.

                                                                         : 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);
            }
        }
    }

References $messages, ilDatePresentation\formatDate(), IL_CAL_TIMESTAMP, ILIAS\Repository\lng(), ilInfoScreenGUI\setMessageBox(), and ILIAS\Repository\ui().

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

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.

                                      : \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;
    }

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(), ilToolbarGUI\addButtonInstance(), ilToolbarGUI\addInputItem(), ilToolbarGUI\addSeparator(), ILIAS\Survey\InfoScreen\InfoScreenGUI\addStartResumeSection(), ILIAS\Survey\Participants\StatusManager\canAddItselfAsAppraisee(), ILIAS\Repository\ctrl(), ILIAS\Survey\InfoScreen\InfoScreenGUI\displayNotStartableReasons(), ilObjUser\getEmail(), ilObject\getId(), ilLinkButton\getInstance(), ilSubmitButton\getInstance(), ilObjSurvey\getIntroduction(), ilObject\getType(), ILIAS\Survey\Participants\StatusManager\isExternalRater(), ILIAS\Repository\lng(), ILIAS\Survey\Participants\StatusManager\mustEnterCode(), ilObjSurvey\prepareTextareaOutput(), and ilToolbarGUI\setFormAction().

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\addStartResumeSection(), 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