namespaces-default

API Documentation

Table of Contents

Classes

XMLQuestionImporter

XMLUserImporter

C_mailer

LatexRender

TMXResourceBundle

TCPDFEX

Constants

HEAD_MAGNIFICATION  = 1.1

magnification factor for titles

K_ADMIN_LINK  = 5

Required user's level to display a link for administration area

K_ADMIN_THEME  = 'default'

Theme for the admin area

K_ALLOWED_ERROR_TAGS  = '<a><b><br><em><p><ol><ul><li><small><table><tr><th><td>'

HTML tags that are allowed in an error message.

K_ALLOWED_TCPDF_TAGS  = ''

List of TCPDF methods that are allowed to be called using HTML syntax.

K_ALLOWED_UPLOAD_EXTENSIONS  = \serialize(array('csv', 'tsv', 'xml', 'txt', 'png', 'gif', 'jpg', 'jpeg', 'svg', 'mp3', 'mid', 'oga', 'ogg', 'wav', 'wma', 'avi', 'flv', 'm2v', 'mpeg', 'mpeg4', 'mpg', 'mpg2', 'mpv', 'ogm', 'ogv', 'vid', 'pfx', 'pem', 'crt'))

List of allowed file types for upload (remove all extensions to disable upload).

K_ANSWER_TEXTAREA_COLS  = 70

Number of columns for answer textarea.

K_ANSWER_TEXTAREA_ROWS  = 15

Number of rows for answer textarea.

K_AUTH_ADMIN_ANSWERS  = \K_AUTH_OPERATOR

Required user's level to access "answer editor".

K_AUTH_ADMIN_DIRS  = \K_AUTH_OPERATOR

Required user's level to create and delete directories.

K_AUTH_ADMIN_FILEMANAGER  = \K_AUTH_OPERATOR

Required user's level to access file manager for multimedia files.

K_AUTH_ADMIN_GROUPS  = \K_AUTH_ADMINISTRATOR

Required user's level to access "group editor".

K_AUTH_ADMIN_IMPORT  = \K_AUTH_ADMINISTRATOR

Required user's level to import questions.

K_AUTH_ADMIN_INFO  = 0

Required user's level to access "TCExam information".

K_AUTH_ADMIN_MODULES  = \K_AUTH_OPERATOR

Required user's level to access "module editor".

K_AUTH_ADMIN_OMR_IMPORT  = \K_AUTH_OPERATOR

Required user's level to import OMR answers.

K_AUTH_ADMIN_ONLINE_USERS  = \K_AUTH_OPERATOR

Required user's level to display online users.

K_AUTH_ADMIN_QUESTIONS  = \K_AUTH_OPERATOR

Required user's level to access "question editor".

K_AUTH_ADMIN_RATING  = \K_AUTH_OPERATOR

Required user's level to manually rate free text answers.

K_AUTH_ADMIN_RESULTS  = \K_AUTH_OPERATOR

Required user's level to display results.

K_AUTH_ADMIN_SSLCERT  = \K_AUTH_OPERATOR

Required user's level to edit SSL certificates.

K_AUTH_ADMIN_SUBJECTS  = \K_AUTH_OPERATOR

Required user's level to access "subject editor".

K_AUTH_ADMIN_TCECODE  = \K_AUTH_OPERATOR

Required user's level to access "tcecode editor".

K_AUTH_ADMIN_TESTS  = \K_AUTH_OPERATOR

Required user's level to access "test editor".

K_AUTH_ADMIN_UPLOAD_IMAGES  = \K_AUTH_OPERATOR

Required user's level to upload images.

K_AUTH_ADMIN_USERS  = \K_AUTH_ADMINISTRATOR

Required user's level to access "user editor".

K_AUTH_ADMINISTRATOR  = 10

Administrator level.

K_AUTH_BACKUP  = \K_AUTH_ADMINISTRATOR

Required user's level to import questions.

K_AUTH_DELETE_GROUPS  = \K_AUTH_ADMINISTRATOR

Required user's level to delete user groups.

K_AUTH_DELETE_MEDIAFILE  = \K_AUTH_OPERATOR

Required user's level to delete multimedia files.

K_AUTH_DELETE_USERS  = \K_AUTH_ADMINISTRATOR

Required user's level to delete users.

K_AUTH_EXPORT_USERS  = \K_AUTH_ADMINISTRATOR

Required user's level to export users.

K_AUTH_IMPORT_USERS  = \K_AUTH_ADMINISTRATOR

Required user's level to import users.

K_AUTH_INDEX  = \K_AUTH_OPERATOR

Required user's level to access index page.

K_AUTH_MOVE_GROUPS  = \K_AUTH_ADMINISTRATOR

Required user's level to move users from one group to another.

K_AUTH_OPERATOR  = 5

Operator level.

K_AUTH_PAGE_USER  = 1

Required user's level to access user page submenu

K_AUTH_PUBLIC_INDEX  = 1

Required user's level to access index page.

K_AUTH_PUBLIC_TEST_EXECUTE  = 1

Required user's level to execute a test

K_AUTH_PUBLIC_TEST_INFO  = 1

Required user's level to view test general information

K_AUTH_PUBLIC_TEST_RESULTS  = 1

Required user's level to view test results

K_AUTH_RENAME_MEDIAFILE  = \K_AUTH_OPERATOR

Required user's level to rename multimedia files.

K_AUTH_SSL_LEVEL  = \false

Minimum page level for which a valid client SSL certificate is required.

K_AUTH_SSL_LEVEL  = \false

Minimum page level for which a valid client SSL certificate is required.

K_AUTH_SSLIDS  = ''

Comma separated lit of SSL certificates IDs required to access pages with K_AUTH_SSL_LEVEL level or more.

K_AUTH_SSLIDS  = ''

Comma separated lit of SSL certificates IDs required to access pages with K_AUTH_SSL_LEVEL level or more.

K_AUTH_USER_CHANGE_EMAIL  = 1

Required user's level to change email

K_AUTH_USER_CHANGE_PASSWORD  = 1

Required user's level to change password

K_AVAILABLE_FONTS  = \serialize(array('courier' => 'courier', 'helvetica' => 'helvetica', 'times' => 'times', 'symbol' => 'symbol', 'zapfdingbats' => 'zapfdingbats', 'DejaVuSans' => 'dejavusans,sans', 'DejaVuSansCondensed' => 'dejavusanscondensed,sans', 'DejaVuSansMono' => 'dejavusansmono,monospace', 'DejaVuSerif' => 'dejavuserif,serif', 'DejaVuSerifCondensed' => 'dejavuserifcondensed,serif', 'FreeMono' => 'freemono,monospace', 'FreeSans' => 'freesans,sans', 'FreeSerif' => 'freeserif,serif'))

Defines a serialized array of available fonts for PDF.

K_AVAILABLE_LANGUAGES  = \serialize(array('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'))

Defines a serialized array of available languages.

K_BLANK_IMAGE  = \K_PATH_IMAGES . '_blank.png'

Full path to a blank image.

K_BRUTE_FORCE_DELAY_RATIO  = 2

Ratio at which the delay will be increased after every failed login attempt.

K_CAS_ENABLED  = \false

If true enable CAS

K_CAS_HOST  = ''

CAS server hostname.

K_CAS_PATH  = '/cas'

The location on the webserver where the CAS application is hosted.

K_CAS_PORT  = 443

The port to connect to.

K_CAS_USER_GROUP_ID  = 1

Default user group ID This is the TCExam group ID to which the CAS accounts belongs.

K_CAS_USER_LEVEL  = 1

Default user level

K_CAS_VERSION  = '2.0'

Version of CAS protocol to use.

K_CELL_HEIGHT_RATIO  = 1.25

height of cell repect font height

K_CHECK_SESSION_FINGERPRINT  = \true

If true, check for possible session hijacking (set to false if you have login problems).

K_CLOCK_IN_UTC  = \false

If true display admin clock in UTC (GMT).

K_COOKIE_DOMAIN  = ''

Cookie domain.

K_COOKIE_EXPIRE  = \K_SECONDS_IN_DAY

Expiration time for cookies.

K_COOKIE_HTTPONLY  = \true

When true the cookie will be made accessible only through the HTTP protocol.

K_COOKIE_PATH  = '/'

Cookie path.

K_COOKIE_SAMESITE  = 'Strict'

The SameSite attribute lets servers specify whether/when cookies are sent with cross-site requests.

K_COOKIE_SECURE  = \true

If true use secure cookies.

K_CUSTOM_AUTH_BASIC_PASSWORD_HASH  = ''

Custom user's Password hash generated with https://www.php.net/manual/en/function.crypt.php

K_CUSTOM_AUTH_BASIC_USER_GROUP_ID  = 1

Custom user group ID.

K_CUSTOM_AUTH_BASIC_USER_LEVEL  = 1

Custom user level.

K_CUSTOM_AUTH_BASIC_USERNAME  = ''

Custom user name.

K_CUSTOM_AUTH_METHODS  = \serialize(array())

Lisf of enabled custom authentication methods.

K_DATABASE_HOST  = ''

database Host name (eg: localhost)

K_DATABASE_NAME  = ''

database name (TCExam)

K_DATABASE_PORT  = ''

database port (eg: 3306, 5432, 1521)

K_DATABASE_TYPE  = ''

database type (MYSQL, POSTGRESQL, ORACLE)

K_DATABASE_USER_NAME  = ''

database user name

K_DATABASE_USER_PASSWORD  = ''

database user password

K_DIGSIG_CERT_TYPE  = '1'

The access permissions granted for this document.

K_DIGSIG_CERTIFICATE  = 'file://../../shared/config/tcpdf.crt'

Signing certificate (string or filename prefixed with 'file://').

K_DIGSIG_CONTACT  = 'you@example.com'

Information provided by the signer to enable a recipient to contact the signer to verify the signature; for example, a phone number or email address.

K_DIGSIG_ENABLE  = \false

If true digitally sign PDF documents.

K_DIGSIG_EXTRA_CERTS  = ''

Name of a file containing a bunch of extra certificates to include in the signature which can for example be used to help the recipient to verify the certificate that you used.

K_DIGSIG_LOCATION  = 'Office'

The CPU host name or physical location of the signing.

K_DIGSIG_NAME  = 'TCEXAM'

The name of the person or authority signing the document.

K_DIGSIG_PASSWORD  = 'tcpdfdemo'

Password for private key.

K_DIGSIG_PRIVATE_KEY  = 'file://../../shared/config/tcpdf.crt'

Private key (string or filename prefixed with 'file://').

K_DIGSIG_REASON  = 'Certification'

The reason for the signing, such as ( I agree ...).

K_DISPLAY_PDFTEXT_BUTTON  = \false

If true display an additional button to print only the TEXT answers on all users' results.

K_DISPLAY_TEST_DESCRIPTION  = \true

If true display test description before executing the test.

K_DOWNLOAD_BACKUPS  = \true

If true enable the backup download.

K_EMAIL_RE_PATTERN  = '^([a-zA-Z0-9_\\.\\-\\+\\%]+)@([a-zA-Z0-9\\.\\-]+)$'

K_ENABLE_ANSWER_EXPLANATION  = \true

If true enable explanation field for answers.

K_ENABLE_CUSTOM_EXPORT  = ''

Name of the button to export results in custom format (file: admin/code/tce_export_custom.php).

K_ENABLE_CUSTOM_IMPORT  = ''

Name of the option to import questions using a custom format (file: admin/code/tce_import_custom.php).

K_ENABLE_JSERRORS  = \false

If true display messages and errors on Javascript popup window.

K_ENABLE_PUBLIC_PDF  = \true

Enable PDF results on public area.

K_ENABLE_QUESTION_EXPLANATION  = \true

If true enable explanation field for questions.

K_ENABLE_VIRTUAL_KEYBOARD  = \true

If true enable virtual keyboard on some textarea fields.

K_ERROR_TYPES  = \E_ALL | \E_STRICT

Define error reporting types for debug.

K_EXTEND_TIME_MINUTES  = 5

Default minutes used to extend test duration.

K_HIDE_EXPIRED_TESTS  = \false

If true hide the expired tests from index table.

K_HTTPBASIC_ENABLED  = \false

If true trust HTTP Basic Auth

K_HTTPBASIC_USER_GROUP_ID  = 1

Default user group ID This is the TCExam group id to which the accounts belong.

K_HTTPBASIC_USER_LEVEL  = 1

Default user level

K_KEY_SECURITY  = 'VENFeGFtIChjKSAyMDA0LTIwMjAgTmljb2xhIEFzdW5pIC0gVGVjbmljay5jb20gLSB0Y2V4YW0uY29t'

String used for security feature, do not alter.

K_LANGUAGE  = 'en'

2-letters code for default language.

K_LANGUAGE_SELECTOR  = \true

If true, display a language selector.

K_LATEX_CLASS  = 'article'

LaTeX class (article).

K_LATEX_FONT_SIZE  = 10

Font size (10).

K_LATEX_FORMULA_DENSITY  = 120

Formula density used by ImageMagick (120).

K_LATEX_IMG_FORMAT  = 'png'

Image format (png).

K_LATEX_IMG_PREFIX  = 'latex_'

Filename prefix for chached images (latex_).

K_LATEX_MAX_HEIGHT  = 800

Image height limit in pixels (500).

K_LATEX_MAX_LENGHT  = 500

Size limit for input string (500).

K_LATEX_MAX_WIDTH  = 800

Image width limit in pixels (500).

K_LATEX_PATH_CONVERT  = '/usr/bin/convert'

Path to ImageMagick convert (/usr/bin/convert).

K_LATEX_PATH_PICTURE  = \K_PATH_CACHE

Absolute path to images directory.

K_LATEX_PATH_PICTURE_HTTPD  = \K_PATH_URL_CACHE

relative path to images directory.

K_LATEX_PDFLATEX  = '/usr/bin/pdflatex'

Path to PDFLATEX (/usr/bin/pdflatex).

K_LDAP_BASE_DN  = 'ou=users,dc=mydom,dc=example,dc=org'

The base DN for the directory.

K_LDAP_ENABLED  = \false

If true enable LDAP.

K_LDAP_FILTER  = 'uid=#USERNAME#'

The search filter can be simple or advanced, using boolean operators in the format described in the LDAP documentation. Use "#USERNAME#" as a placeholder for the username passed by login form. For W2K3 use: "(sAMAccountName=#USERNAME#)"

K_LDAP_HOST  = 'localhost'

LDAP hostname. If you are using OpenLDAP 2.x.x you can specify a URL instead of the hostname. To use LDAP with SSL, compile OpenLDAP 2.x.x with SSL support, configure PHP with SSL, and set this parameter as ldaps://hostname/.

K_LDAP_PORT  = 389

The port to connect to. Not used when using URLs.

K_LDAP_PROTOCOL_VERSION  = 3

LDAP protocol version.

K_LDAP_ROOT_DN  = \null

The DN for the ROOT Account Set to null for anonymous LDAP binding

K_LDAP_ROOT_PASS  = \null

The password for the ROOT Account Set to null for anonymous LDAP binding

K_LDAP_USER_GROUP_ID  = 1

Default user group ID.

K_LDAP_USER_LEVEL  = 1

Default user level

K_LDAP_UTF8  = \true

Set to true if LDAP uses UTF-8 encoding.

K_LOGOUT_URL  = ''

URL to be redirected at logout (leave empty for default).

K_MAIN_PAGE  = 'index.php'

Main page (homepage).

K_MAX_MEMORY_LIMIT  = '512M'

Max memory limit.

K_MAX_MEMORY_LIMIT  = '32M'

Max memory limit for a PHP script.

K_MAX_ROWS_PER_PAGE  = 50

Max number of rows to display in tables.

K_MAX_ROWS_PER_PAGE  = 50

Max number of rows to display in tables.

K_MAX_TESTS_DAY  = \false

Maximum number of tests per day (last 24 hours).

K_MAX_TESTS_MONTH  = \false

Maximum number of tests per month (last 30 days).

K_MAX_TESTS_YEAR  = \false

Maximum number of tests per year (last 365 days).

K_MAX_UPLOAD_SIZE  = 25000000

Max size to be uploaded in bytes.

K_MAX_UPLOAD_SIZE  = 1000000

Max file size to be uploaded [bytes].

K_MYSQL_QA_BIN_UNIQUITY  = \true

If true check the unicity of question and answer descriptions using utf8_bin collation when using MySQL.

K_NEWLINE  = "\n"

New line character.

K_OMR_PATH_ZBARIMG  = '/usr/bin/zbarimg'

Path to zbarimg executable (/usr/bin/zbarimg).

K_OTP_LOGIN  = \false

If true enable One-Time-Password authentication on login.

K_PASSWORD_RESET  = \true

If true enable password reset feature.

K_PATH_BACKUP  = \K_PATH_MAIN . 'admin/backup/'

Full path to backup directory.

K_PATH_CACHE  = \K_PATH_MAIN . 'cache/'

Full path to cache directory.

K_PATH_FONTS  = \K_PATH_MAIN . 'fonts/'

Full path to fonts directory.

K_PATH_HOST  = ''

Host URL (e.g.: "http://www.yoursite.com").

K_PATH_IMAGES  = '../../images/'

Relative path to images directory.

K_PATH_JSCRIPTS  = '../jscripts/'

Relative path to javascript directory.

K_PATH_LANG_CACHE  = \K_PATH_CACHE . 'lang/'

Full path to cache directory used for language files.

K_PATH_MAIN  = ''

Real full path where this program is installed (e.g: "/var/www/html/TCExam/").

K_PATH_PUBLIC_CODE  = \K_PATH_HOST . \K_PATH_TCEXAM . 'public/code/'

Path to public code.

K_PATH_PUBLIC_CODE_REAL  = \K_PATH_MAIN . 'public/code/'

Server path to public code.

K_PATH_SHARED_JSCRIPTS  = '../../shared/jscripts/'

Relative path to shared javascript directory.

K_PATH_STYLE_SHEETS  = '../styles/'

Relative path to stylesheets directory.

K_PATH_TCEXAM  = ''

Relative URL where this program is installed (e.g.: "/").

K_PATH_TMX_FILE  = \K_PATH_MAIN . 'shared/config/lang/language_tmx.xml'

Full path to TMX language file.

K_PATH_URL  = \K_PATH_HOST . \K_PATH_TCEXAM

Constant used on TCPDF library.

K_PATH_URL_CACHE  = \K_PATH_TCEXAM . 'cache/'

URL path to to cache directory.

K_PUBLIC_THEME  = 'default'

Theme for the public area

K_QUESTION_DIFFICULTY_LEVELS  = 10

Number of difficulty levels for questions.

K_QUESTION_LINE_MAX_LENGTH  = 70

Define max line length in chars for question navigator on test execution interface.

K_RADIUS_ACCOUNTING_PORT  = 1813

Radius accounting port (e.g.: 1813).

K_RADIUS_AUTHENTICATION_PORT  = 1812

Radius authentication port (e.g.: 1812).

K_RADIUS_ENABLED  = \false

If true enable RADIUS.

K_RADIUS_SERVER_IP  = 'localhost'

IP address of the radius server (e.g.: "127.0.0.1").

K_RADIUS_SHARED_SECRET  = 'WinRadius'

Shared secret with the radius server.

K_RADIUS_SUFFIX  = ''

Radius domain name suffix (e.g.: "@mydomain.com").

K_RADIUS_UDP_TIMEOUT  = 5

Radius UDP timeout (e.g.: 5).

K_RADIUS_USER_GROUP_ID  = 1

Default user group ID.

K_RADIUS_USER_LEVEL  = 1

Default user level.

K_RADIUS_UTF8  = \true

Set to true if RADIUS uses UTF-8 encoding.

K_RANDOM_SECURITY  = 'mkTzxf8WwUxwvj6w'

String used as a seed for some security code generation please change this value and keep it secret.

K_REDIRECT_LOGIN_MODE  = 4

Various pages redirection modes after login (valid values are 1, 2, 3 and 4).

K_REMAINING_TESTS  = \false

Set to false to disable test counting.

K_SECONDS_IN_DAY  = 24 * \K_SECONDS_IN_HOUR

Number of seconds in one day.

K_SECONDS_IN_HOUR  = 60 * \K_SECONDS_IN_MINUTE

Number of seconds in one hour.

K_SECONDS_IN_MINUTE  = 60

Number of seconds in one minute.

K_SECONDS_IN_MONTH  = 30 * \K_SECONDS_IN_DAY

Number of seconds in one month.

K_SECONDS_IN_WEEK  = 7 * \K_SECONDS_IN_DAY

Number of seconds in one week.

K_SECONDS_IN_YEAR  = 365 * \K_SECONDS_IN_DAY

Number of seconds in one year.

K_SELECT_SUBSTRING  = 40

Max number of chars to display on a selection box.

K_SESSION_LIFE  = \K_SECONDS_IN_HOUR

User's session life time in seconds.

K_SHIBBOLETH_ENABLED  = \false

If true trust Shibboleth Auth

K_SHIBBOLETH_LOGIN  = ''

URL of the Shibboleth login page

K_SHIBBOLETH_USER_GROUP_ID  = 1

Default user group ID This is the TCExam group id to which the accounts belong.

K_SHIBBOLETH_USER_LEVEL  = 1

Default user level

K_SHORT_ANSWERS_BINARY  = \false

If true compare short answers in binary mode.

K_SITE_AUTHOR  = 'Nicola Asuni - Tecnick.com LTD'

Default site author.

K_SITE_DESCRIPTION  = 'TCExam by Tecnick.com'

Default site description.

K_SITE_ICON  = '../../favicon.ico'

Path to default html icon.

K_SITE_KEYWORDS  = 'TCExam, eExam, e-exam, web, exam'

Default keywords.

K_SITE_REPLY  = ''

Default html reply-to meta tag.

K_SITE_STYLE  = \K_PATH_STYLE_SHEETS . \K_PUBLIC_THEME . '.css'

Path to public CSS stylesheet for LTR languages.

K_SITE_STYLE_RTL  = \K_PATH_STYLE_SHEETS . \K_PUBLIC_THEME . '_rtl.css'

Path to CSS stylesheet for RTL languages.

K_SITE_TITLE  = 'TCExam'

Default site name.

K_SMALL_RATIO  = 2 / 3

reduction factor for small font

K_SSL_ENABLED  = \false

If true trust SSL Auth

K_SSL_USER_GROUP_ID  = 1

Default user group ID This is the TCExam group id to which the accounts belong.

K_SSL_USER_LEVEL  = 1

Default user level

K_STANDARD_PORT  = 80

Standard port for http (80) or https (443).

K_TAB  = "\t"

Tabulation character.

K_TABLE_ANSWERS  = \K_TABLE_PREFIX . 'answers'

This table contains all answers relative to a specific questions.

K_TABLE_GROUPS  = \K_TABLE_PREFIX . 'user_groups'

This table contains users' groups. Each user belongs to one of the groups defined in this table.

K_TABLE_LOG_ANSWER  = \K_TABLE_PREFIX . 'tests_logs_answers'

This table contains the list of the selected alternative answers for each multiple-choice question.

K_TABLE_MODULES  = \K_TABLE_PREFIX . 'modules'

Table for modules. A module is a container for subjects.

K_TABLE_PREFIX  = 'tce_'

prefix for database tables names

K_TABLE_QUESTIONS  = \K_TABLE_PREFIX . 'questions'

This table contains all questions relative to specific subjects.

K_TABLE_SESSIONS  = \K_TABLE_PREFIX . 'sessions'

This table stores information about users' Web sessions.

K_TABLE_SSLCERTS  = \K_TABLE_PREFIX . 'sslcerts'

This table contains the SSL certificates.

K_TABLE_SUBJECT_SET  = \K_TABLE_PREFIX . 'test_subjects'

This table contains all tests subjects (topics, branch of studies).

K_TABLE_SUBJECTS  = \K_TABLE_PREFIX . 'subjects'

This table contains all tests subjects (topics, branch of studies).

K_TABLE_TEST_GROUPS  = \K_TABLE_PREFIX . 'testgroups'

This table contains the list of groups enabled for a selected test.

K_TABLE_TEST_SSLCERTS  = \K_TABLE_PREFIX . 'testsslcerts'

This table contains the list of SSL certificates enabled for a selected test.

K_TABLE_TEST_SUBJSET  = \K_TABLE_PREFIX . 'test_subject_set'

This table lists the type and quantity of the questions associated to each set of subjects selected for a particular test.

K_TABLE_TEST_USER  = \K_TABLE_PREFIX . 'tests_users'

This table contains the list of tests generated for each user.

K_TABLE_TESTS  = \K_TABLE_PREFIX . 'tests'

This table contains all tests data.

K_TABLE_TESTS_LOGS  = \K_TABLE_PREFIX . 'tests_logs'

This table contains all questions and user answers relative to a specific test for a specific user.

K_TABLE_TESTUSER_STAT  = \K_TABLE_PREFIX . 'testuser_stat'

This table counts the number of generated tests.

K_TABLE_USERGROUP  = \K_TABLE_PREFIX . 'usrgroups'

This table contains the list of groups to whom each user belongs.

K_TABLE_USERS  = \K_TABLE_PREFIX . 'users'

This table contains all registered users' data, including system administrators and a special 'anonymous' user.

K_TCEXAM_AUTHOR  = 'Nicola Asuni - Tecnick.com LTD'

TCExam Author.

K_TCEXAM_DESCRIPTION  = 'TCExam by Tecnick.com'

TCExam description.

K_TCEXAM_ICON  = '../../favicon.ico'

Relative path to html icon.

K_TCEXAM_KEYWORDS  = 'TCExam, eExam, e-exam, web, exam'

Default html meta keywords.

K_TCEXAM_REPLY_TO  = ''

Reply-to meta tag.

K_TCEXAM_STYLE  = \K_PATH_STYLE_SHEETS . \K_ADMIN_THEME . '.css'

Path to public CSS stylesheet for LTR languages.

K_TCEXAM_STYLE_RTL  = \K_PATH_STYLE_SHEETS . \K_ADMIN_THEME . '_rtl.css'

Full path to CSS stylesheet for RTL languages.

K_TCEXAM_TITLE  = 'TCExam'

TCExam title.

K_TCEXAM_VERSION  = \file_get_contents('../../VERSION')

TCExam version (do not change).

K_TCPDF_CALLS_IN_HTML  = \false

if true allows to call TCPDF methods using HTML syntax IMPORTANT: For security reason, disable this feature if you are printing user HTML content.

K_TCPDF_EXTERNAL_CONFIG  = \true

Do not change the value of this define.

K_TCPDF_THROW_EXCEPTION_ERROR  = \false

if true adn PHP version is greater than 5, then the Error() method throw new exception instead of terminating the execution.

K_TEST_INFO_HEIGHT  = 400

Popup window height in pixels for test info.

K_TEST_INFO_WIDTH  = 700

Popup window width in pixels for test info.

K_THAI_TOPCHARS  = \false

set to true to enable the special procedure used to avoid the overlappind of symbols on Thai language

K_TIMESTAMP_FORMAT  = 'Y-m-d H:i:s'

Define timestamp format using PHP notation (do not change).

K_TIMEZONE  = 'UTC'

Set your own timezone here.

K_TITLE_MAGNIFICATION  = 1.3

title magnification respect main font size

K_UPDATE_PASSKEY  = '0'

UPDATES PASSKEY

K_UPDATE_SERVER  = 'http://updates.tcexam.com'

Updating server

K_USE_ERROR_LOG  = \false

Enable error logs (../log/tce_errors.log).

K_USER_GROUP_RSYNC  = \false

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.

K_USRREG_ADMIN_EMAIL  = ''

The following email will receive copies of verification messages.

K_USRREG_AGREEMENT  = ''

URL of an HTML page containing the registration agreement (i.e.: "http://www.example.com/agreement.html").

K_USRREG_EMAIL_CONFIRM  = \true

If true requires email confirmation.

K_USRREG_ENABLED  = \true

If true enable USER REGISTRATION.

K_USRREG_GROUP  = 1

Default user group ID for registered user.

K_USRREG_PASSWORD_RE  = '^(.{8,})$'

Regular expression defining the allowed characters for a password

K_UTF8_NORMALIZATION_MODE  = 'NONE'

Set the UTF-8 Normalization mode for question and answer descriptions: NONE=None; C=Normalization Form C (NFC) - Canonical Decomposition followed by Canonical Composition; D=Normalization Form D (NFD) - Canonical Decomposition; KC=Normalization Form KC (NFKC) - Compatibility Decomposition, followed by Canonical Composition; KD=Normalization Form KD (NFKD) - Compatibility Decomposition; CUSTOM=Custom normalization using user defined function 'user_utf8_custom_normalizer'.

PDF_AUTHOR  = 'TCExam 12'

Document author.

PDF_CREATOR  = 'TCExam 12'

Document creator.

PDF_FONT_MONOSPACED  = 'courier'

default monospaced font name

PDF_FONT_NAME_DATA  = 'helvetica'

Data font name.

PDF_FONT_NAME_MAIN  = 'helvetica'

Main font name.

PDF_FONT_SIZE_DATA  = 7

Data font size.

PDF_FONT_SIZE_MAIN  = 9

Main font size.

PDF_HEADER_LOGO  = 'logo_example.png'

Image logo.

PDF_HEADER_LOGO_WIDTH  = 20

Header logo image width [mm].

PDF_HEADER_STRING  = "first row\nsecond row\nthird row"

Header description string.

PDF_HEADER_TITLE  = "School name"

Header title.

PDF_IMAGE_SCALE_RATIO  = 1.25

ratio used to adjust the conversion of pixels to user units

PDF_MARGIN_BOTTOM  = 30

Bottom margin.

PDF_MARGIN_FOOTER  = 10

Footer margin.

PDF_MARGIN_HEADER  = 5

Header margin.

PDF_MARGIN_LEFT  = 15

Left margin.

PDF_MARGIN_RIGHT  = 15

Right margin.

PDF_MARGIN_TOP  = 27

Top margin.

PDF_PAGE_FORMAT  = 'A4'

Page format.

PDF_PAGE_ORIENTATION  = 'P'

Page orientation (P=portrait, L=landscape).

PDF_TEXTANSWER_HEIGHT  = 40

Height of area for offline user answer.

PDF_UNIT  = 'mm'

Document unit of measure [pt=point, mm=millimeter, cm=centimeter, in=inch].

PHP_VERSION_ID  = $version[0] * 10000 + $version[2] * 100 + $version[4]

Functions

F_html_color_picker()  : mixed

Display Color Picker

F_isValidbackupFile()  : mixed

F_send_report_emails()  : mixed

Sends email test reports to users.

F_deleteMediaFile()  : true

Delete the selected media file

F_renameMediaFile()  : true

Rename the selected media file

F_createMediaDir()  : true

Create a new media directory inside the cache

F_deleteMediaDir()  : true

Delete the specified media directory

F_getFileInfo()  : associative

Get file information

F_formatFileSize()  : string

Return a formatted file size

F_getMediaDirPathLink()  : an

Get an html string containing active path of the specified directory with links to subdirectories.

F_getDirFiles()  : an

Get an associative array of directories and folder inside the specified dir.

F_isUsedMediaFile()  : true

Return true if the file is used on question or answer descriptions

F_getDirTable()  : html

Get an html table containing files and subdirs

F_getDirVisualTable()  : html

Get an html visual list of files and subdirs

F_getAuthorizedDirs()  : a

Returns a regular expression to match authorised directories.

F_isAuthorizedDir()  : true

Returns true if the user is authorized to use the specified directory, false otherwise.

F_encodeOMRTestData()  : encoded

Encode OMR test data array as a string to be printed on QR-Code.

F_decodeOMRTestData()  : array<string|int, mixed>

Decode OMR test data string (read from QR-Code) as array.

F_decodeOMRTestDataQRCode()  : array<string|int, mixed>

Read QR-Code from OMR page and return Test data.

F_decodeOMRPage()  : array<string|int, mixed>

Decode a single OMR Page and return data array.

F_importOMRTestData()  : bool

Import user's test data from OMR.

F_question_set_enabled()  : mixed

Enable/Disable selected question

F_question_get_position()  : int

Get question position

F_question_get_data()  : array<string|int, mixed>

Get question data

F_question_delete()  : mixed

Delete selected question (or disable it if used)

F_question_copy()  : mixed

Copy selected question to another topic

tcecodeEditorTagButtons()  : XHTML

Display TCExam Code EDITOR Tag Buttons

getImageButton()  : XHTML

Display one tag button

F_select_test()  : true

Display test selection for using F_show_select_test function.

F_show_select_test()  : false

Display test selection XHTML table.

F_show_select_test_popup()  : false

Display user selection XHTML table (popup mode).

F_isTestOnSSLCerts()  : bool

Return true if the selected test is active for the selected SSL Certificate

F_is_allowed_upload()  : true

Check if the uploaded file extension is allowed.

F_upload_file()  : mixed

Uploads image file to the server.

F_read_file_size()  : mixed

returns the file size in bytes

F_select_user()  : true

Display user selection for using F_show_select_user function.

F_show_select_user()  : false

Display user selection XHTML table.

F_show_select_user_popup()  : false

Display user selection XHTML table (popup mode).

F_isTestOnGroup()  : bool

Return true if the selected test is active for the selected group

F_isUserOnGroup()  : bool

Return true if the selected user belongs to the selected group

F_isAuthorizedEditorForGroup()  : bool

Return true if the current user is an administrator or belongs to the group, false otherwise

F_isAuthorizedEditorForUser()  : bool

Return true if the current user is authorized to edit the specified user

F_user_group_select_sql()  : sql

Return the SQL selection query for user groups

F_user_group_select()  : table

Display select box for user groups

F_get_user_groups()  : array<string|int, mixed>

Returns an array containing groups IDs to which the specified user belongs

F_getUIDfromRegnum()  : int

Return the user ID from registration number.

F_show_online_users()  : false

Display online users form using F_list_online_users function.

F_list_online_users()  : false

Display online users.

F_TSVQuestionImporter()  : bool

Import questions from TSV file (tab delimited text).

F_import_tsv_users()  : bool

Import users from TSV file (tab delimited text).

F_show_select_questions()  : false

Display a list of selected questions.

F_tsv_export_questions()  : TSV

Export all questions of the selected subject to TSV.

F_tsv_export_users()  : TSV

Export all users to TSV grouped by users' groups.

F_xml_export_question_stats()  : XML

Export all question statistics of the selected test to XML.

F_xml_export_questions()  : XML

Export all questions of the selected subject to XML.

F_xml_export_results()  : XML

Export results in XML format.

F_xml_export_user_results()  : XML

Export user results in XML format.

F_xml_export_users()  : XML

Export all users to XML grouped by users' groups.

F_altLogin()  : array<string|int, mixed>

Try various external Login Systems.

F_db_connect()  : MySQL

Open a connection to a MySQL Server and select a database.

F_db_close()  : bool

Closes the non-persistent connection to a database associated with the given connection resource.

F_db_error()  : string

Returns the text of the error message from previous database operation

F_db_query()  : false

Sends a query to the currently active database on the server that's associated with the specified link identifier.<br>

F_db_fetch_array()  : Returns

Fetch a result row as an associative and numeric array.

F_db_fetch_assoc()  : Returns

Fetch a result row as an associative array.

F_db_affected_rows()  : Number

Returns number of rows (tuples) affected by the last INSERT, UPDATE or DELETE query associated with link_identifier.

F_db_num_rows()  : Number

Get number of rows in result.

F_db_insert_id()  : int

Get the ID generated from the previous INSERT operation

F_db_datetime_diff_seconds()  : SQL

Returns the SQL string to calculate the difference in seconds between to datetime fields.

F_escape_sql()  : string

Escape a string for insertion into a SQL text field (avoiding SQL injection).

F_db_connect()  : MySQL

Open a connection to a MySQL Server and select a database.

F_db_close()  : bool

Closes the non-persistent connection to a database associated with the given connection resource.

F_db_error()  : string

Returns the text of the error message from previous database operation

F_db_query()  : false

Sends a query to the currently active database on the server that's associated with the specified link identifier.<br>

F_db_fetch_array()  : Returns

Fetch a result row as an associative and numeric array.

F_db_fetch_assoc()  : Returns

Fetch a result row as an associative array.

F_db_affected_rows()  : Number

Returns number of rows (tuples) affected by the last INSERT, UPDATE or DELETE query associated with link_identifier.

F_db_num_rows()  : Number

Get number of rows in result.

F_db_insert_id()  : int

Returns the auto generated id used in the last query.

F_db_datetime_diff_seconds()  : SQL

Returns the SQL string to calculate the difference in seconds between to datetime fields.

F_escape_sql()  : string

Escape a string for insertion into a SQL text field (avoiding SQL injection).

F_db_connect()  : Oracle

Open a connection to a Oracle Server and select a database.

F_db_close()  : bool

Closes the non-persistent connection to a database associated with the given connection resource.

F_db_error()  : string

Returns the text of the error message from previous database operation

F_db_query()  : false

Sends a query to the currently active database on the server that's associated with the specified link identifier.<br> NOTE: Convert MySQL RAND() function to Oracle RANDOM() on ORDER BY clause of selection queries.

F_db_fetch_array()  : Returns

Fetch a result row as an associative and numeric array.

F_db_fetch_assoc()  : Returns

Fetch a result row as an associative array.

F_db_affected_rows()  : Number

Returns number of rows (tuples) affected by the last INSERT, UPDATE or DELETE query associated with link_identifier.

F_db_num_rows()  : Number

Get number of rows in result.

F_db_insert_id()  : int

Get the ID generated from the previous INSERT operation

F_db_datetime_diff_seconds()  : SQL

Returns the SQL string to calculate the difference in seconds between to datetime fields.

F_escape_sql()  : string

Escape a string for insertion into a SQL text field (avoiding SQL injection).

F_db_connect()  : PostgreSQL

Open a connection to a PostgreSQL Server and select a database.

F_db_close()  : bool

Closes the non-persistent connection to a database associated with the given connection resource.

F_db_error()  : string

Returns the text of the error message from previous database operation

F_db_query()  : false

Sends a query to the currently active database on the server that's associated with the specified link identifier.<br> NOTE: Convert MySQL RAND() function to PostgreSQL RANDOM() on ORDER BY clause of selection queries.

F_db_fetch_array()  : Returns

Fetch a result row as an associative and numeric array.

F_db_fetch_assoc()  : Returns

Fetch a result row as an associative array.

F_db_affected_rows()  : Number

Returns number of rows (tuples) affected by the last INSERT, UPDATE or DELETE query associated with link_identifier.

F_db_num_rows()  : Number

Get number of rows in result.

F_db_insert_id()  : int

Get the ID generated from the previous INSERT operation

F_db_datetime_diff_seconds()  : SQL

Returns the SQL string to calculate the difference in seconds between to datetime fields.

F_escape_sql()  : string

Escape a string for insertion into a SQL text field (avoiding SQL injection).

F_select_modules_sql()  : string

Returns a SQL string to select modules accounting for user authorizations.

F_select_subjects_sql()  : string

Returns a SQL string to select subjects accounting for user authorizations.

F_select_module_subjects_sql()  : string

Returns a SQL string to select modules and subjects accounting for user authorizations.

F_select_tests_sql()  : string

Returns a SQL string to select tests accounting for user authorizations.

F_select_executed_tests_sql()  : string

Returns a SQL string to select executed tests accounting for user authorizations.

F_loginForm()  : XHTML

Returns XHTML / CSS formatted string for login form.<br> The CSS classes used are: <ul> <li>div.login_form : container for login box</li> <li>div.login_form div.login_row : container for label + input field or button</li> <li>div.login_form div.login_row span.label : container for input label</li> <li>div.login_form div.login_row span.formw : container for input form</li> </ul>

F_login_form()  : mixed

Display login page.

F_logout_form()  : XHTML

Display logout form.

F_logout_page()  : mixed

Display logout page.

F_isAuthorizedUser()  : bool

Returns true if the current user is authorized to update and delete the selected database record.

F_getAuthorizedUsers()  : string

Returns a comma separated string of ID of the users that belong to the same groups.

F_syncUserGroups()  : mixed

Sync user groups with the ones specified on the configuration file for alternate authentication.

F_isSslCertificateValid()  : true

Check if the client has a valid SSL certificate.

F_getSSLCertificateHash()  : array<string|int, mixed>

Get the hash code of the specified SSL certificate

F_getSSLClientHash()  : string

Get the hash code for the client certificate

F_print_error()  : mixed

Handle error/warning/system messages.

F_display_db_error()  : mixed

Print the database error message.

F_error_handler()  : mixed

Custom PHP error handler function.

F_url_exists()  : Returns

Check if the URL exist.

F_file_exists()  : Returns

Wrapper for file_exists.

F_decode_form_fields()  : array<string|int, mixed>

Returns an array containing form fields.

F_check_required_fields()  : array<string|int, mixed>

Check Required Form Fields.<br> Returns a string containing a list of missing fields (comma separated).

F_check_fields_format()  : array<string|int, mixed>

Check fields format using regular expression comparisons.<br> Returns a string containing a list of wrong fields (comma separated).

F_check_form_fields()  : false

Check Form Fields.

F_stripslashes_formfields()  : mixed

Strip slashes from posted form fields.

F_close_button()  : XHTML

Returns XHTML code string to display a window close button

F_submit_button()  : XHTML

Returns XHTML code string to display Form Submit Button.

F_getCSRFTokenField()  : XHTML

Returns XHTML code string to display the CSRF token field.

getFormRowTextInput()  : string

Print input row form.

getFormRowTextBox()  : string

Print text box row form.

getFormRowSelectBox()  : string

Print select box row form.

getFormRowCheckBox()  : string

Print check box row form.

getFormRowFixedValue()  : string

Print fixed value row form.

getFormSmallVertSpace()  : string

Print empty form row.

getFormSmallDivSpace()  : string

Print empty form row.

getFormRowVertSpace()  : string

Print empty form row.

getFormRowVertDiv()  : string

Print form row with title.

getFormNoscriptSelect()  : string

Print form row with submit button when noscript is active.

getFormDescriptionLine()  : string

Print form row with label and description

getFormUploadFile()  : string

Print input row form to upluad a file.

F_count_rows()  : number

Count rows of the given table.

F_empty_to_null()  : string

Prepare field value for SQL query.<br> Returns the quoted string if not empty, NULL otherwise.

F_zero_to_null()  : string

Prepare field value for SQL query.<br> Returns the num if different from zero, NULL otherwise.

F_getBoolean()  : bool

Returns boolean value from string or integer.<br> This function is needed to get the right boolean value from boolean field returned by PostgreSQL query.

F_check_unique()  : bool

Check if specified fields are unique on table.

unhtmlentities()  : converted

Reverse function for htmlentities.

F_compact_string()  : converted

Remove the following characters: <ul> <li>"\t" (ASCII 9 (0x09)), a tab.</li> <li>"\n" (ASCII 10 (0x0A)), a new line (line feed)</li> <li>"\r" (ASCII 13 (0x0D)), a carriage return</li> <li>"\0" (ASCII 0 (0x00)), the NUL-byte</li> <li>"\x0B" (ASCII 11 (0x0B)), a vertical tab</li> </ul>

F_replace_angulars()  : converted

Replace angular parenthesis with html equivalents (html entities).

F_substr_utf8()  : substring

Performs a multi-byte safe substr() operation based on number of characters.

F_text_to_xml()  : converted

Escape some special characters (&lt; &gt; &amp;).

F_xml_to_text()  : converted

Unescape some special characters (&lt; &gt; &amp;).

F_text_to_tsv()  : converted

Escape some special characters for TSV output.

F_tsv_to_text()  : converted

Unescape some special characters from TSV format.

showRequiredField()  : html

Return a string containing an HTML acronym for required/not required fields.

utrim()  : string

Strip whitespace (or other characters) from the beginning and end of an UTF-8 string and replace the "\xA0" with normal space.

getNormalizedIP()  : string

Convert all IP addresses to IPv6 expanded notation.

getIpAsInt()  : int

Converts a string containing an IP address into its integer value.

getIpAsString()  : int

Converts a string containing an IP address into its integer value and return string representation.

F_formatFloat()  : formatted

Format a percentage number.

F_formatPercentage()  : formatted

Format a percentage number.

F_formatPdfPercentage()  : string

format a percentage number

F_formatXMLPercentage()  : string

format a percentage number for XML

F_getUTCoffset()  : int

Returns the UTC time offset in seconds

F_db_getUTCoffset()  : string

Returns the UTC time offset yo be used with CONVERT_TZ function

getDataXML()  : string

Get data array in XML format.

getDataTSVHeader()  : string

Get data headers (keys) in TSV header (tab separated text values).

getDataTSV()  : string

Get data in TSV format (tab separated text values).

F_html_to_TSV()  : string

Convert HTML code to TSV string.

F_select_table_header_element()  : table

Display table header element with order link.

getContrastColor()  : string

Get a black or white color that maximize contrast.

F_isURL()  : bool

Returns true if the string is an URL.

F_utf8_normalizer()  : normalized

Normalize the UTF-8 input string.

bcdechex()  : string

Convert an long integer number to a Hexadecimal representation

F_html_to_text()  : text

Convert HTML code to Text string.

F_menu_link()  : mixed

Returns a menu element link wit subitems.

F_menu_isChildActive()  : mixed

Returns true if the menu item has an active child, false otherwise.

F_getRandomOTPkey()  : Base32

Return a random One Time Password Secret Key (Base32 encoded).

F_decodeBase32()  : Decoded

Decode a Base32 encoded string.

F_getOTP()  : OTP

Get a One Time Password for the specified secret key.

F_show_page_navigator()  : mixed

Display Pages navigation index.

F_session_open()  : bool

Open session.

F_session_close()  : bool

Close session.<br> Call garbage collector function to remove expired sessions.

F_session_read()  : string

Get session data.

F_session_write()  : resource

Insert or Update session.

F_session_destroy()  : resource

Deletes the specific session.

F_session_gc()  : int

Garbage collector.<br> Deletes expired sessions.<br> NOTE: while time() function returns a 32 bit integer, it works fine until year 2038.

F_session_string_to_array()  : array<string|int, mixed>

Convert encoded session string data to array.

getClientFingerprint()  : string

Generate a client fingerprint (unique ID for the client browser)

getNewSessionID()  : string

Generate and return a new session ID.

getPasswordHash()  : string

Hash password for Database storing.

checkPassword()  : bool

Verifies that a password matches a hash

getPlainCSRFToken()  : string

Generate unencoded CSRF token string

checkCSRFToken()  : bool

Check the CSRF token

F_getCSRFToken()  : string

Generate CSRF token

F_getArrayStatistics()  : array<string|int, mixed>

Return an array containing descriptive statistics for the bidimensional input array.

F_getSVGGraphCode()  : converted

Replace angular parenthesis with html equivalents (html entities).

F_getSVGGraph()  : converted

Replace angular parenthesis with html equivalents (html entities).

F_decode_tcecode()  : string

Returns XHTML code from text marked-up with TCExam Code Tags

F_latex_callback()  : string

Callback function for preg_replace_callback (LaTeX replacement).

F_mathml_callback()  : string

Callback function for preg_replace_callback (MathML replacement).

F_objects_callback()  : string

Callback function for preg_replace_callback.

F_objects_replacement()  : string

Returns the xhtml code needed to display the object by MIME type.

F_remove_tcecode()  : string

Returns specified string without tcecode mark-up tags

F_tcecodeToLine()  : mixed

Converts tcecode text to a single XHTML string removing some objects.

F_tcecodeToTitle()  : mixed

Converts tcecode text to simple string for XHTML title attribute.

F_substrHTML()  : mixed

Return a substring of XHTML code while making sure no html tags are chopped.

F_getUserTests()  : string

Returns an XHTML table of user's tests.

F_repeatTest()  : mixed

Mark previous test attempts as repeated.

F_isValidIP()  : true

Check if user's IP is valid over test IP range

F_isValidSSLCert()  : true

Check if user's IP is valid over test IP range

F_isValidTestUser()  : true

Check if user is authorized to execute the specified test

F_terminateUserTest()  : mixed

Terminate user's test<br>

F_countUserTest()  : retried

Count the number times of retries.<br>

F_checkTestStatus()  : array<string|int, mixed>

Check and returns specific test status for the specified user.<br>

F_testInfoLink()  : mixed

Returns XHTML link to open test info popup.

F_printTestInfo()  : string

Returns an XHTML string containing specified test information.

F_getTestData()  : array<string|int, mixed>

Returns the test data.

F_getUserData()  : array<string|int, mixed>

Returns user data.

F_getTestPassword()  : string

Returns the test password.

F_getTestName()  : string

Returns the test name.

F_getTestDuration()  : int

Returns the test duration time in seconds.

F_getTestStartTime()  : int

Returns the user's test start time in seconds since UNIX epoch (1970-01-01 00:00:00).

F_twoColRow()  : string

Return a formatted XHTML row to display 2 columns data.<br> See CSS classes:<ul> <li>div.row span.label</li> <li>div.row span.formw</li> </ul>

F_executeTest()  : true

Returns true if the current user is authorized to execute the selected test.<br> Generates the test if it's not already generated.

F_isRightTestlogUser()  : bool

Checks if the current user is the right testlog_id owner.<br> This function is used for security reasons.

F_selectAnswers()  : array<string|int, mixed>

Return an array containing answer_id field of selected answers.<br>

F_addLogAnswers()  : bool

Add specified answers on tce_tests_logs_answer table.

F_getFirstTestUser()  : int

Returns the ID of the tce_tests_users table corresponding to a complete test of $test_id type.

F_newTestLog()  : int

Creates a new tce_tests_logs table entry and returns inserted ID.

F_isTestOverLimits()  : bool

Returns false if the number of executed tests is under the limits, true otherwise.

F_count_executed_tests()  : int

Returns the number of executed tests on the specified time interval.

F_updateTestuserStat()  : mixed

Track generated tests.

F_createTest()  : bool

Create user's test and returns TRUE on success.

F_addQuestionAnswers()  : bool

Add answers to selected question.

F_updateQuestionLog()  : bool

Updates question log data (register user's answers and calculate scores).

F_getAnswerIdFromPosition()  : int

Returns the answer ID from position

F_questionForm()  : string

Returns a formatted XHTML form code to handle the specified question.<br> Form fields names are: answer_text, answer_id<br> CSS classes:<ul> <li>div.tcecontentbox</li> <li>div.rowl</li> <li>textarea.answertext</li> </ul>

F_questionsMenu()  : string

Returns a questions menu and navigator buttons.

F_getNumOmittedQuestions()  : int

Returns the number of omitted questions (unanswered + undisplayed).

F_testComment()  : string

Display a textarea for user's comment.<br>

F_updateTestComment()  : string

Updates user's test comment.<br>

F_testLoginForm()  : XHTML

Returns XHTML / CSS formatted page string to insert the test password.<br> The CSS classes used are: <ul> <li>div.login_form : container for login box</li> <li>div.login_form div.login_row : container for label + input field or button</li> <li>div.login_form div.login_row span.label : container for input label</li> <li>div.login_form div.login_row span.formw : container for input form</li> </ul>

F_getTestGroups()  : string

Get a comma separated list of valid group IDs for the selected test.

F_getTestSSLCerts()  : string

Get a comma separated list of valid SSL certificates IDs for the selected test.

F_getUserTestStat()  : mixed

Returns statistic array for the test-user

F_getUserTestTotals()  : mixed

Returns test-user totals

F_getTestStat()  : mixed

Returns statistic array for the selected test.

F_getRawTestStat()  : mixed

Returns raw statistic array for the selected test.

F_normalizeTestStatAverages()  : mixed

Calculate average values from TestStat array

F_printTestStat()  : mixed

Returns test stats as HTML table

F_printTestResultStat()  : mixed

Returns test stats as HTML table

F_printUserTestStat()  : mixed

Returns user test stats as HTML table

F_getAllUsersTestStat()  : mixed

Returns users statistic array for the selected test.

F_lockUserTest()  : mixed

Lock the user's test.<br>

F_getTestIDResults()  : string

Returns a comma separated string of test IDs with test_results_to_users enabled

F_getTestIDReports()  : string

Returns a comma separated string of test IDs with test_results_to_users enabled

F_getTestIDs()  : string

Returns a comma separated string of test IDs with test_results_to_users enabled

F_send_user_reg_email()  : mixed

Send a registration verification email to user.

addSlashesArray()  : array<string|int, mixed>|string

Escape strings with backslashes before characters that need to be escaped.