:: Alfresco. Crear un tema en la versión 5

A menudo en los proyectos de implantación de alfresco se hace necesaria una personalización de la interfaz del gestor documental para adaptarla a la línea gráfica del cliente.

Por este motivo para llevar a cabo esta adaptación realizaremos una serie de pasos.

Creación de un tema

Para llevar a cabo la creación de un nuevo tema, partiremos de uno ya disponible. Para ello copiamos por ejemplo la carpeta: "greenTheme" ubicado en: "${alfresco}\tomcat\webapps\share\themes".

Renombramos esta carpeta greenTheme al nombre de nuestro tema, por ejemplo: "netic360Theme".
En el fichero "presentation.css" y skin.css sustituiremos el literal "-greenTheme" por "-netic360Theme".
Además en la carpeta : "images" modificaremos todas aquellas que sea necesario, manteniendo su nombre para no tener que llevar a cabo modificaciones adicionales.

Estructura del fichero .AMP

La estructura del fichero AMP correspondiente al tema es la siguiente:
module.properties
file-mapping.properties
config
     alfresco
          site-data
               themes
                    netic360.xml
web
     favicon.ico
     componentes
          images
               alfresco-share-logo.png
               alfresco-logo-bg.png
     modules
         images
              about-bg.png
     themes
          netic360
               presentation.css
               images
               yui
                    assets  

module.properties: Se definen una serie de propiedades del tema que estamos creando. Además en este fichero se podrían establecer las versiones máximas y mínimas de Alfresco para el que es válido este tema.
El contenido de este fichero podría ser algo similar a lo siguiente:

# Netic360 Theme module properties
module.id=org.alfresco.module.netic360
module.version=0.1
module.title=Alfresco Share Netic360 Theme
module.description=Alfresco Share Netic360 Theme

file-mapping.properties: Fichero donde se mapea la estructura que tendrá el fichero .AMP
Podría ser algo similar a lo siguiente:

###Netic360
include.default=true

/web=/
/config=/WEB-INF/classes/

La línea "include.default=true" indica que la estructura del fichero .AMP es la establecida por defecto.

netic360.xml: Fichero necesario donde se define el literal que aparecerá al seleccionar el tema a aplicar.
El contenido de este fichero es XML es el siguiente:

< ?xml version='1.0' encoding='UTF-8'? >
< theme >
    < title >Netic360< /title >
< /theme >

favicon.ico: Representará el favicon de nuestro Alfresco ya que lo sobreescribiremos en el momento de desplegar el fichero .amp

alfresco-logo-bg.png: Imagen a mostrar como fondo de página en el control de acceso. La renombramos de esta manera para no tener que llevar a cabo modificaciones adicionales

alfresco-share-logo.png: Imagen a mostrar en el pie de página. La renombraremos de esta manera para no tener que llevar a cabo modificaciones adicionales

about-bg.png: Imagen que se mostrará como fondo en el "Acerca de" de la aplicación

Dentro de la carpeta "web>themes>netic360" se encuentra la estructura del tema del que partimos por lo que modificaremos todas aquellas imágenes que sea necesario.
Otro de los ficheros principales a modificar es:
presentacion.css: Fichero donde se definen los estilos para los distintos elementos del tema que nos ocupa

Como desplegar un fichero AMP

Para desplegar el tema que hemos creado de acuerdo a la estructura anteriormente descrita, ejecutamos la sentencia:

"java –jar  alfresco-mmt.jar netic360-theme.amp share.war –verbose"

Puede que sea posible utilizar la opción -force para "forzar" sobrescribir los ficheros necesarios.

Posteriormente tendremos que llevar a cabo otras modificaciones para personalizar el "Acerca de", el pie de las páginas, etcétera, pero el fichero AMP básico correspondiente a la definición de un tema es el descrito anteriormente.