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",
                        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"),
                                'force_instant_feedback' => $this->lng->txt("tst_instant_feedback_forced")
                        )
                );

                $this->addSetting(
                        'instant_feedback_handling',
                        ilSettingsTemplateConfig::SELECT,
                        $this->lng->txt('tst_instant_feedback_handling'),
                        true,
                        ilObjTestSettingsGeneralGUI::INST_FB_HANDLING_OPT_NONE,
                        array(
                                ilObjTestSettingsGeneralGUI::INST_FB_HANDLING_OPT_NONE => $this->lng->txt('tst_instant_feedback_handling_none'),
                                ilObjTestSettingsGeneralGUI::INST_FB_HANDLING_OPT_FREEZE => $this->lng->txt('tst_instant_feedback_handling_freeze'),
                                ilObjTestSettingsGeneralGUI::INST_FB_HANDLING_OPT_FORCE_AND_FREEZE => $this->lng->txt('tst_instant_feedback_handling_force_and_freeze'),
                                ilObjTestSettingsGeneralGUI::INST_FB_HANDLING_OPT_FORCE => $this->lng->txt('tst_instant_feedback_handling_force'),
                        )
                );

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