Introduzione
Lo script si presenta come la soluzione ideale per inserire un sistema di sondaggi nel nostro sito. La sua semplicità e la sua alta ingrabilità nelle pagine, ne fanno uno script unico nel suo genere.
Configurazione dello Script
Una volta scompattato il file, andare ad editare il file phpPollConfig.php3 ed apportare (se necessario) delle modifiche, riferendosi alla seguente descrizione:
$poll_scriptVersion = "1.0.3";
La versione corrente dello script.
$poll_baseURL = "http://www.myhost.com";
URL base dello script (non usare lo slash finale).
$poll_mySQL_host = "www.myhost.com";
Indirizzo del server MySQL.
$poll_mySQL_user = "sqlusr";
Nome utente di accesso al server MySQL.
$poll_mySQL_pwd = "sqlpwd";
Password di accesso al server MySQL.
$poll_dbName = "phpPolls";
Nome del database nel quale salvare le tabelle.
$poll_descTableName = "vbooth_desc";
Nome della tabella nella quale finiranno i dati relativi alle descrizioni dei sondaggi.
$poll_dataTableName = "vbooth_data";
Nome della tabella nella quale finiranno i dati relativi a tutti i dati dei sondaggi.
$poll_IPTableName = "vbooth_ip";
Nome della tabella nella quale finiranno i dati relativi agli indirizzi IP.
$poll_logTableName = "vbooth_log";
Nome della tabella nella quale finiranno i dati relativi ai Log.
$poll_maxOptions = 10;
Numero massimo di opzioni consentite.
$poll_logging = 0;
Permette di abilitare ("1") o disabilitare ("0") il log di ogni voto.
$poll_IPLocking = 0;
Permette di abilitare ("1") o disabilitare ("0") l'uso addizionale del bloccaggio degli IP.
$poll_IPLockTimeout = 600;
Numero di secondi per il quale un IP rimane bloccato.
$poll_resultBarHeight = 12;
L'altezza in pixel della barra percentuale nella tabella dei risultati.
$poll_resultBarScale = 1;
Scala della barra dei risultati (in multipli di 100 pixel).
$poll_resultBarFile = "phpPollBar.gif";
Nome dell'immagine che contiene la stringa.
$poll_setCookies = 1;
Permette di abilitare ("1") o disabilitare ("0") il divieto di votare due volte per lo stesso sondaggio (usando i cookie).
$poll_warnCheaters = 0;
Permette di abilitare ("1") o disabilitare ("0") un eventuale messaggio di errore nel caso di una doppia votazione.
$poll_usePersistentConnects = 1;
Permette di abilitare ("1") o disabilitare ("0") l'uso di una connessione permanente.
$poll_cookiePrefix = "phpPoll";
Prefisso per il nome del cookie.
Creazione del database
phpPolls necessita di quattro tabelle per funzionare. Basta caricare il file phpPolls.mysql (magari usando phpMyAdmin) ed è tutto pronto. Se però si vogliono usare nomi diversi per le tabelle, bisogna sia modificare il file phpPolls.mysql, sia modificare (nel file phpPollConfig.php3) le variabili:
$poll_descTableName
$poll_dataTableName
$poll_IPTableName
$poll_logTableName
Installazione sul Server
Adesso caricare i file sul server ed iniziare a creare dei nuovi sondaggi. Basta eseguire il file phpPollAdmin.php3 e seguire le istruzioni a video che sono molto semplici. Per creare un sondaggio basta cliccare su "Create new poll", inserire il titolo e le scelte della votazione. Una volta creato un sondaggio ti verrà fornito un ID e ti verrà stampato un semplice codice per inserire o visualizzare il sondaggio nelle tue pagine. Rimuovere un sondaggio invece è ancora più semplice, basta infatti cliccare su "Remove existing poll", selezionare il sondaggio da eleminare e cliccare su "Remove".
Integrare phpPolls nel tuo codice
Questa procedura (l'ultima) è molto semplice, basta infatti includere nello script i file "phpPollConfig.php3" e "phpPollUI.php3", e richiamare la funzione poll_generateUI(ID, "URL al quale tornare dopo la votazione"); per far votare, e la funzione poll_viewResults(ID); per visualizzare i risultati. Per funzioni più complesse consultare i file della guida. phpPolls adesso è correttamente configurato, basta solo iniziare ad usarlo.
Considerazioni Finali
Il prodotto è ottimo, facile ed intuitivo. Una sua pecca è la disponibilità solo in lingua inglese e quindi l'onere di una eventuale traduzione a carico dell'utente.
