Home > Basic > Start Page & Browser > Advanced Options

Advanced Options

The advanced options described here refer mostly to settings that will apply to all skins rather than only one individual skin.

For performance reasons, you may not want to use the skin technology for new browser windows. To disable it, open your SiteKiosk configuration file in an editor and look for <skin-browserwindows>true</skin-browserwindows>. Change this entry to false. You should, however, refrain from making this change unless is is absolutely necessary.

1. Global display options
1.1 Maximize new browser windows by default
Check this option if you would like new browser windows to be maximized. Note that this option cannot be applied to windows whose size is defined by a script as SiteKiosk will adhere to the specified size in this case.
1.2 Display SiteKiosk splash screen on startup
On every start of SiteKiosk, a splash screen will pop up for few seconds, providing information on the currently installed version of SiteKiosk as well as the name under which the software was registered. This option allows you to prevent the splash screen from being displayed.
1.3 Display taskbar (lower edge of the screen)
The taskbar can be used for switching back and forth between different applications. This option turns the taskbar (window bar) in the SiteKiosk browser on or off.
1.4 Enable context menu (brought up by a right mouse button click)
Due to the large number of commands available from Internet Explorer's context menu, we developed an individual context menu for SiteKiosk. Unless you want to enable this context menu, turn off this checkbox.
1.5 Enable popup blocking (requires at least Windows XP Service Pack 2)
This option will prevent popups from being displayed. This feature requires, however, that your system run at least WindowsXP including Service Pack 2.
1.6 Keep the SiteKiosk main window in the background
Enabling this option will cause SiteKiosk to act like the Windows desktop and will result in other windows staying in the foreground even when you click in the main window.
1.7 Logout after the last browser window was closed
This option triggers a logout if the last browser window, excluding the main window of SiteKiosk, was closed.
1.8 Show SiteKiosk navigation error pages
By deactivating this option the internal navigation error pages are replaced by a standard error page. The deactivation of the internal error handling can be helpful if the first response of a web server is an error message followed by the actual content.


2. Maximum number of additionally opened browser windows
You can set the maximum number of browser windows you want to allow to be displayed. Unless you want to allow more windows than just the main browser window, select NONE.

Caution:
If the main window opens a new content window (e.g. by script), the content will be displayed in the main window. This means, with regard to "onload" scripts, that the main page may not appear or it may only be displayed for a short period of time.


3.Set default zoom property
Use this option to start the SiteKiosk browser with a specific web site zoom level.


4. Offline Start Page
You can select an alternative offline start page if your primary start page is not a local file (file protocol). If the primary start page can't be accessed from the Internet, the alternative local start page will be used instead. This helps prevent that only the default navigation error page will be displayed in case of an error.


5. Computer identification
5.1 Add SiteKiosk to user agent
This option is used to add SiteKiosk at the end of the browser user agent list. This addition allows a Web server to determine whether it is being accessed by a SiteKiosk browser and supply code that is adjusted accordingly, e.g. the SiteKiosk Object Model. Please be aware of restrictions when using the compatibility view settings described here (paragraph 7).
5.2 Adjust additional field in user agent
If a browser (client) goes to a Web server (website), this movement will be recorded in the server log files. One of these logs is the user agent, which, in the case of IE 11 may look somewhat like this:
Mozilla/5.0 (Windows NT 6.1; WOW64; Trident/7.0; rv:11.0)

Provided you operate your own Internet server, this option allows you to track when and how often a certain SiteKiosk client visited your Web server based on the server statistics.

Another way to use this option is to identify the machine and execute code on the Web server that is specifically designed to run on this server, e.g. the SiteKiosk Object Model.

Turn on this checkbox if you want the computer's name (represented by the variable $ComputerName) to be automatically attached to the user agent (provided you have not defined anything different):
Mozilla/5.0 (Windows NT 6.1; WOW64; Trident/7.0; rv:11.0; SiteKiosk 9.1 Build 3345; computer name)


6. Execute script file
This option allows you to run a .js (JavaScript) or .vbs (Visual Basic Script) script file in addition to SiteKiosk.

Benefit: The specified script will be executed on every start of SiteKiosk regardless of the skin you selected.

Note that when using the SiteKiosk Object Model in external scripts, the call of window.external.InitScriptInterface() needs to be omitted.

See also

SiteCaster
Language Selection
Start Page
Digital Signage
Full Screen Mode


Back to top