<?php
//============================================================+
// File name : tce_config.php
// Begin : 2002-02-24
// Last Update : 2025-06-12
//
// Description : Shared configuration file.
//
// License:
// Copyright (C) 2004-2026 Nicola Asuni - Tecnick.com LTD
// See LICENSE file for more information.
//============================================================+
/**
* @file
* Shared configuration file.
* @package com.tecnick.tcexam.shared.cfg
* @brief TCExam Main Configuration
* @author Nicola Asuni
* @since 2002-02-24
*/
/**
* TCExam version (do not change).
*/
define('K_TCEXAM_VERSION', file_get_contents('../../VERSION'));
/**
* 2-letters code for default language.
*/
define('K_LANGUAGE', 'en');
/**
* If true, display a language selector.
*/
define('K_LANGUAGE_SELECTOR', true);
/**
* Defines a serialized array of available languages.
* Each language is indexed using a 2-letters code (ISO 639).
*/
define('K_AVAILABLE_LANGUAGES', serialize([
'ar' => 'Arabian',
'az' => 'Azerbaijani',
'bg' => 'Bulgarian',
'br' => 'Brazilian Portuguese',
'cn' => 'Chinese',
'de' => 'German',
'el' => 'Greek',
'en' => 'English',
'es' => 'Spanish',
'fa' => 'Farsi',
'fr' => 'French',
'he' => 'Hebrew',
'hi' => 'Hindi',
'hu' => 'Hungarian',
'id' => 'Indonesian',
'it' => 'Italian',
'jp' => 'Japanese',
'mr' => 'Marathi',
'ms' => 'Malay (Bahasa Melayu)',
'nl' => 'Dutch',
'pl' => 'Polish',
'ro' => 'Romanian',
'ru' => 'Russian',
'tr' => 'Turkish',
'ur' => 'Urdu',
'vn' => 'Vietnamese',
]));
// -- INCLUDE files --
require_once '../../shared/config/tce_paths.php';
require_once '../../shared/config/tce_general_constants.php';
/**
* If true enable One-Time-Password authentication on login.
*/
define('K_OTP_LOGIN', false);
/**
* Ratio at which the delay will be increased after every failed login attempt.
*/
define('K_BRUTE_FORCE_DELAY_RATIO', 2);
/**
* Number of difficulty levels for questions.
*/
define('K_QUESTION_DIFFICULTY_LEVELS', 10);
/**
* Popup window height in pixels for test info.
*/
define('K_TEST_INFO_HEIGHT', 400);
/**
* Popup window width in pixels for test info.
*/
define('K_TEST_INFO_WIDTH', 700);
/**
* Number of columns for answer textarea.
*/
define('K_ANSWER_TEXTAREA_COLS', 70);
/**
* Number of rows for answer textarea.
*/
define('K_ANSWER_TEXTAREA_ROWS', 15);
/**
* If true enable explanation field for questions.
*/
define('K_ENABLE_QUESTION_EXPLANATION', true);
/**
* If true enable explanation field for answers.
*/
define('K_ENABLE_ANSWER_EXPLANATION', true);
/**
* If true display test description before executing the test.
*/
define('K_DISPLAY_TEST_DESCRIPTION', true);
/**
* If true compare short answers in binary mode.
*/
define('K_SHORT_ANSWERS_BINARY', false);
/**
* User's session life time in seconds.
*/
define('K_SESSION_LIFE', K_SECONDS_IN_HOUR);
/**
* When an alternate authentication method is used,
* if this constant is true the default user groups for the selected
* authentication method are always added to the user.
*/
define('K_USER_GROUP_RSYNC', false);
/**
* Define timestamp format using PHP notation (do not change).
*/
define('K_TIMESTAMP_FORMAT', 'Y-m-d H:i:s');
/**
* Define max line length in chars for question navigator on test execution interface.
*/
define('K_QUESTION_LINE_MAX_LENGTH', 70);
/**
* If true, check for possible session hijacking (set to false if you have login problems).
*/
define('K_CHECK_SESSION_FINGERPRINT', true);
// Client Cookie settings
/**
* Cookie domain.
*/
define('K_COOKIE_DOMAIN', '');
/**
* Cookie path.
*/
define('K_COOKIE_PATH', '/');
/**
* If true use secure cookies.
*/
define('K_COOKIE_SECURE', [[K_COOKIE_SECURE]]);
/**
* When true the cookie will be made accessible only through the HTTP protocol.
*/
define('K_COOKIE_HTTPONLY', true);
/**
* The SameSite attribute lets servers specify whether/when cookies are sent with cross-site requests.
*/
define('K_COOKIE_SAMESITE', 'Strict');
/**
* Expiration time for cookies.
*/
define('K_COOKIE_EXPIRE', K_SECONDS_IN_DAY);
/**
* Various pages redirection modes after login (valid values are 1, 2, 3 and 4).
* 1 = relative redirect.
* 2 = absolute redirect.
* 3 = html redirect.
* 4 = full redirect.
*/
define('K_REDIRECT_LOGIN_MODE', 4);
/**
* If true enable password reset feature.
*/
define('K_PASSWORD_RESET', true);
/**
* URL to be redirected at logout (leave empty for default).
*/
define('K_LOGOUT_URL', '');
// Error settings
/**
* Define error reporting types for debug.
*/
define('K_ERROR_TYPES', E_ALL | E_STRICT);
//define ('K_ERROR_TYPES', E_ERROR | E_WARNING | E_PARSE);
/**
* Enable error logs (../log/tce_errors.log).
*/
define('K_USE_ERROR_LOG', false);
/**
* If true display messages and errors on Javascript popup window.
*/
define('K_ENABLE_JSERRORS', false);
/**
* Set your own timezone here.
* Possible values are listed on:
* http://php.net/manual/en/timezones.php
*/
define('K_TIMEZONE', 'UTC');
/**
* Default minutes used to extend test duration.
*/
define('K_EXTEND_TIME_MINUTES', 5);
// ---------- * ---------- * ---------- * ---------- * ----------
/**
* Error handlers.
*/
require_once '../../shared/code/tce_functions_errmsg.php';
// load language resources
// set user's selected language or default language
if (
isset($_REQUEST['lang']) and strlen($_REQUEST['lang']) == 2
and array_key_exists($_REQUEST['lang'], unserialize(K_AVAILABLE_LANGUAGES))
) {
/**
* Use requested language.
* @ignore
*/
define('K_USER_LANG', $_REQUEST['lang']);
// set client cookie
setcookie(
'SessionUserLang',
K_USER_LANG,
time() + K_COOKIE_EXPIRE,
K_COOKIE_PATH,
K_COOKIE_DOMAIN,
K_COOKIE_SECURE,
);
} elseif (
isset($_COOKIE['SessionUserLang']) and strlen($_COOKIE['SessionUserLang']) == 2
and array_key_exists($_COOKIE['SessionUserLang'], unserialize(K_AVAILABLE_LANGUAGES))
) {
/**
* Use session language.
* @ignore
*/
define('K_USER_LANG', $_COOKIE['SessionUserLang']);
} else {
/**
* Use default language.
* @ignore
*/
define('K_USER_LANG', K_LANGUAGE);
}
// TMX class
require_once '../../shared/code/tce_tmx.php';
// instantiate new TMXResourceBundle object
$lang_resources = new TMXResourceBundle(
K_PATH_TMX_FILE,
K_USER_LANG,
K_PATH_LANG_CACHE . basename(K_PATH_TMX_FILE, '.xml') . '_' . K_USER_LANG . '.php',
);
$l = $lang_resources->getResource(); // language array
ini_set('arg_separator.output', '&');
//date_default_timezone_set(K_TIMEZONE);
// NOTE: the legacy register-globals emulation (a foreach over $_POST that auto-created bare
// $variables from posted keys) was removed in the modernisation (plan Stage 8.2). Every
// controller now reads its inputs explicitly from $_POST/$_REQUEST, which also closes the
// variable-injection vector the emulation exposed.
/**
* Lisf of enabled custom authentication methods.
* Add your custom authentication methods here.
*/
define(
'K_CUSTOM_AUTH_METHODS',
serialize([
// 'basic', // Uncomment to enable the simple custom authentication method.
/**
* Take a look at the following files to create your own custom authentication method.
*
* ../../shared/config/custom_auth/basic.php
* ../../shared/custom_auth/basic.php
*/
]),
);