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. 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 Refresh setting 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:

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

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

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.

ActionDescription
Show Block PageDisplay a HTML block page
Prevent NavigationDoes nothing when links are clicked
Show ToastShows 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):

ActionDescription
NavigationCombination of Back and Forward buttons side-by-side
BackNavigates one page backwards in history.
Requires: Web Browsing -> Allow Backwards Navigation
ForwardNavigates one page forward in history.
Requires: Web Browsing -> Allow Backwards Navigation
RefreshPerform a reload on the current webpage.
Requires: Web Browsing -> Allow Refresh
HomeNavigates to the home page.
Requires: Web Browsing -> Allow Go Home
HistoryOpens the history dialog.
Requires: Web Browsing -> Allow History Access
BookmarkOpens the bookmark dialog.
Requires: Web Browsing -> Allow Bookmark Access
FilesOpens the local files dialog.
Requires: Web Content -> Allow Local Files
SettingsOpens the settings page (only visible when unlocked, requires authentication)
LockOpens the settings page (only visible when unlocked)
UnlockOpens 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:

RegionDescription
Top LeftUpper-left quadrant of the screen.
Top RightUpper-right quadrant of the screen.
Bottom LeftLower-left quadrant of the screen.
Bottom RightLower-right quadrant of the screen.
TopUpper half of the screen.
BottomLower half of the screen.
FullEntire screen.
Disabled

Do nothing on multi-tap. Please note that if both of the following are true:

  1. Web Browsing -> Kiosk Control Panel Region is disabled

  2. Device -> Back Button Hold Action is not set to Open Kiosk Control Panel

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):

ActionDescription

Navigation

Combination of Back and Forward buttons side-by-side.

Requires Web Browsing -> Allow Backwards Navigation

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

Home

Navigates to the home page.

Requires Web Browsing -> Allow Go Home

Refresh

Perform a reload on the current webpage.

Requires Web Browsing -> Allow Refresh

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

Open the app settings screen. By default, this action is not configured.

This will always be visible if Appearance -> Floating Toolbar Mode is set to Hidden, and will be appended to the end if not configured.

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,

ProviderSearch URL
Googlehttps://google.com/search?q=
DuckDuckGohttps://duckduckgo.com/?q=
Binghttps://bing.com/search?q=
Yahoohttps://search.yahoo.com/search?p=
Startpagehttps://startpage.com/do/search?q=
Ecosiahttps://ecosia.org/search?q=
Unduckhttps://unduck.link?q=
Unduckifiedhttps://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:

EngineEndpoint
NoneNo search suggestions/autocomplete will be shown
Googlehttps://suggestqueries.google.com/complete/search?client=firefox&q=
DuckDuckGohttps://duckduckgo.com/ac?q=
Yahoohttps://api.search.yahoo.com/sugg/gossip/gossip-in-ura?output=sd1&command=

Default: NONE

On this page