tce_functions_test_stats.php

tce_functions_test_stats.php source file reference

Package: com\tecnick\tcexam\shared

Tags

  • file: Statistical functions for test results.
  • author: Nicola Asuni
  • since: 2004-06-10

Functions

F_getUserTestStat()

File: tce_functions_test_stats.php line 31

F_getUserTestStat(mixed $test_id[, mixed $user_id = 0 ][, mixed $testuser_id = 0 ][, mixed $pubmode = false ]) : mixed

Parameters

  • $test_id : mixed: (int) test ID.
  • $user_id : mixed = 0: (int) user ID - if greater than zero, filter stats for the specified user.
  • $testuser_id : mixed = 0: (int) test-user ID - if greater than zero, filter stats for the specified test-user.
  • $pubmode : mixed = false: (boolean) If true filter the results for the public interface. return $data array containing test-user statistics.

F_getUserTestTotals()

File: tce_functions_test_stats.php line 52

F_getUserTestTotals(mixed $test_id[, mixed $user_id = 0 ][, mixed $testuser_id = 0 ][, mixed $pubmode = false ]) : mixed

Parameters

  • $test_id : mixed: (int) test ID.
  • $user_id : mixed = 0: (int) user ID - if greater than zero, filter stats for the specified user.
  • $testuser_id : mixed = 0: (int) test-user ID - if greater than zero, filter stats for the specified test-user.
  • $pubmode : mixed = false: (boolean) If true filter the results for the public interface. return $data array containing test-user statistics.

F_getTestStat()

File: tce_functions_test_stats.php line 119

F_getTestStat(mixed $test_id[, mixed $group_id = 0 ][, mixed $user_id = 0 ][, mixed $startdate = 0 ][, mixed $enddate = 0 ][, mixed $testuser_id = 0 ][, mixed $pubmode = false ]) : mixed

Parameters

  • $test_id : mixed: (int) test ID.
  • $group_id : mixed = 0: (int) group ID - if greater than zero, filter stats for the specified user group.
  • $user_id : mixed = 0: (int) user ID - if greater than zero, filter stats for the specified user.
  • $startdate : mixed = 0: (int) start date ID - if greater than zero, filter stats for the specified starting date
  • $enddate : mixed = 0: (int) end date ID - if greater than zero, filter stats for the specified ending date
  • $testuser_id : mixed = 0: (int) test-user ID - if greater than zero, filter stats for the specified test-user.
  • $pubmode : mixed = false: (boolean) If true filter the results for the public interface. return $data array containing test statistics.

F_getRawTestStat()

File: tce_functions_test_stats.php line 148

F_getRawTestStat(mixed $test_id[, mixed $group_id = 0 ][, mixed $user_id = 0 ][, mixed $startdate = 0 ][, mixed $enddate = 0 ][, mixed $testuser_id = 0 ][, mixed $data = [] ][, mixed $pubmode = false ]) : mixed

Parameters

  • $test_id : mixed: (int) test ID.
  • $group_id : mixed = 0: (int) group ID - if greater than zero, filter stats for the specified user group.
  • $user_id : mixed = 0: (int) user ID - if greater than zero, filter stats for the specified user.
  • $startdate : mixed = 0: (int) start date ID - if greater than zero, filter stats for the specified starting date
  • $enddate : mixed = 0: (int) end date ID - if greater than zero, filter stats for the specified ending date
  • $testuser_id : mixed = 0: (int) test-user ID - if greater than zero, filter stats for the specified test-user.
  • $data : mixed = []: (array) Array of existing data to be merged with the current one.
  • $pubmode : mixed = false: (boolean) If true filter the results for the public interface. return $data array containing test statistics.

F_normalizeTestStatAverages()

File: tce_functions_test_stats.php line 682

F_normalizeTestStatAverages(mixed $data) : mixed

Parameters

  • $data : mixed: (array) Raw data array. return $data (array) Processed array.

F_printTestStat()

File: tce_functions_test_stats.php line 798

F_printTestStat(mixed $test_id[, mixed $group_id = 0 ][, mixed $user_id = 0 ][, mixed $startdate = 0 ][, mixed $enddate = 0 ][, mixed $testuser_id = 0 ][, mixed $ts = [] ][, mixed $display_mode = 2 ][, mixed $pubmode = false ]) : mixed

Parameters

  • $test_id : mixed: (int) test ID.
  • $group_id : mixed = 0: (int) group ID - if greater than zero, filter stats for the specified user group.
  • $user_id : mixed = 0: (int) user ID - if greater than zero, filter stats for the specified user.
  • $startdate : mixed = 0: (int) start date ID - if greater than zero, filter stats for the specified starting date
  • $enddate : mixed = 0: (int) end date ID - if greater than zero, filter stats for the specified ending date
  • $testuser_id : mixed = 0: (int) test-user ID - if greater than zero, filter stats for the specified test-user.
  • $ts : mixed = []: (array) array of stats to print (leave empty to automatically generate new data).
  • $display_mode : mixed = 2: display (int) mode: 0 = disabled; 1 = minimum; 2 = module; 3 = subject; 4 = question; 5 = answer.
  • $pubmode : mixed = false: (boolean) If true filter the results for the public interface. return $data string containing HTML table.

F_printTestResultStat()

File: tce_functions_test_stats.php line 1262

F_printTestResultStat(mixed $data, mixed $nextorderdir, mixed $order_field, mixed $filter[, mixed $pubmode = false ][, mixed $stats = 1 ]) : mixed

Parameters

  • $data : mixed: (array) Array containing test statistics.
  • $nextorderdir : mixed: (int) next order direction.
  • $order_field : mixed: (string) order fields.
  • $filter : mixed: (string) filter string for URLs.
  • $pubmode : mixed = false: (boolean) If true filter the results for the public interface.
  • $stats : mixed = 1: (int) 2 = full stats; 1 = user stats; 0 = disabled stats; return HTML table string.

F_printUserTestStat()

File: tce_functions_test_stats.php line 1624

F_printUserTestStat(mixed $testuser_id) : mixed

Parameters

  • $testuser_id : mixed: (int) test-user ID - if greater than zero, filter stats for the specified test-user. return $data string containing HTML table.

F_getAllUsersTestStat()

File: tce_functions_test_stats.php line 1829

F_getAllUsersTestStat(mixed $test_id[, mixed $group_id = 0 ][, mixed $user_id = 0 ][, mixed $startdate = 0 ][, mixed $enddate = 0 ][, mixed $full_order_field = 'total_score' ][, mixed $pubmode = false ][, mixed $stats = 2 ]) : mixed

Parameters

  • $test_id : mixed: (int) test ID.
  • $group_id : mixed = 0: (int) group ID - if greater than zero, filter stats for the specified user group.
  • $user_id : mixed = 0: (int) user ID - if greater than zero, filter stats for the specified user.
  • $startdate : mixed = 0: (string) start date ID - if greater than zero, filter stats for the specified starting date
  • $enddate : mixed = 0: (string) end date ID - if greater than zero, filter stats for the specified ending date
  • $full_order_field : mixed = ’total_score’: (string) Ordering fields for SQL query.
  • $pubmode : mixed = false: (boolean) If true filter the results for the public interface.
  • $stats : mixed = 2: (int) 2 = full stats; 1 = user stats; 0 = disabled stats; return $data array containing test statistics.

F_getSafeUsersTestStatOrderBy()

File: tce_functions_test_stats.php line 2071

F_getSafeUsersTestStatOrderBy(mixed $full_order_field) : string

Parameters

  • $full_order_field : mixed: Raw ORDER BY input.

Return values

string

F_lockUserTest()

File: tce_functions_test_stats.php line 2116

F_lockUserTest(mixed $test_id, mixed $user_id) : mixed

Parameters

  • $test_id : mixed: (int) test ID
  • $user_id : mixed: (int) user ID

F_getTestIDResults()

File: tce_functions_test_stats.php line 2144

F_getTestIDResults(mixed $test_id, mixed $user_id) : string

Parameters

  • $test_id : mixed: (int) Test ID.
  • $user_id : mixed

Return values

string

F_getTestIDReports()

File: tce_functions_test_stats.php line 2154

F_getTestIDReports(mixed $test_id, mixed $user_id) : string

Parameters

  • $test_id : mixed: (int) Test ID.
  • $user_id : mixed

Return values

string

F_getTestIDs()

File: tce_functions_test_stats.php line 2164

F_getTestIDs(mixed $test_id, mixed $user_id[, mixed $filter = 'test_results_to_users' ]) : string

Parameters

  • $test_id : mixed: (int) Test ID.
  • $user_id : mixed
  • $filter : mixed = ’test_results_to_users’

Return values

string