## Aiuto

### Presa in mano rapida

1. Creare una directory locale chiamandola, ad esempio, "prova_categoria".
2. Copiare le Vostre immagini nella directory "prova_categoria".
3. Aprire una connessione FTP con la galleria remota.
4. Caricare la directory locale "prova_categoria" nella vostra directory "galleries" remota. Impostare i diritti di accesso a 777 sulla nuova directory caricata "galleries/prova_categoria".
5. Accedete alla vostra Piwigo come amministratore.
6. Andare su Amministrazione -> Immagini -> Miniature. Piwigo troverà le immagini nella directory "prova_categoria" senza miniature e chiederà di crearle.
7. Andare su Amministrazione -> Generale -> Sincronizza. Selezionare l'opzione "directory + file", deselezionare "effettuare solo una simulazione" ed avviare la sincronizzazione.
8. Fatto!!! Avete creato una categoria chiamata "prova_categoria" alla base della Vostra galleria.

### Aggiungere gli elementi

- Nella directory "galleries" si trovano le categorie di Piwigo. Qui di seguito potete vedere lo schema di un albero di una piccola galleria (ma che usa moltissime funzionalità:

      .
      |-- admin
      |-- doc
      |-- galleries
      |   |-- categoria-1
      |   |   |-- categoria-1.1
      |   |   |   |-- categoria-1.1.1
      |   |   |   |   |-- categoria-1.1.1.1
      |   |   |   |   |   |-- pwg_high
      |   |   |   |   |   |   +-- matrimonio.jpg
      |   |   |   |   |   |-- thumbnail
      |   |   |   |   |   |   +-- TN-matrimonio.jpg
      |   |   |   |   |   +-- matrimonio.jpg
      |   |   |   |   +-- categoria-1.1.1.2
      |   |   |   +-- categoria-1.1.2
      |   |   |-- categoria-1.2
      |   |   |   |-- pookie.jpg
      |   |   |   +-- thumbnail
      |   |   |       +-- TN-pookie.jpg
      |   |   +-- categoria-1.3
      |   +-- categoria-2
      |       |-- porcello.gif
      |       |-- pwg_representative
      |       |   +-- video.jpg
      |       |-- thumbnail
      |       |   +-- TN-porcello.jpg
      |       +-- video.avi
      |-- include
      |-- install
      |-- language
      |-- template
      +-- tool

- In linea di massima, una categoria è rappresentata da una directory che si trova a qualsiasi livello della directory "galleries" di Piwigo. Le categorie possono, a loro volta, contenere sottolivelli. Nell'esempio qui sopra, categoria-1.1.1.1 si trova al 4° livello di profondità.
- Un elemento è invece rappresentato da un file. Un file può essere elemento di Piwigo se la sua estensione è tra quelle previste tra le possibilità configurate nel file `file_ext` (vedi file include /config_default.inc.php). Un file è considerato come immagine se la sua estensione si trova tra quelle previste nel file `picture_ext`.
- Ogni elemento immagine deve essere associato ad una miniatura (vedi la sezione più in basso riguardante le miniature)
- Gli elementi di tipo immagine possono avere un'immagine associata in alta qualità. Come per il file matrimonio.jpg nell'esempio proposto. Nessun prefisso è necessario.
- Gli elementi che non sono immagini (video, suoni, file di testo o quant'altro...) sono generalmente rappresentati con un'icona corrispondente all'estensione del file. In modo opzionale è possibile associare una miniatura e un file rappresentativo (come per il file video.avi nell'esempio proposto).
- Attenzione: il nome delle directory o del file deve essere composto da lettere, numeri o caratteri come "-", "_" o ".". Nessuno spazio nè caratteri con gli accenti.
- Consiglio: una categoria può contenere elementi e sottocategorie nello stesso tempo. Ad ogni modo è altamente consigliato di scegliere per ciascuna categoria quelle che contengono elementi e quelle che invece contengono sottocategorie.
- Una volta che i file, le miniature e i file rappresentativi sono correttamente piazzati nelle directory, andare nello schermo Amministrazione -> Generale -> Sincronizza.

### Miniature

- Come detto prima, ciascun elemento immagine deve essere associato ad una miniatura.
- Le miniature si trovano nella sottodirectory "thumbnail" di ogni directory che rappresenta una categoria. La miniatura è un file di tipo immagine (stesso nome dell'immagine che rappresenta) con un prefisso che può essere personalizzato dal parametro di configurazione `prefix_thumbnail` (vedi include/ config.inc.php).
- Non è necessario che le miniature abbiano la stessa estensione dell'immagine che rappresenta (per esempio, un'immagine ".JPG" può avere come miniatura un'immagine ".GIF").
- È altamente consigliato di usare un software esterno (come ThumbClic o PhpMyVignettes, vedi il sito di presentazione di Piwigo) per la creazione delle miniature.
- È anche possibile usare la creazione delle miniature integrata a Piwigo, ma ciò non è raccomandato in quanto la qualità delle miniature può essere scadente e il processo potrebbe utilizzare troppe risorse del server (ciò può essere un problema nel caso in cui si usa un servizio di web hosting gratuito.
- Se decidete di usare il server per la creazione delle miniature è necessario dare i diritti di scrittura su tutte le directory e sottodirectory per tutte le categorie di utenti (utente, gruppo, altri).

### Autorizzazioni

- È possibile impedire l'accesso alle categorie. Le categorie possono essere pubbliche o private. I permessi (per i gruppi e utenti) possono essere configurati solo se la categoria è privata.
- Potete rendere una categoria privata modificandola da Amministrazione -> Categorie -> Gestire -> Modificare o selezionando l'opzione nell'albero delle categorie Amministrazione -> Categorie -> Pubblica/Privata).
- Una volta che certe categorie sono impostate come private, potete gestire i permessi per i gruppi e utenti ( Amministrazione -> Identificazione).

### Utenti e gruppi

- Piwigo permette di gestire gruppi di utenti. Può essere molto utile per gestire permessi di accesso comune su categorie private.
- È possibile creare gruppi in Amministrazione -> Identificazione -> Gruppi ed associarci degli utenti.
- Un utente può appartenere a gruppi diversi. L'autorizzazione è prioritaria rispetto alla proibizione. Ad esempio se l'utente "pippo" appartiene ai gruppi "famiglia" e "amici" e, tra questi gruppi, solo il gruppo "famiglia" può vedere la categoria "Natale 2006", ne consegue che l'utente "pippo" sarà abilitato a visionare la categoria "Natale 2006".

### Immagini caricate dagli utenti

Per permettere agli utenti di caricare i file occorre:

1. autorizzare il caricamento in ogni categoria ( Amministrazione -> Categorie -> Gestire -> Modificare oppure Amministrazione -> Categorie -> Proprietà -> Aggiungere immagine).
2. dare i diritti di scrittura (per tutti gli utenti) sulle directory delle categorie autorizzate a l'aggiunta di file

Il file caricati dagli utenti non sono visibili direttamente sul sito in quanto devono essere convalidati da un amministratore. A questo scopo un amministratore deve recarsi in Amministrazione -> Immagini -> In attesa per convalidare o rifiutare i file proposti. È poi necessario sincronizzare il filesystem con la base dati.

### Collegamenti tra elementi e categorie e le categorie virtuali

- Piwigo dissocia le categorie che contengono le immagini da quelle che le visualizzano.
- Di default, gli elementi sono presenti solo nelle categorie reali che corrispondono alle directory sul server.
- Per legare un elemento a una categoria, è sufficente associarlo sulla pagina di modifica dell'elemento (un link esiste verso la pagina quando siete collegati come amministratore), sulla pagina di gestione degli elementi della categoria o grazie al cestino.
- Usando questo stesso principio è possibile creare delle categorie virtuali : nessuna directory fisica corrisponde a queste nuove categorie. È possibile creare le categorie virtuali da Amministrazione -> Categorie -> Gestire.

### Informazioni

- Dopo aver creato la Vostra galleria, modificatene le proprietà di visualizzazione di default da Amministrazione -> Configurazione -> Visualizzazione di default. In questo modo ogni nuovo utente visualizzerrà la galleria con le stesse impostazioni.
- Per qualsiasi altra domanda, non esitare a visitare il forum disponibile sul sito ufficiale di Piwigo sul quale troverete anche un'ampia documentazione in cui potrete trovare risposte ai vostri dubbi.