Chrissyx Homepage Scripts – Counter

Version: 3.2

ENGLISH - CLICK HERE!

Inhalt

Vorwort
Vorraussetzungen
Installation
Update
FAQ
Credits

Vorwort

Mehr als nur ein einfacher Counter, hat dieser zustätzliche Features und eine multilinguale Administrationsoberfläche. Von dort aus ist alles einstellbar, die Art der Ausgabe bis hin zu den Speicherorten der internen Systemdateien; gecachte Einstellungen werden dabei automatisch erneuert und nach Logout sofort wirksam. Die optionale Backup-Funktion ist so einstellbar, dass man festlegt nach wievielen Hits jeweils der aktuelle Stand per E-Mail versendet wird. Mit der optionalen IP Sperre betreibt man entweder einen reinen Hits-Counter oder einen echten Besucherzähler.

Vorraussetzungen

PHP ab 5.3
chmod-fähiger Webspace

Installation

Lade in dem Ordner, wo deine Webseite ist und auf welcher der Counter zum Einsatz kommen soll, den Ordner "chscore" samt Inhalt hoch. Falls der Ordner bereits existiert, können vorhandene Dateien ersetzt werden.
Falls noch nicht vorhanden, füge ganz am Anfang deiner Seite (noch vor <html>, <!DOCTYPE [...] oder <?xml [...]) diesen Code ein:
<?php include('chscore/CHSCore.php'); ?>
Rufe danach deine Seite auf und hänge ein ?module=CHSCounterAdmin an die Adresse an. Folge dann den Anweisungen.

Beispiel

Deine Seite ist:
https://www.meineSeite.de/meinOrdner/meineIndex.php
(Hier in die erste Zeile <?php include('chscore/CHSCore.php'); ?> einfügen)
Dann den Counter hochladen nach:
https://www.meineSeite.de/meinOrdner/chscore/
Und die Installation starten mit:
https://www.meineSeite.de/meinOrdner/meineIndex.php?module=CHSCounterAdmin

Update

Update von 3.1 auf 3.2

Lade den Ordner "chscore" samt Inhalt hoch und ersetze so die jeweils vorhandenen Dateien.

Update von 3.0 auf 3.2

Sichere dir die Dateien "counter.dat" und, falls vorhanden, "ip.dat" im "chscore/modules/CHSCounter/"-Ordner. Lösche danach den Ordner "chscore" und installiere die neue Version wie oben beschrieben. Eingefügter Code auf deiner Seite braucht dann nicht weiter verändert werden. Lade danach die gesicherten Dateien in den Ordner "chscore/data/" hoch und ersetze die vorhandenen.

Update von älteren Versionen auf 3.2

Falls Du also eine ältere Version betreibst, notiere dir den Counterstand und sichere (wenn vorhanden) die "ip.dat"-Datei aus dem "counter"-Ordner. Danach den "counter"-Ordner löschen und auch den damals eingefügten Code von deiner Seite entfernen. Bei der Installation der 3er kannst Du dann deinen vorhandenen Counterstand wieder eingeben und wenn Du vorher die "ip.dat" gesichert hattest, die Einstellung dafür anpassen. Merke dir dabei den angegebenen Pfad und Dateinamen, denn dort musst Du nach der Installation die "ip.dat" wieder hochladen und überschreiben; ggf. umbenennen.

FAQ

Wie kann ich meinen Counter verwalten?
Rufe, wie schon bei der Installation auch, deine Seite mit dem Anhängsel ?module=CHSCounterAdmin auf und folge den Anweisungen.
Ich habe mein Passwort vergessen!
Begib dich ganz normal zum Login, dort kannst Du dir auch ein neues Passwort zu schicken lassen. Das alte bleibt weiterhin gültig, bis Du dich mit dem neuen eingeloggt hast.
Kann man andere Bilder für die Zahlenausgabe nutzen?
Na klar, Du brauchst nur die vorhandenen PNG-Bilder durch deine eigenen zu ersetzen. Für jede Zahl ein eigenes Bild, also die "0" muss "0.png" heißen, die "1" muss "1.png" heißen, usw. Die Zahlenbilder müssen alle im "chscore/images/CHSCounter/"-Ordner sein.
Ich erhalte die Meldung "ERROR: Can't create config file!"‽
Es werden Schreibrechte benötigt, die Du in so einem Fall wohl selber setzen musst. Ändere mit deinem FTP Programm per chmod-Befehl die Rechte auf 755 für folgende Ordner:
- chscore/config/
- chscore/data/
Kann ich den Counter auch in andere Sprachen übersetzen?
Aber sicher: Kopiere dir die passende INI-Datei aus dem Ordner "chscore/languages/" (z.B. de-DE.CHSCounter.ini) und benenne das offizielle Sprachkürzel im Dateinamen in die jeweilige Sprache um. Z.B. "fr-FR.CHSCounter.ini" für Französisch aus Frankreich oder "nl.CHSCounter.ini" für allgemein Niederländisch. Übersetzte dann die Texte in den Anführungszeichen und achte dabei auf die Hinweise am Anfang der Datei. Wenn Du eine vollständige Übersetzung hast, lade sie in den "chscore/languages/"-Ordner und wähle sie ggf. im Sprachmenü der Administration aus. Bitte schick sie mir auch, so dass ich anderen diese ebenfalls zur Verfügung stellen kann! :)
Meine Frage wurde nicht beantwortet!
Dann besuch mein Forum unter https://www.chrissyx.com/forum/ oder schreib mir eine E-Mail: chris@chrissyx.com

Credits

Introduction

More than a simple counter, this one has additional features and a multilingual administration panel. Starting there everything is configurable, from the type of output up to storage locations of the internal system files; cached settings are renewed automatically and immediately active after logout. The optional backup possibility can be set to send the current value by email after each certain amount of hits. By using the optional IP blocker the script is operating as a true visitor counter or just as a simple hit counter.

Requirements

PHP 5.3 or higher
chmod-able webspace

Installation

Upload in that directory, in which your website is (and you're planning to use the counter), the folder "chscore" including its contents. If it already exists, overwrite the files.
If not yet present, paste in this code at the very beginning of your site (even before <html>, <!DOCTYPE [...] or <?xml [...]):
<?php include('chscore/CHSCore.php'); ?>
Point your browser to your website and attach ?module=CHSCounterAdmin to the address. Follow the instructions.

Example

Your site is:
https://www.mySite.com/myFolder/myIndex.php
(Put in here in the first line <?php include('chscore/CHSCore.php'); ?>)
Then upload the counter to:
https://www.mySite.com/myFolder/chscore/
And start installation with:
https://www.mySite.com/myFolder/myIndex.php?module=CHSCounterAdmin

Update

Update from 3.1 to 3.2

Upload the folder "chscore" including its contents and replace each existing file.

Update from 3.0 to 3.2

Back up the files "counter.dat" and, if present, "ip.dat" from folder "chscore/modules/CHSCounter/". Delete the folder "chscore" afterwards and install the new version as explained above. Pasted in code on your website doesn't need to be changed again. Finally upload the backed up files to the "chscore/data/" folder and replace the existing ones.

FAQ

How to manage my counter?
Just point your browser to your website by adding ?module=CHSCounterAdmin to the address, as you did during the installation and follow the instructions.
I've forgot my password!
Go to the login form, you can request a new password there. The old one is still valid until you log in with the new password.
Can I use other images for displaying the counter value?
Sure, you just need to replace the provided PNG images with your own ones. For each number an own image, that means the "0" has to be named "0.png", the "1" has to be named "1.png", etc. Put all images with numbers into the "chscore/images/CHSCounter/" folder.
I'm getting a message "ERROR: Can't create config file!"‽
Set with your FTP program and chmod command the permisson to 755 for these folders:
- chscore/config/
- chscore/data/
Is it possible to translate the counter to another language?
Of course, copy an appropriate INI file (e.g. en-US.CHSCounter.ini) from the "chscore/languages/" folder and rename the official language code of the filename to the corresponding of the desired language. Like "fr-FR.CHSCounter.ini" for French in France or "nl.CHSCounter.ini" for general Dutch. Start translating the strings between the quotation marks and check the hints at the beginning of the file. By having a complete translation, upload it to the "chscore/languages/" folder and if applicable choose it from the language menu in the administration panel. Please send it also to me for providing it to other user! :)
My question isn't answered here!
Please visit my board at https://www.chrissyx.com/forum/ or write me an email: chris@chrissyx.com