GM Poll V.1.0
GM Poll è un sistema completo di gestione dei sondaggi all'interno di un sito. Lo script include, oltre ai file contenenti il codice da inserire direttamente nelle pagine che visualizzeranno i sondaggi, un pannello di controllo particolarmente accurato.

Lo script si compone di 11 pagine .php, 1 file .css contenente gli stili per testo e link, 1 file .sql per la creazione delle due tabelle e una cartella (img) contenente 8 immagini gif, 2 per il pannello e 6 per la visualizzazione grafica dei risultati del sondaggio.

Le pagine .php sono:
1. index.php che all'inizio richiede il login e quindi consente di aggiungere i sondaggi
2. validate.php che verifica la correttezza dello username e della password inseriti
3. edit.php che consente di editare i sondaggi già creati
4. checking.php che verifica il login in ogni pagina
5. logout.php che effettua il logout
6. head_poll.php che contiene la 'testata' dello script
7. vars.poll.inc.php che contiene le variabili da settare per il funzionamento dello script
8. modvars.php che consente di modificare le variabili contenute in vars.poll.inc.php
9. poll.php che contiene il codice per visualizzare il sondaggio sul sito
10. vote.php la pagina 'puntata' da poll.php, verifica il voto, manda il cookie e aggiorna il DB
11. showresults.php che contiene il codice per mostrare i risultati del sondaggio

Le immagini .gif sono: gmpoll.gif che va nella cartella di Admin e 0.gif, 1.gif, 2.gif, 3.gif, 4.gif, 5.gif da inserire nella directory del sito che contiene le immagini e che servono per visualizzare i risultati del sondaggio. Naturalmente è necessario aggiungerne altre, di colore diverso, seguendo la numerazione progressiva (6.gif, 7.gif, ecc..) nel caso in cui il poll abbia più di sei risposte.

Il file .sql è PollSQL.sql che contiene il codice sql per creare (da shell o da interfaccia grafica tipo PHPMYADMIN) le 2 tabelle polls e risposte

Il file .css è stylesheet.css che contiene gli stili (per testo e links) per i file di admin, e che va quindi messo nella relativa cartella

Installazione

Scompattando il file .zip, verrà creata una cartella chiamata GMPoll, contenente tutti i file su indicati e la directori img. I file 1,2,3,4,5,6,7,8 (i file di Admin) vanno inseriti tutti nella stessa directory (che può anche avere un nome diverso da GMPoll, basta settarlo in vars.poll.inc.php), le altre pagine (9,10,11) vanno invece inserite nel sito (previa personalizzazione di stile, se necessaria), avendo cura di settare i parametri per la connessione a MySQL all'inizio delle pagine. A questo proposito, è indispensabile settare correttamente tutte le variabili contenute in vars.poll.inc.php, pena il mancato funzionamento dello script.
Le immagini 0.gif, 1.gif, 2.gif, 3.gif, 4.gif, 5.gif (ed, eventualmente le altre), vanno inserite nella directory del sito che contiene le immagini.

Per cominciare ad utilizzare lo script, è necessario creare la struttura del DB che conterrà i sondaggi, utilizzando il file PollSQL.sql, quindi si può accedere al pannello. Lo username iniziale è admin, la password pass, ovviamente consiglio di cambiarle immediatamente dopo il primo login, avvalendosi dell'utility modvars.php, raggiungibile direttamente dal pannello.

Questo dovrebbe essere tutto, lo script è stato testato più volte in locale ed in remoto senza dare problemi, ma chiaramente non sono così presuntuoso da ritenerlo immune da errori, quindi per qualsiasi comunicazione a questo proposito, o per segnalazioni varie, scrivetemi.

Giancarlo