Introduzione
Questo script per creare sondaggi risulta molto facile da installare e da utilizzare. Infatti basta inserire pochi dati e lo script si autoinstalla perfettamente permettendo, tra le altre cose, di selezionare il nome delle tabelle che si vogliono utilizzare; utile soprattutto se si vogliono fare più installazioni dello script appoggiandosi sempre allo stesso database MySQL. L'utilizzo risulta ancora più semplice grazie ad un'area di amministrazione protetta da password e che permette di creare i sondaggi in pochi secondi. La licenza utilizzata è la GNU GPL che permette l'utilizzo e la modifica a patto di non toccare il copyright originale.
Configurazione dello script
Una volta scaricato il file, andare a decomprimerlo e, in seguito, caricare tutti i file sul server. Con il proprio programma FTP, quindi, dirigersi nella cartella "Identif" e settare il CHMOD dei file logins.php e admin_infos.php a 777.
Installazione sul server
Adesso puntare all'indirizzo del tipo http://www.tuosito.it/alexpoll/admin/setup.php e seguire le istruzioni a video per portare a termine l'installazione.
Prima Pagina
Scegliere la lingua preferita da utilizzare per visualizzare l'installazione e per la futura gestione dell'amministrazione; sono disponibili inglese e francese.
Seconda Pagina
The URL of your site
Inserire qui l'indirizzo internet del vostro sito.
Directory of your site where you have installed @lex Poll
Qui va messo l'indirizzo internet completo nel quale è installato lo script.
Host of the server for the data base
Indirizzo del server MySQL; può essere in formato testuale (es. localhost) o numerico (es. 127.0.0.1)
Your login of access to this base
Nome utente di accesso al server MySQL. Dato fornito dal provider che ospita il vostro sito.
Your password of access to this base
Password di accesso al server MySQL. Dato fornito dal provider che ospita il vostro sito.
Name of this base
Nome del database MySQL da utilizzare per far funzionare lo script.
Name of the table for the questions of the poll
Nome della tabella da utilizzare per le domande dei sondaggi.
Name of the table for the answers to the poll
Nome della tabella da utilizzare per le risposte dei sondaggi.
Name of the table for save IP adress to the poll
Nome della tabella da utilizzare per registrare gli indirizzi IP dei votanti.
Login for the admin part
Nome utente da utilizzare per il futuro accesso all'amministrazione dello script.
Pass for the admin part
Password da utilizzare per il futuro accesso all'amministrazione dello script.
Terza Pagina
La terza pagina ci informa che lo script è stato installato correttamente e ci consiglia di rimuovere dalla cartella "admin" il file setup.php per evitare future intrusioni o manomissioni dello script.
A questo punto dobbiamo puntare all'indirizzo internet del tipo http://www.tuosito.it/alexpoll/admin; verranno chiesti i dati (nome utente e password) di ingresso di amministratore. Una volta inseriti si presenterà un menù in basso che ci permetterà di modificare le opzioni, creare, eliminare o archiviare i sondaggi.
Pannello di Controllo
New Poll
Nella pagina che apparirà elezionare il numero di possibili risposte al sondaggio. Quindi compilare la seconda pagina come di seguito spiegato:
Question of the poll
Inserire qui la domanda del sondaggio; è consigliabile inserire anche l'eventuale punteggiatura finale come il punto interrogativo (?) o i puntini (...).
Answer X
Inserire nel riquadro contrassegnato (dove X indica il numero della risposta) una delle eventuali risposte tra le quali sarà possibile votare.
I wish that this poll becomes the active poll
Selezionando questa opzione si rende attivo il sondaggio che comparirà nelle pagine che contengono il codice per visualizzare il sondaggio attivo. Inoltre l'eventuale sondaggio attivo che era presente, verrà archiviato.
I wish that this poll is used independently
Invece selezionando questa opzione si rende il sondaggio indipendente. Il codice da inserire nelle pagine varia leggermente, perché; comparirà una variabile che identifica il sondaggio in maniera univoca.
I do not wish to use this poll for the moment, it will will be neither archived so nor visible on the site
Infine selezionando questa opzione il sondaggio verrà registrato e sarà automaticamente archiviato. Ovviamente tale sondaggio non comparirà come sondaggio attivo.
Codice da inserire nelle pagine
Una volta completata tale operazione verrà visualizzato il codice da inserire nelle pagine. Il codice seguente deve essere inserito nelle pagine che vogliono visualizzare il sondaggio attivo:
<?php
$chemin = "##VARIABLE TO BE INFORMED##";
include ("$chemin/afficher.php");
?>
Mentre sotto viene riportato il codice necessario per visualizzare un sondaggio indipendente; si può notare che, rispetto al codice precedente, compare la variabile $ID_SOND (dove "x" è un numero) che identifica il sondaggio creato:
<?php
$chemin = "##VARIABLE TO BE INFORMED##";
$id_sond = "x";
include ("$chemin/afficher.php");
?>
Ricordarsi di assegnare come valore alla variabile $CHEMIN il percorso relativo della directory dove è installato lo script.
Pannello di Controllo - parte II
Poll's Options
The controle of the persons having voted is made
Selezionare la voce che si preferisce per l'eventuale controllo del visitatore, in maniera tale che non possa votare più volte; le opzioni disponibili sono attraverso i cookie, l'indirizzo IP, l'uso combinato dei due oppure si può disabilitare tale controllo e permettere di votare più di una volta.
If you wish a control by cookies, how many days that this is kept
Inserire il numero di giorni (il numero massimo consentito è 115) per i quali si desidera che lo script tenga conto del cookie per evitare doppie votazioni.
If you wish a control by IP address, how many days these address is kept in the table
Inserire il numero di giorni (il numero massimo consentito è 20) per i quali deve essere mantenuto nel database un indirizzo IP per evitare doppie votazioni.
The percentages are posted for the results of the poll
Abilita (yes) o disabilita (no) la visualizzazione delle percentuali nei risultati del sondaggio.
The number of voter is shown for the results of the poll
Abilita (yes) o disabilita (no) la visualizzazione del numero di votanti del sondaggio.
The total number of votes is shown for the results of the poll
Abilita (yes) o disabilita (no) la visualizzazione dei voti totali del sondaggio.
The link "results" is shown for the vote
Abilita (yes) o disabilita (no) la visualizzazione del link per andare a consultare i risultati della votazione corrente.
The link "archives" is shown
Abilita (yes) o disabilita (no) la visualizzazione del link per andare a consultare gli archivi.
If you wish that the percentages are shown, how many figures after the comma are registered
Numero delle immagini da utilizzare per la visualizzazione delle percentuali.
Name of the image used for the bar representing pourcent
Nome dell'immagine utilizzata per la visualizzazione delle percentuali.
Height in pixels of this image
Altezza, in pixel, dell'immagine utilizzata per la visualizzazione delle percentuali.
Multiplicate coefficient for the length of the image representing the percentages
Coefficiente da moltiplicare per la lunghezza dell'immagine che viene utilizzata per la visualizzazione delle percentuali.
Colour of the clickable links
Colore (in formato HTML) dei link cliccabili all'interno dello script.
Number of polls shown on 1 page of archives
Numero di sondaggi da visualizzare nella prima pagina dell'archivio.
Multiplicate coefficient for the length the image representing the percentages in the page of archives
Coefficiente da moltiplicare per la lunghezza dell'immagine che viene utilizzata per la visualizzazione delle percentuali nella pagina degli archivi.
Colour of the clickable links "Preview, next..." on the page of archives
Colore (in fornato HTML) del link "Preview, next..." nella pagina degli archivi.
Colour of the not clickable links "Preview, next..." on the page of archives
Colore (in fornato HTML) del testo non cliccabile "Preview, next..." nella pagina degli archivi.
Colour of the title "Page ... to..." for archives
Colore (in formato HTML) da utilizzare per la scritta degli archivi che indica la pagina corrente sul totale di pagine disponibili.
Format of date for archives
Formato di visualizzazione della data per gli archivi.
Html code of the part high of the archival part
Codice HTML dell'intestazione per la pagina degli archivi.
Html code of the low part of the archival part
Codice HTML del piè di pagina per la pagina degli archivi.
Presentation of the part "vote" of the poll
Formattazione HTML da utilizzare per visualizzare la pagina contenente la votazione del sondaggio attivo; sono presenti codici proprietari dello script che identificano funzioni di visualizzazione.
Presentation of the part "results" of the poll
Formattazione HTML da utilizzare per visualizzare la pagina contenente il risultato del sondaggio attivo; sono presenti codici proprietari dello script che identificano funzioni di visualizzazione.
Presentation of the part "archives" of the poll
Formattazione HTML da utilizzare per visualizzare la pagina contenente gli archivi dei sondaggi; sono presenti codici proprietari dello script che identificano funzioni di visualizzazione.
To restore all the options by default
Selezionare questa casella se si desidera riportare le impostazioni allo stato originale.
Attenzione tale procedura eliminerà completamente ogni personalizzazione apportata alle opzioni dello script.
Pannello di Controllo - parte III
Poll's Management
In questa sezione sono presenti varie funzioni, delle quali la più importante è "modify" che viene spiegata di seguito.
ID dof the poll
Numero identificativo del sondaggio; tale numero è utile per identificare il sondaggio durante l'inserimento nelle pagine.
Question of the poll
Inserire qui la domanda del sondaggio; è consigliabile inserire anche l'eventuale punteggiatura finale come il punto interrogativo (?) o i puntini (...).
Answer X
Inserire nel riquadro contrassegnato (dove X indica il numero della risposta) una delle eventuali risposte tra le quali sarà possibile votare.
Nb of votes
Si possono modificare i valori relativi alle risposte inserendo, per ogni casella, il valore desiderato.
Comment for archives
Eventuale commento per il sondaggio se si ha intenzione di archiviarlo.
I wish that this poll becomes the active poll
Selezionando questa opzione si rende attivo il sondaggio che comparirà nelle pagine che contengono il codice per visualizzare il sondaggio attivo. Inoltre l'eventuale sondaggio attivo che era presente, verrà archiviato.
I wish that this poll is used independently
Invece selezionando questa opzione si rende il sondaggio indipendente. Il codice da inserire nelle pagine varia leggermente, perché; comparirà una variabile che identifica il sondaggio in maniera univoca.
I do not wish to use this poll for the moment, it will will be neither archived so nor visible on the site
Infine selezionando questa opzione il sondaggio verrà registrato e sarà automaticamente archiviato. Ovviamente tale sondaggio non comparirà come sondaggio attivo.
Date of add
Si può modificare la data di creazione del sondaggio modificando questa casella.
Code to be insert on your page(s)
In questo riquadro viene visualizzato l'eventuale codice PHP da inserire nelle proprie pagine affinchè vi compaia il sondaggio.
Passwords
Language
Scegliere la lingua preferita da utilizzare per la gestione dell'amministrazione; sono disponibili inglese (english) e francese (french).
The URL of your site
Inserire qui l'indirizzo internet del vostro sito.
Directory of your site where you have installed @lex Poll
Qui va messo l'indirizzo internet completo nel quale è installato lo script.
Host of the server for the data base
Indirizzo del server MySQL; può essere in formato testuale (es. localhost) o numerico (es. 127.0.0.1)
Your login of access to this base
Nome utente di accesso al server MySQL. Dato fornito dal provider che ospita il vostro sito.
Your password of access to this base
Password di accesso al server MySQL. Dato fornito dal provider che ospita il vostro sito.
Name of this base
Nome del database MySQL da utilizzare per far funzionare lo script.
Login for the admin part
Nome utente da utilizzare per il futuro accesso all'amministrazione dello script.
Pass for the admin part
Password da utilizzare per il futuro accesso all'amministrazione dello script.
Considerazioni Finali
Gli sviluppatori francesi contribuiscono molto allo sviluppo del PHP. Ne è una dimostrazione questo script veloce e funzionale. Come detto all'inizio l'installazione e l'utilizzo sono davvero operazioni molto semplici e veloci. Le lingue disponibili sono il francese e l'inglese, ma solo per l'installazione e l'amministrazione; alcune scritte lato utente sono in francese, anche se non è affatto difficile modificare il sorgente per tradurlo. Insomma un ottimo script che genera sondaggi facilmente integrabili nelle proprie pagine e che dispone, tra l'altro, di un'amministrazione completa e protetta da password.
