Look du portail

Le look du portail peut être modifié en agissant sur trois partie :

• Les images : icones, bandeau, etc ...
• La CSS : couleurs, police, disposition des zones
• La XSL : pour des modification de structure HTML

Le portail fonctionne avec un mécanisme de skin, on peut avoir plusieur skin disponible dans le portail et l'utilisateur puet choisir celui qu'il désiré utiliser.
Les images et la CSS se trouve inclus dans le skin.

Les SKINS 

Ils se trouve dans le dossier uPortal/webpages/media/org/jasig/portal/layout/tab-column/xhtml-theme

Le dossier contenant le skin doit se nommé du nom du skin.
Par exemple le skin esup de base dans le package : uPortal/webpages/media/org/jasig/portal/layout/tab-column/xhtml-theme/esup

Le skin se découpe comme suit :

•  [SKIN_NAME]

  • controls : images des boutons de controle dans la XSL (focus, supprimer un canal, etc ...)
  • institutional : plus orienté sur les bandeau institutionnel
  • navigation : images servant a la navigation (onglet, liste de canaux, etc ...)
  • skin

    • [SKIN_NAME].css : css du skin

    • [SKIN_NAME]_thumb.gif : image miniature utilisé lors du choix du skin

Découpage de la page

 Voici le découpage des zone HTML de la base (pour vous faciliter la compréhension des style)

1. BODY
   1. portal-page-header
      1. logo
      2. welcome (bandeau de lien en haut a droite)
      3. tabs (les onglets)
   2. portal-page-body
      1. preference-items (bandeau des préférences)
      2. columns-table
         1. colonne_sAAA

1. 1. 1. 1. 1. portlet_nXXX
               1. toolbar_nXXX
               2. portletContent_nXXX
            2. portlet_nYYY
               1. toolbar_nYYY
               2. portletContent_nYYY
         2. colonne_sBBB
            1. portlet_nZZZ
               1. toolbar_nZZZ
               2. portletContent_nZZZ
   2. portal-page-footer
      1. pied de page

Déclarer le skin

Pour que le portail connaisse le skin il faut le déclarer dans le fichier Portal/webpages/media/org/jasig/portal/layout/tab-column/xhtml-theme/skinList.xml

<?xml version="1.0"?>

<skins>
  <skin>
    <skin>[SKIN_NAME]</skin>
    <skin-name>[NOM AFFICHE A L'UTILISATEUR]</skin-name>
    <skin-description>[DESCRIPTION AFFICHE A L'UTILISATEUR]</skin-description>
  </skin>

La XSL

Si vous voulez modifier la structure de la page (HTML) vous devez modifier la XSL de rendu du portail.

Ellle se trouve dans uPortal/webpages/stylesheets/org/esupportail/portal/layout/tab-column/xhtml-theme/xhtml-theme.xsl

Si vous venez a la modifier faite attention a conserver la tag de remplacement utilisé par le package (<title>@esup.title.html@</title>)