Configuring

From Sit
Jump to: navigation, search
Config page
Warning.png The information in this article (or section) relates to SiT! v3.45 and later. Earlier versions may not have this functionality.

From v3.45 onwards, you can configure all settings (except basic connection settings) by logging into SiT with admin permissions and selecting SiT!


Contents

Config Settings

The SiT! Configuration page presents four main tabs, each with a number of sub-pages of config variables. Each variable affects the way SiT! behaves, everything from the application name to the system timezone.

Application

This tab controls the main SiT application behaviour, important things like the name of the application as displayed in the the title bar and the theme to use.

General

  • Application Name - The full name of this application. This is displayed at the top of each page and various other places throughout the web interface.
  • Short Application Name - A short (abbreviated) version of the application name. This is used to refer to this application where space is at a premium.
  • URI Prefix - The URI prefix to use when referring to this application (in emails etc.) e.g. http://{$_SERVER['HTTP_HOST']}
  • Logout URL - The URL to redirect the user to after he/she logs out. When left blank this defaults to the SiT login page.
  • Load Plugins - Comma separated list of plugins to load. e.g. magic_plugin,lookup_plugin

Theme

  • Default Theme - The theme/interface style that be given to new user accounts, also used for the login page
  • Default CSS file - A URL pointing to the CSS file to use when no other is configured. You should not normally need to change this.
  • Default Gravatar - One of 'wavatar', 'identicon', 'monsterid', a URL to an image, or blank (for a blue G icon). See www.gravatar.com to learn about gravatars
  • Tag Icons - You can specify icons to display next to certain tags, enter tag/icon associations one per line, format: tag=>icon

LDAP

See Configuring LDAP.

Other

  • Debug Mode - Set to TRUE to output extra debug information, some as HTML comments and some in the page footer, FALSE to disable
  • Path to an error log file - The filesystem path and filename of a file that already exist and is writable to log error messages into. Enable Debug Mode to see more verbose messages in this file.
  • Support Manager- The person who is in charge of your support service. Used in email templates etc.
  • Tasks Enabled - Set to TRUE to enable the tasks feature, or FALSE to disable
  • Timesheets Enabled - Experimental Feature. Set to TRUE to enable, or FALSE to disable
  • Demo Mode - Set to TRUE to run in demo mode, some features are disabled or replaced with mock-ups
  • Bug tracker URL - The URL of a web page to report bugs with SiT! We recommend you don't alter this setting unless you really need to.
  • Path to the Changelog file - The filesystem path and filename of the SiT! Changelog file, this can be specified relative to the SiT directory.
  • Path to the Credits file - The filesystem path and filename of the SiT! CREDITS file, this can be specified relative to the SiT directory.
  • Path to the License file
  • Session Name - The session name for use in cookies and URLs, Must contain alphanumeric characters only
  • The maximum file upload size (in bytes)
  • Default role id - Role given to new users by default
  • Enable trusted server mode - At SiT v3.45 the only affect of this setting is to disable the change password option in the user profile page.

Email

Inbound

See Inbound Email.

Outbound

See Outbound Email.

Features

Incidents

  • Auto-assign incidents - Incidents are automatically assigned based on a lottery weighted towards who are less busy, assumes everyone set to accepting is an engineer and willing to take incidents
  • Number of free (site) support incidents that can be logged to a site
  • Hide closed incidents older than - Incidents closed more than this number of days ago aren't show in the Incident Queue, -1 means disabled
  • Incident Pool options - Comma seperated list specifying the numbers of incidents to assign to contracts
  • Preferred SLA for new incidents - A comma separated list of SLA's to indicate order of preference when logging incidents against them e.g. 'standard,high'
  • Record Lock Delay - The period to wait before automatically unlocking records that have been locked by a user (e.g. Incoming email)

Portal

  • Enable user portal
  • Portal/Public Knowledge base - Public puts a link on the login page, Private makes it available on login for contacts
  • Show site incidents in portal - Users in the portal can view site incidents based on the contract options
  • Allow portal users to change usernames
  • Portal can create Incidents? - When set to TRUE portal users can create incidents directly, when set to FALSE incidents appear in the holding queue
  • Portal interface style - Theme to use for portal users

FTP

Removed in 3.90

  • FTP hostname - The hostname or IP address of the FTP server to connect to
  • FTP username
  • FTP password
  • FTP passive mode - Set to TRUE to enable FTP Passive (PASV) mode or FALSE to disable
  • FTP Path - The path to the directory where we store files on the ftp server (e.g. /pub/support/) the trailing slash is important

Knowledge Base

  • Knowledge base Enabled - Set to TRUE to enable the Knowledge Base or FALSE to disable it
  • Knowledgebase disclaimer - A disclaimer message to be displayed at the bottom of every knowledge base article. Simple HTML is allowed
  • Knowledgebase ID prefix - Inserted before the ID to give it uniqueness

Service Levels

See also Service Levels

  • Default Service Level - The service level to use in case the contact does not specify
  • Start of the working day - The number of seconds since midnight that indicate the start of the working day. (e.g. 32400 = 9am)
  • End of the working day - The number of seconds since midnight that indicate the end of the working day. (e.g. 61200 = 5pm)
  • Critical Threshold - Flag items as critical when they are this percentage complete.
  • Urgent Threshold - Flag items as urgent when they are this percentage complete.
  • Notice Threshold- Flag items as notice when they are this percentage complete.
  • Regular contact period - The number of days to elapse before users are prompted to contact the customer (can be overridden by the SLA)
  • Working Days - Comma separated list of working days (Where 0 = Sun, 1 = Mon... 6 = Sat)

Holidays

  • Holidays Enabled - Set to TRUE to enable Holidays or set to FALSE to disable
  • Default Holiday Entitlement - The default holiday entitlement for new users and new holiday periods (in days)

Feedback

  • Feedback Enabled - Set to TRUE to enable Feedback, or FALSE to disable it
  • Feedback Form - The ID number of the feedback form to use. Leave blank disable sending feedback forms
  • Max Score - The maximum score to use in rating fields for feedback forms
  • No-Feedback Contracts - A comma separated list of contract ID's where feedback is not to be requested e.g. '123,765' would withhold feedback requests for contract 123 and 765

System

Paths

  • Web Path - The path to SiT! from the browsers perspective with a trailing slash. e.g. /sit/
  • Path to an access log file - The filesystem path and filename of a file that already exist and is writable to log authentication messages into.
  • Attachment Filesystem Path - The full absolute file system path to a directory to store attachments in (with a trailing slash). This directory should be writable
  • Attachment Web Path - The path to the attachments directory from the browsers perspective with a trailing slash. e.g. /sit/

Locale

  • The default country in capitals. e.g. 'UNITED KINGDOM'
  • System Time Zone - Set this to match the timezone that your server running SiT! is configured to use. Note that SiT! required PHP >= 5.1 for timezone support
  • Date and Time format - See http://www.php.net/manual/en/function.date.php for help with date formats
  • Normal date format
  • Date and Time format to use for files
  • Long date format
  • Short date format
  • Short time format
  • Normal time format
  • Default Language - The system language, or the language that will be used when no other language is selected by the user, see Translation for an up to date list of supported languages.
  • Languages Available - The languages available for users to select at login or in their profile.

Journal

  • Journal Logging Level - What to log in the Journal 0 = none, 1 = minimal, 2 = normal, 3 = full, 4 = maximum/debug
  • Journal Purge Delay - How long should we keep journal entries (in seconds), entries older than this will be purged (deleted)


Plugins

Warning.png The information in this article (or section) relates to SiT! v3.60 and later. Earlier versions may not have this functionality.

If your plugin supports it, you can configure your active plugins from here. See the individual plugin documentation for more help with settings. See here for help with developing a plugin to use this feature.

Config file

From v3.45 onwards the config file config.inc.php is only used to store basic connection and path settings, all other settings are stored in the database and configured via the SiT! | Control Panel | Configure interface.

See Also

Personal tools
project