HowTo cambiar apariencia de o3portal

Objetivo:

Cambiar colores del portal en la página de ingreso y página de marcadores.

A partir de la versión 5 se implementó para facilitar el cambio de colores y otro cambios de L&F la idea de temas.
En este tutorial explicaremos como cambiar de tema, eligiendo algunos de los prearmados o definiendo uno propio, y personalizar el portal.

Consideraciones previas

Este documento es válido para versiones 5.1.xxx en adelante
Tener conocimientos básicos de CSS
Recomendamos el uso de Firefox junto con el complento Firebug. La combinación facilita el desarrollo de temas en dos aspectos: i) inspeccionar la página web del portal para encontrar el estilo CSS que se debe modificar, ii) modificar directamente la página para probar una modificación de estilo CSS.

Temas pre armados

La instalación de O3PS prevee los siguiente temas por defecto:

red	blue	green	grey

red es el tema por defecto.

para cambiar a otro tema basta con agregar un nuevo archivo GServer_custom.properties con una property (puede ser en cualquier lugar, por ej: al final del archivo), en <o3>/jboss/server/default/ideasoft-o3/GServer_custom.properties, siendo alguna de las siguientes:

ideasoft.themes.defaultTheme = blue
ideasoft.themes.defaultTheme = green
ideasoft.themes.defaultTheme = red
ideasoft.themes.defaultTheme = grey

Advertencia!

Para los temas pre armados se debe respetar el uso de mayúsculas y minúsculas. La herramienta es Case Sensitive.

Reiniciar Jboss

Una vez que se hizo ésto el cambio a otro tema prearmado consisten en cambiar el nombre del color en el archivo .properties y refrescar (no es necesario reiniciar el jboss)

Creando un nuevo tema : Violeta

A lo efectos de ejemplificar el proceso vamos a crear un nuevo tema que se llamará Violeta.

Pasos a seguir:

Copiar la carpeta <o3>/jboss/server/default/deploy/gserver/0o3.ear/o3portal.war/themes/red en el mismo lugar y la re nombramos como Violeta.
Copiar la carpeta <o3>/jboss/server/default/deploy/gserver/0o3.ear/o3cas.war/themes/red en el mismo lugar y la re nombramos como Violeta.
Avisarle al O3Server que use este nuevo tema, para ello en <o3>/jboss/server/default/ideasoft-o3/GServer_custom.propertiesagregamos la siguiente property
```
ideasoft.themes.defaultTheme = Violeta
```
Cambiar al nuevo nombre los css, en:

<o3>/jboss/server/default/deploy/gserver/0o3.ear/o3portal.war/themes/Violeta/common/css copiar el archivo red.css y re nombrarlo como Violeta.css
Cambiar las clases dentro de Violeta.css. Editemos Violeta.css y cambiamos todos los .red por .Violeta
<o3>/jboss/server/default/deploy/gserver/0o3.ear/o3portal.war/themes/Violeta/jdesktop/css modificar el nombre red.css por Violeta.css
Cambiar las clases dentro de Violeta.css. Editemos Violeta.css y cambiamos todos los .red por .Violeta

Si seguimos estos pasos habremos creado un nuevo tema Violeta. Vemos ahora como cambiar algunos estilos

Cambiando estilos en el nuevo tema

Como podemos ver la carpeta de temas tiene varias sub carpetas que ordenan y facilitan los cambios. En su mayoría lo que contienen son las imágenes correspondientes.

El archivo más importante es <o3>/jboss/server/default/deploy/gserver/0o3.ear/o3portal.war/themes/Violeta/common/css/Violeta.css, en el tenemos la mayoria de estilos que se aplicarán al o3portal.

El otro archivo importante es <o3>/jboss/server/default/deploy/gserver/0o3.ear/o3portal.war/themes/Violeta/jdesktop/css/common/Violeta.css, donde tenemos la mayoría de los estilos que controlan al portal un vez que abrimos un cubo.

Reiniciar Jboss