Personnalisation de la barre de navigation

Vous pouvez éditer les fichiers qui contrôlent le contenu de la barre de navigation d'IBM® Connections pour accroître ses fonctionnalités. Par exemple, vous pouvez ajouter des liens supplémentaires à la barre de navigation, supprimer le lien Déconnexion, ou insérer des menus déroulants supplémentaires.

Procédure

Facultatif : Activez la fonction de débogage de personnalisation. Pour plus d'informations, voir Activation et désactivation du débogage de la personnalisation.
Pour ajouter un lien à la liste des liens de la barre de navigation, par exemple un lien intitulé Logiciel IBM renvoyant vers ce site Web, procédez comme suit :
1. Faites une copie du fichier header.jsp qui définit le contenu de la barre de navigation principale. Vous pouvez accéder au fichier à partir du répertoire suivant :
  nom_application.war/nav/templates
  Pour connaître l'emplacement des répertoires source d'application Web fournis avec IBM Connections, reportez-vous à la rubrique Fichiers WAR d'application et bundles OSGi.
  
  Le fichier header.jsp est le même pour chaque application ; il vous suffit donc de faire une copie d'un des fichiers header.jsp.
  Remarque : Vous pouvez être amené à copier vos modifications d'en-tête dans les fichiers login.jsp et error.jsp pour garantir la cohérence dans votre déploiement. Pour plus d'informations, voir Personnalisation de la page de connexion et Personnalisation de la page d'erreur.
2. Collez la copie du fichier header.jsp dans le sous-répertoire approprié du répertoire de personnalisation, de préférence le répertoire common. Pour plus de détails sur les sous-répertoires de personnalisation, voir Détermination de l'emplacement de sauvegarde de vos personnalisations.
  Par exemple, pour modifier l'apparence de la barre de navigation dans toutes les applications, copiez le fichier dans le répertoire suivant :
  rép_personnalisation/common/nav/templates
3. Ouvrez la copie du fichier header.jsp dans un éditeur de texte et recherchez la section suivante :
```
Links to each installed application are displayed here. To add a link to another website, add the following markup: 
   <li>
      <a href="http://mycompany.com/link">My Company Site</a>
   </li>
to the end of the following <UL>. This section replaces the macro "{{application links: li }}" in the previous version of the header.
```
4. Ajoutez le code HTML ci-dessous avant la balise </ul> fermante :
```
<li><a href="http://www.ibm.com" title="IBM website">IBM website/a></li>
```
5. Après avoir effectué vos mises à jour, enregistrez et fermez la copie du fichier header.jsp. Il n'est pas nécessaire de redémarrer les applications pour voir l'affichage des liens.
Si vous voulez supprimer le lien Déconnexion du menu déroulant, par exemple, lorsque la connexion unique est activée, vous pouvez empêcher l'affichage du lien en éditant l'élément logoutContainer dans le fichier user.jsp :
1. Copiez le fichier user.jsp depuis nom_application.war/nav/templates/menu/ vers l'emplacement suivant :
  rép_personnalisation/common/nav/templates/menu/user.jsp
2. Modifiez la ligne suivante dans le fichier copié pour ajouter un style lotusHidden :
```
--%><td class="lotusNowrap lotusHidden" id="logoutContainer"</><%--
```
3. Enregistrez et fermez le fichier user.jsp personnalisé.
Pour ajouter un nouveau menu déroulant, procédez comme suit :
1. Copiez le fichier user.jsp depuis nom_application.war/nav/templates/menu/ vers l'emplacement suivant :
  rép_personnalisation/common/nav/templates/menu/user.jsp
2. Copiez l'une des sections de menu existantes et modifiez l'attribut "src" pour qu'il pointe vers un servlet, une page JSP ou une page HTML statique contenant le marquage que vous souhaitez utiliser. Veillez à modifier l'ID du nouvel élément pour éviter d'avoir des ID en double sur la page.
  Exemple :
```
<tr role="menuitem">
   <td class="lotusNowrap" id="logoutContainer">
       <a href="http://www.ibm.com">IBM Homepage</a>
   </td>
</tr>
```
3. Enregistrez et fermez le fichier user.jsp personnalisé.

Pour apporter des modifications aux menus Communautés, Profils, et Applications, copiez ou supprimez les sections de code correspondant à l'affichage des liens dans les fichiers JSP respectifs :

Copiez un fichier de menu à partir de l'un des emplacements suivants :
- Menu Profils : nom_application.war/nav/templates/menu/people.jsp
- Menu Communautés : nom_application.war/nav/templates/menu/communities.jsp
- Menu Applications : nom_application.war/nav/templates/menu/apps.jsp
Collez le fichier copié dans le répertoire suivant :
rép_personnalisation/common/nav/templates/menu/
Ouvrez le fichier copié dans un éditeur de texte et effectuez vos modifications.
Enregistrez et fermez le fichier personnalisé.

Remarque : Le menu Apps est toujours visible par défaut. Si vous supprimez toutes les applications qui sont répertoriées dans ce menu, vous devez également mettre en commentaire cette section dans le fichier header.jsp :

<li id="lotusBannerApps" class="<c:if test="${first}">lotusFirst</c:if> <c:if test="${'communities' != appName && 'profiles' != appName && 'homepage' != appName}">lotusSelected</c:if>"><%-- 
            --%><a onmouseover="dojo.require('lconn.core.header');lconn.core.header.menuMouseover(this);" 
                   onclick="dojo.require('lconn.core.header');lconn.core.header.menuClick(this);" 
                   onfocus="dojo.require('lconn.core.header');lconn.core.header.menuFocus(this);" 
                   role="button" 
                   _lconn_menuid="lconnheadermenu-apps"
                   aria-label="<fmt:message key="label.menu.apps.name" />" 
                   src="<lc-cache:uri template="{staticLanguageRoot}/nav/templates/menu/apps.jsp" />"
                   href="javascript:;"
                   errormessage="<fmt:message key="${appName}.error.unavailable.title" />"><%-- 
                
                --%><fmt:message key="label.menu.apps.name" /><%-- 
                --%> <img role="presentation" alt="" src="<lc-ui:blankGif />" class="lotusArrow lotusDropDownSprite"><span class="lotusAltText">&#9660;</span><%--
                
             --%></a><%-- 
         --%>
</li>

Facultatif : Si vous avez activé le débogage de personnalisation à l'étape 1, désactivez cette fonction lorsque vous êtes prêt à publier vos modifications. Testez l'ajout de vos modifications en redémarrant les applications et en actualisant le navigateur Web. L'actualisation du navigateur fera apparaître uniquement vos modifications si le débogage est activé. Pour plus de détails, voir Activation et désactivation du débogage de la personnalisation.
Pour savoir comment mettre à jour l'horodatage de version du produit et vérifier que vos utilisateurs voient les modifications lors de la prochaine connexion à IBM Connections, voir Etape post-personnalisation requise.