Home > Customization (Skins) > Manuell editierbare Optionen

Manuell editierbare Konfigurationsoptionen

Einige Konfigurationsoptionen von SiteKiosk sind nicht über die grafische Konfigurationsoberfläche von SiteKiosk editierbar. Es handelt sich dabei um spezielle Optionen, die im Normalfall nicht geändert werden müssen.
Mit Hilfe eines Texteditors können Sie die xml-basierten Konfigurationsdateien von SiteKiosk öffnen und editieren.

Hinweis:
Die manuelle Änderung der nachfolgenden Optionen erfolgt auf eigenes Risiko. Testen Sie die Auswirkungen bitte bevor Sie die editierte Konfiguration im Normalbetrieb einsetzten.



1. Automatischer Prozess Neustart
Um die Stabilität des Systems zu erhöhen, haben wir eine Funktion eingebaut, die den SiteKioskprozess (Browser) bei Nicht-verwendung beendet und neustartet.

Sie können diese Option auch komplett deaktivieren. Öffnen Sie dazu Ihre Konfigurationsdatei .skcfg im Verzeichnis ..\SiteKiosk\Config\.. mit einem Editor und suchen Sie den folgenden Eintrag und ersetzen
<enable-automatic-restart>true</enable-automatic-restart>
entsprechend mit
<enable-automatic-restart>false</enable-automatic-restart>.
Zudem können Sie die Zeit bis zum Neustart (in Minuten) durch diesen Wert beeinflussen
<automatic-restart-time>360</automatic-restart-time>
.

Hinweis:
Diese Funktion wird generell nur dann ausgeführt, wenn Sie in der Konfiguration den Bildschirmschoner aktiviert haben. Des Weiteren wird diese Funktion NICHT ausgeführt, wenn der Computer in Benutzung ist, sondern explizit nur dann, wenn der Bildschirmschoner auch aktiv ist.
Die Option sollte nicht deaktiviert werden, wenn der Wert <reset-browser-on-screensaver-start> auf false steht (der Wert wird bei der Kombination von einigen SiteKiosk Optionen auch automatisch vom Konfigurator auf false gesetzt).


Auch für Digital Signage (Auslaufprodukt, welches durch SiteCaster ersetzt wurde) ist eine Funktion eingebaut, die den Digital Signage Prozess (SiteCaster Player) regelmäßig beendet und neu startet (Default alle 360 Minuten).
Sie können auch diese Option komplett deaktivieren. Öffnen Sie dazu die Datei "SiteCaster.config" im Verzeichnis "C:\ProgramData\PROVISIO\SiteCaster" mit einem Editor.
Suchen Sie den folgenden Eintrag <AllowTimedRestarts>true</AllowTimedRestarts> und ersetzen diesen entsprechend mit <AllowTimedRestarts>false</AllowTimedRestarts>.


2. Software Watchdog
SiteKiosk wurde mit verschiedensten Sicherheitsmerkmalen ausgestattet. Hierzu gehört auch ein Softwarewatchdog (watchdog.exe). Hinter der Datei watchdog.exe verbirgt sich ein Programm, welches beim Start von SiteKiosk aufgerufen wird und im Hintergrund läuft.

SiteKiosk muss sich in bestimmten Zeitintervallen (einstellbar) bei der Watchdog.exe zurückmelden. Geschieht dies nicht, dann ist sehr wahrscheinlich der Browser bzw. SiteKiosk ausgelastet oder sogar abgestürzt. In diesem Fall startet Watchdog.exe die SiteKiosk.exe neu. Dies stellt eine hohe Verfügbarkeit der Anwendung sicher.
Sollten Sie es dennoch wünschen, den Software Watchdog nicht zu aktivieren, öffnen Sie Ihre Konfigurationsdatei .skcfg im Verzeichnis ..\SiteKiosk\Config\.. mit einem Editor und suchen Sie den folgenden Eintrag und ersetzen <watchdog>true</watchdog> entsprechend mit <watchdog>false</watchdog>.

Des Weiteren beinhaltet die Software Watchdog auch die Funktion bei mehreren Systemabstürzen das komplette System neuzustarten. Nach einem Crash von SiteKiosk startet der Watchdog das Programm erneut. Hierbei kann es z.B. aufgrund einer Speicherüberlastung dazu kommen, dass das Programm nicht gestartet werden kann. Nach drei erfolglosen Startversuchen wird der Rechner automatisch neugestartet, was das Problem in den meisten Fällen behebt.
Sollten Sie es dennoch wünschen, die Speicherüberwachung des Watchdogs zu deaktivieren, öffnen Sie Ihre Konfigurationsdatei .skcfg im Verzeichnis ..\SiteKiosk\Config\.. mit einem Editor und suchen Sie den folgenden Eintrag und ersetzen
<start-monitoring emergency-interval="300" emergency-count="10">true</start-monitoring>
entsprechend mit
<start-monitoring emergency-interval="300" emergency-count="10">false</start-monitoring>.
SiteKiosk überwacht auch die Anzahl von SiteKiosk Abstürzen innerhalb eines bestimmten Zeitintervalls. Standardmäßig sind dies 10 (emergency-count) innerhalb von 300 Sekunden (emergency-interval). Sollte die Zahl überschritten werden, wird ebenfalls ein Systemneustart ausgelöst. Sie können diese Werte Ihren Bedürfnissen anpassen.



3. Bildschirmschoner

Sie können die Sitekiosk Bildschirmschoner-Funktion deaktivieren, jedoch ist dies aus Stabilitäts- und Datenschutzgründen NICHT zu empfehlen! Öffnen Sie dazu die von Ihnen erstellte Konfigurationsdatei mit einem Editor und suchen Sie nach dem Eintrag <screensaver enabled="true"> und setzen Sie ihn auf false.



4. Bildschirmauflösung

Die Konfigurationsseite für die Bildschirmauflösung gibt es ab SiteKiosk 7 nicht mehr. SiteKiosk verwendet standardmäßig die unter Windows eingestellte Auflösung. Falls Sie explizit festlegen möchten, dass SiteKiosk beim Start zu einer bestimmten Bildschirmauflösung wechseln soll, können Sie dazu die von Ihnen erstellte Konfigurationsdatei mit einem Editor öffnen. Suchen Sie nach dem nachfolgenden Eintrag:

<screenmode>
      <xpres>800</xpres>
      <yres>600</yres>
      <bitdepth>16</bitdepth>
      <frequency>0</frequency>
      <autoset>false</autoset>
      ...
</screenmode>

Setzen Sie autoset auf true und ändern Sie die Einstellungen für Bildschirmbreite (xres), -höhe (yres), Farbqualität (bitdepth) und Bildwiederholrate (frequency) Ihren Wüschen entsprechend.



5. SiteKiosk auf einen Teil des Bildschirms beschränken

Ab SiteKiosk 7.8 kann die SiteKiosk Applikation auf einen Teil des Bildschirms begrenzt werden. Um die Abstände festzulegen, suchen Sie nach diesem Segment:

<screenmode>
      ...
      <workarea enabled="false">
            <capture-mouse>true</capture-mouse>
            <left>0</left>
            <top>0</top>
            <right>100</right>
            <bottom>100</bottom>
      </workarea>
</screenmode>

Setzen Sie für workarea das enabled auf true, um die nachfolgenden Werte nutzen zu können. Der Wert capture-mouse legt fest, ob die Maus außerhalb des SiteKioskbereichs benutzt werden kann. Die übrigen Werte sind Koordinaten in Prozentangaben (0-100) in Relation zu den jeweiligen Desktop-Abmessungen.




6. Favicons abschalten

Sie können die Anzeige von Favicons in der Adresszeile des SiteKiosk Browsers deaktivieren. Öffnen Sie dazu die von Ihnen erstellte Konfigurationsdatei mit einem Editor und suchen Sie nach dem Eintrag <usefavicons enabled="true"/> und setzen Sie ihn auf false.



7. IE Kompatibilitätsmodus

Sie können auch den für den SiteKiosk Browser gesetzten IE Kompatibilitätsmodus deaktivieren, dies kann helfen Darstellungsprobleme auf Webseiten zu beheben. Öffnen Sie dazu die von Ihnen erstellte Konfigurationsdatei mit einem Editor und suchen Sie nach dem Eintrag <ie8-compatibility-view enabled="true"/> und setzen Sie ihn auf false. Der Wert false versetzt den Browser in einen IE7-Modus. Mit dem Wert true wird der Browser passend zum installierten Internet Explorer betrieben, 8000 bei Systemen mit dem IE8, 9000 beim IE9 usw.

Auf Systemen mit dem IE11 ist auch die Angabe eines optionalen Attributs mit dem Namen emulation-mode möglich. Dem Attribut kann ein Dezimalwert zugewiesen werden, der SiteKiosk in einen bestimmten Kompatibilitätsmodus zwingt, z.B. in den IE9-Modus <ie8-compatibility-view enabled="true" emulation-mode="9000" />.
Wenn Sie SiteKiosk mit einem angepassten User Agent betreiben sind nur erzwungene Modi zulässig, also z.B. 9999 statt 9000. Das kann allerdings zu Darstellungsproblemen auf Seiten führen, die nicht für den erzwungenen Browser-Modus ausgelegt sind.
Die Werte sind je nach Internet Explorer Version verschieden. Nutzen Sie bitte die Microsoft Dokumentation, um die passenden Werte zu ermitteln. In unserer FAQ-Sektion finden sich ebenfalls weiterführende Informationen zu dem Thema.

Dass in der Benamung der Option vom IE8 die Rede ist, hat mit dem Zeitpunkt der Einführung dieser Option zu tun.



8. SiteKiosk Player deaktivieren

Für die Darstellung verschiedener Medientypen (RSS-Feeds, Flash, PDF, Video und Audio) wird innerhalb des SiteKiosk Browsers ein integrierter Player verwendet. Dies erhöht die Sicherheit und vereinheitlicht die Bedienung. Insbesondere bei dynamisch generierten PDF-Dateien kann es aber vorkommen, dass dies zu Darstellungsproblemen führen kann.
Um den integrierten Player für einzelne Medientypen zu deaktivieren, öffnen Sie bitte die von Ihnen erstellte Konfigurationsdatei mit einem Editor und suchen Sie nach dem Eintrag <mime-filters> im Anschluss zu dieser Zeile finden Sie eine Liste der Medientypen. Wenn Sie den Eintrag <filter enabled="true" player="pdf" content="application/pdf" action="2" /> so ändern <filter enabled="false" player="pdf" content="application/pdf" action="2" />, dann deaktivieren Sie z.B. den integrierten Player für PDF Dokumente.



9. Druckvorschau aktivieren

Für eine Druckvorschau kann der SiteKiosk Browser die Druckvorschau Funktion des Internet Explorers verwenden.
Um dieses Feature zu aktivieren, müssen Sie Ihre SiteKiosk Konfiguration mit einem Editor öffnen (z.B. Notepad).

Suchen Sie dann nach den folgenden Zeilen:

<printtemplates>
      <enabled>false</enabled>
      ...
</printtemplates>

Setzen Sie enabled auf true und speichern Sie die Änderung. Bitte beachten Sie, dass die Druckvorschau nicht in vollem Umfang in SiteKiosk integriert ist, es kann daher vorkommen, dass nicht alle Funktionen zur Verfügung stehen.



10. IE Downloaddialog erlauben

Es besteht die Möglichkeit, den SiteKiosk Downloadmanager für bestimmte Seiten zu deaktivieren. In diesem Fall erscheint wieder der normale IE-Download Dialog (Öffnen/Speichern unter). Aus Sicherheitsgründen sollten Sie bei dieser Vorgehensweise den eingeschränkten SiteKiosk Benutzer verwenden, damit Ihr System bestmöglich geschützt ist. Die hierfür notwendigen Einstellungen müssen Sie allerdings direkt in der SiteKiosk Konfigurationsdatei durchführen.

Bitte öffnen Sie die Datei mit einem Editor und ersetzen Sie den Eintrag <msdownloaddlg-urls/> mit:

<msdownloaddlg-urls>
      <url>http://aWebPage.com/*</url>
</msdownloaddlg-urls>

Wobei die URL-Zeile für die freizugebende URL steht, die mit Wildcards verallgemeinert werden kann. Die Beispiel-URL bezieht sich auf Hotmail-Downloads.
Sollte diese URL bei Ihnen nicht funktionieren oder haben Sie Probleme auf anderen Seiten, können Sie die betreffenden URLs mit Hilfe der SiteKiosk Logdateien herausfinden.
Stellen Sie in der Konfiguration von SiteKiosk sicher, dass die Logdateien aktiviert sind und schalten Sie am besten auch das Debug Output Fenster ein. Wenn Sie jetzt SiteKiosk starten, werden Ihnen die Logeinträge in einem separaten Fenster angezeigt. Versuchen Sie nun den Download erneut und ermitteln Sie anhand der Logeinträge die fragliche URL.



11. Anti-Sabotage-Modus deaktivieren

Sie können den Anti-Sabotage-Modus von SiteKiosk deaktivieren, z.B. wenn eine von Ihnen gewünschte Seite potentiell gefährliches Skriptverhalten zeigt, wie wiederholte Aufrufe der gleichen Funktion. Öffnen Sie dazu die von Ihnen erstellte Konfigurationsdatei mit einem Editor und suchen Sie nach dem Eintrag <antisabotage enabled="true"/> und setzen Sie ihn auf false.



12. Digital Signage-Bereich (Auslaufprodukt)

Der Digital Signage-Bereich (Auslaufprodukt, bitte verwenden Sie jetzt SiteCaster), wenn dieser auf dem Hauptbildschirm mit SiteKiosk kombiniert wird, überlagert standardmäßig Fenster anderer Applikationen, da der Bereich als topmost definiert ist. Das können Sie durch manuelles Editieren der SiteKiosk Konfigurationsdatei mit Editor ändern.

Bitte öffnen Sie die Datei mit einem Editor und ändern Sie topmost von true auf false:

<sitecasterwindow enabled="true" topmost="true">



13. Bezahlinformationen

SiteKiosk zeigt diverse Bezahlinformationen an, die im Normalfall Hinweise auf Tarife und Bezahlweisen enthalten.

Ein Teil davon ist in den erweiterten Optionen der Bezahlgeräte-Konfiguration editierbar. Andere Teile (z.B. die Tarifanzeige der Portal-Seite oder des Bezahldialogs) richten sich dynamisch nach den konfigurierten Bezahlgeräten. Bei der alleinigen Verwendung des Surfzeit-Begrenzers werden z.B. neutralere Texte angezeigt.

Sollten Sie diese neutralen Texte auch anzeigen wollen, wenn andere Bezahlgeräte verwendet werden können Sie dies durch Änderung einer Variablen in einer Skriptdatei erreichen (ab SiteKiosk 8.2).

Bitte öffnen Sie die Datei ..\SiteKiosk\SiteCash\hidedefaultpayinfo.js mit einem Editor und ändern Sie gb_hidedefaultpayinfos von false auf true:

var gb_hidedefaultpayinfos = false;



14. Drag&Drop im Browser erlauben

Standardmäßig ist Drag&Drop im SiteKiosk-Browser nicht erlaubt (das betrifft nicht ActiveX Controls im Brower). Sollte diese Funktion doch gewünscht sein, kann diese durch manuelles Editieren der Konfigurationsdatei freigegeben werden.

Bitte öffnen Sie die Datei mit einem Editor und ändern Sie block-copy-move von true auf false:

<block-copy-move>true</block-copy-move>




15. Die Standardfehlerseiten des IE nutzen

Falls Sie nicht die anpassbare Navigationsfehlerseite von SiteKiosk sondern die Standardfehlerseiten des Internet Explorers nutzen wollen, können Sie mit einem Editor (z.B. Notepad) die Zeile <show-nav-error>false</show-nav-error> dem Abschnitt /sitekiosk-configuration/browserbar/ in der von Ihnen genutzten SiteKiosk Konfiguration hinzufügen:

<show-nav-error>false</show-nav-error>


16. SiteKiosk nach X Sekunden Leerlauf automatisch beenden
Diese Option erlaubt es, dass SiteKiosk nach einer gewissen Leerlaufzeit (Anzahl der Sekunden ohne Maus-/Tastatureingaben) automatisch geschlossen wird. Diese Option sollte nur dann eingeschaltet werden, wenn ein Zusatztool die Kontrolle über der Terminal hat. Die Option sollte nicht zusammen mit dem Shellaustausch verwendet werden.
Wenn bei den erweiterten Einstellungen des Bildschirmschoners von SiteKiosk die Option 'Bei Guthaben Screensaver nicht aktivieren' aktiviert ist, beendet sich SiteKiosk erst nach Ablauf des Restguthabens.
Die Werte in der Konfiguration sind:

<idle-deactivate>true</idle-deactivate>
<deactivate-time>60</deactivate-time>


17. PnP Device Watcher aktivieren

Ab SiteKiosk 8.9 ist es möglich das Anstecken, Abziehen und Modifizieren von Plug'n'Play Geräten (USB und COM-Emulation) überwachen zu lassen. Dafür kann pnpwatcher durch manuelles Ändern der SiteKiosk Konfiguration in einem Editor von false auf true gesetzt werden:

<pnpwatcher enabled="true"/>

Nach der Änderung muss einmal SiteKiosk gestartet worden sein, um den neuen Wert zu aktivieren. Die Überwachung ist danach aber auch aktiv, wenn SiteKiosk selbst nicht läuft, da diese durch den SiteRemote Client Service erfolgt.

Die Überwachung der PnP-Geräte erfolgt mit Hilfe von WMI-Events (Windows Management Instrumentation).

Es werden unter SiteRemote auswertbare Logeinträge wie dieser generiert:
20 1023 2014-07-24 12:51:00 +0200 [SiteRemote Client] PnP device inserted: DeviceID=USBSTOR\DISK&VEN_&PROD_USB_DISK_2.0&REV_PMAP\07102CA8228E9994&0; Caption=USB DISK 2.0 USB Device; ConfigManagerErrorCode=0; Status=OK;

Beachten Sie, dass eine Aktivierung des Watchers eine sehr große Anzahl von Logeinträgen erzeugt. Bereits das Anstecken eines USB-Sticks kann bis zu 5 PnP-Events feuern. Sie sollten daher die Möglichkeit von include bzw. exclude nutzen, um die für Ihren Anwendungsfall interessanten Einträge zu filtern. Normalerweise reicht es, sich für include oder exclude zu entscheiden. Werden beide miteinander kombiniert, hat exclude Vorrang vor include. Die Verwendung von Wildcards (*) ist möglich. Als Filterung dient die DeviceID, die z.B. im Logeintrag erscheint (siehe oben).

<plugin name="SiteRemote" enabled="true" clsid="2F5B83E1-88BC-44D2-9E5D-B3D621C4A292">
      ...
      <pnpwatcher enabled="true">
            <include>HID\*</include>
            <include>USB\*</include>
            <include>USBSTOR\DISK*</include>
            <exclude>*VID_8087*</exclude>
            <exclude>*VID_0409*</exclude>
      </pnpwatcher>
</plugin>



18. Temporäre Internetdateien, Cookies und Zertifikate um Mitternacht löschen

Um temporäre Internetdateien, Cookies und Zertifikate (basierend auf den unter Logout gemachten Einstellungen) zu löschen, kann die nachfolgende Einstellung von false auf true gesetzt werden:

<clear-cache-midnight>false</clear-cache-midnight>



19. HTTP-Post Dateiuploads sperren (verhindert z.B. das Anhängen von Dateien)

Diese Option verhindert, dass Benutzer über Web-Formulare Dateien vom lokalen Rechner hochladen können.

Beachten Sie bitte, dass SiteKiosk nicht alle Dateiuploads sperren kann. Die Sperrung von Dateiuploads ist von der auf der jeweiligen Webseite verwendeten Technik abhängig. Ggf. ist es notwendig entsprechende Dialoge über das Fenster- und Dialogmanagement von SiteKiosk zu blocken.

Da der Benutzer generell keinen Zugriff auf die Dateien auf Ihrem Terminal haben sollte, sollten Sie diese Option nur bei Verwendung von SiteKiosk unter dem eingeschräkten SiteKiosk Benutzer eingeschaltet lassen. Nur für diesen Benutzer sind auch die damit zusammenhängenden Dialoge standardmäßig erlaubt.

Um SiteKiosk versuchen zu lassen den HTTP-Post-Upload von Dateien zu unterbinden, kann die nachfolgende Einstellung von false auf true gesetzt werden:

<no-http-uploads>false</no-http-uploads>



20. Fenster nicht auf den Anzeigebereich von SiteKiosk beschränken

Standardmäßig lassen sich Fenster nicht aus dem Anzeigebereich von SiteKiosk schieben. Diese Einschränkung kann aufgehoben werden, indem man die SiteKiosk Konfiguration mit einem Editor öffnet und direkt nach der Zeile <windowmanager> eine neue Zeile mit folgendem Inhalt hinzufügt:

<disallow-window-clipping>true</disallow-window-clipping>



21. Aus der Konfigurationsoberfläche entfernte Optionen

Im Laufe der vielen Jahre der Weiterentwicklung von SiteKiosk werden der Software zahlreiche neue Funktionen hinzugefügt. Gleichsam wird aber der Support für einige Funktionen eingestellt, die zu dem Zeitpunkt von unseren Kunden mehrheitlich nicht mehr genutzt werden.

Diese Funktionen werden allerdings lediglich aus der Oberfläche des Konfigurators entfernt, um diesen nicht mit kaum genutzten Funktionen zu überfrachten. Sie stehen grundsätzlich noch zur Verfügung, werden aber nicht mehr offiziell durch unseren Support abgedeckt.

Die gestrichenen Funktionen können über das manuelle Editieren einer Konfigurationsdatei mit Hilfe eines Texteditors weiterhin genutzt und konfiguriert werden. Nachfolgend finden Sie eine grobe Übersicht, die überwiegend die Hauptknoten in der XML-Struktur einer SiteKiosk Konfigurationsdatei benennt, über die die jeweilige Option kontrolliert werden kann.

Videomail/Webcam:

<plugin name="SiteCam" enabled="false" clsid="5aadd108-c1ba-4fe7-8096-65cf19d58e14">...</plugin>

<mediamailprice enabled="false">1.11</mediamailprice>

Bitte beachten Sie, dass in SiteKiosk Versionen nach 8.91 Videomail/Webcam nicht mehr vollständig konfiguriert werden kann, da die SiteKiosk Konfigurationsoberfläche für die Hardwareerkennung erforderlich ist.

Heatmap:

<heatmap enabled="false">...</heatmap>

Skin Zonen:

<siteskin>
      ...
      <zone>
            <zonename>Name of the Skin Zone</zonename>
            <skinname>Name of the Skin</skinname>
            <url>URL the zone applies to</url>
            <language>7</language>
            <language>9</language>
      </zone>
</siteskin>

Brennen von CD-ROMs:

<allow-burn>false</allow-burn>
<show-copyright-notice>false</show-copyright-notice>

<cdrecordingprice enabled="false">1.11</cdrecordingprice>

Tagesraten für Bezahlgeräte:

<plugin name="SiteCash" enabled="false" clsid="476d1841-6b58-424f-a9e5-f024f0384ab1">
      ...
      <time-zone>...</time-zone>
</plugin>




Siehe auch



Nach oben