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.