class.ilStudyProgrammeIndividualPlanTableGUI.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

class ilStudyProgrammeIndividualPlanTableGUI extends ilTable2GUI
{
    private const SEL_COLUMN_COMPLETION_DATE = "completion_date";
    private const SEL_COLUMN_DEADLINE = "prg_deadline";
    private const SEL_COLUMN_ASSIGNMENT_DATE = "assignment_date";

    protected ilDBInterface $db;

    protected ilPRGAssignment $assignment;
    protected string $possible_image;
    protected string $not_possible_image;

    public function __construct(
        ilObjStudyProgrammeIndividualPlanGUI $parent_obj,
        ilPRGAssignment $ass
    ) {
        $this->setId("manage_indiv");

        parent::__construct($parent_obj, 'manage');

        global $DIC;
        $this->ctrl = $DIC['ilCtrl'];
        $this->lng = $DIC['lng'];
        $this->db = $DIC['ilDB'];

        $this->assignment = $ass;

        $this->setEnableTitle(true);
        $this->setTopCommands(false);
        $this->setEnableHeader(true);
        // TODO: switch this to internal sorting/segmentation
        $this->setExternalSorting(false);
        $this->setExternalSegmentation(false);
        $this->setRowTemplate("tpl.individual_plan_table_row.html", "components/ILIAS/StudyProgramme");
        $this->setDefaultOrderDirection("asc");

        $this->getParentObject()->appendIndividualPlanActions($this);

        $columns = [
            "status",
            "title",
            "prg_points_current",
            "prg_points_required",
            "prg_manual_status",
            "prg_possible",
            "prg_changed_by",
            "prg_completion_by"
        ];

        foreach ($this->getSelectedColumns() as $column) {
            $columns[] = $column;
        }

        foreach ($columns as $lng_var) {
            $this->addColumn($this->lng->txt($lng_var));
        }

        $plan = $this->fetchData();

        $this->setMaxCount(count($plan));
        $this->setData($plan);

        $this->determineLimit();
        $this->determineOffsetAndOrder();

        $ui_factory = $DIC['ui.factory'];
        $ui_renderer = $DIC['ui.renderer'];
        $this->possible_image = $ui_renderer->render(
            $ui_factory->symbol()->icon()->custom(ilUtil::getImagePath("standard/icon_ok.svg"), 'ok')->withSize('small')
        );
        $this->not_possible_image = $ui_renderer->render(
            $ui_factory->symbol()->icon()->custom(ilUtil::getImagePath("standard/icon_not_ok.svg"), 'not ok')->withSize('small')
        );
    }

    protected function fillRow(array $a_set): void
    {
        $this->tpl->setVariable("STATUS", $a_set['status_repr']);

        $title = $a_set["title"];
        if ((int) $a_set["program_status"] === ilStudyProgrammeSettings::STATUS_DRAFT) {
            $title .= " (" . $this->lng->txt("prg_status_draft") . ")";
        } elseif ((int) $a_set["program_status"] === ilStudyProgrammeSettings::STATUS_OUTDATED) {
            $title .= " (" . $this->lng->txt("prg_status_outdated") . ")";
        }

        $this->tpl->setVariable("TITLE", $title);
        $this->tpl->setVariable("POINTS_CURRENT", $a_set["points_current"]);
        $this->tpl->setVariable(
            "POINTS_REQUIRED",
            $this->getRequiredPointsInput($a_set["progress_id"], $a_set["status"], (string) $a_set["points_required"])
        );
        $this->tpl->setVariable("MANUAL_STATUS", $this->getManualStatusSelect(
            $a_set["progress_id"],
            (int) $a_set["status"],
            (int) $a_set["program_status"],
        ));
        $this->tpl->setVariable("POSSIBLE", $a_set["possible"] ? $this->possible_image : $this->not_possible_image);
        $this->tpl->setVariable("CHANGED_BY", $a_set["changed_by"]);
        $this->tpl->setVariable("COMPLETION_BY", $a_set["completion_by"]);

        foreach ($this->getSelectedColumns() as $column) {
            switch ($column) {
                case self::SEL_COLUMN_ASSIGNMENT_DATE:
                    $this->tpl->setCurrentBlock("assignment_date");
                    $this->tpl->setVariable("ASSIGNMENT_DATE", $a_set["assignment_date"]);
                    $this->tpl->parseCurrentBlock("assignment_date");
                    break;
                case self::SEL_COLUMN_DEADLINE:
                    $this->tpl->setCurrentBlock("deadline");
                    $this->tpl->setVariable("DEADLINE", $this->getDeadlineInput($a_set["progress_id"], $a_set["deadline"]));
                    $this->tpl->parseCurrentBlock("deadline");
                    break;
                case self::SEL_COLUMN_COMPLETION_DATE:
                    $this->tpl->setCurrentBlock("completion_date");
                    $this->tpl->setVariable("COMPLETION_DATE", $a_set["completion_date"]);
                    $this->tpl->parseCurrentBlock("completion_date");
                    break;
            }
        }
    }

    public function getSelectableColumns(): array
    {
        $cols = array();

        $cols[self::SEL_COLUMN_ASSIGNMENT_DATE] = array(
                "txt" => $this->lng->txt("assignment_date"));
        $cols[self::SEL_COLUMN_DEADLINE] = array(
                "txt" => $this->lng->txt("prg_deadline"));
        $cols[self::SEL_COLUMN_COMPLETION_DATE] = array(
                "txt" => $this->lng->txt("completion_date"));
        return $cols;
    }

    protected function fetchData(): array
    {
        $prg_id = $this->assignment->getRootId();
        $prg = ilObjStudyProgramme::getInstanceByObjId($prg_id);

        $ass_id = $this->assignment->getId();
        $usr_id = $this->assignment->getUserId();
        $plan = array();

        $prg->applyToSubTreeNodes(
            function ($node) use ($prg_id, $ass_id, $usr_id, &$plan, $prg) {
                $progress = $this->assignment->getProgressForNode($node->getId());
                $completion_by = $progress->getCompletionBy();

                if ($completion_by === ilPRGProgress::COMPLETED_BY_SUBNODES) {
                    $successful_subnodes = array_filter(
                        $progress->getSubnodes(),
                        static fn(ilPRGProgress $pgs): bool => $pgs->isSuccessful()
                    );
                    $successful_subnode_ids = array_map(
                        static fn(ilPRGProgress $pgs): int => $pgs->getNodeId(),
                        $successful_subnodes
                    );
                    $out = array_map(
                        fn(int $node_obj_id): string => ilStudyProgrammeUserTable::lookupTitle($node_obj_id),
                        $successful_subnode_ids
                    );
                    $completion_by = implode(', ', $out);
                } else {
                    $completion_by = $progress->isSuccessful() ? ilStudyProgrammeUserTable::lookupTitle($completion_by) : '';
                }

                $programme = ilObjStudyProgramme::getInstanceByObjId($progress->getNodeId());
                $plan[] = [
                    "status" => $progress->getStatus(),
                    "status_repr" => $programme->statusToRepr($progress->getStatus()),
                    "title" => $node->getTitle(),
                    "points_current" => $progress->getCurrentAmountOfPoints(),
                    "points_required" => $progress->getAmountOfPoints(),
                    "possible" => $progress->isSuccessful()
                        || $programme->canBeCompleted($progress)
                        || (!$progress->isRelevant() && $programme->getStatus() !== ilStudyProgrammeSettings::STATUS_DRAFT),
                    "changed_by" => ilObjUser::_lookupLogin($progress->getLastChangeBy()),
                    "completion_by" => $completion_by,
                    "progress_id" => $progress->getId(),
                    //draft/active/outdated
                    "program_status" => $programme->getStatus(),
                    "assignment_date" => $progress->getAssignmentDate()->format('d.m.Y'),
                    "deadline" => $progress->isSuccessful() ? null : $progress->getDeadline(),
                    "completion_date" => $progress->getCompletionDate() ? $progress->getCompletionDate()->format('d.m.Y') : ''
                ];
            },
            true
        );
        return $plan;
    }

    protected function getManualStatusSelect(string $progress_id, int $status, int $node_lifecycle_status): string
    {
        $parent = $this->getParentObject();
        $options = [
            $parent::MANUAL_STATUS_NONE => '-',
            ilPRGProgress::STATUS_IN_PROGRESS => $this->lng->txt("prg_status_in_progress"),
            ilPRGProgress::STATUS_ACCREDITED => $this->lng->txt("prg_status_accredited"),
            ilPRGProgress::STATUS_NOT_RELEVANT => $this->lng->txt("prg_status_not_relevant")
            //COMPLETED/FAILED are not to be set manually.
        ];

        $allowed = ilPRGProgress::getAllowedTargetStatusFor($status);

        $options = array_filter(
            $options,
            static function ($o) use ($allowed, $parent, $node_lifecycle_status): bool {
                return (in_array($o, $allowed) || $o === $parent::MANUAL_STATUS_NONE)
                && ($node_lifecycle_status !== ilStudyProgrammeSettings::STATUS_DRAFT);
            },
            ARRAY_FILTER_USE_KEY
        );

        $select = new ilSelectInputGUI("", $parent::POST_VAR_STATUS . "[$progress_id]");
        $select->setOptions($options);
        $select->setValue($parent::MANUAL_STATUS_NONE);

        return $select->render();
    }

    protected function getRequiredPointsInput(string $progress_id, int $status, string $points_required): string
    {
        if ($status != ilPRGProgress::STATUS_IN_PROGRESS) {
            return $points_required;
        }

        $parent = $this->getParentObject();
        $input = new ilNumberInputGUI("", $parent::POST_VAR_REQUIRED_POINTS . "[$progress_id]");
        $input->setValue($points_required);
        $input->setSize(5);
        return $input->render();
    }

    protected function getDeadlineInput(string $progress_id, $deadline): string
    {
        $parent = $this->getParentObject();
        $gui = new ilDateTimeInputGUI("", $parent::POST_VAR_DEADLINE . "[$progress_id]");
        $gui->setDate($deadline ? new ilDateTime($deadline->format('Y-m-d H:i:s'), IL_CAL_DATETIME) : null);
        return $gui->render();
    }
}