On the Popup Access List Configuration screen (see image above), select any textbox or dropdown menu and make changes. KioWare will automatically save your changes.
“X” icons appear to the right of domain and page entries (see image above). Select any “X” icon to remove a domain or web page. Icons to the far right are for domains, and indented icons are for pages. Note: Removing an entire domain will also remove settings for all pages within that domain.
Selecting this button shows a slider. If set to the “On” position and your web page has both a file input element with an accept type of image/* and the capture attribute set, then KioWare will attempt to use a camera to capture an image for the file input element. When turned on, three tabs show: Camera Options, Windows Text, and Appearance and Colors (see specific sections below for details on each tab).
When the Camera Options tab is selected, the screen looks like this.
When the Windows Text tab is selected, the screen looks like this.
When the Appearance and Colors tab is selected, the screen looks like this.
What is a browser tab? | Just as you can open multiple tabs in a browser such as Google Chrome, in KioWare, you can have multiple tabs within a single browser window. By setting the “Popup Mode” to “Always Open in New Tab” and setting the “Max Popups/Tabs Open”, each new popup (see below) will show in a new browser tab. At the top of the browser window, you will see a line of tab images (that look a bit like file folder tabs). These are your browser tabs. Select a tab to show the content of its popup. Set the “Tab Height” to show these tabs at a specific size (must be at least 35 to be visible and usable). |
Can I customize browser tabs? | Use the “Tab Styles” button to customize your tabs. This lets you set text color, font, color of tab backgrounds, and color of the top tab borders, as well as color gradients (start color transitions to another). You can also customize the image of the “Close” button on tabs. Save your custom image as CloseTab.png and place it in the user data directory (see Configuration Tool, Related Terms and Questions for details on the user data directory). That image will show on all browser tabs. |
KioWare shows a page that says the website attempted to close the browser. | This is the Browser Closed page that shows when a website tries to close the KioWare browser. By default, you will be returned to your start page in 10 seconds (see General Tab, Start Page URL). Select the “Go to Start Page” button to return to your start page now, or choose the “End Session” button to log off and end the user session. The Browser Closed page can also be customized (see below). |
Can I customize the Browser Closed page? | Yes, it is an HTML file that can be customized. See Configuration Tool, Customizing Warning and Other Pages for details on locating and customizing this file. |
KioWare shows a page that says a web page is temporarily down. | This is the Navigation Error page that shows when a website you are trying to access is temporarily down (due to updates being made to the page, server maintenance, web page redirection that failed, etc.). The “Status Code” will show the specific error code (404 Page Not Found, 500 Internal Server Error, etc.), and under “Page Requested”, you will see the URL of the page you tried to access (so you can verify that this is the correct page). By default, KioWare will try to load the web page every 60 seconds. Select the “Go to Start Page” button to return to your start page now, or choose the “Go Back” button to show the prior page. |
Can I customize the Navigation Error page? | Yes, it is an HTML file that can be customized. See Configuration Tool, Customizing Warning and Other Pages for details on locating and customizing this file. |
KioWare shows a page that says the renderer has crashed. | This is the Renderer Crash page that shows when KioWare's browser renderer stops working and cannot show the web page you are trying to access. By default, you will be returned to your start page in 10 seconds (see General Tab, Start Page URL). Select the “Go to Start Page” button to return to your start page now, or choose the “End Session” button to log off and end the user session. The Renderer Crash page can also be customized (see below). |
Can I customize the Renderer Crash page? | Yes, it is an HTML file that can be customized. See Configuration Tool, Customizing Warning and Other Pages for details on locating and customizing this file. |
What is a popup? | It is a smaller window that suddenly appears overtop of your main window. Popups typically contain ads, messages for users, or information about an area of a website that you placed your mouse on. They are generally created by websites. Use the “Page Handling”, “All Pages”, “All Other Pages”, and “Everything Else” settings on the Popup Access List Configuration screen to tell KioWare to allow, block, or flatten (open in the currently displayed tab) popups from specific domains and web pages. The options in the “Popup Mode” dropdown on the main Browser tab can also be used to tell KioWare how to handle all popups or to disable them all. |
Can popups be blocked in KioWare? | Yes, by selecting the “Disabled” option in the “Popup Mode” dropdown. They can also be opened in new browser tabs so they do not interrupt your main window (select the “Always Open in New Tab” option). A popup access list can also be set up for blocking some but not all popups (see below). |
When I set the Popup Mode to “Use Popups and Tabs”, how does KioWare know when to use a popup or a tab? | JavaScript (see below) is used to open popups, and the JavaScript code may or may not tell KioWare what size the popup window should be (typically, it will not). When it does not, KioWare opens a new browser tab. If the JavaScript does indicate a size, then KioWare opens a new window of that size. |
What is a popup access list? | It is a list that tells KioWare which web pages should be allowed to show popups and which web pages should have their popups blocked or flattened (opened in the currently displayed tab) when the KioWare browser is running. Using the “Popup ACL” button, you can block, flatten, or allow popups from all pages in a domain (root of a website, such as kioware.com). Popups from specific pages within a domain (e.g., kioware.com/support.aspx) can also be blocked, flattened, or allowed. Remember that when adding domains, you should not include protocols at the beginning (e.g., “http://” and “https://”). |
I set the max. popups/tabs to 5, so why are 6 showing? | When you set the “Max Popups/Additional Tabs Open” setting to 5, this actually means that you can open 5 popups/tabs in addition to the main browser window or original tab. If you want a maximum of 5 popups/tabs to be allowed, then change the setting to 4. By doing this, the main browser window (or original tab) shows and up to 4 other windows (or tabs) can also show, making a maximum of 5. |
What is a regular expression? | It is a string (sequence of characters) that tells a computer program what patterns to look for (typically when doing searches) and what to do if these patterns are found. The program will then look for patterns that match what is in the string and complete the action the string tells it to. In KioWare's popup access list, domains and web pages set to “REGX” are treated as regular expressions within KioWare. Each domain or web page you attempt to visit in the KioWare browser is compared to those in the popup access list, and when an exact match is found, KioWare will allow or block popups from that domain/web page based on your settings. (See also Security Tab, Related Terms and Questions for details on regular expressions in mime type matching.) |
What is CONTAINS matching? | Unlike matching on a regular expression (see above) where a computer program looks for an exact pattern of characters, CONTAINS matching tells a computer program to check only if certain characters are contained in the items being searched. Though other characters may appear before or after, as long as these certain characters are there, the computer program considers it a match and will complete the action you specify. In KioWare's popup access list, domains and web pages set to “CONT” tell KioWare to do CONTAINS matching. This means that if a domain or web page you try to open in the KioWare browser contains the characters of a domain or web page you entered in the popup access list, KioWare will consider this a match and will allow or block popups from that domain/web page based on your settings. |
How can I change the order of entries in the popup access list? | Select any entry and drag it up or down to reorder. |
What is a script error? | It is an error that occurs because the HTML code for a web page does not work correctly with Microsoft JavaScript (see below). There are various reasons why script errors occur, such as problems with antivirus software, Internet-related folders, video card drivers, or settings for Active scripting, ActiveX controls, or Java programs, but many times the cause is a website's source code. The “Log Script Errors” setting is used to tell KioWare if it should or should not create an Event Log (see below) whenever a script error occurs. |
What is JavaScript? | It is one of the world's most popular programming languages, used in servers, hardware controls, and web applications. Typically, it is used to add animated features, automation of processes, and user interactivity to web pages. JavaScript commands can be used to print from KioWare. The “Disable Javascript Printing” setting is used to tell KioWare if it should block or allow printing via JavaScript. If allowed, the “Print Without Showing Printer-Selection Dialog” setting then tells KioWare if it should show a window for selecting your printer and printer preferences, or print directly without showing it. (For other JavaScript commands that can be used with KioWare, see Scripting.) |
What is an SSL error? | Secure Sockets Layer (SSL) is a type of security software. It runs on both your computer and the computer that is hosting a website you visit. SSL encrypts any data that is passed between your computer and the web site and ensures that a secure connection is made between the two. When the connection is not completely secure, an SSL error appears. The “Ignore SSL Errors” checkbox is used to tell KioWare if it should or should not ignore all SSL errors in its browser. (For details on SSL and telling KioWare to automatically use authentication when importing remote settings files, see General Tab, Remote Authentication Settings, Server SSL Options. For details on SSL errors related to a connection with KioWare Server, see Kiosk Management Tab, Advanced Server Settings, Server SSL Options.) |
I want to connect a server to KioWare. Can SSL be used? | Yes, SSL can be used for both server communication and for content downloads (if using the KioWare Server content updating feature that pushes content from the server to all connected kiosks at once). Remember, you will need to purchase a license of KioWare Server and install it on your server for all this to work. Or, if you do not want the hassles of managing your own server, you can subscribe to the KioCloud, connect your kiosk/computer to it, and let us do all the work for you (for more information on KioWare Server or KioCloud, visit the KioWare website or email KioWare Sales). |
What is pinch zoom? | Pinch zoom is a feature of touchscreens that lets you change the zoom of your screen. Generally, you place your thumb and forefinger on a touchscreen and move them together to zoom out (decrease size) or move them apart to zoom in (increase size). Use the “Disable Pinch Zoom” checkbox to set if users can or cannot use pinch zoom on a touchscreen that is connected to a kiosk/computer running KioWare. |
What is a user agent? | It is a string (sequence of characters) that helps identify which browser is being used, what version, and details about your system such as operating system and version. When you open a web page, your browser sends the user agent to the web server that is hosting this web page. The web server uses this data to show you content that will best suit your browser. (And when your browser is happy, web pages display their best!)  For applications that need to tell the difference between a user running a normal browser and a user running KioWare, the user agent includes “KioWare” along with the KioWare version number. Other identifying text can be added to the user agent by entering it into the “Additional User Agent Data” box. |
I have two kiosks, and I would like to be able to recognize each one separately online. Is there a way to customize the browser user-agent string to help me identify each kiosk? | On each kiosk, install a separate license of KioWare and use the “Additional User Agent Data” box to enter unique identifiers. |
What are Event Logs, and how do I find them? | To help troubleshoot problems with MS Windows or applications running with MS Windows, Event Logs are created. Event Logs can contain informational messages or details about warnings and errors. Windows stores different types of Event Logs, such as for your applications, security, setup, and system. When errors occur with KioWare, only Application Event Logs are created. The “Log Script Errors” and “Log Blocked Matches” settings tell KioWare if it should or should not create Event Logs for script errors and attempts to visit web pages whose popups are blocked. To view Windows Application Event Logs, select the Windows “Start” button, search for and open “Event Viewer”, and select “Windows Logs”, “Application”. (For details on Event Logs and how to show them from KioWare, see Configuration Tool, Related Terms and Questions. For details on Event Logs relating to KioWare Server, see Kiosk Management Tab, Related Terms and Questions.) |
What is geolocation? | It is a wireless method of finding the geographical location of an item, such as a computer or mobile device. With geolocation, digital information that is carried through a wireless Internet network is associated with a geographical location. This digital information can include an IP address of a computer or mobile device, Wi-Fi connection location, or global positioning system (GPS) coordinates. In KioWare, you can set the geolocation feature to use geographical coordinates (latitude, longitude, and even altitude) by selecting the “Fixed Location” option and entering the coordinates and accuracy levels for detecting them. Or, you can use the Google Maps service (see below) to locate positions for you (select “Google Maps API” option and enter your Google client ID, client secret, and API key; see below). You can also turn off the geolocation feature by selecting the “Disabled” option. |
What is Google Maps and how does it work with KioWare? | Google Maps is a web-based service that shows you maps, geographical coordinates, and other data about a specific location or region. You have probably visited a website of a business that showed you a small map of how to get there. Most likely, this map was created by Google Maps and pulled into the website. Google Maps offers an application programming interface (API) that can not only set up maps like this on web pages but can also turn on a geolocation feature (see above). In KioWare, when you select the “Google Maps API” option and enter your Google client ID, client secret (see below), and API key (see below), you can make this geolocation feature run with the KioWare browser. It will automatically detect the location of the kiosk or computer that is running KioWare. |
What is a client secret? | It is a unique ID number that Google gives to users who want to do custom programming or websites using Google's application programming interface (API). The client secret is separate from the normal Client ID that Google gives out to programmers, and generally the client ID, client secret, and API key (see below) are issued when you register a custom programming project with Google. In KioWare, all three of these must be entered to use Google Maps (see above) for geolocation (see above). |
What is an API key? | An Application Programming Interface (API) key is a unique code that a computer program or website submits to an API that it is “talking” with. This code tells the API that the computer program or website has been given prior permission to “talk” with it, and that contact is not being made by an unwanted user that might hack into or abuse the API's features. Google Maps requires that its API users register their custom programming or website projects with Google, and then Google gives them an API key to use when logging into its API. To use Google Maps with KioWare, you must first select the “Google Maps API” option and then enter your API key (as well as client ID and client secret; see above). |
What do I enter into the text and background color settings for the media capture window? | Enter a specific hex color value (e.g., #8B0000) or color name (e.g., red). |