Coppermine 1.3.2: installazione e configurazione

Introduzione

Se volete gestire in modo semplice ed efficace intere gallerie di immagini Coppermine Photo Gallery può essere l'applicazione che fa' al caso vostro. Le immagini vengono catalogate in album a loro volta organizzati in categorie e sottocategorie. È possibile attribuire alle immagini uplodate titolo, descrizione, parole chiave per la ricerca e persino alcuni campi descrittivi personalizzati.

Gli album possono essere creati e gestiti da diversi tipi utenti: amministratori, utenti registrati o anche anonimi, a seconda delle impostazioni e delle restrizioni scelte. I livelli di permessi all'interno della galleria possono essere gestiti creando dei gruppi ed assegnandovi gli utenti registrati.

Tra le molte funzioni disponibili si possono citare la generazione automatica di miniature, la spedizione di cartoline elettroniche, la creazione di slide show, l'invio di commenti e voti relativi alle immagini. Fondamentali sono il supporto multilingue, la possibilità di creare temi personalizzati per le proprie pagine e, soprattutto, la disponibilità di una semplice installazione guidata. Per concludere il software è rilasciato gratuitamente e coperto da licenza GNU/GPL 2.

Se tutto questo è sufficiente a destare il vostro interesse proseguite la lettura e verrete guidati passo passo nell'installazione e configurazione del software.

Prima di prelevare Coppermine, ospitato da Sourceforge, verifichiamo che il nostro server soddisfi i requisiti minimi per la sua installazione:

• un web server che supporti PHP...naturalmente Apache
• PHP almeno nella versione 4.1.0;
• GD library o ImageMagick;
• MySQL almeno nella versione 3.23.23.

Una piccola nota merita il terzo requisito, ovvero la necessità di una libreria grafica che permetta a PHP di manipolare le immagini. GD
php.ini decommentando la direttiva extension=php_gd2.dll (il
corrispondente file
directory "extensions" )

In alternativa è possibile ricorrere ad ImageMagick

Fate bene attenzione: Coppermine non funzionerà senza GD o ImageMagick!

Il tutorial fa' riferimento all'installazione di Coppermine 1.3.2 su un web server Linux RH 7.3 con Apache 1.3.27, PHP 4.2.3, GD 2 e MySQL 3.23.56. Non sarà comunque difficile adattare le indicazioni fornite alle caratteristiche del vostro sistema.

Fasi preliminari dell'installazione

Per prima cosa occupiamoci di prelevare il software raggiungendo la home page di Coppermine alla url http://coppermine.sourceforge.net e seguendo il link "Downloads" in alto a destra. Per vostra comodità potete prelevare il file compresso direttamente da qui, dal link "download" in alto in questa pagina.

Se disponiamo di una shell sul nostro server trasferiamo direttamente il file zippato e scompattiamolo sotto la document root (la directory in cui solitamente memorizziamo le nostre pagine). Nel farlo dobbiamo preservare l'esatta struttura di directory e sottodirectory a partire dalla directory base cpg132. Se il nome di default non vi piace potete modificarlo, ma non quello di files e sottodirectory, pena il non funzionamento dell'applicazione. D'ora innanzi faremo comunque riferimento alla directory base dell'installazione con il nome "cpg132".

Se disponiamo solo di un accesso ftp, dovremo prima scompattare il file .zip in locale e poi trasferire i files, sempre mantenendo inalterata la struttura delle directory.

A questo punto modifichiamo i permessi sulle directory include ed albums, in modo tale che il nostro script abbia i privilegi necessari. Un chmod 755 o 777, a seconda della configurazione del server, dovrebbe risolvere il problema. Verifichiamo che anche tutte le sottodirectory di "albums" abbiano i medesimi permessi.

Infine creiamo il database MySQL "coppermine" ed un utente che possieda su di esso i privilegi di select, update, insert, delete e create, a meno che non decidiate di ricorrere ad un database già esistente. Se non possedete le autorizzazioni necessarie dovrete contattare chi amministra il server, tipicamente il supporto tecnico del vostro web hosting provider.

Installazione

Se il nostro sito è raggiungibile all'indirizzo http://www.miosito.it, iniziamo il processo d'installazione puntando il browser sulla url http://www.miosito.it/cpg132/install.php. Se vi risponde una pagina di errore che esorta alla modifica dei permessi sulle directory sopra menzionate, significa che non avete correttamente seguito le indicazioni precedenti. Niente paura, provvedete semplicemente ad eseguire il corretto settaggio e proseguite cliccando sul pulsante "Try again!".

A questo punto dovremmo trovarci di fronte alla pagina di benvenuto della procedura d'installazione che richiede l'inserimento di alcuni dati suddivisi logicamente in tre aree:

• Your admin account
• Your MySQL configuration
• • Come MySQL Host
  • In MySQL Database Name
  • Nei campi MySQL Username MySQL Password
  • MySQL table prefix
• ImageMagick

Un ultimo controllo per verificare la correttezza dei dati inseriti, e poi selezioniamo il pulsante "Let's Go!". Lo script d'installazione popolerà il database con le relative tabelle e porterà a termine il processo. Se non si verificano problemi verremo diretti verso una pagina che conferma il completamento della procedura d'installazione. Tale pagina, oltre ad alcuni suggerimenti ed indicazioni, propone un link Login che ci permetterà di autenticarci all'interno della galleria fotografica.

Prima di procedere, per ragioni di sicurezza, sarà consigliabile cancellare il file install.php ed eliminare i permessi di scrittura sulla directory include. Quest'ultima operazione non risulta documentata, tuttavia, procedendo così, non ho personalmente riscontrato problemi di funzionamento.

Purtroppo non si potrà fare altrettanto sulla directory albums necessaria all'upload delle immagini.

Se vogliamo ulteriormente aumentare il livello di sicurezza possiamo revocare il privilegio "create" all'utente che gestisce il database.

Per ora ci fermiamo qui, nella seconda parte del tutorial, di prossima pubblicazione, analizzeremo in dettaglio tutte le opzioni di configurazione.

Configurazione generale

Raggiunta la pagina di login, inseriamo i dati relativi all'account amministrativo che abbiamo creato durante la precedente fase d'installazione ed autentichiamoci.

Attenzione: l'applicazione prevede due modalità operative: Admin mode e User mode, la prima con una propria barra menù per la gestione della galleria. La duplice modalità è prevista sia per amministratori che per regolar users. Nel loggarci come amministratori ci troviamo di default in admin mode, possiamo dunque procedere selezionando il pulsante Config.

La pagina di configurazione è suddivisa in varie sezioni, tra queste individuiamo Language, Themes & Charset settings. Dal menù a discesa Language selezioniamo Italian, scrolliamo fino a fondo pagina e clicchiamo sul pulsante "Save new configuration". Verremo reindirizzati alla pagina che ci aveva accolti dopo il login, ma questa volta messaggi e pulsanti sono in lingua italiana. Ora che ci siamo messi più a nostro agio riprendiamo la configurazione selezionando la voce Configura.

Ecco una descrizione dettagliata delle diverse opzioni disponibili per poter ottenere una galleria fotografica che meglio si adatti alle nostre esigenze. Le voci sono raggruppate in base alla sezione di riferimento.

Impostazioni generali

• Nome galleria:
• Descrizione galleria:
• Email amministratore:
• target per il link 'Vedi altre immagini' nelle e-cards:
• Galleria non operativa:
• Registra e-Cards:
• Consenti download come ZIP dei Preferiti:

Language, Themes & Charset settings

• Lingua:
• Tema:
• Mostra elenco lingue:
• Mostra bandiere lingue:
• Mostra "reset" nella scelta della lingua:
• Mostra elenco temi:
• Mostra "reset" nella scelta del tema:
• Mostra FAQ - domande frequenti:
• Mostra aiuto per bbcode:
• Codifica caratteri:

Vista elenco album

• Larghezza tabella principale (pixels o %):
• Numero di livelli delle categorie da mostrare:
• Numero di albums da mostrare:
• Numero di colonne dell'elenco album:
• Dimensione miniature in pixels:
• Contenuto della pagina principale:
• • breadcrumb =
  • catlist
  • alblist
  • random
  • lastup
  • topn
  • toprated
  • lastcom
  • lasthits
  • lastalb
  • anycontent
• Il valore di default è breadcrumb/catlist/alblist/random,2/lastcom,2 dove ",2" sta a significare 2 righe di miniature.
• Mostra miniature per primo livello album nelle categorie:

Vista miniature

• Numero di colonne nella pagina delle miniature:
• Numero di righe nella pagina delle miniature:
• Massimo numero di tabs da mostrare:
• Mostra descrizione (in aggiunta al titolo) sotto la miniatura:
• Mostra numero di viste sotto la miniatura :
• Mostra numero di commenti sotto la miniatura:
• Mostra nome uploader sotto la miniatura:
• Criterio di default per ordinare le immagini:
• Minimo numero di voti affinché un'immagine entri nella lista delle 'più votate':

Vista immagine & Impostazioni commenti

• Larghezza della tabella mostra immagine (pixels o %):
• Info immagini visibili di default:
• Filtra parolacce nei commenti:
• Consenti smiles nei commenti:
• Consenti più commenti consecutivi ad un'immagine dallo stesso utente (disattiva protezione flood):
• Lunghezza massima descrizione:
• Max numero di caratteri in una parola:
• Max numero di linee in un commento:
• Lunghezza massima del commento:
• Mostra film strip:
• Numero di miniature nella film strip:
• Avvisa admin via email quando arrivano commenti:
• Intervallo slideshow in millisecondi (1 secondo = 1000 millisecondi):

Impostazioni immagini e miniature

• Qualità files JPEG:
• Max dimensione delle miniature:
• Usa dimensione (larghezza o altezza o aspetto Max per miniature e immagini intermedie):
• Crea immagini intermedie:
• Max larghezza o altezza delle immagini intermedie:
• Peso massimo dei files (KB):
• Max larghezza o altezza delle immagini/video caricati (pixels):

Impostazioni avanzate files e miniature

• Mostra icona album privati ad utenti non connessi:
• Caratteri proibiti nei nomi dei file:
• Tipi di immagine consentiti:
• Tipi di video consentiti:
• Tipi di audio consentiti:
• Tipi di documento consentiti:
• Metodo ridimensionamento immagini:
• Percorso per la utility 'convert' di ImageMagick (esempio /usr/bin/X11/):
• Opzioni di comando per ImageMagick:
• Leggi dati EXIF nei file JPEG:
• Leggi dati IPTC nei file JPEG:
• Cartella degli album:
• Cartella immagini utenti:
• Prefisso per le immagini intermedie:
• Prefisso per le miniature:
• Chmod di default per le cartelle:
• Chmod di default per i file:

Impostazioni utenti

• Consenti nuove registrazioni:
• Verifica tramite e-mail richiesta:
• Avvisa via email admin di registrazioni utenti:
• Consenti due utenti con la stessa email:
• Utenti possono avere album privati (Nota: cambiando da 'si' a 'no' tutti gli album attualmente privati diventeranno pubblici):
• Avvisa via email admin di file in attesa di approvazione:
• Consenti agli utenti connessi di vedere la Lista Utenti:

Campi personalizzati per le descrizioni (lascia vuoti se inutilizzati)

• Nome campo 1:

Impostazioni cookies

• Nome del cookie usato dallo script (usando l'integrazione con la bbs, assicurati che sia diverso dal nome dei cookie di quest'ultima):
• Percorso del cookie usato dallo script:

Impostazioni varie

• Attiva modalità debug:
• Mostra avvisi (notices) in modalità debug:

Conclusioni

Coppermine Photo Gallery, come riferisce lo stesso team di sviluppo, utilizza codice di altri software liberamente distribuiti (phpBB, phpMyAdmin, phpPhotoAlbum, etc.). Questo è uno dei grandi vantaggi del software rilasciato sotto GPL o licenze similari. Il legame più evidente, anche per l'impostazione grafica di default, è sicuramente con phpBB. A questo proposito è utile segnalare la possibilità di integrazione con i più diffusi bulletin board (phpBB, vBulletin,YaBB SE, etc.) per maggiori dettagli consultate la documentazione ufficiale.

Complessivamente il software risulta funzionale e sufficientemente stabile anche se ogni tanto evidenzia qualche problemino. Vorrei fare alcune osservazioni finali relativamente all'upload di files via HTTP ed alle restrizioni imposte dalla configurazione di PHP. Alcune direttive del file php.ini influenzeranno il comportamento del software ed andranno eventualmente modificate secondo le proprie esigenze:

• file_uploads
• upload_tmp_dir
• max_input_time
• upload_max_filesize
• post_max_size
• memory_limit

Infine, come ultimo suggerimento, monitorate periodicamente il sito di riferimento dove potrete trovare documentazione, supporto, mods, temi grafici, ma soprattutto eventuali security fix.