## System Configuration

The System Configuration page allows system administrators to configure site-wide information, features, and settings. The available configuration options and their descriptions are:

### General

Portal Name

  The name of the CWIS site as displayed in the title bar of the browser window and the page header above the navigation bar.

Administrator E-mail

  The e-mail address of the individual responsible for overall site management. Feedback and other administrative mail is directed to this e-mail address.

Legal Notice

  The legal notice displayed at the bottom of each page.

Site Keywords

  A list of keywords that describe the site. The keywords are used by search engines to provide more relevant search results.

About Text

  Intended to hold information that briefly describes the site and its collection. This is the text that is viewable on the About page. HTML is permitted in the about text.

### Features

Announcements

  Determines whether announcements on the front page of the site are enabled. Limited HTML is permitted in announcements to increase visual appeal:

  - anchor/link `<a>`
  - abbreviation `<abbr>`
  - bold `<b>`
  - block quotation `<blockquote>`
  - line break `<br>`
  - table caption `<caption>`
  - title of work `<cite>`
  - computer code `<code>`
  - definition list `<dl>`
  - definition term `<dt>`
  - definition `<dd>`
  - removed text `<del>`
  - generic block container `<div>`
  - emphasized text `<em>`
  - first-level header `<h1>`
  - second-level header `<h2>`
  - third-level header `<h3>`
  - fourth-level header `<h4>`
  - fifth-level header `<h5>`
  - sixth-level header `<h6>`
  - horizontal rule `<hr>`
  - italicized text `<i>`
  - inserted text `<ins>`
  - user input `<kbd>`
  - ordered list `<ol>`
  - unordered list `<ul>`
  - list item `<li>`
  - marked/highlited text `<mark>`
  - paragraph `<p>`
  - preformatted text `<pre>`
  - quote `<q>`
  - irrelevant text/strikethrough `<s>`
  - sample computer output `<samp>`
  - small print `<small>`
  - generic inline container `<span>`
  - text with strong importance `<strong>`
  - subscript `<sub>`
  - superscript `<sup>`
  - table `<table>`
  - table body `<tbody>`
  - table header `<thead>`
  - table footer `<tfoot>`
  - table row `<tr>`
  - table header cell `<th>`
  - table data cell `<td>`
  - date and time `<time>`
  - underlined text `<u>`
  - variable `<var>`

  Only the following attributes may be used with the tags above:

  - link destination (unsafe protocols are stripped) `href`
  - identifier `id`
  - table summary `summary`
Forums

  Determines whether forums can be created and used within the site.

Saved Search Mailings

  Determines whether users can select to be e-mailed periodic results of searches saved on the Advanced Search page. A mailing will only be sent if the user has requested it while saving a new search or editing a saved search. A user's mailings will include resources released in the period prior to the mailing that fit the user's preferences and search criteria.

Resource Ratings

  Determines whether resource ratings are enabled and displayed on the site.

Resource Comments

  Determines whether resource comments are enabled and displayed on the site. Some HTML tags are permitted in comments to increase visual appeal: bold `<b>`, italics `<i>`, underline `<u>`, strike `<s>`, anchor `<a>`, superscript `<sup>`, and subscript `<sub>`.

  Determines whether users can customize the appearance of the site for themselves to make it more accessible. Users are allowed to customize the fonts, colors, content density, and alternatives to various media, depending on their needs or preferences.

Incremental Keyword Search

  Determines whether users see an incremental keyword search, a.k.a. search-as-you-type, interface to interactively show a subset of search results for the current search string when performing a keyword search from the primary search form.

OAI-SQ

  Determines whether the OAI-SQ extension to OAI-PMH is enabled.

### Interface

Announcements On Home Page

  The maximum number of announcements that will be displayed on the home page if announcements are enabled.

Resources On Home Page

  The maximum number of resources that will be displayed in the New Resources section on the home page.

Display Resource Total on Home Page

  Determines whether the total number of publicly-viewable resources is displayed on the home page.

Default Character Encoding

  Determines the character encoding defined in the HTTP and HTML headers for pages on the site. Currently, UTF-8 and ISO-8859-1 are the only options provided. System administrators who intend to use Unicode data in their portals should set this option to UTF-8. UTF-8 should be used in most cases as it makes the site future-proof.

Default User Interface

  Determines the user interface new members and logged-out users will view. Individual users may control this option for themselves through their preferences options if multiple interfaces are allowed by the site administrator. Selecting the Set All Users to This Interface checkbox will set each user's interface setting to the user interface selected.

Allow Multiple User Interfaces

  Determines whether users may use a different user interface when logged in by selecting one in their preferences options. System administrators may select different interfaces even if this function is enabled.

Resource Launches New Window

  Determines whether clicking on a resource title or URL opens a new browser window when loading the resource's full record page. The full record page will open in the same browser window when this option is disabled. Note: launching a new window may interfere with assistive technology devices.

Resource Title Field

  The metadata field used as the title when displaying resources. Only Text fields can be used as the default title field.

Resource Description Field

  The metadata field used as the description field when displaying resources. Only Paragraph fields can be used as the default description field.

Resource URL Field

  The metadata field used as the URL field when displaying resources. Only Url fields can be used as the default URL field.

Resource File Field

  The metadata field used as the file field when displaying resources. Only File fields can be used as the default file field.

Resource Screenshot Field

  The metadata field used as the screenshot field when displaying resources. Only Image fields can be used as the default screenshot field.

Preferred Link Value

  Determines whether the resource URL or file field is used when displaying links for resources. This is only used if both Resource URL Field and Resource Field Field are set.

Titles Link To

  Determines whether to use the resource's full record page or its URL when displaying links containing its title.

Collapse Metadata Field Groups

  Determines whether metadata field groups created on the Metadata Field Ordering page should be collapsed by default when editing a resource.

Require E-mail Address with Feedback

  Determines whether users who are not logged in are required to include an e-mail address when submitting feedback.

### Browsing

Classifications Per Page When Browsing

  The default number of classifications to display on the Browse Resources page before they are split up. System administrators should consider the size of the collection as well as the current state of browser technology as longer numbers of resource entries per page may require lengthy browser load times.

Columns Per Page When Browsing

  The number of columns in which to display the classifications on the Browse Resources page. The value must between 1 and 4, and 2 is the recommended value.

Default Browsing Field

  The default field displayed and used as the default browsing option on the Browse Resources page. This may be set to any tree field present in the metadata schema. While the field specified will be the default browsing option, users may choose to browse by any tree field they have permission to browse.

### Search

Default Search Term Handling

  Determines whether AND or OR logic is used when more than one search term is specified. Resource records that contain all specified search terms will be retrieved when AND is selected. Resource records that have any of the search terms specified will be retrieved when OR is selected, but those that have two or more will be ranked higher.

Display Search Limits By Default

  Determines whether the search limits on the Advanced Search page are displayed or hidden by default.

Default Search Results Per Page

  Determines the default number of search results displayed per page. Users can override this setting from the User Preferences page.

Default Sort Field

  Determines the default field used to sort search results.

### Metrics

AWStats Logging

  Determines whether AWStats logging is performed.

Google Analytics

  Determines whether Google Analytics is used for logging. Logging is only performed when a valid code is set in the Google Analytics Code setting.

Google Analytics Code

  The code to use in conjunction with Google Analytics to peform logging. Please refer to the support pages for Google Analytics for more information on how to obtain one.

### System

Current Logging Level

  Determines the highest level of error messages to record in the site's error log.

Maximum Execution Time

  The maximum amount of time to allow background tasks to execute. The value is in seconds.

Maximum Simultaneous Background Tasks

  The maximum amount of tasks to run in the background per execution cycle.

Template Location Cache Expiration

  The maximum amount of time to allow template file locations to remain cached. Setting this option to 0 will disable template file location caching. The value is in minutes.

Use Minimized JavaScript When Available

  Determines whether CWIS will use a minimized JavaScript file alternative (name.min.js) if found.

Search Engine Update Task Priority

  The priority given to the tasks that run search engine updates for resources.

Recommender Engine Update Task Priority

  The priority given to the tasks that run recommender engine updates for resources.

### Mailing

Mailing Method

  The method used when sending e-mail from the site. Selecting ``PHP mail()`` will use the default e-mail configuration for PHP on the web server. Select ``SMTP`` to configure the site to use SMTP instead.

SMTP Server

  The SMTP server to use when sending e-mail from the site. This setting is only available when ``SMTP`` is selected for the Mailing Method setting.

SMTP Port

  The TCP port to use to connect to the SMTP server when sending e-mail from the site. This setting is only available when ``SMTP`` is selected for the Mailing Method setting.

Use Authentication for SMTP

  Determines whether authentication is used to connect to the SMTP server when sending e-mail from the site. This setting is only available when ``SMTP`` is selected for the Mailing Method setting.

SMTP User Name

  The user name used to create an authenticated connection to the SMTP server when sending e-mail from the site. This setting is only available when ``SMTP`` is selected for the Mailing Method setting and Use Authentication for SMTP is enabled.

SMTP Password

  The password used to create an authenticated connection to the SMTP server when sending e-mail from the site. This setting is only available when ``SMTP`` is selected for the Mailing Method setting and Use Authentication for SMTP is enabled.

E-mail Line Ending

  The character sequence used to end lines in e-mail sent from CWIS. This should be set to CR LF in most cases, but some mail transfer agents and servers require a different line ending to properly send e-mail.

Saved Search Mail Template

  The template used for saved search mailings. The Mailer plugin must be installed and enabled in order to create and select a different mail template.

### User Accounts

Default New User Privileges

  Determines the privilege flags that are given to users after they have registered for an account.

Secure Login Forms

  Determines whether secure login forms are enabled, optional, or disabled. Users are given the option of using secure login every time they submit their credentials if ``Optional`` is selected.