## Aiuto

Aggiungere delle foto con pLoader

pLoader per Windows o pLoader per Linux : descrizione, download e i dettagli delle nuove versioni.

1. Create una directory "upload" a fianco della directory "galleries" della vostra installazione di Piwigo, con dei diritti di scrittura.
2. Installate pLoader sul vostro PC, avviatelo e riempite i parametri di conessione : URL della vostra galleria, il vostro utente e la vostra password .
3. Aggiungete delle foto con un semplice drag'n drop verso la selezione di pLoader.
4. Create una categoria e selezionatela.
5. Selezionate qualche foto.
6. Cliccare sulla freccia verde per trasferire le foto verso la vostra galleria

Bravo! Avete appena creato la prima categoria della vosrta galleria.

Aggiungere delle foto con l'FTP

### Presa in mano rapida

1. Create una directory sul vostro PC.
2. Copiate qualche foto in questa directory, e ridimenzionatele per la visualizzazione sul web. Attenzione: il nome delle directories e dei files deve contenere solo delle lettre, cifre e i caratteri "-", "_" o ".". Nessuno sazio o caratteri accentuati.
3. Con un cliente FTP, copiate la directory in nella directory "galleries" del vostro Piwigo.
4. Connettetevi alla vostra galleria e andate a Amministrazione » Immagini » Miniature per creare le miniature mancanti.
5. Andare a Amministrazione e cliccare sul grosso pulzante Sincronizzazione.

Bravo! Avete appena creato la prima categoria della vosrta galleria.

### Organizzazione delle directories e dei files

- 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. Ogni categoria può contenere altretanti sottolivelli che si desidera. 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 un elemento di Piwigo se la sua estensione è tra quelle previste tra le possibilità previste nel parametro di configuarzione `file_ext` (vedi file include/config_default.inc.php). Un file è considerato come un immagine se la sua estensione si trova tra quelle previste nel file `picture_ext`.
- Ogni elemento di tipo 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 prima del nome del file.
- Gli elementi che non sono delle 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 ne 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 del file) 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 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 ed il processo potrebbe utilizzare troppe risorse del server (ciò può essere un problema per un servizio di web hosting gratuito.
- Se decidete comunque di usare il server per la creazione delle miniature è necessario dare i diritti di scrittura su tutte le directory.

Permessi

- Potete vietare l'accesso alle categorie. Settate il tipo d'accesso a "privato" se desiderate gestire i permessi
- Potete rendere una categoria privata modificandola da Amministrazione » Categorie » Gestire » Modificare o selezionando l'opzione nell'albero delle categorie Amministrazione » Categorie » Proprietà » Pubblica/Privata).

- Una volta che certe categorie sono private, potete gestire i permessi da 3 schermi:

  - Amministrazione » Identificazione » Utenti » azione Permessi (un' link per utente)
  - Amministrazione » Identificazione » Gruppi » azione Permessi (un' link per gruppo)
  - Amministrazione » Categorie » Gestire » Modificare i permessi (un' link per categoria)

Utenti e gruppi

- I gruppi d'utenti permettono di dare dei permessi ad una lista di utenti.
- È possibile creare gruppi in Amministrazione » Identificazione » Gruppi.
- Un utente può appartenere a diversi gruppi. 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 2008", ne consegue che l'utente "pippo" sarà abilitato a visionare la categoria "Natale 2008".

Immagini caricate dagli utenti

Gli utenti possono anche loro caricare le loro foto.

1. Autorizare l'upload su una o più categorie fisiche (Amministrazione » Categorie » Gestire » Modificare o Amministrazione » Categorie » Proprietà » Caricare). Le categorie virtuali non permettono l'upload.
2. dare i diritti di scrittura (per tutti gli utenti) sulle directory delle categorie autorizzate a l'aggiunta dei file

Le foto aggiunte dagli utenti non sono direttamente visibili sul sito. Devono essere convalidate da un amministratore. Per ciò, un'amministratore deve andare in Amministrazione » Immagini » In attesa » Immagini per approvare o scartare le immagini proposte

Collegamenti tra elementi e categorie e le categorie virtuali

- Le foto sono visualizzate nella categoria corrispondente alla directory.
- Potete anche visualizzare una foto in più di una categoria, senza dupplicare il file. Associate la foto a un'altra o più categorie d'allo schermo di modifica della foto (al quale acedete dalla pagina di visualizzazione della foto della vostra galleria, quando siete connessi come amministratore).
- Le categorie virtuali nascono da questo principio : non sono associati a nessuna directory fisica. Create delle categorie virtuali in 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 queste stesse impostazioni.
- Se avedte delle domande, la comunità di Piwigo sarà lieta di rispondere sul'forum.