WLWebview Kiosk
Settings

Web Browsing

Refresh, navigation, history, bookmark, search provider

1. Allow Refresh

Set to true to allow the user to refresh the page, e.g. by pulling down from the top 1/4 of the screen, when at the top of the webpage.

Default: true

2. Allow Backwards Navigation

Set to true to allow the user to go back one page in history.

This also enables forward navigation.

Default: true

3. Allow Go Home

Set to true to allow the user to go home using one of:

  1. Tapping the top-left quadrant of the screen 10 times in quick succession (opens Kiosk Control Panel)
  2. Holding the back button (long-pressed). For more details, see Settings -> Device
  3. Clicking the () icon on the right of the address bar (top-right corner of screen) and selecting Home
  4. Clicking the floating toolbar () icon and selecting Home

Default: true

4. 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

5. 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

6. 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

7. 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

8. 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

9. 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

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:

  1. Copy Link
  2. Open Link
  3. Open in Browser (only available when not in Locked mode)

Default: true

11. 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.

The actions available in the dialog are:

ActionDescription
BackNavigates one page backwards in history.
ForwardNaviagtes one page forward in history.
HomeNavigates to the home page.
RefreshPerform a reload on the current webpage.
LockTrigger either screen pinning or lock task mode depending on your device.
UnlockTrigger screen unpinning or unlock task. Will require biometrics or device credentials to succeed.

At the top-right corner of the dialog, there is an icon button that toggles the stickyness 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

12. Search Provider URL

The URL used for search queries in the address bar. This URL must include the search string query parameter.

Default: https://google.com/search?q=

12.1. Google

https://google.com/search?q=

12.2. DuckDuckGo

https://duckduckgo.com/?q=

12.3. Bing

https://bing.com/search?q=

12.4. Yahoo

https://search.yahoo.com/search?p=

12.5. Startpage

https://startpage.com/do/search?q=

12.6. Ecosia

https://ecosia.org/search?q=

12.7. Unduck

https://unduck.link?q=

12.8. Unduckified

https://s.dunkirk.sh?q=