Page Comparison

This is located in the config subdirectory.

...

If a new configuration option is to be enabled by default then it should be added to the install script, and to an upgrade script for users upgrading an existing instance.

...

.

...

Any new configuration items should be placed in the new config table (unless there is a specific reason it should remain placed in the config file). These items are accessible via the config screen in the administration section of Rogo.

Config items should be added via the install and update scripts using the Config→set_setting function.

Config items can be asked via the Config→get_setting function.

Current Config File Options

...

Current Config File Options (as of 6.5.0)

$cfg_tmpdir (String):: The Name of the University/OrganisationTemp directory for the system

$cfg_academicrogo_year_start data (String):: The Month/Day when the academic year changes. In the example below the academic year will change on July 1st. The system will use the current year from the system clock, thus: a) 01/05/2013 = academic session 2012/13, b) 01/07/2013 = academic session 2013/13 Since Rogo 6.1.0 Stores the location that user data directories will be stored in. The path should use the local file system separator (in the case of Windows it will need to be properly escaped).  The setting should have a trailing shash.

 $cfg_rogo_data = '07/01/var/www/rogodata/';

$cfg_tmpdir (String):: The Temp directory for the system

...

 $cfg_rogo_data = 'c:\\rogodata\\';

$cfg_db_username (String):: Since Rogo 6.1.0 Stores the location that user data directories will be stored in. The path should use the local file system separator (in the case of Windows it will need to be properly escaped).  The setting should have a trailing shash.

 $cfg_rogo_data = '/var/www/rogodata/';

 $cfg_rogo_data = 'c:\\rogodata\\';

$cfg_summative_mgmt (Bool):: If Central Summative Exam Administration is enabled.

• true enables this.

$cfg_client_lookup (String):: How machines are evaluated for summative exam access. Either

• 'ipaddress' use the machines ip address
• 'name' looksup the name of the machine from its ip address (useful in dynamic environments)

$cfg_db_username This is the db (MySQL) username that is initially used for authentication (after authentication the system will switch the db to a specific user for each userrole)

$cfg_db_passwd (String):: This is the db (MySQL) password that goes with $cfg_db_username username

$cfg_db_database (String):: The name of the MySQL database.

$cfg_db_host (String):: The name of the MySQL host server.

$cfg_db_port (Integer):: The port number of the MySQL database.

$cfg_db_charset (String):: The character set that is used on the MySQL database.

$cfg_db_charset = 'utf8';

$cfg_db_student_user (String):: This is the db (MySQL) username that is initially used for authentication (after authentication the system will switch the db to a specific user for each userrole)switched to for the student user.

$cfg_db_student_passwd (String):: This is the db (MySQL) password that goes with $cfg_db_student_user username username.

$cfg_db_staff_database user (String):: The name of the MySQL databaseThis is the db (MySQL) username that is switched to for the staff user.

$cfg_db_host staff_passwd (String):: The name of the MySQL host server.

$cfg_db_port (Integer):: The port number of the MySQL database.

$cfg_db_charset (String):: The character set that is used on the MySQL database.

...

...

This is the db (MySQL) password that goes with $cfg_db_staff_user username.

$cfg_db_studentexternal_user (String):: This is the db (MySQL) username that is switched to for the student external review user.

$cfg_db_studentexternal_passwd (String):: This is the db (MySQL) password that goes with $cfg_db_studentexternal_user username.

$cfg_db_staffsysadmin_user (String):: This is the db (MySQL) username that is switched to for the staff sysadmin user.

$cfg_db_staffsysadmin_passwd (String):: This is the db (MySQL) password that goes with $cfg_db_staffsysadmin_user username.

$cfg_db_externalsct_user (String):: This is the db (MySQL) username that is switched to for the external review Script Concordance Test Expert user.

$cfg_db_externalsct_passwd (String):: This is the db (MySQL) password that goes with $cfg_db_externalsct_user username.

$cfg_db_sysadmininv_user (String):: This is the db (MySQL) username that is switched to for the sysadmin invigilator user.

$cfg_db_sysadmininv_passwd (String):: This is the db (MySQL) password that goes with $cfg_db_sysadmininv_user username.

$cfg_dbshort_sct_user date (String): : This is the db (MySQL) username that is switched to for the Script Concordance Test Expert user.

$cfg_db_sct_passwd (String):: This is the db (MySQL) password that goes with $cfg_db_sct_user username.

$cfg_db_inv_user the MYSQL_DATE_FORMAT that is used for display of short date only.

$cfg_short_date = '%d/%m/%y';

$cfg_long_date_time (String):: This is the db (MySQL) username that is switched to for the invigilator user.$cfg_db_inv_passwd the MYSQL_DATE_FORMAT that is used for display of date & time.

$cfg_long_date_time = '%d/%m/%Y %H:%i';

$cfg_long_date_php = (String):: This is the db (MySQL) password that goes with $cfg_db_inv_user username.$cfg_short_date (String): the MYSQL_DATE_FORMAT that is used for display of short date onlythe PHP display format for the long date.

$cfg_shortlong_date_php = '%dd/%mm/%yY';

$cfg_longshort_date_time php (String):: the MYSQL_DATE_FORMAT that is used for display of date & timePHP display format for the short date.

$cfg_longshort_date_timephp = '%dd/%m/%Y %H:%im/y';

$cfg_long_datetime_php = php (String):: the PHP display format for the long dateMYSQL_DATE_FORMAT that is used for display of long date & time.

$cfg_long_datetime_php = 'd/m/YH:i:s';

$cfg_short_datetime_php (String):: the PHP display format for the short dateMYSQL_DATE_FORMAT that is used for display of short datae & time.

$cfg_short_datetime_php = 'd/m/yH:i';

$cfg_long_time_php timezone (String):: the MYSQL_DATE_FORMAT that is used for display of long date & timetimezone that the machine is in (force).

$cfg_long_time_phptimezone = 'H:i:sEurope/London';

$cfg_shorttablesorter_timedate_php time (String):: the MYSQL_DATE_FORMAT that is used for display of short datae & timetimezone used by the jquery tablesorter library (should match above time zones) - ROGO 6.0.

$cfg_tablesorter_shortdate_time_php = 'H:i'uk';

$cfg_cron_timezone user (String):: the timezone that the machine is in (force).

$cfg_timezone = 'Europe/London';

$cfg_tablesorter_date_time (String):: the timezone used by the jquery tablesorter library (should match above time zones) Cron user (used by the system to run automated scripts - ROGO 6.0.

$cfg_cron_passwd (String):: Cron user password- ROGO 6.0.

$cfg_tablesorter_date_time = 'uk';

$cfg_cron_user (String):: Cron user (used by the system to run automated scripts - ROGO 6.0.

$cfg_cron_passwd (String):: Cron user password- ROGO 6.0.

$cfg_sms_api (String):: Configure the sms api.

$cfg_sms_url (String):: base url of the student management system.- ROGO 6.1.0

$cfg_lti_allow_module_self_reg (Bool):: if via lti and using standard integration allows auto adding of students onto self registration module.

• false disables this behaviour.

$cfg_lti_allow_staff_module_register (Bool):: if via lti and using standard integration allows auto adding of staff onto module.

$cfg_lti_allow_module_create (Bool):: if via lti and using standard integration allows auto creation of module.

$authentication_fields_required_to_create_user (Array):: This is an array of the required fields that the authentication stack requires before it will create a user.

...

...

$cfg_sms_api (String):: Configure the sms api.

$authentication_fields_required_to_create_user (Array):: This is an array of the required fields that the authentication stack requires before it will create a user.

$authentication_fields_required_to_create_user = array('username', 'title', 'firstname', 'surname', 'email', 'role');

$lookup (Array):: This is the configuration array for the Lookup Stack and lets you select which plugins are loaded and the configuration for each plugin. For plugin config options see Lookup Plugin Config. Each element of the outer array is another array with the first parameter being the name of the plugin (String) then an array of configuration options, followed by a description (String).

$lookup = array(
  array('ldap', array('ldap_server' => 'iLDAP.x.ac.uk', 'ldap_search_dn' => 'OU=xx,DC=xx,DC=xx,DC=ac,DC=uk', 'ldap_bind_rdn' => 'UserName', 
'ldap_bind_password' => 'PassWd', 'ldap_user_prefix' => 'sAMAccountName=', 'ldap_attributes' => array('sAMAccountName' => 'username', 'sn' => 'surname', 'emailtitle', 'role');

$lookup (Array):: This is the configuration array for the Lookup Stack and lets you select which plugins are loaded and the configuration for each plugin. For plugin config options see Lookup Plugin Config. Each element of the outer array is another array with the first parameter being the name of the plugin (String) then an array of configuration options, followed by a description (String).

$lookup = array(
  array('ldap', array('ldap_server' => 'iLDAP.x.ac.uk', 'ldap_search_dn' => 'OU=xx,DC=xx,DC=xx,DC=ac,DC=uk', 'ldap_bind_rdn' => 'UserName', 
'ldap_bind_password' => 'PassWd', 'ldap_user_prefix' => 'sAMAccountName=', 'ldap_attributes' => array('sAMAccountName' => 'username', 'sn' => 'surname', 'title' => 'title', 
'givenName' => 'firstname', 'department' => 'school', 'xx' => 'email', 'xx' => 'email', 'mail' => 'email', 'UonStuID' => 'studentID', 
'UoNStaffID' => 'staffID', 'cn' => 'username', 'UoNPosition' => 'role', 'employeeType' => 'role', 'UoNUPSStatus' => 'role', 'initials' => 'initials'), 'lowercasecompare' => TRUE, 
'storeprepend' => 'ldap_'), 'LDAP'),
  array('XML', array('baseurl' => 'http://exports/', 'userlookup' => array( 'url' => '/student.ashx?campus=uk', 'mandatoryurlfields' => array('username'), 
'urlfields' => array('username' => 'username'), 'xmlfields' => array('StudentID' => 'studentID', 'Title' => 'title', 'Forename' => 'firstname', 'Surname' => 'surname', 
'Email' => 'email', 'Gender' => 'gender', 'YearofStudy' => 'yearofstudy', 'School' => 'school', 'Degree' => 'degree', 'CourseCode' => 'coursecode', 'CourseTitle' => 'coursetitle', 
'AttendStatus' => 'attendstatus'), 'oneitemreturned' => true, 'override' => array('firstname' => true), 'storeprepend' => 'sms_userlookup_')), 'XML')
);

$authentication (Array):: This is the configuration array for the Authentication Stack and lets you select which plugins are loaded and the configuration for each plugin. For plugin config options see Authentication Plugin Config. Each element of the outer array is another array with the first parameter being the name of the plugin (String) then an array of configuration options, followed by a description (String).

$authentication = array(
array('ltilogin', array(), 'LTI Auth'),
array('guestlogin', array(), 'Guest Login'),
array('impersonation', array('separator' => '_'), 'Impersonation'),
array('internaldb', array('table' => 'users', 'username_col' => 'username', 'passwd_col => 'title', 
'givenName' => 'passwordfirstname', 'id_coldepartment' => 'idschool', 'encryptxx' => 'SHA-512email', 'encrypt_saltxx' => 'EncSaltemail'), 'Internal Database'),
array('ldap',array( 'table' mail' => 'usersemail', 'username_colUonStuID' => 'usernamestudentID', 
'id_colUoNStaffID' => 'idstaffID', 'ldap_servercn' => 'iLDAP.nottingham.ac.ukusername', 'ldap_portUoNPosition' => 389'role',  'ldap_search_dnemployeeType' => 'OU=University,DC=intdir,DC=nottingham,DC=ac,DC=ukrole', 'ldap_bind_rdnUoNUPSStatus' => 'UserNamerole', 'ldap_bind_passwordinitials' => 'PassWdinitials'), 'ldap_user_prefixlowercasecompare' => TRUE, 
'storeprepend'sAMAccountName => 'ldap_'), 'LDAP')
);

...

,
  array('

...

XML',

...

$cfg_institutional_domains = array('rji.ac.uk', 'nottingham.ac.uk');

$enhancedcalc_type (String):: The method/system used to mark Calculation questions. Currently there is support for the in-built PHP method 'phpEval' or the more sophisticated 'Rrserve'.

$enhancedcalculation (Array): Array of settings to use with the set type. For phpEval set to an empty array.

$enhancedcalculation = array('host' => '127.0.0.1', 'port'=>6311,'timeout'=>5);

$cfg_js_root (String) (Javascript Code):: The Root path for Javascript

  $cfg_js_root = <<< SCRIPT
<script>
  if (typeof cfgRootPath == 'undefined') {
    var cfgRootPath = '$cfg_root_path';
  }
</script>
SCRIPT;

$cfg_editor_name (String):: The name of the editor

$cfg_editor_javascript (String) (Javascript Code):: Javascript Code to enable the editor

$cfg_editor_javascript = <<< SCRIPT
$cfg_js_root
<script type="text/javascript" src="$cfg_root_path/tools/tinymce/jscripts/tiny_mce/tiny_mce.js"></script>
<script type="text/javascript" src="$cfg_root_path/tools/tinymce/jscripts/tiny_mce/tiny_config.js"></script>
SCRIPT;

$cfg_hour_warning (Integer):: This is related to summative exam and gives a warning on the editing screen if the exam is set before this time

$cfg_autosave_settimeout (Integer):: This is the time in seconds before the autosave will try again.

$cfg_autosave_frequency (Integer):: How often the autosave routine runs in seconds.

$cfg_autosave_retrylimit (Integer):: How many times the auto fails or timesout before reporting a save failed.

$cfg_autosave_backoff_factor (Decimal):: The backoff amount on each failure. each retry is lenghtend to $cfg_autosave_settimeout + ($cfg_autosave_backoff_factor * $cfg_autosave_settimeout * retryCount);

$support_email (String):: The support email that is displayed.

$emergency_support_numbers (Array):: An array of the support contact as the key and the telephone number as the value

$emergency_support_numbers = array('Primary Rogo OSS Support '=>'111111', 'Secondary Rogo OSS Support '=>'222222');

$dbclass (String):: The class the db uses. This is for debugging as the mysqli class can be overloaded with debug functions.

$display_auth_debug (Bool):: Display extra debug on the authentication screen so you can see why login attempts failed etc.

$cfg_setting_icons_order (Array):: Allows system admin to customise the order/number of the admin screen items - ROGO 6.0.4

$cfg_setting_icons_order = array('calendar','modules','schools','courses');

$cfg_oauth_access_lifetime (Integer):: Since Rogo 6.1.0 Stores in seconds the lifetime of an oauth access token.

$cfg_oauth_refresh_token_lifetime (Integer):: Since Rogo 6.1.0 Stores in seconds the lifetime of an oauth refresh token.

$cfg_oauth_always_issue_new_refresh_token (Bool):: Since Rogo 6.1.0 Enables or disables the oauth refresh token.

$cfg_enable_api (Bool):: Since Rogo 6.1.0 Enables or disables API functionality.

$cfg_enable_gradebook (Bool):: Since Rogo 6.1.0 Enables or disables the gradebook functionality.

...

 array('baseurl' => 'http://exports/', 'userlookup' => array( 'url' => '/student.ashx?campus=uk', 'mandatoryurlfields' => array('username'), 
'urlfields' => array('username' => 'username'), 'xmlfields' => array('StudentID' => 'studentID', 'Title' => 'title', 'Forename' => 'firstname', 'Surname' => 'surname', 
'Email' => 'email', 'Gender' => 'gender', 'YearofStudy' => 'yearofstudy', 'School' => 'school', 'Degree' => 'degree', 'CourseCode' => 'coursecode', 'CourseTitle' => 'coursetitle', 
'AttendStatus' => 'attendstatus'), 'oneitemreturned' => true, 'override' => array('firstname' => true), 'storeprepend' => 'sms_userlookup_')), 'XML')
);

$authentication (Array):: This is the configuration array for the Authentication Stack and lets you select which plugins are loaded and the configuration for each plugin. For plugin config options see Authentication Plugin Config. Each element of the outer array is another array with the first parameter being the name of the plugin (String) then an array of configuration options, followed by a description (String).

$authentication = array(
array('ltilogin', array(), 'LTI Auth'),
array('guestlogin', array(), 'Guest Login'),
array('impersonation', array('separator' => '_'), 'Impersonation'),
array('internaldb', array('table' => 'users', 'username_col' => 'username', 'passwd_col' => 'password', 'id_col' => 'id', 'encrypt' => 'SHA-512', 'encrypt_salt' => 'EncSalt'), 'Internal Database'),
array('ldap',array( 'table' => 'users', 'username_col' => 'username', 'id_col' => 'id', 'ldap_server' => 'iLDAP.nottingham.ac.uk', 'ldap_port' => 389, 
'ldap_search_dn' => 'OU=University,DC=intdir,DC=nottingham,DC=ac,DC=uk', 'ldap_bind_rdn' => 'UserName', 'ldap_bind_password' => 'PassWd', 'ldap_user_prefix' => 'sAMAccountName='),'LDAP')
);

$cfg_js_root (String) (Javascript Code):: The Root path for Javascript

  $cfg_js_root = <<< SCRIPT
<script>
  if (typeof cfgRootPath == 'undefined') {
    var cfgRootPath = '$cfg_root_path';
  }
</script>
SCRIPT;

$dbclass (String):: The class the db uses. This is for debugging as the mysqli class can be overloaded with debug functions.

$display_auth_debug (Bool):: Display extra debug on the authentication screen so you can see why login attempts failed etc.

$cfg_setting_icons_order (Array):: Allows system admin to customise the order/number of the admin screen items - ROGO 6.0.4

$cfg_setting_icons_order = array('calendar','modules','schools','courses');

$cfg_memcache_host(array)::  Since Rogo 6.1.0 Array of hosts for memcache servers (used by admin/healthcheck.php)

...

$displayallerrors(Bool)  Enables or disable logging PHP notice and warning messages

$cfg_install_type(String) Optional string to append to 'Rogo' in browser page title - useful to visually separate different rogo instances i.e. test systems

...

or disable logging PHP notice and warning messages

Related articles