Web Browsing
Refresh, navigation, history, bookmark, search provider
1. Allow Refresh
Set to true to allow the user to refresh the page, e.g. using the
- address bar actions
- kiosk control panel
- pull to refresh (can be configured separately)
Default: true
2. Allow Pull to Refresh
Set to true to allow the user to refresh the page by pulling down from the top 1/4 of the screen.
Note that this requires:
- the
Allow Refreshsetting to also be true - the page to have been scrolled fully to the top prior to the gesture
- a single finger (touch) is used
Default: true
3. Allow Backwards Navigation
Set to true to allow the user to go back one page in history.
This also enables forward navigation.
Default: true
4. Allow Go Home
Set to true to allow the user to go home using one of:
- Tapping the top-left quadrant of the screen 10 times in quick succession (opens Kiosk Control Panel)
- Holding the back button (long-pressed). For more details, see
Settings -> Device - Clicking the () icon on the right of the address bar (top-right corner of screen) and selecting
Home - Clicking the floating toolbar () icon and selecting
Home - Clicking your device's home button
- This requires Webview Kiosk to be set as the default launcher (home) app
Default: true
5. Clear History on Home
Set to true if you want to clear the backwards/forward navigation history
whenever a Go Home action is triggered.
Default: false
6. Replace History URL on Redirect
Set to true to replace the current history entry with the final URL if any page redirections occurs, rather than adding multiple entries to the history navigation stack.
Default: true
7. Allow History Access
Set to true to allow viewing and navigating back in history, by
clicking the () icon
on the right of the address bar (top-right corner of screen) and selecting History.
Default: true
8. Allow Bookmark Access
Set to true to allow viewing and navigating to bookmarks configured in settings, by
clicking the () icon
on the right of the address bar (top-right corner of screen) and selecting Bookmark.
Default: true
9. Allow Other URL Schemes
This option only works when the application is not in locked (pinned) mode.
When enabled, clicking on URLs with schemes like mailto:, sms, tel,
intent:, spotify:, whatsapp:, etc will prompt the user to select an
appropriate application to handle.
Default: false
10. Allow Default Long Press
When enabled, long-pressing areas in the WebView will trigger the native WebView behaviour, e.g. text selection.
Specifically for links, even if set to false, this setting can be overridden
by the Allow Link Long Press Context Menu setting.
Default: true
11. Allow Link Long Press Context Menu
When enabled, long-pressing links in the WebView will trigger a custom link options dialog.
This will take precedence over the Allow Default Long Press setting
(i.e. overrides it).
This actions available in the dialog are:
- Copy Link
- Open Link
- Open in Browser (only available when not in Locked mode)
Default: true
12. Override URL Loading Block Action
Action to take when a URL navigation (via shouldOverrideUrlLoading) matches the blacklist regex.
Typically, this is from clicking links (<a> tags) on a webpage's HTML.
| Action | Description |
|---|---|
| Show Block Page | Display a HTML block page |
| Prevent Navigation | Does nothing when links are clicked |
| Show Toast | Shows a toast with your custom block message |
This option will NOT take effect for:
- JavaScript navigation
- Custom URL loading, e.g. from the Address Bar, Bookmarks, History, etc
In those other cases, the block page will simply be shown.
Default: Show Block Page
13. Address Bar Actions
This setting is only controlling the UI aspect of the Address Bar.
Access will still need to be enabled using the dependent settings.
The following actions are available to be configured (remove or rearrange):
| Action | Description |
|---|---|
| Navigation | Combination of Back and Forward buttons side-by-side |
| Back | Navigates one page backwards in history. Requires: Web Browsing -> Allow Backwards Navigation |
| Forward | Navigates one page forward in history. Requires: Web Browsing -> Allow Backwards Navigation |
| Refresh | Perform a reload on the current webpage. Requires: Web Browsing -> Allow Refresh |
| Home | Navigates to the home page. Requires: Web Browsing -> Allow Go Home |
| History | Opens the history dialog. Requires: Web Browsing -> Allow History Access |
| Bookmark | Opens the bookmark dialog. Requires: Web Browsing -> Allow Bookmark Access |
| Files | Opens the local files dialog. Requires: Web Content -> Allow Local Files |
| Settings | Opens the settings page (only visible when unlocked, requires authentication) |
| Lock | Opens the settings page (only visible when unlocked) |
| Unlock | Opens the settings page (only visible when locked, requires authentication) |
14. Kiosk Control Panel Region
Controls which part of the screen can be multi-tapped 10 times in quick succession to show the Kiosk Control Panel dialog.
Available regions are:
| Region | Description |
|---|---|
| Top Left | Upper-left quadrant of the screen. |
| Top Right | Upper-right quadrant of the screen. |
| Bottom Left | Lower-left quadrant of the screen. |
| Bottom Right | Lower-right quadrant of the screen. |
| Top | Upper half of the screen. |
| Bottom | Lower half of the screen. |
| Full | Entire screen. |
| Disabled | Do nothing on multi-tap. Please note that if both of the following are true:
Then this option cannot be disabled, and will default to Top Left. |
At the top-right corner of the dialog, there is an icon button that toggles the stickiness Kiosk Control Panel's stickiness behaviour. By default, sticky mode is disabled (). When enabled (), clicking on the action buttons will not automatically close the dialog.
You can also disable this setting and instead configure
Device -> Back Button Hold Action to open the Kiosk Control Panel.
Default: Top left
15. Kiosk Control Panel Actions
This setting is only controlling the UI aspect of the Kiosk Control Panel. Access will still need to be enabled using the dependent settings.
The following actions are available to be configured (remove or rearrange):
| Action | Description |
|---|---|
Navigation | Combination of Requires |
Back | Navigates one page backwards in history. Requires |
Forward | Navigates one page forward in history. Requires |
Home | Navigates to the home page. Requires |
Refresh | Perform a reload on the current webpage. Requires |
History | Opens the history dialog. Requires |
Bookmark | Opens the bookmark dialog. Requires |
Files | Opens the local files dialog. Requires |
Settings | Open the app settings screen. By default, this action is not configured. This will always be visible if |
Lock | Trigger either screen pinning or lock task mode. |
Unlock | Trigger screen unpinning or unlock task. Will require biometrics or device credentials to succeed. This action will always be visible when the device is in locked mode, and will be appended to the end if not configured. |
16. Search Provider URL
The URL used for search queries in the address bar. This URL must include the search string query parameter.
For example,
| Provider | Search URL |
|---|---|
https://google.com/search?q= | |
| DuckDuckGo | https://duckduckgo.com/?q= |
| Bing | https://bing.com/search?q= |
| Yahoo | https://search.yahoo.com/search?p= |
| Startpage | https://startpage.com/do/search?q= |
| Ecosia | https://ecosia.org/search?q= |
| Unduck | https://unduck.link?q= |
| Unduckified | https://s.dunkirk.sh?q= |
Default: https://google.com/search?q=
17. Search Suggestion Engine
Configure the search engine for text suggestions (autocomplete/hints) when typing in the address bar.
For example, when searching for "new", you may get suggested
- news
- new recipes
- new york times
Supported options are:
| Engine | Endpoint |
|---|---|
| None | No search suggestions/autocomplete will be shown |
https://suggestqueries.google.com/complete/search?client=firefox&q= | |
| DuckDuckGo | https://duckduckgo.com/ac?q= |
| Yahoo | https://api.search.yahoo.com/sugg/gossip/gossip-in-ura?output=sd1&command= |
Default: NONE