ilMarkSchemaGUI Class Reference

Collaboration diagram for ilMarkSchemaGUI:

Public Member Functions
	executeCommand ()
	Controller method. More...

Protected Member Functions
	ensureMarkSchemaCanBeEdited ()
	ensureEctsGradesCanBeEdited ()
	addMarkStep ()
	Add a new mark step to the tests marks. More...
	saveMarkSchemaFormData ()
	addSimpleMarkSchema ()
	Add a simple mark schema to the tests marks. More...
	deleteMarkSteps ()
	Delete selected mark steps. More...
	saveMarks ()
	Save the mark schema. More...
	showMarkSchema (ilPropertyFormGUI $ects_form=null)
	Display mark schema. More...
	populateEctsForm (ilPropertyFormGUI $form)
	getEctsForm ()
	saveEctsForm ()

Protected Attributes
	$object
	$lng
	$ctrl
	$tpl
	$toolbar

Private Member Functions
	objectSupportsEctsGrades ()

Detailed Description

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

Member Function Documentation

addMarkStep()

ilMarkSchemaGUI::addMarkStep ( )

protected

Add a new mark step to the tests marks.

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

References ensureMarkSchemaCanBeEdited(), saveMarkSchemaFormData(), and showMarkSchema().

    {
        $this->ensureMarkSchemaCanBeEdited();

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

Here is the call graph for this function:

addSimpleMarkSchema()

ilMarkSchemaGUI::addSimpleMarkSchema ( )

protected

Add a simple mark schema to the tests marks.

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

References ensureMarkSchemaCanBeEdited(), and showMarkSchema().

    {
        $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->showMarkSchema();
    }

Here is the call graph for this function:

deleteMarkSteps()

ilMarkSchemaGUI::deleteMarkSteps ( )

protected

Delete selected mark steps.

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

References $_POST, ensureMarkSchemaCanBeEdited(), ilUtil\sendFailure(), and showMarkSchema().

                                         : void
    {
        $delete_mark_steps = $_POST['marks'];
        $this->ensureMarkSchemaCanBeEdited();
        if (!isset($delete_mark_steps) || !is_array($delete_mark_steps)) {
            $this->showMarkSchema();
            return;
        }

        // test delete
        $schema = clone $this->object->getMarkSchema();
        $schema->deleteMarkSteps($delete_mark_steps);
        $check_result = $schema->checkMarks();
        if (is_string($check_result)) {
            ilUtil::sendFailure($this->lng->txt($check_result), true);
            $this->showMarkSchema();
            return;
        }

        //  actual delete
        if (!empty($delete_mark_steps)) {
            $this->object->getMarkSchema()->deleteMarkSteps($delete_mark_steps);
        } else {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt('tst_delete_missing_mark'));
        }
        $this->object->getMarkSchema()->saveToDb($this->object->getTestId());

        $this->showMarkSchema();
    }

Here is the call graph for this function:

ensureEctsGradesCanBeEdited()

ilMarkSchemaGUI::ensureEctsGradesCanBeEdited ( )

protected

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

References ilUtil\sendFailure().

Referenced by saveEctsForm().

    {
        if (!$this->object->canEditEctsGrades()) {
            ilUtil::sendFailure($this->lng->txt('permission_denied'), true);
            $this->ctrl->redirect($this, 'showMarkSchema');
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

ensureMarkSchemaCanBeEdited()

ilMarkSchemaGUI::ensureMarkSchemaCanBeEdited ( )

protected

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

References ilUtil\sendFailure().

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

    {
        if (!$this->object->canEditMarks()) {
            ilUtil::sendFailure($this->lng->txt('permission_denied'), true);
            $this->ctrl->redirect($this, 'showMarkSchema');
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

executeCommand()

ilMarkSchemaGUI::executeCommand

(

)

Controller method.

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

References $DIC, and ilTestTabsManager\TAB_ID_SETTINGS.

    {
        global $DIC; /* @var ILIAS\DI\Container $DIC */

        $DIC->tabs()->activateTab(ilTestTabsManager::TAB_ID_SETTINGS);

        $cmd = $this->ctrl->getCmd('showMarkSchema');
        $this->$cmd();
    }

getEctsForm()

ilMarkSchemaGUI::getEctsForm ( )

protected

Returns

ilPropertyFormGUI

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

References $i, ilFormPropertyGUI\setDisabled(), and ilFormPropertyGUI\setInfo().

Referenced by saveEctsForm(), and showMarkSchema().

    {
        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;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

objectSupportsEctsGrades()

ilMarkSchemaGUI::objectSupportsEctsGrades ( )

private

Returns

boolean

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

Referenced by showMarkSchema().

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

Here is the caller graph for this function:

populateEctsForm()

ilMarkSchemaGUI::populateEctsForm ( ilPropertyFormGUI  $form )

protected

Parameters

ilPropertyFormGUI

$form

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

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

Referenced by showMarkSchema().

    {
        $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);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

saveEctsForm()

ilMarkSchemaGUI::saveEctsForm ( )

protected

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

References $i, ensureEctsGradesCanBeEdited(), getEctsForm(), and showMarkSchema().

    {
        $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();

        ilUtil::sendSuccess($this->lng->txt('saved_successfully'));
        $ects_form->setValuesByPost();
        $this->showMarkSchema($ects_form);
    }

Here is the call graph for this function:

saveMarks()

ilMarkSchemaGUI::saveMarks ( )

protected

Save the mark schema.

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

References $result, ensureMarkSchemaCanBeEdited(), saveMarkSchemaFormData(), ilUtil\sendFailure(), and showMarkSchema().

    {
        $this->ensureMarkSchemaCanBeEdited();

        if ($this->saveMarkSchemaFormData()) {
            $result = $this->object->checkMarks();
        } else {
            $result = 'mark_schema_invalid';
        }

        if (is_string($result)) {
            ilUtil::sendFailure($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();
    }

Here is the call graph for this function:

saveMarkSchemaFormData()

ilMarkSchemaGUI::saveMarkSchemaFormData ( )

protected

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

References $_POST, and ilUtil\stripSlashes().

Referenced by addMarkStep(), and saveMarks().

    {
        $no_save_error = true;
        $this->object->getMarkSchema()->flush();
        $postdata = $_POST;
        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;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

showMarkSchema()

ilMarkSchemaGUI::showMarkSchema ( ilPropertyFormGUI  $ects_form = null )

protected

Display mark schema.

Parameters

ilPropertyFormGUI

$ects_form

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

References ilButton\BUTTON_TYPE_SUBMIT, getEctsForm(), ilSubmitButton\getInstance(), ilButton\getInstance(), objectSupportsEctsGrades(), populateEctsForm(), and ilUtil\sendInfo().

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

    {
        if (!$this->object->canEditMarks()) {
            ilUtil::sendInfo($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);

        if ($this->object->canEditMarks()) {
            require_once 'Services/UIComponent/Button/classes/class.ilSubmitButton.php';
            $create_simple_mark_schema_button = ilSubmitButton::getInstance();
            $create_simple_mark_schema_button->setCaption($this->lng->txt('tst_mark_create_simple_mark_schema'), false);
            $create_simple_mark_schema_button->setCommand('addSimpleMarkSchema');
            $this->toolbar->addButtonInstance($create_simple_mark_schema_button);

            require_once 'Services/UIComponent/Button/classes/class.ilButton.php';
            $create_new_mark_step_button = ilButton::getInstance();
            $create_new_mark_step_button->setCaption($this->lng->txt('tst_mark_create_new_mark_step'), false);
            $create_new_mark_step_button->setButtonType(ilButton::BUTTON_TYPE_SUBMIT);
            $create_new_mark_step_button->setForm('form_' . $mark_schema_table->getId());
            $create_new_mark_step_button->setName('addMarkStep');
            $this->toolbar->addButtonInstance($create_new_mark_step_button);
        }


        $content_parts = array($mark_schema_table->getHTML());

        if ($this->objectSupportsEctsGrades() && $this->object->canShowEctsGrades()) {
            if (!($ects_form instanceof ilPropertyFormGUI)) {
                $ects_form = $this->getEctsForm();
                $this->populateEctsForm($ects_form);
            }
            $content_parts[] = $ects_form->getHTML();
        }

        $this->tpl->setContent(implode('<br />', $content_parts));
    }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$ctrl

ilMarkSchemaGUI::$ctrl

protected

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

$lng

ilMarkSchemaGUI::$lng

protected

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

$object

ilMarkSchemaGUI::$object

protected

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

$toolbar

ilMarkSchemaGUI::$toolbar

protected

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

$tpl

ilMarkSchemaGUI::$tpl

protected

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

---

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

• Modules/Test/classes/class.ilMarkSchemaGUI.php