KioWare - Kiosk System Software - Documentation

See All User Docs
KioWare Lite   |   Platform: Windows®   |   Version: 6.8.0

Configuration Tool

Browser Tab:

There are numerous configuration settings that are related to the underlying Microsoft IE browser.  Refer to the following screenshot.


Miscellaneous Browser Settings

Disable File Download

If checked, KioWare Lite will block the File Download dialog box that the browser displays if it doesn't recognize the file type.

Display Download Restricted Message

Displays a message to the user when a download has been blocked.

Enable Scrollbars

If checked, then if the application will not fully fit in the main window then KioWare Lite will display vertical or horizontal scrollbars.

Main Window

Disable Moving

If checked, KioWare Lite prevents the application from programmatically moving the main window on the screen.  If both Disable Moving and Disable Resizing are checked, then KioWare Lite will force the application to display in full screen mode.

Disable Resizing

If checked, KioWare Lite prevents the user from resizing the main window on the screen.  If both Disable Moving and Disable Resizing are checked, then KioWare Lite will force the application to display in full screen mode.

Use KioWare User Agent

If checked, KioWare Lite will modify the User Agent property of the browser to include the phrase "KioWare" and the current KioWare Lite version number.

Custom User Agent Tags

Additonal text to be added to the User Agent text.

Browser Emulation Mode

Also called compatibility mode in Internet Explorer 8.  IE 8 added the ability to render pages with strict standards compliance.  This makes some web pages display improperly, so they also provided the ability to toggle modes.

  • Internet Explorer 7:  Renders pages just like IE 7.
  • Internet Explorer 8:  Renders pages like IE 7 unless the page claims to support IE 8.
  • Internet Explorer 8 - Forced:  Renders pages in IE 8 (strict compliance) mode.


Popup Settings

Popups are web pages that display in a new window.  KioWare Lite can be configured to either allow or deny popups.

Refer to the following screenshot.

Disable/Enable Popups

Determines whether popup windows will be displayed.

Max Popups

Determines how many popups any one page can spawn.

Max Popup Depth

Determines how many levels of popups (ie, parent/child generations) are allowed.

Disable Popup Sizing

If checked, prevents the user from resizing popup windows.

Popup Restrictions Messages

Display Popups Disabled Message

If checked, the message defined in Popups Disabled Message will be displayed to the user when they try to navigate to a popup page.  Otherwise, nothing will happen when the user tries to navigate.

Popups Disabled Message

The message to display to the user when they try to navigate to a popup page.

Display Maximum Popups Message

If checked, the message defined in Maximum Popups Message will be displayed when the user has more than three popups (manually configurable - refer to FAQ's on http://www.kioware.com) open at any given time.

Maximum Popups Message

The message to display to the user when the maximum number of popups have been reached.

Display Max Popup Depth Message

If checked, the message defined in Max.  Popup Depth Message will be displayed when more than three generations (manually configurable - refer to FAQ's on http://www.kioware.com) of popups have been spawned (ie, a popup creating a popup, creating a popup, etc) at any given time.

Max.  Popup Depth Message

The message to display when the maximum popup depth has been reached.


Dialog Settings

Changes the font name, style, size and color and background color of all KioWare Lite generated dialog boxes with the exception of phone dialing dialog boxes.

Refer to the following screenshot.

Text Alignment

Specifies whether text should be left, center or right justified.

Change Font

Loads a standard Windows font selection window that enables the font name, style and size to be selected.

Font Color

Loads a standard Windows color picker window that enables the text color to be selected.

Change Background Color

Loads a standard Windows color picker window that enables the background color of the dialog box to be selected.

Dialog Timeout

How long to display all KioWare Lite dialog boxes before closing the dialog box.  If set to zero, the dialog box will not disappear until either the user closes the dialog box, or KioWare Lite enters Attract Screen mode.


User Interface

Refer to the following screenshot.

Enable Context Menus

If enabled, selected Toolbar buttons will be added to the context menu displayed by clicking the mouse right button.

Note: the Exit command is not recommended for most situations.


Edit Toolbar

Loads the tool bar designer.


Error Handling

KioWare Lite can intercept web server errors and redirect to a defined error handling URL.  In addition, KioWare Lite can pass into the error handling script the URL of the script causing the error and the server error code.  This information is passed using a querystring of the form:

?url=<filename>&status_code=<error number>

With the information contained in the querystring, an error handling routine can be created that elegantly recovers from the error, provides a consistent user interface to the user, and perhaps logs the error for follow-up.

Refer to the following screenshot.

An example error handling page.  After clicking the link, right click to save the page.

Redirection

Enable Error Redirection

If checked, upon a web server error KioWare Lite will redirect to the URL stored in Redirection URL.

Send Error Parameters in URL

If checked, a querystring will be passed to the Redirection URL with the filename of the script that caused the error and the server error code.

Enable Frame Navigation

If checked, the redirection URL can specify a frame within a frameset.  Used only when the application uses frames.

Redirection URL

The URL KioWare Lite will redirect to when a server error is encountered.

Script Errors

Disable Script Error Alerts

If checked, KioWare Lite will not display the IE error dialog box whenever a javascript error has been processed.

Log Script Errors

If checked, KioWare Lite will log the contents of the script error into the Windows Application Event Log.


External Applications

A critical feature of KioWare Lite is the ability to lockdown the browser; however, this can be a challenge because some external apps that can be embedded into web applications can cause security problems.

For example, HTML Mailto tags will cause the default email tool (typically Outlook Express) to load, and a user has the option to save the email to the hard drive – not typically a desirable action.

Another example are ActiveX controls.  Many controls, such as Macromedia's Flash player, support a right mouse click to popup a context menu that typically has file save or print capability that can enable a user to save a file to the hard drive – again, not typically a desirable action.

KioWare Lite has the ability to lockout these security problems.

Refer to the following screenshot.

Mailto: Handling

Mailto: Enabled

If checked, HTML Mailto tags will be ignored

Display Mailto: Disabled Message

If checked will display the message defined in Mailto: Disabled Message when a user clicks an HTML Mailto: tag.

Mailto: Disabled Message

Message to display when a user clicks an HTML Mailto: tag when Mailto: Disabled is enabled.

Disable App Left Clicks

Acrobat Reader

NOTE: Only valid for Reader 7 and below.  In version 8 you can simply open a document in IE and remove/add buttons to and from the Reader toolbars by right clicking on the toolbar.

If checked, Acrobat Reader left clicks will be ignored.

Outlook Web Access

If checked, Outlook Web Access left clicks will be ignored.

Disable App Right Clicks

All Apps

If checked, all right mouse clicks will be ignored, including KioWare Lite specific context menu items.

Acrobat Reader

If checked, Acrobat Reader right clicks will be ignored.

Flash

If checked, Flash right clicks will be ignored.


KioWare .NET Addins

KioWare .NET Addins provide a way for programmers to write custom features and/or perform whatever action they want.  They also provide a way for users to obtain custom written .NET addins to add functionality to KioWare Lite that was not originally there.

Also see KioWare .NET Addins Programming

This dialog allows you to add, edit and remove .NET addin libraries (.dll files).

Clicking Add New will bring up another dialog.

The first textbox allows you to manually enter the full path to the .dll file that you want to use for the addin.  Alternatively, clicking the button to the right will allow you to pick the file.

Once the file has been chosen, the second textbox will be populated with every public class found in the addin so that you can pick the proper one according to what the custom addin documentation says.

Once the proper class is chosen you may be able to press the Configure button to configure settings for the addin.  This dialog is written by the addin writer so it will look different depending upon the addin and may not even be there.