class.AbstractUIModifier.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
namespace ILIAS\Survey\Mode;
 
use ILIAS\Survey\InternalGUIService;
use ILIAS\Survey\InternalDomainService;
use ILIAS\Survey\InternalService;
use ILIAS\UI\Component\Input\Container\Form;
use ILIAS\UI\Component\Modal;
 
abstract class AbstractUIModifier implements UIModifier
{
    protected InternalGUIService $gui;
    protected ?InternalService $service = null;
 
    public function __construct(InternalGUIService $gui)
    {
        $this->gui = $gui;
    }
 
    public function setInternalService(InternalService $internal_service): void
    {
        $this->service = $internal_service;
    }
 
    public function getInternalService(): InternalService
    {
        return $this->service;
    }
 
    public function getSurveySettingsGeneral(
        \ilObjSurvey $survey
    ): array {
        return [];
    }
 
    public function getSurveySettingsReminderTargets(
        \ilObjSurvey $survey,
        InternalGUIService $ui_service
    ): array {
        return [];
    }
 
    public function getSurveySettingsResults(
        \ilObjSurvey $survey,
        InternalGUIService $ui_service
    ): array {
        return [];
    }
 
    public function setValuesFromForm(
        \ilObjSurvey $survey,
        \ilPropertyFormGUI $form
    ): void {
    }
 
    public function setResultsOverviewToolbar(
        \ilObjSurvey $survey,
        int $user_id,
        \ilTemplate $eval_tpl
    ): array {
        $components = [];
 
        $config = $this->getInternalService()->domain()->modeFeatureConfig($survey->getMode());
        if ($config->usesAppraisees()) {
            $components = array_merge(
                $components,
                $this->getApprSelectionComponents($survey, $user_id)
            );
        }
 
        $components = array_merge(
            $components,
            $this->getExportAndPrintComponents($survey, false, $eval_tpl)
        );
 
        return $components;
    }
 
    public function setResultsCompetenceToolbar(
        \ilObjSurvey $survey,
        int $user_id
    ): array {
        return $this->getApprSelectionComponents($survey, $user_id);
    }
 
    public function setResultsDetailToolbar(
        \ilObjSurvey $survey,
        int $user_id,
        \ilTemplate $eval_tpl
    ): array {
        $components = [];
 
        $request = $this->service
            ->gui()
            ->evaluation($survey)
            ->request();
 
        $gui = $this->service->gui();
        $lng = $gui->lng();
        $ctrl = $gui->ctrl();
        $ui_fac = $gui->ui()->factory();
 
        $config = $this->getInternalService()->domain()->modeFeatureConfig($survey->getMode());
        if ($config->usesAppraisees()) {
            $components = array_merge(
                $components,
                $this->getApprSelectionComponents($survey, $user_id)
            );
        }
 
        $caption_options = [
            "ap" => $lng->txt("svy_eval_captions_abs_perc"),
            "a" => $lng->txt("svy_eval_captions_abs"),
            "p" => $lng->txt("svy_eval_captions_perc"),
        ];
        $current_cp = $request->getCP();
        $caption_items = [];
        foreach ($caption_options as $key => $label) {
            $ctrl->setParameterByClass("ilSurveyEvaluationGUI", "cp", $key);
            $ctrl->setParameterByClass("ilSurveyEvaluationGUI", "vw", $request->getVW());
            $caption_items[] = $ui_fac->button()->shy(
                $label,
                $ctrl->getLinkTargetByClass("ilSurveyEvaluationGUI", "evaluationdetails")
            );
        }
        // reset parameter
        $ctrl->setParameterByClass("ilSurveyEvaluationGUI", "cp", $current_cp);
        $components[] = $ui_fac->dropdown()->standard($caption_items)
                               ->withLabel($caption_options[$current_cp] ?? $lng->txt("svy_eval_captions"));
 
        // View dropdown (replaces ilSelectInputGUI "vw")
        $view_options = [
            "tc" => $lng->txt("svy_eval_view_tables_charts"),
            "t" => $lng->txt("svy_eval_view_tables"),
            "c" => $lng->txt("svy_eval_view_charts"),
        ];
        $current_vw = $request->getVW();
        $view_items = [];
        foreach ($view_options as $key => $label) {
            $ctrl->setParameterByClass("ilSurveyEvaluationGUI", "vw", $key);
            $ctrl->setParameterByClass("ilSurveyEvaluationGUI", "cp", $request->getCP());
            $view_items[] = $ui_fac->button()->shy(
                $label,
                $ctrl->getLinkTargetByClass("ilSurveyEvaluationGUI", "evaluationdetails")
            );
        }
        // reset parameter
        $ctrl->setParameterByClass("ilSurveyEvaluationGUI", "vw", $current_vw);
        $components[] = $ui_fac->dropdown()->standard($view_items)
                               ->withLabel($view_options[$current_vw] ?? $lng->txt("svy_eval_view"));
 
        // Separator + export/print
        $components = array_merge(
            $components,
            $this->getExportAndPrintComponents($survey, true, $eval_tpl)
        );
 
        return $components;
    }
 
    public function setResultsParticipantToolbar(
        \ilObjSurvey $survey,
        int $user_id
    ): array {
        $components = [];
 
        $config = $this->getInternalService()->domain()->modeFeatureConfig($survey->getMode());
        if ($config->usesAppraisees()) {
            $components = array_merge(
                $components,
                $this->getApprSelectionComponents($survey, $user_id)
            );
        }
 
        return $components;
    }
 
    protected function getExportAndPrintComponents(
        \ilObjSurvey $survey,
        bool $details,
        \ilTemplate $eval_tpl
    ): array {
        $components = [];
 
        // Export button + modal
        $this->buildExportButtonAndModal($eval_tpl, $details ? "exportDetailData" : "exportData");
 
        if ($details) {
            $pv = $this->service->gui()->print()->resultsDetails($survey->getRefId());
            $this->service->gui()->ctrl()->setParameterByClass(
                "ilSurveyEvaluationGUI",
                "vw",
                $this->service->gui()->evaluation($survey)->request()->getVW()
            );
            $this->service->gui()->ctrl()->setParameterByClass(
                "ilSurveyEvaluationGUI",
                "cp",
                $this->service->gui()->evaluation($survey)->request()->getCP()
            );
            $modal_elements = $pv->getModalElements(
                $this->service->gui()->ctrl()->getLinkTargetByClass(
                    "ilSurveyEvaluationGUI",
                    "printResultsDetailsSelection"
                )
            );
        } else {
            $pv = $this->service->gui()->print()->resultsOverview($survey->getRefId());
            $modal_elements = $pv->getModalElements(
                $this->service->gui()->ctrl()->getLinkTargetByClass(
                    "ilSurveyEvaluationGUI",
                    "printResultsOverviewSelection"
                )
            );
        }
 
        $components[] = $modal_elements->button;
        $components[] = $modal_elements->modal;
 
        return $components;
    }
 
    protected function getApprSelectionComponents(
        \ilObjSurvey $survey,
        int $user_id
    ): array {
        $this->addApprSelectionToToolbar(
            $survey,
            $this->gui->toolbar(),
            $user_id
        );
        return [];
    }
 
    protected function buildExportButtonAndModal(
        \ilTemplate $eval_tpl,
        string $export_cmd
    ): void {
        $lng = $this->gui->lng();
        $ctrl = $this->gui->ctrl();
        $toolbar = $this->gui->toolbar();
        $ui_fac = $this->gui->ui()->factory();
        $ui_ren = $this->gui->ui()->renderer();
        $ui_request = $this->gui->http()->request();
 
        $ctrl->setParameterByClass("ilsurveyevaluationgui", "export_cmd", $export_cmd);
        $modal = $this->getExportModal();
        $button = $ui_fac->button()->standard(
            $lng->txt("export"),
            "#"
        )->withOnClick($modal->getShowSignal());
 
        $toolbar->addComponent($button);
        if ("POST" === $ui_request->getMethod()
            && isset($ui_request->getQueryParams()["fallbackCmd"])
            && $ui_request->getQueryParams()["fallbackCmd"] === "validateAndSubmitExportForm") {
            $modal = $modal->withRequest($ui_request);
            $eval_tpl->setVariable("MODAL", $ui_ren->render($modal->withOnLoad($modal->getShowSignal())));
        } else {
            $eval_tpl->setVariable("MODAL", $ui_ren->render($modal));
        }
    }
 
    protected function getExportModal(): Modal\RoundTrip|Form\Standard
    {
        $lng = $this->gui->lng();
        $ctrl = $this->gui->ctrl();
        $ui_fac = $this->gui->ui()->factory();
 
        $post_url = $ctrl->getFormActionByClass("ilsurveyevaluationgui", "validateAndSubmitExportForm");
 
        $inputs["export_format"] = $ui_fac->input()->field()->select(
            $lng->txt("filetype"),
            [
                \ilSurveyEvaluationGUI::TYPE_XLS => $lng->txt("exp_type_excel"),
                \ilSurveyEvaluationGUI::TYPE_SPSS => $lng->txt("exp_type_csv")
            ]
        )
            //->withValue(\ilSurveyEvaluationGUI::TYPE_XLS)
                                          ->withRequired(true);
 
        $inputs["export_label"] = $ui_fac->input()->field()->select(
            $lng->txt("title"),
            [
                "label_only" => $lng->txt("export_label_only"),
                "title_only" => $lng->txt("export_title_only"),
                "title_label" => $lng->txt("export_title_label")
            ]
        )
            //->withValue("label_only")
                                         ->withRequired(true);
 
        $modal = $ui_fac->modal()->roundtrip(
            $lng->txt("svy_export_format"),
            null,
            $inputs,
            $post_url
        )
                        ->withSubmitLabel($lng->txt("export"));
 
        return $modal;
    }
 
    public function addApprSelectionToToolbar(
        \ilObjSurvey $survey,
        \ilToolbarGUI $toolbar,
        int $user_id
    ): void {
        $lng = $this->service->gui()->lng();
        $ctrl = $this->service->gui()->ctrl();
        $req = $this->service->gui()->evaluation($survey)->request();
 
        $evaluation_manager = $this->service->domain()->evaluation(
            $survey,
            $user_id,
            $req->getAppraiseeId(),
            $req->getRaterId()
        );
 
        if ($evaluation_manager->isMultiParticipantsView()) {
            $appr_id = $evaluation_manager->getCurrentAppraisee();
            $options = array();
            if (!$appr_id) {
                $options[""] = $lng->txt("please_select");
            }
 
            foreach ($evaluation_manager->getSelectableAppraisees() as $appraisee_usr_id) {
                $options[$appraisee_usr_id] = \ilUserUtil::getNamePresentation(
                    $appraisee_usr_id,
                    false,
                    false,
                    "",
                    true
                );
            }
 
            $appr = new \ilSelectInputGUI($lng->txt("survey_360_appraisee"), "appr_id");
            $appr->setOptions($options);
            $appr->setValue($appr_id);
            $toolbar->addInputItem($appr, true);
 
            $this->gui->button(
                $lng->txt("survey_360_select_appraisee"),
                $ctrl->getCmd()
            )->submit()->toToolbar(false, $toolbar);
 
            if ($appr_id) {
                $toolbar->addSeparator();
            }
        }
    }
 
    public function getDetailPanels(
        array $participants,
        \ILIAS\Survey\Evaluation\EvaluationGUIRequest $request,
        \SurveyQuestionEvaluation $a_eval
    ): array {
        $a_results = $a_eval->getResults();
        $panels = [];
        $ui_factory = $this->service->gui()->ui()->factory();
 
        $a_tpl = new \ilTemplate(
            "tpl.svy_results_details_panel.html",
            true,
            true,
            "components/ILIAS/Survey/Evaluation"
        );
 
        $question_res = $a_results;
        $matrix = false;
        if (is_array($question_res)) {
            $question_res = $question_res[0][1];
            $matrix = true;
        }
 
        if (!is_object($question_res)) {
            return [];
        }
 
        $question = $question_res->getQuestion();
 
        $qst_title = $question->getTitle();
        $svy_text = nl2br($question->getQuestiontext());
 
        $anchor_id = "svyrdq" . $question->getId();
        $title = "<span id='$anchor_id'>$qst_title</span>";
        $panel_qst_card = $ui_factory->panel()->sub($title, $ui_factory->legacy()->content($svy_text))
                                     ->withFurtherInformation($this->getPanelCard($question_res));
 
        $panels[] = $panel_qst_card;
 
        $a_tpl->setVariable(
            "TABLE",
            $this->getPanelTable(
                $participants,
                $request,
                $a_eval
            )
        );
 
        $a_tpl->setVariable(
            "TEXT",
            $this->getPanelText(
                $request,
                $a_eval,
                $question_res
            )
        );
 
        $a_tpl->setVariable(
            "CHART",
            $this->getPanelChart(
                $request,
                $a_eval
            )
        );
 
        $panels[] = $ui_factory->panel()->sub("", $ui_factory->legacy()->content($a_tpl->get()));
        return $panels;
    }
 
    protected function getPanelTable(
        array $participants,
        \ILIAS\Survey\Evaluation\EvaluationGUIRequest $request,
        \SurveyQuestionEvaluation $a_eval
    ): string {
        $a_results = $a_eval->getResults();
 
        $a_tpl = new \ilTemplate(
            "tpl.svy_results_details_table.html",
            true,
            true,
            "components/ILIAS/Survey/Evaluation"
        );
 
        if ($request->getShowTable()) {
            $grid = $a_eval->getGrid(
                $a_results,
                $request->getShowAbsolute(),
                $request->getShowPercentage()
            );
            if ($grid) {
                foreach ($grid["cols"] as $col) {
                    $a_tpl->setCurrentBlock("grid_col_header_bl");
                    $a_tpl->setVariable("COL_HEADER", $col);
                    $a_tpl->parseCurrentBlock();
                }
                foreach ($grid["rows"] as $cols) {
                    foreach ($cols as $idx => $col) {
                        if ($idx > 0) {
                            $a_tpl->touchBlock("grid_col_nowrap_bl");
                        }
 
                        $a_tpl->setCurrentBlock("grid_col_bl");
                        $a_tpl->setVariable("COL_CAPTION", trim((string) ($col ?? "")));
                        $a_tpl->parseCurrentBlock();
                    }
 
                    $a_tpl->touchBlock("grid_row_bl");
                }
            }
        }
        return $a_tpl->get();
    }
 
    protected function getPanelChart(
        \ILIAS\Survey\Evaluation\EvaluationGUIRequest $request,
        \SurveyQuestionEvaluation $a_eval
    ): string {
        $a_results = $a_eval->getResults();
 
        $a_tpl = new \ilTemplate(
            "tpl.svy_results_details_chart.html",
            true,
            true,
            "components/ILIAS/Survey/Evaluation"
        );
        if ($request->getShowChart()) {
            $chart = $a_eval->getChart($a_results);
            if ($chart) {
                if (is_array($chart)) {
                    if (is_array($chart[1])) {
                        foreach ($chart[1] as $legend_item) {
                            $r = hexdec(substr($legend_item[1], 1, 2));
                            $g = hexdec(substr($legend_item[1], 3, 2));
                            $b = hexdec(substr($legend_item[1], 5, 2));
 
                            $a_tpl->setCurrentBlock("legend_bl");
                            $a_tpl->setVariable("LEGEND_CAPTION", $legend_item[0]);
                            $a_tpl->setVariable("LEGEND_COLOR", $legend_item[1]);
                            $a_tpl->setVariable("LEGEND_COLOR_SVG", $r . "," . $g . "," . $b);
                            $a_tpl->parseCurrentBlock();
                        }
                    }
 
                    $chart = $chart[0];
                }
 
                $a_tpl->setVariable("CHART", $chart);
            }
        }
 
        return $a_tpl->get();
    }
 
    protected function getPanelText(
        \ILIAS\Survey\Evaluation\EvaluationGUIRequest $request,
        \SurveyQuestionEvaluation $a_eval,
        \ilSurveyEvaluationResults $question_res
    ): string {
        $a_results = $a_eval->getResults();
        $question = $question_res->getQuestion();
        $lng = $this->service->gui()->lng();
 
        $a_tpl = new \ilTemplate("tpl.svy_results_details_text.html", true, true, "components/ILIAS/Survey/Evaluation");
 
        $texts = $a_eval->getTextAnswers($a_results);
        if ($texts) {
            if (array_key_exists("", $texts)) {
                $a_tpl->setVariable("TEXT_HEADING", $lng->txt("given_answers"));
                foreach ($texts[""] as $item) {
                    $a_tpl->setCurrentBlock("text_direct_item_bl");
                    $a_tpl->setVariable("TEXT_DIRECT", nl2br(htmlentities($item)));
                    $a_tpl->parseCurrentBlock();
                }
            } else {
                $acc = new \ilAccordionGUI();
                $acc->setId("svyevaltxt" . $question->getId());
 
                $a_tpl->setVariable("TEXT_HEADING", $lng->txt("freetext_answers"));
 
                foreach ($texts as $var => $items) {
                    $list = array("<ul class=\"small\">");
                    foreach ($items as $item) {
                        $list[] = "<li>" . nl2br(htmlentities($item)) . "</li>";
                    }
                    $list[] = "</ul>";
                    $acc->addItem((string) $var, implode("\n", $list));
                }
 
                $a_tpl->setVariable("TEXT_ACC", $acc->getHTML());
            }
        }
        return $a_tpl->get();
    }
 
    protected function getPanelCard(
        \ilSurveyEvaluationResults $question_res
    ): \ILIAS\UI\Component\Card\Card {
        $ui_factory = $this->service->gui()->ui()->factory();
        $lng = $this->service->gui()->lng();
 
        $question = $question_res->getQuestion();
        $kv = array();
        $kv["users_answered"] = $question_res->getUsersAnswered();
        $kv["users_skipped"] = $question_res->getUsersSkipped();
 
        $card_table_tpl = new \ilTemplate(
            "tpl.svy_results_details_card.html",
            true,
            true,
            "components/ILIAS/Survey/Evaluation"
        );
 
        if (true) {     // formerly check for matrix type, shouldnt be needed
            if ($question_res->getModeValue() !== null) {
                $kv["mode"] = wordwrap($question_res->getModeValueAsText(), 50, "<br />");
                $kv["mode_nr_of_selections"] = $question_res->getModeNrOfSelections();
            }
            if ($question_res->getMedian() !== null) {
                $kv["median"] = $question_res->getMedianAsText();
            }
            if ($question_res->getMean() !== null) {
                $kv["arithmetic_mean"] = $question_res->getMean();
            }
        }
 
        foreach ($kv as $key => $value) {
            $card_table_tpl->setCurrentBlock("question_statistics_card");
            $card_table_tpl->setVariable("QUESTION_STATISTIC_KEY", $lng->txt($key));
            $card_table_tpl->setVariable("QUESTION_STATISTIC_VALUE", $value);
            $card_table_tpl->parseCurrentBlock();
        }
 
        $svy_type_title = \SurveyQuestion::_getQuestionTypeName($question->getQuestionType());
 
        return $ui_factory->card()
                          ->standard($svy_type_title)
                          ->withSections(
                              array($ui_factory->legacy()->content($card_table_tpl->get()))
                          );
    }
}