Counter

Kort beskrivelse

Counter er et tællerscript, der både kan vise antallet af forespørgsler som tekst og med billedfiler.

Forberedelser til installationen

Åbn filen counter.php i en tekst-editor, f.eks. KEdit (Linux) eller Notesblok (Windows). Ændr variablerne i sektionen, der begynder med PLEASE EDIT THE FOLLOWING VARIABLES. Hvis tælleren skal vise tekst, så skal $counterstyle være lig med "text". Hvis tælleren skal vise billedfiler, så skal $counterstyle være lig med "image". Hvis tælleren skal være usynlig (altså, hvis antallet af forespørgsler ikke skal vises for den besøgende), så skal $invisible være sat til "yes" - eller skal den være sat til "no". De fleste vil nok vælge at sætte den til "no".

Installation

Upload hele denne mappe (counter-mappen) til serveren. Sæt hits-filens rettigheder til 0666. Dette kan gøres ved at vælge punktet "chmod" eller "set file permissions" i et FTP-program og dernæst indstille det således, at både brugeren, gruppen og andre kan læse og skrive i filen. Man kan også gøre det vha. telnet: Åbn et kommandolinjevindue og skriv "telnet dit-netsted.dk". Når du er logget ind, så skift til counter-mappen ("cd /stien/til/counter"), og skriv "chmod 0666 hits".

Indsættelse af tælleren på en side

Nu skal tælleren indsættes på en side. Først og fremmest er det vigtigt, at siden, som tælleren skal indsættes på, er en PHP-side. Filefternavnet for siden skal altså være f.eks. .php eller .phtml. Hvis det f.eks. er forsiden, tælleren skal indsættes på, og det nuværende filefternavn er .html, så skal filefternavnet bare ændres til f.eks. .php. Dernæst skal der indsættes en lille stump kode:

<? require("$DOCUMENT_ROOT/stien/til/counter/counter.php"); ?>

Det mellem parenteserne skal selvfølgelig ændres til den rigtige sti til counter.php. Og hvordan finder man så ud af, hvad stien er? Jo, man åbner sin browser og indtaster adressen til counter.php. Adressen kan f.eks. se sådan ud: http://dit-netsted.dk/scripts/counter/counter.php. $DOCUMENT_ROOT i ovenståede kode svarer nogenlunde til http://dit-netsted.dk, så derfor skal koden i dette eksempel altså ændres til <? require("$DOCUMENT_ROOT/scripts/counter/counter.php"); ?>.

Ovenstående kode skal indsættes på det sted på siden, hvor man vil have tælleren placeret. Man kan også sætte noget tekst foran og bagved. Eksempel:

<b>Der var været <? require("$DOCUMENT_ROOT/stien/til/counter/counter.php"); ?> inde at se dette netsted.</b>

Sådan kommer det til at se ud:

Der har været inde at se dette netsted.

Bemærk, at man også skal indsætte ovenstående kode (minus teksten foran og bagved), hvis man ønsker, at tælleren skal være usynlig. Man skal bare huske inden da at have sat variablen $invisible i counter.php til "yes". Når man så vil tjekke hvor mange, der har set ens side, så skal man bare se i filen hits, hvor tallet står.

Spørgsmål og svar

Hvordan nulstiller man tælleren?
Man åbner filen hits og overskriver det tal, der står der, med 0. Man kan selvfølgelig også skrive et hvilket som helst andet tal, som tælleren skal starte på.

Jeg får fejlen "Warning: Unable to access hits...", når jeg kører scriptet
Dette skyldes sandsynligvis, at filen hits er blevet fjernet fra counter-mappen eller er slettet. Filen skal ligge i samme mappe som selve scriptet (counter.php).

Jeg får fejlen "Permission denied in...", når jeg kører scriptet
Problemet er, at hits-filens rettigheder ikke er indstillet ordentligt. Filen skal chmod'es 0666 - se ovenstående installationsvejledning.

Ophavsret mm.

Dette script udgives under GNU General Public-licensen (også kaldet GPL).

About this script

This script is a counter with the ability to show the number of hits either with text or with images.

Preparations for installation

Load the counter.php file into a text editor, i.e. KEdit (Linux) or Notepad (Windows). Edit the variables in the top part of the script: If you want the counter to be a text counter, set the $counterstyle variable to "text". If you want an image counter, set $counterstyle to "image". If you want the counter to be invisible, set the $invisible variable to "yes" - otherwise, set it to "no". Most people will go for "no" here.

Installation

Upload the entire counter directory to your server. Set the file permissions for hits to 0666. This can be done by selecting the "chmod" or the "set file permissions" option in your FTP client and making the file readable and writeable by both the user, the group, and others. Another way of doing it is telnetting to the server: Open a command line window and enter "telnet your-website.com". Once you've logged in you need to change to the counter dir: "cd /path/to/counter". Now enter "chmod 0666 hits".

Inserting the counter into one of your web site pages

Now you need to insert a code snippet into one of your web site pages (usually the front page). It is very important that you change the file extension of the page to i.e. .php or .phtml. I.e., if the file name of your front page is index.html, you need to change it to index.php. Next, you need to insert this piece of code:

<? require("$DOCUMENT_ROOT/path/to/counter/counter.php"); ?>

The path part needs to be changed into the right path to counter.php. To find out what the right path is, open your browser and enter the URL to counter.php. The URL probably looks something like this: http://your-site.com/scripts/counter/counter.php. The $DOCUMENT_ROOT part of the above code snippet is basically the same as http://your-site.com. Thus, the code that we would write in this example would be: <? require("$DOCUMENT_ROOT/scripts/counter/counter.php"); ?>.

The above code can be put anywhere on your page. You can also add some text in front of it and behind it:

<b>Number of hits: <? require("$DOCUMENT_ROOT/path/to/counter/counter.php"); ?> since January 2000.</b>

This is what it would look like:

Number of hits: since January 2000.

Please note that you need to insert the above code even if you want your counter to be invisible. Just make sure you set the $invisible variable to "yes" in counter.php before inserting the code into one of your pages. When you want to check the number of hits, just open the hits file and take a look.

Questions and answers

How do I reset the counter?
Open the hits file and replace the number in there with 0. Of course you can write any number.

I get this error message when running the script: "Warning: Unable to access hits..."
Maybe the hits file has been moved or deleted. You need to place the hits file in the same directory as the script (counter.php).

I get this error message: "Permission denied in..."
You did not set the file permissions for hits properly. The file needs to be chmod'ed 0666. Have a look at the installation instructions above.

Copyright, etc.

This script is released under the terms of the the GNU General Public License (also known as GPL).