Diseños Navegador - Ayuda-SiteKiosk

El archivo de definición XML para diseños de navegador contiene toda la información necesaria para usar un diseño de navegador (skin).

Por favor, tenga en cuenta:
Es preciso algún conocimiento básico para crear un nuevo diseño de navegador. Por razones obvias no podemos (aparte de esta documentación) proporcionar soporte gratuito para crear sus skins personalizados.

1. Estructura General del Archivo de Definición

La estructura del archivo de definición depende el Skin específico.

Ruta de acceso al archivo de definición para el Default Skin:
directorio-de-instalacion-de-SiteKiosk/Skins/Default/DefaultSkindef.xml

El siguiente extracto contiene los elementos más importantes del archivo:

<touchscreen>TX82-Ultra English (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. Los Elementos y Atrbituos del Achivo de Definición

2.1 Elemento skindef
Cada elemento de un diseño de navegador se divide en una sección skindef con varias secciones subskindef.

...

</subskindef>

</skindef>

name:
Define el nombre de un Skin. El contenido de este atributo se muestra en la configuración de SiteKiosk. El atributo name debe ser único para cada diseño.

languages-selectable:
Variable booleana que especifica si la opción de selección de idiomas del Skin está habilitado(true) o deshabilitado (false).

2.2 Elemento touchscreen

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

No implementado completamente.

2.3 Elemento stringtable
Especifica la ruta de acceso al archivo XML de tabla de strings (cadenas o textos).

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

En el archivo stringtable.xml, encontrará todos los ajustes relacionados. Puede encontrar más información aquí.

2.4 Elemento languageoption
Define los idiomas existentes seleccionables en la configuración del diseño de navegador.

id:
El idendificador ID define todos los idiomas disponibles.

Los IDs de los idiomas son los siguientes:

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:
Se define desde el idioma del sistema operativo y si el idioma no está soportado por SiteKiosk (ej: Swahili), entonces se utilizará el idioma por defecto automáticamente.

2.5 Elemento subskindef
Bajo los elementos subskindef, se incluye un grupo de elementos relacionados.

...

</subskindef>

name:
Especifica el nombre de subskindef. El nombre debe ser único.

language='id':
Hay dos soluciones posibles para mostrar el idioma:

Solución 1: Crear un subskindef con <em>language="0"</em>. En este caso, se mostrará el mismo diálogo independientemente al idioma. El texto sólo se mostrará según se indique en la tabla de strings en el idioma seleccionado. El skin por defecto funciona según este principio.

Solución 2: Crear su propio subskindef de idioma (language=<em>"[language-id]"</em>). Esto le da la posibilidad de mostrar todos los diálogos (ver id dialogue) y diseños de navegador dependiendo del idioma. Para otros idiomas la solución 1 es una alternativa, por ejemplo cuando un idioma tiene reglas de visualización completamente distinta, como el Chino o el Hebreo.

2.6 Elemento url
Define varias URLs predefinidas para un Skin. Esta información es opcional y puede omitirse si las URLs correspondientes no necesitan un diseño de navegador.

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

...

id='emailbutton':
Define la URL que se llama cuando se hace clic en el botón de correo electrónico de la barra de tareas.

id='emailnav':
Define la URL que se llama cuando el usuario hace clic en enlace mailto (dirección email) o el botón email.

id='mediamail':
Define la URL que se llama cuando se presiona el botón de WebCam de la barra de tareas. Oficialmente ya no es soportado a partir del SiteKiosk 9.0.

id='applications':
Define la URL que se llama cuando se preciona el botón Programas desde la barra de tareas.

id='naverror':
Define la URL que se llama cuando falla una navegación en el navegador de SiteKiosk.

2.7 Elemento dialog
El elemento dialog define la URL de una variedad de diálogos del diseño del Skin, por ejemplo el diálogo que aparece cuando se abren demasiadas ventanas.

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

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

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

...

id:
Define un nombre único para el diálogo.

En el archivo XML se encuentran los siguientes IDs:

id='toomanywindows':
Se muestra cuando existen más de 5 ventanas (por defecto) abiertas.

id='sabotage':
Aparece cuando alguien realiza acciones prohibidas de forma repetida (30 segundos Tilt Mode).

id='surfarea':
Se muestra cuando se llama a una URL no permitida (según las reglas del Área de Navegación).

id='dialup':
Se muestra cuando se realiza una conexión de marcado telefónico.

id='actionforbidden':
Se muestra cuando tiene lugar una acción no autorizada como una descarga.

id='email-disabled':
Se muestra cuando la función de correo electrónico no está activo y se llama a un enlace mailto-Link is called.

id='printerpay':
Se muestra cuando se llama un trabajo de trabajo de impresión sujeto a cargo.

id='printerinfojobs':
Se muestra cuanto el trabajo de impresión se permite.

id='printerinfopages':
Se muestra cuando el trabajo de impresión contiene más páginas de las permitidas.

id='payment':
Se muestra cuando se llama a una página o servicio sujeto a cargo y no existe suficiente crédito.

id='lowsurftime':
Se muestra según el varlo de tiempo configurado, avisando del crédito próximo a agotarse.

id='pullmode':
Se muestra cuando se llama un script con la función pullmode.

id='acos-readerror':
Se muestra cuando no se reconoce una smart card por el lector de smar cards.

id='acos-nomoney':
Se muestra cuando el crédito de una smart card está próximo a agotarse.

id='avt-inpayment':
Se muestra cuando una tarjeta money card se inserta en al lector correspondiente. Aviso: los pagos mediante tarjetas money card ya no se soportan.

id='avt-status':
Se muestra cuando un lector money card no se inicializa correctamente. Aviso: ya no se soportan los pagos con tarjetas money card.

id='coachblocked':
Se muestra se bloquea un sitio está dentro de los criterios filtrador por el filtro de contenidos.

id='discardmoney':
Se muestra cuando un usuario hace clc en el botón de cerrar sesión / terminal y el crédito restante va a ser descargado.

width:
El ancho del cuadro de diálogo.

height:
La altura del cuadro de diálogo.

titlebar:
Variable booleana que define si la barra de título es visible o no.

scrollbars:
Variable booleana que define si las barras de desplazamiento son visiibles o no.

border:
Variable booleana que defini si el borde es visible o no.

sysmenu:
Variable boolena que especifica si el menú de sistema para cerrar, minimizar, etc. es visible.

PreventInput:
Varibable booleana que especifica si son posibles o no entradas en el cuadro de diálogo. De forma similar al modo sabotaje cuando el diálogo se muestra con un valor true (verdadero) el navegador se bloqueará. No es posible ninguna entrada hasta que se muestre el cuadro de diálogo. El diálogo debería cerrarse posteriormente por un script después de un intervalo de tiempo.

Closeable:
Variba booleana que cuando está establecida como false, no es posible cerrar el cuadro de diálogo. El menú de sistema no cerrará el diálogo.

CloseOnInput:
Valor booleano que especifica si un diálogo es cerrado cuando existe una entrada en el cuadro de diálogo, por ejemplo un clic de ratón.

TopMostWindow:
Valor boolleano que especifica si un diálogo debe estar siempre en primer plano, por ejemplo cuando se pulsa en un área fuera de la ventana. El comportamiento del Gestor de Tareas de Windows es similar.

Los siguientes valores por defecto se establecen automáticamente para cualquier diálogo si no se especifica ningún otro valor distinto en algún atributo:

Width = 400;

Height = 300;

ScrollBars = false;

Titlebar = false;

Border = true;

Sysmenu = true;

PreventInput = false;

CloseOnInput = false;

Closable = true;

TopMostWindow = false;

2.8 traywindow-Element
Este elemento especifica la URL del archivo para mostrar la barra de tareas.

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

height:
Especifica la altura de la barra de tareas en píxeles.

2.9 mainskin-Element:
Se refiere a los parámetros dentro de la ventana principal. No tiene ningún efecto en abrir ventanas adicionales del navegador.

...

</mainskin>

Los siguientes parámetros están disponibles:

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

statusbar:
Variable booleana que si se utiliza con un skin que tiene su propia barra de estado, el valor debería ser true (verdadero). Si el skin no tiene su propia barra de estado, puede establecer el valor a false (falso) y SiteKiosk mostrará una barra de estado estándar de Windows.

progressbar:
Variable booleana que si se utiliza mostrará una barra de progreso para el módulo payment cuando se define el valor como true (verdadero). Si un Skin no tiene una barra de progreso, puede establecer el valor como false (falso) y SiteKiosk mostrará una barra estándar de progreso.

source:
URL responsable de mostrar la ventana principal del diseño de navegador.

2.10 Elemento windowskinless
Puede acceder a este valor desde el archivo de configuración de SiteKiosk editándolo manualmente para que las ventanas se carguen sin un skin. En este caso se mostrará una ventana estándar reducida sin elementos de diseño. La configuración se realiza aquí. Aviso: esta función ya no está soportada oficialmente en las últimas versiones.

...

</windowskinless>

Los siguientes parámetros están disponibles:

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

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

busyanim:
Define los parámetros para la animación de ocupado si se muestra una ventana sin un Skin.

toolbar:
Define los parámetros de los elementos de una barra de tareas si una ventana se abre sin Skin.

2.11 Elemento windowskin
Define los parámetros de una nueva ventana.

minwidth:
Define el el ancho mínimo de una nueva ventana.

minheight:
Define la altura mínima de una nueva ventana.

Los siguientes elementos están disponibles en el elemento windowskin:

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

source:
URL responsable de mostrar las nuevas ventanas de navegador para el diseño de navegador.

border:
Información para calcular las dimensiones del marco de la ventana.

addressbar:
Información para calcular las dimensiones de la barra de direcciones.

statusbar:
La indicación de verdadero o falso (true / false) determina si la información será utilizada en el cálculo.

menubar:
Información para calcular las dimensiones de la barra de menú. Información sólo proporcionada por motivos de compativilidad. El valor debería dejarse en 0.

toolbar:
Información para calcular las dimensiones de la barra de herramientas.

2.12 Elemento confightml
Especifica la ruta de acceso al archivo que se utiliza para mostrar el cuadro de diálogo Personalizar en el Asistente de Configuración de SiteKiosk. Esta información es opcional y sólo es necesario si el botón Personalizar debe utilizarse.

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

Por favor tenga en cuenta:
Desde las últimas versiones de SiteKiosk 8 el archivo HTML para el dialogo personalizar se encuentra en la carpeta ..\SiteKiosk\ConfigServer\Web\HtmlConfig y despues en la subcarpeta Skins o Startpages. La especificación de la ruta para el elemento confightml es relative a la carpeta web y debe tener este aspecto:

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

Puede utilizar el archivo de uno de los diseños descargables como plantilla.