I file ".counter"

Per inserire un contatore in una certa pagina occorrerà innanzitutto creare, nella stessa directory, un file con lo stesso nome ma con in più la desinenza ".counter".

Se ad esempio vogliamo contare il numero di accessi alla pagina "index.html", dobbiamo creare un file chiamato "index.html.counter".

Questo file sarà usato per memorizzare il valore del contatore, senza nessun formato particolare, ma come semplice stringa di cifre decimali. Quindi, se ad esempio il contatore è arrivato al valore 1234, il file conterrà la sequenza di caratteri "1234".

All'inizio si potrà anche lasciare il file vuoto, ed in tal caso il conteggio partirà da 1 (ma bisogna comunque ricordarsi di crearlo!). Altrimenti si potrà creare il file inserendogli un qualsiasi valore di partenza. Ovviamente si potrà modificare il valore del contatore in qualsiasi momento, semplicemente cambiando il valore contenuto all'interno del file.

A questo punto occorrerà decidere se utilizzare il contatore in forma grafica o in forma testuale.

Versione grafica

Questo è il caso più semplice, sarà infatti sufficiente inserire nella pagina HTML una immagine creata dinamicamente da un apposito programma cgi-bin, che si trova alla URL "/cgi-bin/counter" (attenzione a scrivere tutto in minuscolo!). Ecco quindi un esempio di tag img da inserire all'interno della propria pagina HTML:

<img src="/cgi-bin/counter">

Se non diversamente specificato, il valore del contatore si riferisce alla pagina mostrata in quel momento dal browser. L'indirizzo di tale pagina viene ricavato dal campo "Referer" che normalmente i browser mandano assieme alla richiesta di ogni file. Ciò implica che questo sistema molto semplice di richiamare il contatore potrebbe non funzionare con qualche browser molto vecchio o molto rudimentale. Un'altra possibile causa di problemi potrebbe verificarsi qualora la URL puntata dal browser sia una directory, perché in questo caso il programma deve tentare di indovinare il nome del file realmente scaricato (di solito "index.html").

Nella maggioranza dei casi non vi è alcun problema ad usare questa forma semplice per richiamare il contatore, ma se si vuol essere proprio sicuri si può usare il parametro "file" descritto di seguito.

Il parametro "file"

Per risolvere un maniera definitiva i potenziali problemi sopra descritti si può specificare esattamente il nome del file di cui si vuole mostrare il valore del contatore specificandone il path completo tramite il parametro "file".

Per far ciò occorre innanzitutto conoscere il path del proprio spazio web all'interno del server Neomedia. Questa informazione č riportata all'inizio della sezione "Spazio web" del proprio Pannello di controllo.

Supponiamo ad esempio che il path al proprio spazio web sia "/wwwdocs/user/mross01/". A questo punto il path completo al file "miofile.html" nella directory "miadir" sarà:

/wwwdocs/user/mross01/miadir/miofile.html

Il tag "img" da utilizzare per mostrare il valore del contatore di accessi a questo file sarà quindi il seguente:

<img src="/cgi-bin/counter?file=/wwwdocs/user/mross01/miadir/miofile.html">

Tramite il parametro "file" è quindi possibile visualizzare in una qualsiasi pagina web il contatore relativo a qualsiasi altra pagina oppure a qualsiasi altro file presente nel proprio spazio web, sia esso una immagine, un file sonoro, un documento Word o quant'altro. Occorre ovviamente ricordarsi di attivare il contatore creando il file ".counter" corrispondente.

Il parametro "type"

Questo parametro permette di specificare quali immagini utilizzare per le cifre del contatore. Sono disponibili una serie di immagini predefinite identificate dai seguenti nomi (cliccateci sopra per vedere un esempio del risultato):

Il tipo usato di default è "a". Se invece si vogliono utilizzare ad esempio le immagini di tipo "baby" si può utilizzare il seguente tag:

<img src="/cgi-bin/counter?type=baby">

È inoltre possibile utilizzare qualsiasi altra serie di immagini. Per far ciò occorre creare dieci immagini in formato GIF contenenti le dieci cifre, chiamando i file "0.gif", "1.gif", "2.gif", etc. Questi file vanno scaricati in una directory del proprio spazio web, ad esempio "miocontatore". A questo punto sarà sufficiente impostare il parametro "type" con il path completo alla suddetta directory. Ad esempio:

<img src="/cgi-bin/counter?type=/wwwdocs/user/mross01/miocontatore">

Il parametro "length"

Tramite il parametro "length" si può specificare il numero di cifre del contatore (di default è pari a 5).

Ad esempio, per visualizzare un contatore di 8 cifre si può utilizzare il seguente tag:

<img src="/cgi-bin/counter?length=8">

Il parametro "val"

Infine, per fare degli esperimenti, si può usare il parametro "val" per visualizzare un dato valore a piacimento, al posto del valore del contatore della pagina.

Ad esempio, per vedere tutte le dieci cifre del tipo "baby" si può usare un tag img come il seguente, che inoltre mostra come combinare più parametri in un unico tag tramite l'operatore "&":

<img src="/cgi-bin/counter?type=baby&length=10&val=1234567890">

Versione testuale

Il numero di volte che una pagina è stata letta si trova nella variabile d'ambiente "COUNTER". Per visualizzare il contenuto di una variabile d'ambiente occorre utilizzare i server-side includes. Se non si sa di che cosa si tratta, si può far riferimento alla documentazione di Apache (il server web utilizzato da Neomedia, ed il pių diffuso al mondo).

Ricordiamo che per attivare i server-side includes bisogna rinominare i file cambiandone la desinenza in ".shtml". In alternativa, si può dire al server web di gestire tramite i server-side includes tutti i file HTML contenuti in una certa directory. Per far ciò si può aggiungere la seguente linea al file ".htaccess" nella directory in questione:

AddType text/x-server-parsed-html .html

In tal modo tutti i file con desinenza ".html" verranno processati come se fossero degli ".shtml", a scapito però di un certo appesantimento nella gestione delle pagine.

A questo punto sarà sufficiente scrivere il valore della variabile "COUNTER" tramite il comando "#echo" dei server-side includes. Un esempio di testo da inserire nella propria pagina HTML potrebbe quindi essere il seguente:

Sei il visitatore numero <!--#echo var="COUNTER"-->.