Personalizzazione della barra di navigazione

È possibile modificare i file che controllano il contenuto della barra di navigazione di IBM® Connections per aggiungere funzionalità alla barra. Ad esempio, è possibile aggiungere altri link nella barra di navigazione, rimuovere il link Log Out o inserire altri menu a discesa.

Procedura

Opzionale: Attivare la funzionalità di debug per la personalizzazione. Per ulteriori informazioni, consultare Abilitazione e disabilitazione del debug per la personalizzazione.
Per aggiungere un link all'elenco di link nella barra di navigazione, ad esempio un link denominato "software IBM" che si collega al sito Web, effettuare le seguenti operazioni:
1. Effettuare una copia del file header.jsp che definisce il contenuto della barra di navigazione principale. È possibile accedere al file dalla seguente directory:
  nome_applicazione.war/nav/templates
  Per informazioni utili per reperire le directory di origine dell'applicazione Web contenute in IBM Connections, consultare File WAR e bundle OSGi dell'applicazione.
  
  Il file header.jsp è lo stesso per ogni applicazione, per cui basta effettuare una copia di uno dei file header.jsp.
  Nota: potrebbe essere opportuno copiare le modifiche delle intestazioni nei file login.jsp e error.jsp per motivi di congruenza in tutta la distribuzione. Per ulteriori informazioni, consultare Personalizzazione della pagina di login e Personalizzazione della pagina degli errori.
2. Incollare la copia del file header.jsp nella sottodirectory appropriata nella directory delle personalizzazioni, che generalmente è la directory common. Per ulteriori dettagli sulle sottodirectory delle personalizzazioni, consultare Determinare la posizione di salvataggio delle personalizzazioni.
  Ad esempio, per modificare l'aspetto della barra di navigazione in tutte le applicazioni, copiare in file nella seguente directory:
  customizationDir/common/nav/templates
3. Aprire la copia del file header.jsp in un editor di testo e cercare la sezione seguente:
```
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. Aggiungere il seguente codice HTML prima della chiusura del tag </ul>:
```
<li><a href="http://www.ibm.com" title="IBM website">IBM website/a></li>
```
5. Al termine degli aggiornamenti, salvare e chiudere la copia del file header.jsp. Non è necessario riavviare le applicazioni per visualizzare i link.
Per rimuovere il link Log Out dal menu a discesa, ad esempio, quando è abilitato SSO (single sign-on is), è possibile evitare la visualizzazione del link modificando l'elemento logoutContainer nel file user.jsp:
1. Copiare il file user.jsp da nome_applicazione.war/nav/templates/menu/ nella posizione seguente:
  customizationDir/common/nav/templates/menu/user.jsp
2. Modificare la riga seguente nel file copiato per aggiungere un stile lotusHidden:
```
--%><td class="lotusNowrap lotusHidden" id="logoutContainer"</><%--
```
3. Salvare e chiudere il file user.jsp personalizzato.
Per aggiungere un nuovo menu a discesa, effettuare le seguenti operazioni:
1. Copiare il file user.jsp da nome_applicazione.war/nav/templates/menu/ nella posizione seguente:
  customizationDir/common/nav/templates/menu/user.jsp
2. Copiare una delle sezioni del menu esistenti e modificare l'attributo "src" in modo che faccia riferimento a un servlet, JSP o una pagina HTML statica contenente la markup da utilizzare. Accertarsi di modificare l'ID del nuovo elemento per evitare la duplicazione di ID nella pagina.
  Esempio:
```
<tr role="menuitem">
   <td class="lotusNowrap" id="logoutContainer">
       <a href="http://www.ibm.com">IBM Homepage</a>
   </td>
</tr>
```
3. Salvare e chiudere il file user.jsp personalizzato.

Per apportare modifiche ai menu Comunità, Profili e App, copiare o rimuovere sezioni di codice per rappresentare i link nei rispettivi file JSP:

Copiare uno dei file dei menu dalle seguenti posizioni:
- Menu Profili: nome_applicazione.war/nav/templates/menu/people.jsp
- Menu Comunità: nome_applicazione.war/nav/templates/menu/communities.jsp
- Menu App: nome_applicazione.war/nav/templates/menu/apps.jsp
Incollare il file copiato nella seguente directory:
customizationDir/common/nav/templates/menu/
Aprire il file copiato in un editor di testo e apportare le modifiche.
Salvare e chiudere il file personalizzato.

Nota: il menu App è sempre visibile per impostazione predefinita. Se si rimuovono tutte le applicazioni elencate in questo meno, è necessario togliere i simboli di commento a questa sezione nel file 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>

Opzionale: Se è stato abilitato il debug per la personalizzazione nel passaggio 1, disattivare questa funzionalità una volta pronti a pubblicare le modifiche. Controllare se le modifiche sono state aggiunge correttamente riavviando le applicazioni e aggiornando il browser Web. L'aggiornamento del browser mostra le modifiche solo se il debug è attivato. Per ulteriori dettagli, consultare Abilitazione e disabilitazione del debug per la personalizzazione.
Consultare Operazione post-personalizzazione per informazioni sull'aggiornamento della data/ora della versione del prodotto e sull'accertamento che gli utenti visualizzino le modifiche al successivo accesso a IBM Connections.