lucliscio/fanKounter

View on GitHub
docs/faqs.txt

Summary

Maintainability
Test Coverage

                                        __       HZKnight free PHP Scripts    _    vs 5.1
                                       / _| __ _ _ __   /\ /\___  _   _ _ __ | |_ ___ _ __
                                      | |_ / _` | '_ \ / //_/ _ \| | | | '_ \| __/ _ \ '__|
                                      |  _| (_| | | | / __ \ (_) | |_| | | | | ||  __/ |
                                      |_|  \__,_|_| |_\/  \/\___/ \__,_|_| |_|\__\___|_|

 ******************************************************************************************
 faqs.txt                                     lucliscio <lucliscio@h0model.org>, ITALY
 ******************************************************************************************

 Q   Come vanno impostati i permessi sui file dello script?

     R   Il fanKounter crea/scrive file ascii, per cui tutti i file dello script devono
         trovarsi in cartelle con permessi di accesso particolari (0777).

     R   Se lo script non riuscisse a creare automaticamente le proprie cartelle di lavoro
         con i permessi di accesso corretti, provare a crearle manualmente ('data/',
         'back/', 'temp/'), attraverso il proprio client FTP, eliminando eventuali cartelle
         omonime gi� create.

     R   Alcuni host WEB mettono a disposizione dei propri utenti cartelle speciali,
         denominate ad esempio 'cgi-bin/' e 'public/', per ospitare script dinamici con
         queste caratteristiche.



 Q   Perch� nella mia pagina WEB l'immagine del contatore grafico non viene visualizzata?

     R   Se stai caricando un contatore in modalit� grafica e ti viene restituito un
         contatore in modalit� testo, probabilmente non � disponibile la libreria GD.

     R   Il contatore restituisce un file/immagine e non codice HTML. Nel caso in cui lo
         script sia ospitato su un dominio gratuito che aggiunge codice (HTML, JavaScript)
         per esporre banner e messaggi pubblicitari, il problema molto probabilmente
         potrebbe essere dovuto a questa situazione. Prova ad utilizzare il contatore in
         modalit� solo testo o nascosta.

     R   Probabilmente lo script 'counter.js.php' non riesce ad auto-generare la posizione
         del fanKounter. Apri il file 'counter.js.php' ed imposta la seguente variabile:

          define( "SCRIPT_PATH" , "http://www.domain.com/path/" );



 Q   Perch� non viene visualizzato nessun output in assenza di messaggi di errore?

     R   L'output di errori e di avvisi � disabilitato. Probabilmente si � verificato un
         qualche errore nello script, forse localizzato in qualche file di configurazione
         che hai creato o modificato. Ricontrolla questi file.

     R   Provare a riattivare l'output degli errori e degli avvisi: dal file 'cnf.inc.php',
         sostituire "error_reporting(0);" con "error_reporting(E_ALL);". Errori tipici che
         potrebbero verificarsi sono quelli dei permessi sui file. Dopo i test, ricordarsi
         di ripristinare le modifiche nel file 'cnf.inc.php'.



 Q   Perch� il contatore non incrementa il numero degli accessi?

     R   Probabilmente ti sta bannando, o per via del tuo IP, o perch� non riconosce la
         giusta locazione, o perch� ti ha gi� conteggiato tra i visitatori. Controlla la
         configurazione del contatore.

     R   Se il contatore segna ancora zero, probabilmente non stai utilizzando il corretto
         identificatore del contatore.



 Q   Perch� quando visito i pannelli delle statistiche mi viene richiesta la password?

     R   La password viene memorizzata nel tuo PC, tramite cookie. Abilita i cookies.



 Q   Cosa stanno ad indicare i termini "visitatore" e "visita"?

     R   Un visitatore compie le visite al sito, quindi uno stesso visitatore pu� compiere
         pi� visite al sito. Rilevare visitatori anzich� visite vuol dire tener conto solo
         una volta di un dato visitatore nell'arco di un periodo di tempo (tempo di visita)
         nell'ambito delle statistiche, evitando di falsarle. Il tempo di visita nel
         fanKounter pu� essere personalizzato in base alle proprie preferenze.



 Q   Come fa il fanKounter a distinguere visitatori da visite?

     R   Memorizza un "impasto" di informazioni del visitatore, composte essenzialmente da
         IP, browser e sistema operativo, in un file sul server.



 Q   Quali sono le caratteristiche dell'immagine originale del contatore?

     R   La codifica � PNG, le dimensioni sono 98 pixel di larghezza e 38 pixel di altezza.



 Q   Quali sono e dove sono i file per far funzionare un contatore?

     R   Per ogni istanza di contatore di nome "ID", i *5* seguenti file:

         conf/conf_ID.php      il file di configurazione
         data/data_ID.php      il database dei dati statistici
         back/data_ID.php      la copia del database, creata temporaneamente a run-time
         temp/accs_ID.dat      i dati per riconoscere visitatori e visite
         temp/lock_ID.tmp      il file condiviso per l'accesso esclusivo al database

         I file nella cartella 'temp' possono essere eliminati senza problemi e verranno
         ricreati dal fanKounter alla prossima esecuzione. Non eliminarli con una procedura
         automatica dentro lo script!



 Q   Come posso azzerare un contatore e le sue statistiche?

     R   Sia tale il contatore identificato con "ID": elimina il file 'data/data_ID.php'.



 Q   Posso fare modifiche allo script e magari redistribuirlo?

     R   Si, ma possibilmente attieniti a quanto scritto nel file 'license.txt'.