Collaboration diagram for ilMarkSchemaGUI:

Public Member Functions
	executeCommand ()

Protected Member Functions
	ensureMarkSchemaCanBeEdited ()

	ensureEctsGradesCanBeEdited ()

	addMarkStep ()

	saveMarkSchemaFormData ()

	resetToSimpleMarkSchema ()

	deleteMarkSteps ()

	saveMarks ()

	showMarkSchema (?ilPropertyFormGUI $ects_form=null)

	populateEctsForm (ilPropertyFormGUI $form)

	getEctsForm ()

	saveEctsForm ()

Protected Attributes
	$object

ilLanguage	$lng

ilCtrl	$ctrl

ilGlobalPageTemplate	$tpl

ilToolbarGUI	$toolbar

ilTabsGUI	$tabs

UIFactory	$ui_factory

UIRenderer	$ui_renderer

Private Member Functions
	objectSupportsEctsGrades ()

	populateToolbar (InterruptiveModal $confirmation_modal, string $mark_schema_id)

	buildCreateStepButton (string $mark_schema_id)

Private Attributes
const	RESET_MARK_BUTTON_LABEL = 'tst_mark_reset_to_simple_mark_schema'

RequestWrapper	$post_wrapper

Request	$request

Refinery	$refinery

Detailed Description

Definition at line 32 of file class.ilMarkSchemaGUI.php.

Member Function Documentation

◆ addMarkStep()

ilMarkSchemaGUI::addMarkStep ( )

protected

Definition at line 99 of file class.ilMarkSchemaGUI.php.

                                    : void
    {
        $this->ensureMarkSchemaCanBeEdited();
 
        if ($this->saveMarkSchemaFormData()) {
            $this->object->getMarkSchema()->addMarkStep();
        } else {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('mark_schema_invalid'), true);
        }
        $this->showMarkSchema();
    }

References ensureMarkSchemaCanBeEdited(), ILIAS\Repository\lng(), saveMarkSchemaFormData(), and showMarkSchema().

Here is the call graph for this function:

◆ buildCreateStepButton()

ilMarkSchemaGUI::buildCreateStepButton ( string $mark_schema_id )

private

Definition at line 275 of file class.ilMarkSchemaGUI.php.

                                                                  : StandardButton
    {
        return $this->ui_factory->button()->standard(
            $this->lng->txt('tst_mark_create_new_mark_step'),
            ''
        )->withAdditionalOnLoadCode(
            fn (string $id): string =>
            "{$id}.addEventListener('click', "
            . ' (e) => {'
            . '     e.preventDefault();'
            . '     e.target.name = "cmd[addMarkStep]";'
            . "     let form = document.getElementById('form_{$mark_schema_id}');"
            . '     let submitter = e.target.cloneNode();'
            . '     submitter.style.visibility = "hidden";'
            . '     form.appendChild(submitter);'
            . '     form.requestSubmit(submitter);'
            . ' }'
            . ');'
        );
    }

References $id, and ILIAS\Repository\lng().

Referenced by populateToolbar().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteMarkSteps()

ilMarkSchemaGUI::deleteMarkSteps ( )

protected

Definition at line 161 of file class.ilMarkSchemaGUI.php.

                                        : void
    {
        $marks_trafo = $this->refinery->custom()->transformation(
            function ($vs): ?array {
                if ($vs === null || !is_array($vs)) {
                    return null;
                }
                return $vs;
            }
        );
        $deleted_mark_steps = null;
        if ($this->post_wrapper->has('marks')) {
            $deleted_mark_steps = $this->post_wrapper->retrieve(
                'marks',
                $marks_trafo
            );
        }
 
        $this->ensureMarkSchemaCanBeEdited();
        if (!isset($deleted_mark_steps) || !is_array($deleted_mark_steps)) {
            $this->showMarkSchema();
            return;
        }
 
        // test delete
        $schema = clone $this->object->getMarkSchema();
        $schema->deleteMarkSteps($deleted_mark_steps);
        $check_result = $schema->checkMarks();
        if (is_string($check_result)) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt($check_result), true);
            $this->showMarkSchema();
            return;
        }
 
        //  actual delete
        if (!empty($deleted_mark_steps)) {
            $this->object->getMarkSchema()->deleteMarkSteps($deleted_mark_steps);
        } else {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt('tst_delete_missing_mark'));
        }
        $this->object->getMarkSchema()->saveToDb($this->object->getTestId());
 
        $this->showMarkSchema();
    }

References ensureMarkSchemaCanBeEdited(), ILIAS\Repository\lng(), ILIAS\Repository\object(), ILIAS\Repository\refinery(), and showMarkSchema().

Here is the call graph for this function:

◆ ensureEctsGradesCanBeEdited()

ilMarkSchemaGUI::ensureEctsGradesCanBeEdited ( )

protected

Definition at line 91 of file class.ilMarkSchemaGUI.php.

                                                    : void
    {
        if (!$this->object->canEditEctsGrades()) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('permission_denied'), true);
            $this->ctrl->redirect($this, 'showMarkSchema');
        }
    }

References ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

Referenced by saveEctsForm().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ensureMarkSchemaCanBeEdited()

ilMarkSchemaGUI::ensureMarkSchemaCanBeEdited ( )

protected

Definition at line 83 of file class.ilMarkSchemaGUI.php.

                                                    : void
    {
        if (!$this->object->canEditMarks()) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('permission_denied'), true);
            $this->ctrl->redirect($this, 'showMarkSchema');
        }
    }

References ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

Referenced by addMarkStep(), deleteMarkSteps(), resetToSimpleMarkSchema(), and saveMarks().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ executeCommand()

ilMarkSchemaGUI::executeCommand ( )

Definition at line 71 of file class.ilMarkSchemaGUI.php.

                                    : void
    {
        global $DIC;
 
        $DIC->tabs()->activateTab(ilTestTabsManager::TAB_ID_SETTINGS);
        $cmd = $this->ctrl->getCmd('showMarkSchema');
        if ($cmd === self::RESET_MARK_BUTTON_LABEL) {
            $cmd = 'resetToSimpleMarkSchema';
        }
        $this->$cmd();
    }

References $DIC, ILIAS\Repository\ctrl(), and ilTestTabsManager\TAB_ID_SETTINGS.

Here is the call graph for this function:

◆ getEctsForm()

ilMarkSchemaGUI::getEctsForm ( )

protected

Definition at line 313 of file class.ilMarkSchemaGUI.php.

                                    : ilPropertyFormGUI
    {
        require_once 'Services/Form/classes/class.ilPropertyFormGUI.php';
 
        $disabled = !$this->object->canEditEctsGrades();
 
        $form = new ilPropertyFormGUI();
        $form->setFormAction($this->ctrl->getFormAction($this, 'saveEctsForm'));
        $form->setTitle($this->lng->txt('ects_output_of_ects_grades'));
 
        $allow_ects_marks = new ilCheckboxInputGUI($this->lng->txt('ects_allow_ects_grades'), 'ectcs_status');
        $allow_ects_marks->setDisabled($disabled);
        for ($i = ord('a'); $i <= ord('e'); $i++) {
            $mark = chr($i);
 
            $mark_step = new ilNumberInputGUI(chr($i - 32), 'ects_grade_' . $mark);
            $mark_step->setInfo(
                $this->lng->txt('ects_grade_desc_prefix') . ' ' . $this->lng->txt('ects_grade_' . $mark . '_desc')
            );
            $mark_step->setSize(5);
            $mark_step->allowDecimals(true);
            $mark_step->setMinValue(0, true);
            $mark_step->setMaxValue(100, true);
            $mark_step->setSuffix($this->lng->txt('percentile'));
            $mark_step->setRequired(true);
            $mark_step->setDisabled($disabled);
            $allow_ects_marks->addSubItem($mark_step);
        }
 
        $mark_step = new ilNonEditableValueGUI('F', 'ects_grade_f');
        $mark_step->setInfo(
            $this->lng->txt('ects_grade_desc_prefix') . ' ' . $this->lng->txt('ects_grade_f_desc')
        );
        $allow_ects_marks->addSubItem($mark_step);
 
        $use_ects_fx = new ilCheckboxInputGUI($this->lng->txt('use_ects_fx'), 'use_ects_fx');
        $use_ects_fx->setDisabled($disabled);
        $allow_ects_marks->addSubItem($use_ects_fx);
 
        $mark_step = new ilNonEditableValueGUI('FX', 'ects_grade_fx');
        $mark_step->setInfo(
            $this->lng->txt('ects_grade_desc_prefix') . ' ' . $this->lng->txt('ects_grade_fx_desc')
        );
        $use_ects_fx->addSubItem($mark_step);
 
        $threshold = new ilNumberInputGUI($this->lng->txt('ects_fx_threshold'), 'ects_fx_threshold');
        $threshold->setInfo($this->lng->txt('ects_fx_threshold_info'));
        $threshold->setSuffix($this->lng->txt('percentile'));
        $threshold->allowDecimals(true);
        $threshold->setSize(5);
        $threshold->setRequired(true);
        $threshold->setDisabled($disabled);
        $use_ects_fx->addSubItem($threshold);
 
 
        $form->addItem($allow_ects_marks);
 
        if (!$disabled) {
            $form->addCommandButton('saveEctsForm', $this->lng->txt('save'));
        }
 
        return $form;
    }

References $i, ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

Referenced by saveEctsForm().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ objectSupportsEctsGrades()

ilMarkSchemaGUI::objectSupportsEctsGrades ( )

private

Definition at line 229 of file class.ilMarkSchemaGUI.php.

                                               : bool
    {
        require_once 'Modules/Test/interfaces/interface.ilEctsGradesEnabled.php';
        return $this->object instanceof ilEctsGradesEnabled;
    }

◆ populateEctsForm()

ilMarkSchemaGUI::populateEctsForm ( ilPropertyFormGUI $form )

protected

Definition at line 296 of file class.ilMarkSchemaGUI.php.

                                                                : void
    {
        $data = array();
 
        $data['ectcs_status'] = $this->object->getECTSOutput();
        $data['use_ects_fx'] = preg_match('/\d+/', $this->object->getECTSFX());
        $data['ects_fx_threshold'] = $this->object->getECTSFX();
 
        $ects_grades = $this->object->getECTSGrades();
        for ($i = ord('a'); $i <= ord('e'); $i++) {
            $mark = chr($i);
            $data['ects_grade_' . $mark] = $ects_grades[chr($i - 32)];
        }
 
        $form->setValuesByArray($data);
    }

References $data, $i, ILIAS\Repository\object(), and ilPropertyFormGUI\setValuesByArray().

Here is the call graph for this function:

◆ populateToolbar()

ilMarkSchemaGUI::populateToolbar	(	InterruptiveModal	$confirmation_modal,
		string	$mark_schema_id
	)

private

Definition at line 263 of file class.ilMarkSchemaGUI.php.

                                                                                                   : void
    {
        $create_simple_schema_button = $this->ui_factory->button()->standard(
            $this->lng->txt(self::RESET_MARK_BUTTON_LABEL),
            $confirmation_modal->getShowSignal()
        );
        $this->toolbar->addComponent($create_simple_schema_button);
 
        $create_step_button = $this->buildCreateStepButton($mark_schema_id);
        $this->toolbar->addComponent($create_step_button);
    }

References buildCreateStepButton(), ILIAS\Repository\lng(), and ILIAS\Repository\toolbar().

Referenced by showMarkSchema().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ resetToSimpleMarkSchema()

ilMarkSchemaGUI::resetToSimpleMarkSchema ( )

protected

Definition at line 143 of file class.ilMarkSchemaGUI.php.

                                                : void
    {
        $this->ensureMarkSchemaCanBeEdited();
 
        $this->object->getMarkSchema()->createSimpleSchema(
            $this->lng->txt('failed_short'),
            $this->lng->txt('failed_official'),
            0,
            0,
            $this->lng->txt('passed_short'),
            $this->lng->txt('passed_official'),
            50,
            1
        );
        $this->object->getMarkSchema()->saveToDb($this->object->getTestId());
        $this->showMarkSchema();
    }

References ensureMarkSchemaCanBeEdited(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and showMarkSchema().

Here is the call graph for this function:

◆ saveEctsForm()

ilMarkSchemaGUI::saveEctsForm ( )

protected

Definition at line 377 of file class.ilMarkSchemaGUI.php.

                                     : void
    {
        $this->ensureEctsGradesCanBeEdited();
 
        $ects_form = $this->getEctsForm();
        if (!$ects_form->checkInput()) {
            $ects_form->setValuesByPost();
            $this->showMarkSchema($ects_form);
            return;
        }
 
        $grades = array();
        for ($i = ord('a'); $i <= ord('e'); $i++) {
            $mark = chr($i);
            $grades[chr($i - 32)] = $ects_form->getInput('ects_grade_' . $mark);
        }
 
        $this->object->setECTSGrades($grades);
        $this->object->setECTSOutput((int) $ects_form->getInput('ectcs_status'));
        $this->object->setECTSFX(
            $ects_form->getInput('use_ects_fx') && preg_match('/\d+/', $ects_form->getInput('ects_fx_threshold')) ?
            $ects_form->getInput('ects_fx_threshold') :
            null
        );
 
        $this->object->saveECTSStatus();
 
        $this->tpl->setOnScreenMessage('success', $this->lng->txt('saved_successfully'));
        $ects_form->setValuesByPost();
        $this->showMarkSchema($ects_form);
    }

References $i, ensureEctsGradesCanBeEdited(), getEctsForm(), ILIAS\Repository\lng(), and showMarkSchema().

Here is the call graph for this function:

◆ saveMarks()

ilMarkSchemaGUI::saveMarks ( )

protected

Definition at line 206 of file class.ilMarkSchemaGUI.php.

                                  : void
    {
        $this->ensureMarkSchemaCanBeEdited();
 
        if ($this->saveMarkSchemaFormData()) {
            $result = $this->object->checkMarks();
        } else {
            $result = 'mark_schema_invalid';
        }
 
        if (is_string($result)) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt($result), true);
        } else {
            $this->object->getMarkSchema()->saveToDb($this->object->getMarkSchemaForeignId());
            $this->object->onMarkSchemaSaved();
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('saved_successfully'), true);
            $this->object->getMarkSchema()->flush();
            $this->object->getMarkSchema()->loadFromDb($this->object->getTestId());
        }
 
        $this->showMarkSchema();
    }

References ensureMarkSchemaCanBeEdited(), ILIAS\Repository\lng(), ILIAS\Repository\object(), saveMarkSchemaFormData(), and showMarkSchema().

Here is the call graph for this function:

◆ saveMarkSchemaFormData()

ilMarkSchemaGUI::saveMarkSchemaFormData ( )

protected

Definition at line 111 of file class.ilMarkSchemaGUI.php.

                                               : bool
    {
        $no_save_error = true;
        $this->object->getMarkSchema()->flush();
        $postdata = $this->request->getParsedBody();
        foreach ($postdata as $key => $value) {
            if (preg_match('/mark_short_(\d+)/', $key, $matches)) {
                $passed = "0";
                if (isset($postdata["passed_$matches[1]"])) {
                    $passed = "1";
                }
 
                $percentage = str_replace(',', '.', ilUtil::stripSlashes($postdata["mark_percentage_$matches[1]"]));
                if (!is_numeric($percentage)
                    || (float) $percentage < 0.0
                    || (float) $percentage > 100.0) {
                    $percentage = 0;
                    $no_save_error = false;
                }
 
                $this->object->getMarkSchema()->addMarkStep(
                    ilUtil::stripSlashes($postdata["mark_short_$matches[1]"]),
                    ilUtil::stripSlashes($postdata["mark_official_$matches[1]"]),
                    (float) $percentage,
                    (int) ilUtil::stripSlashes($passed)
                );
            }
        }
 
        return $no_save_error;
    }

References ILIAS\LTI\ToolProvider\$key, and ilUtil\stripSlashes().

Referenced by addMarkStep(), and saveMarks().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showMarkSchema()

ilMarkSchemaGUI::showMarkSchema ( ?ilPropertyFormGUI $ects_form = null )

protected

Definition at line 235 of file class.ilMarkSchemaGUI.php.

                                                                           : void
    {
        if (!$this->object->canEditMarks()) {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt('cannot_edit_marks'));
        }
 
        $this->toolbar->setFormAction($this->ctrl->getFormAction($this, 'showMarkSchema'));
 
        require_once 'Modules/Test/classes/tables/class.ilMarkSchemaTableGUI.php';
        $mark_schema_table = new ilMarkSchemaTableGUI($this, 'showMarkSchema', '', $this->object);
        $mark_schema_table->setShowRowsSelector(false);
 
        $rendered_modal = '';
        if ($this->object->canEditMarks()) {
            $confirmation_modal = $this->ui_factory->modal()->interruptive(
                $this->lng->txt(self::RESET_MARK_BUTTON_LABEL),
                $this->lng->txt('tst_mark_reset_to_simple_mark_schema_confirmation'),
                $this->ctrl->getFormAction($this, 'resetToSimpleMarkSchema')
            )->withActionButtonLabel(self::RESET_MARK_BUTTON_LABEL);
            $this->populateToolbar($confirmation_modal, $mark_schema_table->getId());
            $rendered_modal = $this->ui_renderer->render($confirmation_modal);
        }
 
        $this->tpl->setContent(
            $mark_schema_table->getHTML() . $rendered_modal
        );
    }

References ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ILIAS\Repository\object(), populateToolbar(), and ILIAS\Repository\toolbar().

Referenced by addMarkStep(), deleteMarkSteps(), resetToSimpleMarkSchema(), saveEctsForm(), and saveMarks().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

◆ $ctrl

ilCtrl ilMarkSchemaGUI::$ctrl

protected

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

◆ $lng

ilLanguage ilMarkSchemaGUI::$lng

protected

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

◆ $object

ilMarkSchemaGUI::$object

protected

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

◆ $post_wrapper

RequestWrapper ilMarkSchemaGUI::$post_wrapper

private

Definition at line 35 of file class.ilMarkSchemaGUI.php.

◆ $refinery

Refinery ilMarkSchemaGUI::$refinery

private

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

◆ $request

Request ilMarkSchemaGUI::$request

private

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

◆ $tabs

ilTabsGUI ilMarkSchemaGUI::$tabs

protected

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

◆ $toolbar

ilToolbarGUI ilMarkSchemaGUI::$toolbar

protected

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

◆ $tpl

ilGlobalPageTemplate ilMarkSchemaGUI::$tpl

protected

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

◆ $ui_factory

UIFactory ilMarkSchemaGUI::$ui_factory

protected

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

◆ $ui_renderer

UIRenderer ilMarkSchemaGUI::$ui_renderer

protected

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

◆ RESET_MARK_BUTTON_LABEL

const ilMarkSchemaGUI::RESET_MARK_BUTTON_LABEL = 'tst_mark_reset_to_simple_mark_schema'

private

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

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

Modules/Test/classes/class.ilMarkSchemaGUI.php

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Member Function Documentation

◆ addMarkStep()

◆ buildCreateStepButton()

◆ deleteMarkSteps()

◆ ensureEctsGradesCanBeEdited()

◆ ensureMarkSchemaCanBeEdited()

◆ executeCommand()

◆ getEctsForm()

◆ objectSupportsEctsGrades()

◆ populateEctsForm()

◆ populateToolbar()

◆ resetToSimpleMarkSchema()

◆ saveEctsForm()

◆ saveMarks()

◆ saveMarkSchemaFormData()

◆ showMarkSchema()

Field Documentation

◆ $ctrl

◆ $lng

◆ $object

◆ $post_wrapper

◆ $refinery

◆ $request

◆ $tabs

◆ $toolbar

◆ $tpl

◆ $ui_factory

◆ $ui_renderer

◆ RESET_MARK_BUTTON_LABEL