Browserlayout - SiteKiosk Hilfe

Die XML-Definitionsdatei für Browserlayouts enthält alle notwendigen Informationen, die zum Betrieb eines Browserlayout (Skin) notwendig sind.

Bitte beachten Sie:
Für die Erstellung eines eigenen Browserlayouts sind gewisse Grundkenntnisse notwendig. Aus verständlichen Gründen können wir Ihnen (ausser dieser ausführlichen Dokumentation) keinen Support bei der Erstellung eines eigenen Skins leisten!

1. Genereller Aufbau der Definitionsdatei

Der Aufbau der Definitionsdatei soll anhand der Datei eines spezifischen Skins erläutert werden.

Pfad zur Definitionsdatei des Default Skins: SK-Installationsordner/Skins/Default/DefaultSkindef.xml

Nachfolgend ein Auszug mit den wichtigsten Elementen der Datei:

<touchscreen>TX82-Ultra Deutsch (docked)</touchscreen>

<stringtable>Language\Browserskins\stringtable.xml</stringtable>

<url id="emailbutton">skins\public\default\menu.html</url>

<dialog id='toomanywindows' width='373' height='225'

titlebar='true' scrollbars='false' border='true'

sysmenu='false'>skins\default\systemdialog\toomanywnds.htm</dialog>

<traywindow height='28'>skins\default\TrayWindow.html</traywindow>

<source>skins\default\MainWnd.htm</source>

</mainskin>

skins\default\img\Logos\anilogo.png</busyanim>

skins\default\img\ButtonBar.png</toolbar>

</windowskinless>

<source>skins\default\NewWnd.htm<source>

</windowskin>

</subskindef>

<confightml>skins\default\defaultconfig.html</confightml>

</skindef>

2. Die Elemente und Attribute der Definitionsdatei

2.1 skindef-Element
Jedes Layout eines Browserlayouts gliedert sich in einen skindef-Abschnitt mit mehreren subskindef-Abschnitten.

...

</subskindef>

</skindef>

name:
Definiert den Namen des Skins. Der Inhalt dieses Attributes wird in der SiteKiosk Konfiguration angezeigt. Das Attribut name muss für jedes Layout eindeutig sein.

languages-selectable:
Boolescher Wert der festlegt, ob die Sprachauswahlmöglichkeit für das Skin in der Konfiguration aktiviert (true) oder deaktiviert (false) ist.

2.2 touchscreen-Element

<touchscreen>TX82-Ultra German (docked)</touchscreen>

Noch nicht vollständig implementiert.

2.3 stringtable-Element
Legt den Pfad zur Stringtable-XML-Datei fest.

<stringtable>Language\Browserskins\stringtable.xml</stringtable>

In der stringtable.xml finden Sie alle sprachrelevanten Einstellungen. Mehr Informationen finden Sie hier.

2.4 languageoption-Element
Definiert die im Layout vorhandenen und in der Konfiguration auswählbaren Sprachen.

id:
Über die ID wird jede zur Verfügung gestellte Sprache definiert. Die für ein Skin vorgesehenen Sprachen werden einfach der Reihe nach aufgelistet.

Die Language-IDs sind wie folgt:

LANG_AFRIKAANS	54
LANG_ALBANIAN	28
LANG_ARABIC	1
LANG_ARMENIAN	43
LANG_ASSAMESE	77
LANG_BULGARIAN	2
LANG_CATALAN	3
LANG_CHINESE	4
LANG_CROATIAN	26
LANG_CZECH	5
LANG_DANISH	6
LANG_DUTCH	19
LANG_ENGLISH	9
LANG_ESTONIAN	37
LANG_FINNISH	11
LANG_FRENCH	12
LANG_FRENCH-BELGIUM	2060
LANG_GERMAN	7
LANG_GREEK	8
LANG_HEBREW	13
LANG_HINDI	57
LANG_HUNGARIAN	14
LANG_ICELANDIC	15
LANG_INDONESIAN	33
LANG_ITALIAN	16
LANG_JAPANESE	17
LANG_KANNADA	75
LANG_KOREAN	18
LANG_LATVIAN	38
LANG_LITHUANIAN	39
LANG_MACEDONIAN	47
LANG_MALAY	62
LANG_MALAYALAM	76
LANG_MARATHI	78
LANG_NORWEGIAN	20
LANG_POLISH	21
LANG_PORTUGUESE	22
LANG_ROMANIAN	24
LANG_RUSSIAN	25
LANG_SERBIAN	26
LANG_SLOVAK	27
LANG_SLOVENIAN	36
LANG_SPANISH	10
LANG_SWEDISH	29
LANG_THAI	30
LANG_TURKISH	31

enabled-by-default:
Wird die vom Betriebssstem eingestellte Systemsprache nicht von SiteKiosk unterstützt (z.B. Suaheli), so gilt automatisch die hier angegebene default Sprache.

2.5 subskindef-Element
Unterbereich des skindef-Elements, der einige zusammengehörige Elemente gruppiert.

...

</subskindef>

name:
Legt den Namen des subskindef-Bereiches fest. Der Name muss eindeutig sein.

language='id':
Für die Sprachanzeige gibt es unterschiedliche Lösungsansätze:

Lösung 1: Man erstellt ein subskindef mit language="0". In diesem Fall werden immer die gleichen Dialoge angezeigt, ganz unabhängig von der Sprache. Lediglich die Texte werden durch die Stringtable in der ausgewählten Sprache angezeigt. Das Default Skin arbeitet nach diesem Prinzip.

Lösung 2: Man erstellt für eine Sprache (language="[language-id]") ein eigenen subskindef-Bereich. Dies gibt Ihnen die Möglichkeit, für die jeweils ausgewählte Sprache völlig andere Dialoge (Siehe auch dialog id) oder aber auch Browserskins anzuzeigen. Für alle anderen Sprachen gilt als Fallback dann Lösung 1. Dies ist sinnvoll, wenn eine Sprache völlig andere Anzeige-Regeln hat, wie z.B. Chinesisch oder Hebräisch.

2.6 url-Element
Legt verschiedene fest definierte URLs eines Skins fest. Die Angabe ist optional und kann ausgespart werden, wenn entsprechende URLs in einem Browserlayout nicht benötigt werden.

<url id='emailbutton'>skins\public\default\menu.html</url>

...

id='emailbutton':
Legt die URL fest, die aufgerufen wird, wenn der Email-Button innerhalb der Symbolleiste gedrückt wird.

id='emailnav':
Legt die URL fest, die aufgerufen wird, wenn innerhalb des Browsers auf einen mailto-Link (Emailadresse) geklickt wird und wenn innerhalb der Symbolleiste der Email-Button geklickt wird.

id='mediamail':
Legt die URL fest, die aufgerufen wird, wenn der WebCam-Button innerhalb der Symbolleiste gedrückt wird. Wird ab SiteKiosk 9.0 nicht mehr offiziell unterstützt.

id='applications':
Legt die URL fest, die aufgerufen wird, wenn der Programme-Button innerhalb der Symbolleiste gedrückt wird.

id='naverror':
Legt die URL fest, die aufgerufen wird, wenn eine Navigation innerhalb des SiteKiosk Browsers fehlschlägt.

2.7 dialog-Element
Dialog definiert die URL von diversen Skin-Dialogen, z.B. dem Dialog der angezeigt wird, wenn zu viele Fenster geöffnet wurden.

<dialog id='toomanywindows' width='373' height='225'

titlebar='true' scrollbars='false' border='true' sysmenu='false'>

skins\default\systemdialog\toomanywnds.htm</dialog>

...

id:
Legt den eindeutigen internen Namen des Dialogs fest.

Folgende IDs finden Sie in der XML Datei:

id='toomanywindows':
Erscheint sobald versucht wird, mehr als 5 Fenster aufzurufen.

id='sabotage':
Erscheint, wenn jemand ständig verbotene Aktionen durchführt (30 Sekunden Tilt-Modus).

id='surfarea':
Erscheint, wenn eine nicht erlaubte URL aufgerufen wird (Surfgebiet eingeschränkt).

id='dialup':
Erscheint, wenn eine Einwahl in das Internet per DFÜ stattfindet.

id='actionforbidden':
Erscheint, wenn eine verbotene Aktion angestossen wurde, z.B. Download aus dem Internet.

id='email-disabled':
Erscheint, wenn die Emailfunktion nicht aktiviert wurde und ein mailto-Link aufgerufen wird.

id='printerpay':
Erscheint, wenn ein kostenpflichtiger Druckauftrag angestossen wird.

id='printerinfojobs':
Erscheint, wenn mehr Druckjobs angestossen wurden als erlaubt sind.

id='printerinfopages':
Erscheint, wenn ein Druckjob mehr Seiten beinhaltet als erlaubt.

id='payment':
erscheint, wenn eine kostenpflichtige Seite aufgerufen wird und nicht genug Guthaben verfügbar ist.

id='lowsurftime':
Erscheint, je nach konfigurierter Zeit, kurz bevor das Guthaben Null beträgt.

id='pullmode':
Erscheint, wenn ein Script mit Pullmode-Funktionen angestossen wird.

id='acos-readerror':
Eerscheint, wenn eine Smartcard nicht ordnungsgemäß vom Smartcard-Leser erkannt wurde. Smartcards werden nur bis SiteKiosk 8.91 unterstützt.

id='acos-nomoney':
Erscheint, wenn das Guthaben auf einer SmartCard Null beträgt. Smartcards werden nur bis SiteKiosk 8.91 unterstützt.

id='avt-inpayment':
Erscheint, wenn eine Geldkarte in einen Geldkartenleser eingeführt wurde. Hinweis: Die Bezahlung per Geldkarte wird nicht mehr unterstützt.

id='avt-status':
Erscheint, wenn der Geldkartenleser nicht ordnungsgemäß initialisiert werden konnte. Hinweis: Die Bezahlung per Geldkarte wird nicht mehr unterstützt.

id='coachblocked':
Erscheint, wenn eine Webseite aufgrund der Filterkriterien vom Content Filter geblockt wurde.

id='discardmoney':
Erscheint, wenn ein Benutzer den Logout-Button drückt und das Restguthaben nicht gutgeschrieben werden kann.

width:
Gibt des Breite des Dialogs an.

height:
Gibt die Höhe des Dialogs an.

titlebar:
Boolescher Wert der festlegt, ob eine Titelzeile sichtbar ist.

scrollbars:
Boolescher Wert der festlegt, ob Laufleisten sichtbar sind.

border:
Boolescher Wert der festlegt, ob ein Dialograhmen sichtbar ist.

sysmenu:
Boolescher Wert der festlegt, ob eine Systemmenü zum Schließen, Verkleinern etc. des Dialogs sichtbar ist.

PreventInput:
Boolescher Wert der festlegt, ob eine Eingabe im Dialog möglich ist. Ähnlich wie beim Sabotage-Modus wird bei der Anzeige eines solchen Dialogs mit dem Wert true der komplette Browser geblockt. D.h., es sind keine Eingaben möglich, solange der Dialog angezeigt wird. Die Dialog sollte dann über Code z.B. nach einer bestimmten Zeit automatisch geschlossen werden.

Closeable:
Boolescher Wert: sofern der Wert false ist, ist es nicht möglich, den Dialog z.B. über das Systemmenü zu schliessen.

CloseOnInput:
Boolescher Wert der festlegt, ob der Dialog geschlossen wird, wenn eine Eingabe im Dialogbereich, z.B. ein Mausklick, erfolgt.

TopMostWindow:
Boolescher Wert der festlegt, ob ein Dialog im Vordergrund bleibt, wenn man z.B. mit der Maus außerhalb des Fensters klickt. Vergleichbar mit dem Verhalten des Taskmanagers von Windows.

Folgende Standardwerte werden automatisch für jeden Dialog gesetzt, wenn die obigen Werte für ein oder alle Attribute nicht definiert wurden:

Width = 400;

Height = 300;

ScrollBars = false;

Titlebar = false;

Border = true;

Sysmenu = true;

PreventInput = false;

CloseOnInput = false;

Closable = true;

TopMostWindow = false;

2.8 traywindow-Element
Das Element gibt die URL der Datei für die Darstellung der Taskbar an.

<traywindow height='28'>skins\default\TrayWindow.html</traywindow>

height:
Legt die Höhe der Taskbar in Pixeln fest.

2.9 mainskin-Element:
Bezieht sich auf Parameter innerhalb des Hauptfensters. Hat keine Auswirkungen auf zusätzlich geöffnete Browserfenster.

...

</mainskin>

Folgende Parameter sind verfügbar:

<source>skins\default\MainWnd.htm</source>

statusbar:
Boolescher Wert: sofern im Skin eine eigene Statusbar mit Handling implementiert ist, sollte der Wert true sein. Besitzt ein Skin keine eigene Statusbar, so kann man den Wert auf false setzen und SiteKiosk blendet eine Standard-Windowsstatusbar ein, die sich um alles kümmert.

progressbar:
Boolescher Wert: sofern im Skin eine eigene Fortschrittsanzeige für das Payment Module implementiert ist, sollte der Wert auf true gesetzt sein. Besitzt ein Skin keine eigene Progressbar, so kann man den Wert auf false setzen und SiteKiosk blendet eine eigene Standard-Fortschrittsanzeige ein, die sich um alles kümmert.

source:
URL zur Datei, die für die Darstellung des Hauptfensters des Browserlayouts verantwortlich ist.

2.10 windowskinless-Element
Sie können in einer SiteKiosk Konfigurationsdatei durch manuelles Editieren der Datei erreichen, dass neue Fenster ohne Skin geladen werden. In dem Fall wird ein Standardfenster angezeigt mit reduzierten Designelementen. Die hierfür notwendigen Einstellungen werden hier vorgenommen. Hinweis: Diese Funktion wird offiziell nicht mehr unterstützt.

...

</windowskinless>

Folgende Parameter sind verfügbar:

<busyanim framedelay='25' imgwidth='65'>skins\default\img\anilogo.png</busyanim>

<toolbar transcolor='16711935'>skins\default\img\ButtonBar.png</toolbar>

busyanim:
Legt die Parameter für die Busy-Animation innerhalb von neuen Fenstern fest, sofern diese ohne Skin angezeigt werden sollen.

toolbar:
Legt die Parameter für die Symbolleiste innerhalb von neuen Fenstern fest, sofern diese ohne Skin angezeigt werden sollen.

2.11 windowskin-Element
Legt die Anzeige-Parameter für neue Fenster innerhalb von SiteKiosk fest.

minwidth:
Legt die Mindestbreite für ein neues Fenster fest.

minheight:
Legt die Mindesthöhe für ein neues Fenster fest.

Folgende Parameter sind innerhalb des windowskin-Elements verfügbar:

<source>skins\default\NewWnd.htm</source>

source:
URL zur Datei, die für die Darstellung von neuen Browserfensters des Browserlayouts verantwortlich ist.

border:
Informationen zur Kalkulation der Maße des Fensterrahmens.

addressbar:
Informationen zur Kalkulation der Maße der Adresszeile.

statusbar:
Informationen zur Kalkulation der Maße der Statuszeile. Die Angabe von true oder false ist zulässig, um zu bestimmen, ob die Angaben bei der Maßkalkulation verwendet werden sollen.

menubar:
Informationen zur Kalkulation der Maße des Menüzeile. Angabe erfolgt nur aus Kompatibilitätsgründen. Die Werte sollten bei 0 belassen werden.

toolbar:
Informationen zur Kalkulation der Maße der Werkzeugleiste.

2.12 confightml-Element
Gibt den Pfad zur Datei an, die für die Darstellung des Anpassen-Dialogs für das Browserlayout im Konfigurationstool von SiteKiosk genutzt wird. Die Angabe ist optional und nur notwendig, wenn ein Anpassen-Dialog genutzt werden soll.

<confightml>skins\default\defaultconfig.html</confightml>

Bitte beachten Sie:
Seit den aktuellsten SiteKiosk 8 Versionen befindet sich die Html-Datei für den Anpassen-Dialog in dem Ordner ..\SiteKiosk\ConfigServer\Web\HtmlConfig und dann entweder in dem Unterordner Skins oder Startpages. Die Pfadangabe für das confightml-Element ist relativ zu dem Web-Ordner und muss daher so aussehen:

<confightml>HtmlConfig\Skins\Skinname.html</confightml>