<WRAP centeralign><font 28px/inherit;;inherit;;inherit>**__Web Menu__**</font> </WRAP>

====== 1. Introduzione ======

La presente guida spiega come installare una pagina sul web server, contenente un menu per poter avviare varie applicazioni interne o esterne al server locale.

Il menu è dotato di una password per evitare l'utilizzo indesiderato ed è ottimizzato per dispositivi mobili.

il pacchetto contenente il software si può scaricare cliccando sul link seguente [[https://www.dropbox.com/s/zurjj3v3uruydoz/menu.tar?dl=0|{{:img_menu:download.png?nolink&100x41}}]]


====== 2. Installazione e configurazione ======

===== 2.1. Installazione del software =====

Scaricato il software, copiare il file menu.tar sulla radice del web server

<WRAP important>\\
Attenzione che sulla directory non sia presente alcun file "index", se presente bisogna capire a cosa serva e se si può eliminare o se deve essere integrato in qualche modo\\
</WRAP>

Portarsi sulla directory www del web server ed estrarre i file

<code>
sudo -s
cd /var/www
tar -xf menu.tar
rm -v menu.tar
chown -vR www-data:www-data menu
chmod -vR 775 menu
</code>

L'installazione ha creato:

- un nuovo file index.php che serve ad avviare il menu\\
- una cartella menu con tutti i file necessari al funzionamento

A questo punto il software è installato e funzionante, per avviare il menu basta digitare su un browser qualsiasi l'indirizzo del webserver o l'IP pubblico per aprire il menu. Al primo accesso viene richiesto di inserire la password che di default è:

<WRAP important>\\
<font 20px/inherit;;inherit;;inherit>**123456**</font>\\
</WRAP>

da cambiare immediatamente. La password, una volta inserita, rimane memorizzata per 7 giorni (eventualmente si può cambiare) dopo di che serve reinserirla, questo per evitare inutili reinserimenti quando si stà lavorando sul server, in ogni caso facendo il "Logout" (cliccando su "Esci") la password viene cancellata.

L'inserimento della password si può fare in due modi:

  - utilizzando il tastierino a video, in questo modo raggiunta la lunghezza della password automaticamente il programma procede con il login
  - mediante l'inserimento sulla label superiore usando la tastiera, in questo caso, digitata la password è necessario cliccare si "Entra"


===== 2.2. Configurazione =====

Aperto il menu

{{  :img_menu:menu-01.png?nolink&300  }}

cliccare sull'ultima riga di menu per aprire la finestra di configurazione principale

{{  :img_menu:menu-02.png?nolink&300x350  }}modificare i valori a piacimento facendo attenzione a far corrispondere la lunghezza della password con il numero di caratteri, alla fine cliccare su "Salva dati"

==== 2.2.1. Modifica voci di menu ====

Per modificare le voci di menu si deve editare il file "menu.php", ogni riga di menu è gestita dal seguente blocco di codice

<code>
<li>
   <a href="../123solar" target="_blank">
   <img src="images/1.png">
   <h2>123solar</h2></a>
</li>
</code>

//**il tag "href"**// indica la posizione e/o il file da aprire, la posizione deve essere relativa alla posizione del file menu.php, nell'esempio si accede alla directory di 123solar che si trova un livello più sotto rispetto al file menu.php

**//il tag "img"//** indica l'icona da utilizzare sulla voce di menu, le immagini vanno salvate all'interno della directory "images" devono essere:
  * in formato png
  * dimensione 80×80 pixel
  * risoluzione 72×72 ppi

**//il tag "h2" //**indica la voce di menu da visualizzare

Se si desidera aggiungere ulteriori voci di menu basta inserire un blocco nella posizione desiderata