Add key combo for hard refresh in kiosk

controller/Changelog.md

@@ -2,6 +2,7 @@
 
 ## Added
 
+- kiosk: Add a key combination to perform hard refresh (Ctrl-Shift-R)
 - os: Added localization options for Polish and Czech
 
 # [2023.9.0] - 2023-09-12

docs/user-manual/Readme.org

@@ -131,6 +131,10 @@ View what has been added, changed and fixed with each version.
 
 A status screen providing a brief status report about various components of the system is available on ~tty8~. It can be accessed using the key combination ~Ctrl-Alt-F8~. To get back from the status screen to the graphical interface, use ~Ctrl-Alt-F7~.
 
+** Clearing kiosk browser cache
+
+At times network issues may cause corrupted media resources to end up in the kiosk browser's cache. In this case it may be helpful to clear this cache to force all resources being downloaded again. A hard refresh can be triggered using ~Ctrl-Shift-R~, which clears the cache and then reloads the kiosk application. The hard refresh does not affect user sessions or preferences, so it can be performed without the user having to log in again.
+
 ** Wiping user data
 
 Certain user data such as Play login credentials, wireless settings are stored persistently on the computer's disk.

kiosk/kiosk_browser/browser_widget.py

@@ -61,6 +61,9 @@ def __init__(self, url, get_current_proxy, parent):
         # Shortcut to manually reload
         self.reload_shortcut = QtWidgets.QShortcut('CTRL+R', self)
         self.reload_shortcut.activated.connect(self.reload)
+        # Shortcut to perform a hard refresh
+        self.hard_refresh_shortcut = QtWidgets.QShortcut('CTRL+SHIFT+R', self)
+        self.hard_refresh_shortcut.activated.connect(self.hard_refresh)
 
         # Prepare reload timer
         self._reload_timer = QtCore.QTimer(self)
@@ -77,6 +80,18 @@ def reload(self):
         if self._reload_timer.isActive():
             self._reload_timer.stop()
 
+    def hard_refresh(self):
+        """ Clear cache, then reload.
+
+        Does not affect cookies or localstorage contents.
+
+        NOTE This clears the entire HTTP cache, assumed to be OK as the kiosk targets a specific page.
+        """
+        logging.info(f"Clearing HTTP cache (hard refresh)")
+        QtWebEngineWidgets.QWebEngineProfile.defaultProfile().clearHttpCache()
+
+        self.reload()
+
     def load(self, url: str):
         """ Load specific URL.
         """