class.ilTestSettingsTemplateConfig.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2013 ILIAS open source, Extended GPL, see docs/LICENSE */

require_once 'Services/Administration/classes/class.ilSettingsTemplateConfig.php';
require_once 'Modules/Test/classes/inc.AssessmentConstants.php';
require_once 'Modules/Test/classes/class.ilObjTestSettingsGeneralGUI.php';

class ilTestSettingsTemplateConfig extends ilSettingsTemplateConfig
{
    protected $lng;

    public function __construct(ilLanguage $lng)
    {
        $this->lng = $lng;
        parent::__construct('tst');
    }

    public function init()
    {
        $this->initLanguage();
        $this->initHidableTabs();
        $this->initSettings();
    }

    private function initLanguage()
    {
        $this->lng->loadLanguageModule("tst");
        $this->lng->loadLanguageModule("assessment");
    }

    private function initHidableTabs()
    {
        $this->addHidableTab("questions", $this->lng->txt('assQuestions') . ' - ' . $this->lng->txt('edit_test_questions'));
        $this->addHidableTab("mark_schema", $this->lng->txt('settings') . ' - ' . $this->lng->txt("mark_schema"));
        $this->addHidableTab("certificate", $this->lng->txt('settings') . ' - ' . $this->lng->txt("certificate"));
        $this->addHidableTab("defaults", $this->lng->txt('settings') . ' - ' . $this->lng->txt("tst_default_settings"));

        $this->addHidableTab("learning_progress", $this->lng->txt("learning_progress"));
        $this->addHidableTab("manscoring", $this->lng->txt("manscoring"));
        $this->addHidableTab("statistics", $this->lng->txt("statistics"));
        $this->addHidableTab("history", $this->lng->txt("history"));
        $this->addHidableTab("meta_data", $this->lng->txt("meta_data"));
        $this->addHidableTab("export", $this->lng->txt("export"));
        $this->addHidableTab("permissions", $this->lng->txt("permission"));
    }

    private function initSettings()
    {
        $this->addGeneralPropertySettings();
        $this->addTestIntroProperties();
        $this->addTestAccessProperties();
        $this->addTestRunProperties();
        $this->addQuestionBehaviourProperties();
        $this->addTestSequenceProperties();
        $this->addTestFinishProperties();
        $this->addScoringOptionsProperties();
        $this->addResultSummaryProperties();
        $this->addResultDetailsProperties();
        $this->addResultMiscOptionsProperties();
    }

    private function addGeneralPropertySettings()
    {
        $this->addSetting(
            "use_pool",
            ilSettingsTemplateConfig::SELECT,
            $this->lng->txt("test_question_pool_usage"),
            true,
            0,
            array(
                1 => $this->lng->txt('test_question_pool_usage_optional'),
                0 => $this->lng->txt('test_question_pool_usage_tst_directly')
            )
        );

        $this->addSetting(
            "question_set_type",
            ilSettingsTemplateConfig::SELECT,
            $this->lng->txt("tst_question_set_type"),
            true,
            0,
            array(
                ilObjTest::QUESTION_SET_TYPE_FIXED => $this->lng->txt("tst_question_set_type_fixed"),
                ilObjTest::QUESTION_SET_TYPE_RANDOM => $this->lng->txt("tst_question_set_type_random"),
                ilObjTest::QUESTION_SET_TYPE_DYNAMIC => $this->lng->txt("tst_question_set_type_dynamic"),
            )
        );
    }

    private function addTestIntroProperties()
    {
        // Test Introduction
        $this->addSetting(
            "intro_enabled",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_introduction"),
            false
        );

        // All Details on Info Screen
        $this->addSetting(
            "showinfo",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("showinfo"),
            true
        );
    }

    private function addTestAccessProperties()
    {
        $this->addSetting(
            "chb_starting_time",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_starting_time"),
            false
        );

        $this->addSetting(
            "chb_ending_time",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_ending_time"),
            false
        );

        $this->addSetting(
            "password_enabled",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_password"),
            false
        );

        $this->addSetting(
            "fixedparticipants",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("participants_invitation"),
            true
        );

        $this->addSetting(
            "limitUsers",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_allowed_users"),
            false
        );
    }

    private function addTestRunProperties()
    {
        $this->addSetting(
            "nr_of_tries",
            ilSettingsTemplateConfig::TEXT,
            $this->lng->txt("tst_nr_of_tries"),
            false,
            3
        );

        $this->addSetting(
            "chb_processing_time",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_processing_time"),
            false
        );

        $this->addSetting(
            "kiosk",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("kiosk"),
            false
        );

        $this->addSetting(
            "examid_in_test_pass",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("examid_in_test_pass"),
            false
        );
    }

    private function addQuestionBehaviourProperties()
    {
        $this->addSetting(
            "title_output",
            ilSettingsTemplateConfig::SELECT,
            $this->lng->txt("tst_title_output"),
            true,
            0,
            array(
                '0' => $this->lng->txt("tst_title_output_full"),
                '1' => $this->lng->txt("tst_title_output_hide_points"),
                '2' => $this->lng->txt("tst_title_output_no_title"),
            )
        );

        $this->addSetting(
            "autosave",
            ilSettingsTemplateConfig::TEXT,
            $this->lng->txt("autosave"),
            true,
            5
        );

        $this->addSetting(
            "chb_shuffle_questions",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_shuffle_questions"),
            true
        );

        $this->addSetting(
            "offer_hints",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_setting_offer_hints_label"),
            true
        );

        $this->addSetting(
            "instant_feedback_contents",
            ilSettingsTemplateConfig::CHECKBOX,
            $this->lng->txt("tst_instant_feedback"),
            true,
            0,
            array(
                'instant_feedback_points' => $this->lng->txt("tst_instant_feedback_results"),
                'instant_feedback_generic' => $this->lng->txt("tst_instant_feedback_answer_generic"),
                'instant_feedback_specific' => $this->lng->txt("tst_instant_feedback_answer_specific"),
                'instant_feedback_solution' => $this->lng->txt("tst_instant_feedback_solution")
            )
        );

        $this->addSetting(
            "instant_feedback_trigger",
            ilSettingsTemplateConfig::SELECT,
            $this->lng->txt("tst_instant_feedback_trigger"),
            true,
            0,
            array(
                ilObjTestSettingsGeneralGUI::INSTANT_FEEDBACK_TRIGGER_MANUAL => $this->lng->txt("tst_instant_feedback_trigger_manual"),
                ilObjTestSettingsGeneralGUI::INSTANT_FEEDBACK_TRIGGER_FORCED => $this->lng->txt("tst_instant_feedback_trigger_forced")
            )
        );

        $this->addSetting(
            'answer_fixation_handling',
            ilSettingsTemplateConfig::SELECT,
            $this->lng->txt('tst_answer_fixation_handling'),
            true,
            0,
            array(
                ilObjTestSettingsGeneralGUI::ANSWER_FIXATION_NONE => $this->lng->txt('tst_answer_fixation_none'),
                ilObjTestSettingsGeneralGUI::ANSWER_FIXATION_ON_INSTANT_FEEDBACK => $this->lng->txt('tst_answer_fixation_on_instant_feedback'),
                ilObjTestSettingsGeneralGUI::ANSWER_FIXATION_ON_FOLLOWUP_QUESTION => $this->lng->txt('tst_answer_fixation_on_followup_question'),
                ilObjTestSettingsGeneralGUI::ANSWER_FIXATION_ON_IFB_OR_FUQST => $this->lng->txt('tst_answer_fixation_on_instantfb_or_followupqst')
            )
        );

        $this->addSetting(
            "obligations_enabled",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_setting_enable_obligations_label"),
            true
        );
    }

    private function addTestSequenceProperties()
    {
        $this->addSetting(
            "chb_use_previous_answers",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_use_previous_answers"),
            true
        );

        $this->addSetting(
            "chb_show_cancel",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_show_cancel"),
            true
        );

        $this->addSetting(
            "chb_postpone",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_postpone"),
            true
        );

        $this->addSetting(
            "list_of_questions",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_show_summary"),
            false
        );

        $this->addSetting(
            "chb_show_marker",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("question_marking"),
            true
        );
    }

    private function addTestFinishProperties()
    {
        $this->addSetting(
            "enable_examview",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("enable_examview"),
            false
        );

        $this->addSetting(
            "showfinalstatement",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("final_statement"),
            false
        );

        /* $this->addSetting(
            "redirection_enabled",
            ilSettingsTemplateConfig::SELECT,
            $this->lng->txt("redirect_after_finishing_tst"),
            false,
            0,
            array(
                REDIRECT_NONE => $this->lng->txt("redirect_none"),
                REDIRECT_ALWAYS => $this->lng->txt("redirect_always"),
                REDIRECT_KIOSK => $this->lng->txt("redirect_in_kiosk_mode"),
            )
        ); */
        $this->addSetting(
            "redirection_enabled",
            ilSettingsTemplateConfig::TEXT,
            $this->lng->txt("redirect_after_finishing_tst"),
            false
        );

        $this->addSetting(
            "sign_submission",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("sign_submission"),
            true
        );

        $this->addSetting(
            "mailnotification",
            ilSettingsTemplateConfig::SELECT,
            $this->lng->txt("tst_finish_notification"),
            false,
            0,
            array(
                '0' => $this->lng->txt("tst_finish_notification_no"),
                '1' => $this->lng->txt("tst_finish_notification_simple"),
                '2' => $this->lng->txt("tst_finish_notification_advanced"),
            )
        );
    }

    private function addScoringOptionsProperties()
    {
        $this->addSetting(
            "count_system",
            ilSettingsTemplateConfig::SELECT,
            $this->lng->txt("tst_text_count_system"),
            true,
            0,
            array(
                '0' => $this->lng->txt("tst_count_partial_solutions"),
                '1' => $this->lng->txt("tst_count_correct_solutions")
            )
        );

        $this->addSetting(
            "mc_scoring",
            ilSettingsTemplateConfig::SELECT,
            $this->lng->txt("tst_score_mcmr_questions"),
            true,
            0,
            array(
                '0' => $this->lng->txt("tst_score_mcmr_zero_points_when_unanswered"),
                '1' => $this->lng->txt("tst_score_mcmr_use_scoring_system")
            )
        );

        $this->addSetting(
            "score_cutting",
            ilSettingsTemplateConfig::SELECT,
            $this->lng->txt("tst_score_cutting"),
            true,
            0,
            array(
                '0' => $this->lng->txt("tst_score_cut_question"),
                '1' => $this->lng->txt("tst_score_cut_test")
            )
        );

        $this->addSetting(
            "pass_scoring",
            ilSettingsTemplateConfig::SELECT,
            $this->lng->txt("tst_pass_scoring"),
            true,
            0,
            array(
                '0' => $this->lng->txt("tst_pass_last_pass"),
                '1' => $this->lng->txt("tst_pass_best_pass")
            )
        );

        $this->addSetting(
            "pass_deletion_allowed",
            ilSettingsTemplateConfig::SELECT,
            $this->lng->txt("tst_pass_deletion"),
            true,
            0,
            array(
                '0' => $this->lng->txt("tst_pass_deletion_not_allowed"),
                '1' => $this->lng->txt("tst_pass_deletion_allowed")
            )
        );
    }

    private function addResultSummaryProperties()
    {
        $this->addSetting(
            "results_access_enabled",
            ilSettingsTemplateConfig::SELECT,
            $this->lng->txt("tst_results_access_enabled"),
            false,
            0,
            array(
                '0' => $this->lng->txt("tst_results_access_never"),
                '2' => $this->lng->txt("tst_results_access_always"),
                '1' => $this->lng->txt("tst_results_access_finished"),
                '3' => $this->lng->txt("tst_results_access_date")
            )
        );

        $this->addSetting(
            "grading_status",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_results_grading_opt_show_status"),
            true
        );

        $this->addSetting(
            "grading_mark",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_results_grading_opt_show_mark"),
            true
        );
    }

    private function addResultDetailsProperties()
    {
        $this->addSetting(
            "solution_details",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_show_solution_details"),
            false
        );
        
        $this->addSetting(
            "solution_feedback",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_show_solution_feedback"),
            true
        );
        
        $this->addSetting(
            "solution_suggested",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_show_solution_suggested"),
            true
        );
        
        $this->addSetting(
            "solution_printview",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_show_solution_printview"),
            false
        );
        
        $this->addSetting(
            "highscore_enabled",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_highscore_enabled"),
            false
        );
        
        $this->addSetting(
            "solution_signature",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_show_solution_signature"),
            true
        );
        
        $this->addSetting(
            "examid_in_test_res",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("examid_in_test_res"),
            true
        );

        $this->addSetting(
            "exp_sc_short",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("tst_exp_sc_short"),
            true
        );
    }

    private function addResultMiscOptionsProperties()
    {
        $this->addSetting(
            "anonymity",
            ilSettingsTemplateConfig::SELECT,
            $this->lng->txt("tst_anonymity"),
            true,
            0,
            array(
                '0' => $this->lng->txt("tst_anonymity_no_anonymization"),
                '1' => $this->lng->txt("tst_anonymity_anonymous_test"),
            )
        );

        $this->addSetting(
            "enable_archiving",
            ilSettingsTemplateConfig::BOOL,
            $this->lng->txt("test_enable_archiving"),
            true
        );
    }
}