Location: PHPKode > projects > PHPOLL php - mysql poll system > info.php
<?php echo "<?xml version=\"1.0\" encoding=\"iso-8859-1\"?".">"; 

/*

This file is part of PHPOLL.

    PHPOLL is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    PHPOLL is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with PHPOLL; if not, write to the Free Software
    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

*/

?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">

<head>

<script type="text/javascript" language="JavaScript">

</script>

<title>PHPOLL</title>
<link rel="stylesheet" href="css/homepage_layout.css" title="homepage layout" />
</head>
<body>

<?php

if (isset ($_GET['language'])) { 
	$language=(int)$_GET['language'];
}

else {
	$language=1;
}

if ($language==0) {

  die ("Try a different way!");

}
	
?>

<div class="corpo">

<img src="img/poll_logo.jpg" alt="phpoll logo" />
<img src="main_img/phpoll_char.gif" alt="phpoll" />

<br />

<a href="info.php?language=1"><img src="img/ita.jpg" alt="italiano" /></a>
<a href="info.php?language=2"><img src="img/eng.jpg" alt="english" /></a>

<br />

<div class="menu">

<?php

if ($language==1) {
	
print "<a href=\"index.php?language=".$language."\">home</a>";
print "<a href=\"connetti_db.php?language=".$language."\">connetti al database</a>";
print "<div class=\"menu_attuale\">info</div>";

?>

</div>

</div>

<div class="corpo">


<p class="titolo">
PHPOLL v. 0.97 beta
</p>

<p class="sotto_titolo">
scritto in PHP da Massimo Perini
</p>
<p class="note">necessita di MySql</p>
<p class="note">per lodi, consigli e critiche: <a href="mailto:hide@address.com">hide@address.com</a></p>

<div class="corpo2">

<p class="titoletto">INSTALLAZIONE</p>
<p class="note">fase 1 - installazione del generatore di phpoll (se leggete queste righe vuol dire che l'avete già superata e potete passare alla fase 2)</p>
<ul>

<li>assicuratevi di avere installato il modulo php e mySql</li>
<li>scompattate la cartella zippata "phpoll.zip" dentro la cartella dove risiedono i documenti www 
nel vostro server (di solito htdocs), eventualmente all'interno di un percorso da voi preferito</li>
<li>accertatevi che questa operazione abbia creato una cartella dal nome "phpoll", che sarà il punto di partenza</li>
<li>se lo ritenete opportono, create un nuovo database all'interno di mySql, tramite phpmyadmin o 
altro programma (phpoll non crea nuovi database, ma soltanto tabelle all'interno di un database 
preesistente, questo perchè solitamente sono necessari permessi speciali per compiere queste 
operazioni in un server)</li>
<li>aprite uno user agent (browser) e digitate l'indirizzo dove avete appena copiato il phpoll (ad 
esempio se avete copiato i files dentro la cartella "phpoll" in www.phpoll.com dovrete digitare 
"www.phpoll.com/phpoll/")</li>

</ul>
<p class="note">fase 2 - installazione del phpoll vero e proprio</p>
<ul>
<li><b>date i permessi di scrittura</b> (CHMOD 777, 755, 750 vanno bene) alla cartella polls/ all'interno della root di phpoll (questo lo potete fare con qualsiasi client FTP)</li>
<li>cliccate su "connetti al database" dal menu in alto</li>
<li>inserite "host", "user" e "password" per connettervi a mySql</li>
<li>ora dovrete selezionare il database all'interno del quale volete che phpoll generi le tabelle 
necessarie al funzionamento</li>
<li>inserite il <b>NOME</b> del poll che intendete creare nell'apposito form e cliccate su "crea"</li>


</ul>

<p class="note">a questo punto <b>phpoll</b> avrà generato:</p>

<ol>
<li>le tabelle mySql necessarie, ovvero:</li>
<ul>
<li>phpoll_NOME_band = tabella che contiene i dati relativi ai candidati alle votazioni</li>
<li>phpoll_NOME_configurazione = tabella che contiene i dati relativi alla configurazione (customizzazione)</li>
<li>phpoll_NOME_voti = tabella che contiene le informazioni dei votanti (IP, data, browser, ecc...)</li>
</ul>
<li>
una directory contenente tutti i files necessari al funzionamento di phpoll, che assumerà il 
nome scelto da voi (es.: "NOME") e sarà creata all'interno della directory "polls" in "phpoll" 
(nell'esempio precedente il percorso sarebbe "www.phpoll.com/phpoll/polls/NOME/"</li>
</ol>

<p class="note">sarete poi direttamente indirizzati alla pagina di amministrazione (nell'esempio il 
percorso sarebbe: "www.phpoll.com/phpoll/polls/NOME/admin/") e da qui potrete fare tutte le 
modifiche necessarie</p>

<p class="titoletto">IMPOSTAZIONE DEL PERCORSO ASSOLUTO DEL POLL APPENA CREATO (IMPORTANTE)</p>
<p>è molto importante a questo punto che impostiate il percorso assoluto del poll appena creato, perchè questo
serve poi per la conferma del voto via e-mail alla localizzazione del file di controllo "elabora_voto_new.php",
che è il programma che serve a verificare e confermare il voto dal link mandato via mail</p>
<p>per fare questo dovete semplicemente:</p>
<ul>
<li>andare alla pagina di amministrazione</li>
<li>selezionare <b>configurazione</b> dal menu in alto</li>
<li>alla voce "percorso assoluto del POLL (es.: http://www.phpoll.com/poll/)" dovrete scrivere il percorso assoluto del
poll appena creato (sempre partendo dall'esempio precedente, il percorso assoluto sarebbe:
<b>http://www.phpoll.com/phpoll/polls/NOME/</b></li>
<li>è importante indicare anche il suffisso del protocollo "http://"</li>
</ul>

<p class="titoletto">INTEGRAZIONE CON LE VOSTRE PAGINE WEB</p>

<p class="note">i files che servono per il funzionamento di phpoll sono essenzialmente due:</p>
<ul>
<li>phpoll.php</li>
<li>risultati.php</li>
</ul>
<p>(si trovano nella root della directory generata nella fase precedente ("../phpoll/polls/NOME/"))</p>
<ul>
<li>"phpoll.php": è il file che contiene lo script che genera la lista dei candidati da votare</li> 
<li>"risultati.php": è il file che genera i risultati delle votazioni</li>
</ul>
<p class="note">in particolare:</p>
<ul>
<li>siete liberi di integrare questi script all'interno delle vostre pagine html o php nonchè liberi di 
modificare qualunque parte per adattarla alle vostre esigenze</li>
<li>se avete intenzione di riportare soltanto il codice vero e proprio all'interno di una vostra pagina, ricordatevi di copiare la parte relativa allo <b>script (javascript)</b> nella sezione "head" della 
pagina <b>phpoll.php</b> all'interno della stessa sezione "head" della vostra pagina in cui viene eseguito il phpoll, per non compromettere alcune importanti funzioni</li>
<li>l'impaginazione è semplice ed ho usato un piccolo file css, facilmente modificabile 
("../css/homepage_layout.css")</li>
<li>siete liberi di riprogettarla completamente con o senza css</li>
<li>potete spostare la cartella appena creata ("NOME/") mantenendo le relazioni delle sottocartelle, 
e il funzionamento non sarà compromesso</li>
</ul>

<p class="titoletto">PHPOLL si avvale dei seguenti programmi open source (un grazie particolare a tutti gli autori):</p>
<ul>
<li>AnchorPosition.js di Matt Kruse <a href="http://www.mattkruse.com/">http://www.mattkruse.com</a></li>
<li>PopupWindow.js di Matt Kruse <a href="http://www.mattkruse.com/">http://www.mattkruse.com</a></li>
<li>ColorPicker2.js di Matt Kruse <a href="http://www.mattkruse.com/">http://www.mattkruse.com</a></li>
<li>Custom JavaScript Functions di Shawn Olson <a href="http://www.shawnolson.net">http://www.shawnolson.net</a></li>
<li>Uno script di cripting di Alexander Valyalkin trovato su php.net <a href="http://www.php.net">http://www.php.net</a></li>
</ul>


<p class="titoletto">NOTE FINALI</p>
<ul>
<li>questo programma è rilasciato sotto licenza <a href="license.txt">GNU/GPL</a></li>
<li>il software è progettato in php (programmazione strutturata, non orientata agli oggetti) ed è stato ampiamente testato</li>
<li>non sono in ogni caso responsabile di eventuali bug, malfunzionamenti del presente software, nè tantomeno sono responsabile di eventuali danni causati al vostro database, server, ecc...</li>
<li>apprezzerò comunque ogni segnalazione di bug, così come ogni suggerimento per migliorare questo software</li>
<li>le donazioni sono totalmente libere e sono sempre gradite (via paypal a hide@address.com o utilizzando il link preimpostato)</li>
<li>non sono un programmatore professionista, per cui non chiedetemi la luna!</li>
</ul>

</div>
</div>

<?php

}

else if ($language==2) {
	
print "<a href=\"index.php?language=".$language."\">home</a>";
print "<a href=\"connetti_db.php?language=".$language."\">connect to database</a>";
print "<div class=\"menu_attuale\">info</div>";
	
?>

</div>

</div>

<div class="corpo">

<p class="titolo">
PHPOLL v. 0.97 beta
</p>

<p class="sotto_titolo">
written in PHP by Massimo Perini
</p>
<p class="note">MySql needed</p>
<p class="note">for any question: <a href="mailto:hide@address.com">hide@address.com</a></p>
<p class="note">IF YOU WANT TO HELP ME IN LOCALIZATION (ENGLISH, SPANISH, FRENCH, GERMAN AND OTHER) PLEASE WRITE THANKS</p>

<div class="corpo2">

<p class="titoletto">INSTALLATION</p>
<p class="note">step 1 - installation of the PHPOLL generator (if you are reading this it means that you already made and you can jump to step 2)</p>
<ul>

<li>be sure you have installed the php and mySql modules and software</li>
<li>unzip the "phpoll096b.zip" into the root directory of your web site (mostly htdocs or www)</li>
<li>bu sure that after this operation a directory named "phpoll" is generated</li>
<li>if you want, first create a new database into mySql (using phpmyadmin or something else) because PHPOLL only generates
tables into an existing database</li>
<li>open a browser and insert the right address where you have just copied the files (eg. if you created "phpoll" 
into www.phpoll.com you have to digit "www.phpoll.com/phpoll/")</li>

</ul>
<p class="note">fase 2 - installation of PHPOLL</p>
<ul>
<li><b>give the writing permissions</b> (CHMOD 777, 755, 750 are good) to the directory "polls/"
into the phpoll root (any FTP client can do this)</li>
<li>click to "connect to database" in the menu</li>
<li>insert "host", "user" and "password" to connect to mySql</li>
<li>now choose the database where you want that PHPOLL generates the new tables (needed to work)</li>
<li>insert the <b>NAME</b> of the poll you want to create and confirm with the submit button "create"</li>

</ul>

<p class="note">if everything was ok, <b>phpoll</b> generated:</p>

<ol>
<li>the mySql tables needed:</li>
<ul>
<li>phpoll_NOME_band = contains the candidates data</li>
<li>phpoll_NOME_configurazione = contains the configuration data</li>
<li>phpoll_NOME_voti = contains the voting info (IP, data, browser, etc...)</li>
</ul>
<li>
a directory containing all the files needed by phpoll to work, that will be named with the name just
chose by you (eg.: "NAME") and will be created into the "polls/" directory into "phpoll/"
(in the example, the url should be "www.phpoll.com/phpoll/polls/NAME/")</li>
</ol>

<p class="note">you will be redirected to the admin page (in the example the url
should be: "www.phpoll.com/phpoll/polls/NAME/admin/") and from here you can do all the modifies
you want</p>

<p class="titoletto">IMPORTANT!!! SETUP THE ABSOLUTE URL OF THE PHPOLL</p>
<p>it's very important that you setup the absolute URL of the poll just created, because this is needed
for the poll confirmation via e-mail, for locating the file "elabora_voto_new.php", that is the php script
that verifies and confirm the vote from the link sent via mail</p>
<p>to do this you only have to:</p>
<ul>
<li>go to the admin page</li>
<li>select <b>configuration</b> from the menu</li>
<li>at point "absolute URL of the poll (ex.: http://www.phpoll.com/poll/)" you have to write the absolute URL
of the poll just created (in the example, the URL should be:
<b>http://www.phpoll.com/phpoll/polls/NAME/</b></li>
<li>it's very important to include the "http://"</li>
</ul>

<p class="titoletto">INTEGRATION WITH YOUR WEB PAGES</p>

<p class="note">the files you really need to let PHPOLL work are 2:</p>
<ul>
<li>phpoll.php</li>
<li>risultati.php</li>
</ul>
<p>(they are into the root generated ("../phpoll/polls/NAME/"))</p>
<ul>
<li>"phpoll.php": contains the script that generate the candidate list</li> 
<li>"risultati.php": contains the script that generate the results of the votation</li>
</ul>
<p class="note">in particular:</p>
<ul>
<li>you are free to integrate these scripts into your web pages, and adapt at your needs</li>
<li>if you want to copy just the php script without the html header, please remember to copy also the <b>script (javascript)</b> into the "HEAD" section 
of the file <b>phpoll.php</b> into the section "HEAD" of your html (php generated of course) to let the javascript work</li>
<li>for the layout I used a simple css file, easy to change 
("../css/homepage_layout.css")</li>
<li>you are free to redesign, with or without css</li>
<li>you can change the url of the directory just created, keeping all the relations of the files</li>
</ul>

<p class="titoletto">PHPOLL contains part of the following open source software (many thanks to the authors):</p>
<ul>
<li>AnchorPosition.js by Matt Kruse <a href="http://www.mattkruse.com/">http://www.mattkruse.com</a></li>
<li>PopupWindow.js by Matt Kruse <a href="http://www.mattkruse.com/">http://www.mattkruse.com</a></li>
<li>ColorPicker2.js by Matt Kruse <a href="http://www.mattkruse.com/">http://www.mattkruse.com</a></li>
<li>Custom JavaScript Functions by Shawn Olson <a href="http://www.shawnolson.net">http://www.shawnolson.net</a></li>
<li>A cripting php script by Alexander Valyalkin found on php.net <a href="http://www.php.net">http://www.php.net</a></li>
</ul>


<p class="titoletto">FINAL NOTES</p>
<ul>
<li>this software is released under license <a href="license.txt">GNU/GPL</a></li>
<li>the software is written in php (structured, not oop) and also well tested in the occasion of a big contest</li>
<li>I take no responsability for any bug, as well I take no responsability for any lost of your data or database settings, server settings, etc.</li>
<li>I will appreciate any bug submission</li>
<li>donations are totally free (via paypal to hide@address.com)</li>
<li>I am not a professional programmer, it's just a passions!</li>
</ul>

</div>
</div>


	
<?php	
	
}

?>


</body>
</html>
Return current item: PHPOLL php - mysql poll system