// *************************************************************************************
//                                                                      
//  Contatore GIF  - Versione 2.00 - Dicembre 2005
//     
//  by gian luca ruggero (rgl_it@yahoo.it)
//      
//  Ultima modifica: marted 13 settembre 2005 20:05
//      
//  Codice: Script in php 4.4.0
//          Necessita di GD2 (libreria grafica di php, chiedete al web Hoster)
//
// ***************************************************************************************
//
// Funzione: E' un contatore in php che una volta linkato restituisce una GIF (immagine) 
//           che mostra un contatore (tipo 0002520). Permette quindi di capire quante 
//           persone visitano il tuo sito.
//
// Funzionalit:
//    Lo script  configurabile via url. In pratica se vuoi puoi vedere l'immagine
//    del contatore in tuti i colori che preferisci, con il font che vuoi  e della
//    dimensione che vorresti. Questo per potersi integrare il contatore nello stile 
//    della tua pagina web.
//
// Come funziona in due frasi:
//    Lo linki come immagine e ogni volta che il visitatore vede la pagina
//    in numeretto mostrato aumenta di uno [o di quello che vuoi ;-)]
//
// Installazione super-rapida:
//   Decomprimi il tutto in una cartella root/contatore_gif/
//   Copia e incolla il seguente codice (modificando dove serve...)
//
//   <img src="http://www.nome_tuo_sito.xxx/contatore_gif/contatore_gif.php" alt='Contatore GIF V2.00 - By rgl_it@yahoo.it'>
//
//  Controlla che funzioni. Se non hai le librerie GD2 o hai un php vecchio non vedrai
//  nessuna immagine. Se vedi un !01203 lo script quasi funziona. Mancano probabilmente le
//  librerie GD2. Chiedi al tuo hoster di installarle o esegui un phpinfo() per vedere
//  cosa hai.
//
// Installazione:
//    Il percorso di installazione cambia se sei o meno esperto di php e http.
//    Partiamo dalla maniera pi semplice:
//    
//    A) Prendi il file compresso (contatore_gif.zip)
//       e decomprimilo in una cartella di servizio (cio non sul tuo server!).
//
//    Dovresti avere i seguenti file:
//       + Nuova Cartella 
//           -> readme.txt              (questo file)
//           -> contatore_gif.php       (il contatore stesso)
//           +  contatore               (una sotto cartella)
//              -> arial_10.gif          (questi sono i caratteri utilizzabili)
//              -> arial_12.gif
//              -> arialblack_10.gif
//              -> arialblack_12.gif
//              -> times_10.gif
//              -> times_12.gif
//              -> timesblack_10.gif
//              -> timesblack_12.gif
//              -> verdana_10.gif
//              -> verdana_12.gif
//              -> verdanablack_10.gif
//              -> verdanablack_12.gif
//              -> ... altri file.gif
//
//   B) Copia i file nella directory del tuo sito. Puoi benissimo mandarli via ftp o come preferisci.
//      Ti consiglio di non copirali nella directory principale ma in una sottocartella, come
//      vedi nell'esempio:
//
//       + tua_directory
//         -> index_tuo_sito.html
//         -> altri_file.*
//         +  sottocartelle_tuo_sito
//         +  contatore_gif            (crea questa cartella !)
//            -> readme.txt              (questo file)
//            -> contatore_gif.php       (il contatore stesso)
//            +  etc etc
//
//   C) Se segui l'esempio avrai in file contatore_gif.php in una sottodirectory di tua_directory. Quello
//   che ti serve sapere  l'indirizzo URL del file! Poniamo che sia come l'esempio di sopra:
//
//     URL relativo = ./contatore_gif/     (rispetto ad index_tuo_sito.html)
//     URL assoluto = http://www.nome_tuo_sito.xxx/contatore_gif/contatore_gif.php
//
//   D) ti consiglio di determinare l'url ASSOLUTO e di usare sempre quello.
//
//   E) adesso devi linkare il contatore nelle tue pagine. Dovresti copiare il seguente codice HTML nella
//      tua pagina web:
//
//      <img src="http://www.nome_tuo_sito.xxx/contatore_gif/contatore_gif.php" alt='Contatore GIF V2.00 - By rgl_it@yahoo.it'>
//
//      oppure se vuoi personalizzarlo (cambiare colore, font, etc...):
//      <img src="http://www.nome_tuo_sito.xxx/contatore_gif/contatore_gif.php?[PARAMETRI]" alt='Contatore GIF V2.00 - By rgl_it@yahoo.it'>
//
//      Quello che ho chiamato [PARAMETRI] son appunto i parametri del contatore.
//
// ***************************************************************************************************************************
//
//  PARAMETRI del contatore:
//
//        Prima di cominciare ricordati che in contatore pu usare i font che trovi sotto la cartella /contatore/*.gif. I
//        font altro non sono che immagini trasperenti. Vedi l'ultima sezione per sapere come creare altri font.
//        Adesso partiamo con i parametri. Sono semplici comandi GET nel file php. Cio in parole povere
//        passi un parametro sulla linea di comando (il src di img per capirci) e cos configuri il contatore.
//
//   i parametri vengono passati come GET, cio come &[NOME_PARAMETRO]=(Valore_PARAMETRO) un dopo l'altro.
//   dovresti vedere qualcosa del tipo:
//      <img src="http://www.nome_tuo_sito.xxx/contatore_gif/contatore_gif.php?BG=ffccff&F=arilablack_10&CAR=7" alt='Contatore GIF V2.00 - By rgl_it@yahoo.it'>
//  
//   il primo parametro (quello dopo ?) non ha bisogno di &. Puoi mettere i parametri in qualsiasi ordine preferisci
//   o anche non metterne affatto. I parametri possono essere scritti in maiuscolo o minuscolo.
//        
//    il contatore accetta i parametri:
//          
//    [B]    background: imposta il colore di sfondo in esadecimale (000000 per nero, FFFFFF per bianco, etc)
//           (Default: bianco #ffffff)
//    [F]    sceglie il font utilizzato.  prende il font da /counter/*.gif. Basta porre il nome di uno dei file 
//           che trovi (senza il gif finale).  Se ad esempio vuoi arialblack_10.gif devi porre f=arialblack_10.
//           (Default: verdana_10)
//    [CF]   stabilisce il numero di cifre del contatore.
//           ad esempio se vuoi un contatore a 8 cifre devi porre CF=8, oppure
//           CF=3 per tre cifre, etc. Quando il contatore sfora ritorna a zero (sullo schermo!)
//           (Default: 5 cifre => del tipo 12345, minimo 3 massimo 10)
//    [CL]   imposta il colore del font.
//           (Default: nero #000000)
//    [BR]   imposta il colore del border (bordino intorno al testo) e contemporaneamente lo attiva.
//           Se non impostato non mostra nessun bordo
//           (Default: nessun bordo)
//    [C]    Il parametro pi importante. Permette di avere diversi contatori per ogni singola pagina.
//           Quindi se hai duemila pagine avrai anche duemila contatori diversi che segnano duemila numeri
//           diversi. Come si ottiene? Semplice. Prendi questo parametro e mettigli un nome.
//           Poniamo che tua abbia tra pagine nel tuo sito. Chiamiamole per semplicit adelina.html, giovanna.html 
//           e michela.html. Se vuoi tre contatori nelle tre pagine aggiungi il codice html:
//
//         in adelina.html :
//         <img src="http://www.nome_tuo_sito.xxx/contatore_gif/contatore_gif.php?c=adelina" alt='Contatore GIF V2.00 - By rgl_it@yahoo.it'>
//
//         in giovanna.html :
//         <img src="http://www.nome_tuo_sito.xxx/contatore_gif/contatore_gif.php?c=giovanna" alt='Contatore GIF V2.00 - By rgl_it@yahoo.it'>
//
//         in michela.html :
//         <img src="http://www.nome_tuo_sito.xxx/contatore_gif/contatore_gif.php?c=michela" alt='Contatore GIF V2.00 - By rgl_it@yahoo.it'>
//                
//         ed avrai il numero di visite in ognuno di essi!
//         (Default: vuoto, quindi tutte le pagine hanno lo stesso numero)
//         ATTENZIONE:   
//         con il parametro counter puoi avere due o pi contatori nella stessa pagina. Ti basta chiamarli con nomi diversi!
//   [S]   imposta di quanto cambia il contatore per ogni visita.
//         in genere un visitoatore = +1 al contatore. Ma ci sono utenti che mi hanno chiesto di poter imbrogliare,
//         aumentanto il numero segnato. se impostate step ad un valore diverso da 1, avrete un aumento __random__
//         fino al valore indicato.
//         Esempietto: STEP=5 incrementa il contatore di un numero compreso tra 1 e 5. Quindi se visitate la pagina
//         ad esempio 3 volte il contatore si incrementer da minimo 3 a massimo 15 volte.
//         Consiglio: uno step=2  un buon inganno. Ogni step superiore  una truffa che in genere si nota.
//         (default = 1, minimo 1, massimo 10)
//
// ******************************************  
//  TUTTI I PARAMETRI SONO OPZIONALI!!!
// *****************************************
//   
// Esempio di utilizzo:
//
// prendimao le tre pagine viste sopra: adelina.html, michela.html e giovanna.html. Mostriamo adesso come realizzare tre contatori
// specifici per ongi pagina e una contatore "unico" per tutte e tre le pagine.
// Cioe: un contatore per uno e uno per tutti e tre.
//
// Poniamo che lo sfondo di adelina di nero, il testo tutto blu.
// potreste copiare i due codici html;
//
//  <...altro html ...>
//    <tr> <td> Visite in adelina.html: 
//         <td> <img src="http://www.nome_tuo_sito.xxx/contatore_gif/contatore_gif.php?c=adelina&cf=3&br=00000&cl=00FFFF" alt='Contatore GIF V2.00 - By rgl_it@yahoo.it'>
//    <tr> <td> Visite in tuo_sito: 
//         <td> <img src="http://www.nome_tuo_sito.xxx/contatore_gif/contatore_gif.php" alt='Contatore GIF V2.00 - By rgl_it@yahoo.it'>
//  <...altro html ...>
//
// Poniamo adesso che lo sfondo di michela sia rosso e il testo tutto blu come prima ma che tu volgia un contatore diverso.
// potreste copiare i due codici html;
//
//  <...altro html ...>
//    <tr> <td> Visite in michela.html: 
//         <td> <img src="http://www.nome_tuo_sito.xxx/contatore_gif/contatore_gif.php?c=michela&f=verdanablack_12&cf=7&br=FF0000&cl=00FFFF" alt='Contatore GIF V2.00 - By rgl_it@yahoo.it'>
//    <tr> <td> Visite in tuo_sito: 
//         <td> <img src="http://www.nome_tuo_sito.xxx/contatore_gif/contatore_gif.php" alt='Contatore GIF V2.00 - By rgl_it@yahoo.it'>
//  <...altro html ...>
//
// In ultimo lasciamo a giovanna le impostazioni di default ma poniamo solo uno step=4
// potreste copiare i due codici html;
//
//  <...altro html ...>
//    <tr> <td> Visite in giovanna.html: 
//         <td> <img src="http://www.nome_tuo_sito.xxx/contatore_gif/contatore_gif.php?c=giovanna&s=4" alt='Contatore GIF V2.00 - By rgl_it@yahoo.it'>
//    <tr> <td> Visite in tuo_sito: 
//         <td> <img src="http://www.nome_tuo_sito.xxx/contatore_gif/contatore_gif.php" alt='Contatore GIF V2.00 - By rgl_it@yahoo.it'>
//  <...altro html ...>
//
// COME OPERA LO SCRIPT:
//    lo script una volta chiamato attraverso le GD2 di php crea una immagine e copia dal file font_XX.gif l'immagine
//    della cifra. Se volete creare un nuovo font vi basta salvare le cifre 0123456789 in una file in bianco/trasparente.
//    fate attenzione a che tutte le cifre siano in fila e spaziate opportunamente (con in una griglia).
//    Vi devo sconsigliare dall'usare pi di due volte in una stessa pagina perch potreste occupare troppe risorse
//    sul server. Nei miei test sono per arrivato a 15 contatori attivi senza troppi problemi. Ma  anche vero che non sono 
//    io che devo gestire un server ;-)
//
// FINE:
//  Grazie per aver scaricato e provato questo file.
//  Suggerimenti, bugs e commenti sono bene accetti [anche soldi, se ne avete ;-) ]
//  Il software  liberamente usabile (freeware) per utenti privati e commerciali per uso proprio.
//  Se volete fornire un servizio di monitoraggio e volete usare questo script,
//  contattatemi perch posso offrirvi una soluzione (commerciali) di gran lunga pi sofisticata e meno
//  invasiva dal punto di vista delle risorse.
   
