1. SimpleCounter-2  Kurzbeschreibung
Ein DSGVO-freundlicher Besucherzhler fr moziloCMS. Zhlt Besucher nach verschiedenen Zeitrumen, speichert IP-Adressen nur verschlsselt, bietet Cookie-Sperre, konfigurierbare Online-Anzeige und barrierefreie Ausgabe.

2. Besonderheiten SimpleCounter-2

2.1 Modernisierung

- berarbeitung fr neuere PHP-Versionen
- Entfernung veralteter Funktionen
- JSON-basierte Speicherung statt serialize / unserialize
- interne Struktur vollstndig modernisiert

2.2 Sicherheit

- IP-Adressen werden nicht im Klartext gespeichert
- Hashing mit SHA-256 und individuellem Salt
- Cookies mit SameSite=Lax, HttpOnly und Secure (bei HTTPS)
- automatische Salt-Erzeugung bei der Installation

2.3 Funktionale nderungen

- Anzeige der Online-Benutzer ber konfigurierbare Zeitspanne
- Cookie-Sperre zur Vermeidung mehrfacher Zhlungen
- benutzerdefinierte Ausgabe per Template und Platzhaltern
- automatische Erstellung der Datei data.txt

2.4 Barrierefreiheit

- Standardausgabe erfolgt ber strukturiertes HTML
- klare Listenausgabe fr Screenreader geeignet

2.5 Sonstiges

- Salt kann im Adminbereich regeneriert werden
- Listen-Prfix frei einstellbar
- Auswahl Modus: als Block mit Listenelementen oder eine Zeile

3. Voraussetzungen und Empfehlungen

3.1 MoziloCMS-Version

- moziloCMS 2.x Rev. 55 oder 3.x

3.2 PHP-Version

- PHP 7.4 oder 8.x

3.3 Weitere Hinweise

- Schreibrechte fr den Plugin-Ordner erforderlich (Erzeugung und Beschreiben von data.txt)
- optional: Session-Untersttzung fr mehrsprachige Ausgaben

4. Installation

4.1 Vorheriges Plugin deinstallieren
- Das alte Plugin SimpleCounter muss vollstndig entfernt werden.

4.2 Installation von SimpleCounter-2

- ZIP-Datei im Adminbereich ber die Pluginverwaltung einbinden
- Anzeige im Adminbereich als SimpleCounter-2

4.3 Aktivierung

* Plugin aktivieren, falls nicht automatisch geschehen

4.4 Grundeinstellungen

- Dauer der IP-Sperre konfigurieren; wann wird Besucher neu gezhlt
- Zeitfenster fr Online-Benutzer einstellen
- Listen-Prfix festlegen
- Template-Einstellungen prfen
- Hash-Salt wird bei der ersten Ausfhrung automatisch erzeugt (normal kein Eingriff ntig)
- Ausgabemodus whlen:
o list  Standard; Blockdarstellung 
o inline  Ausgabe in Zeilenform; frei konfigurierbar

5. Einbau und Syntax

5.1 Grundsyntax
{SimpleCounter}
- Zeigt den Counter an und zhlt den Besucher.

{SimpleCounter|hidden}
- Zhlt den Besucher, zeigt aber keine Ausgabe.

5.3 Untersttzte Platzhalter fr benutzerdefinierte Ausgabe
5.3.1. Blockmodus; (Modus list in admin)

A) Benutzerdefinierte Counter-Darstellung LEER
- Standardblock mit allen Eintrgen
B) Benutzerdefinierte Counter-Darstellung erhlt nur gewnschte Eintrge
- Ausgabe in der Form: Wert Bezeichner (2 Online, 5 Heute usw.)
- Folgende Werte stehen zur Verfgung:
{IconUndTitel|Titel}	- Icon als png-Datei + whlbarer Titel
{UserOnline}		- Besucher gerade online
{Heute}			- Besucher Heute
{Woche}			- Besucher aktuelle Woche
{Monat}			- Besucher aktueller Monat
{Jahr}			- Besucher aktuelles Jahr
{Gesamt}			- Besucher Gesamt; seit Einbau SimpleCounter
{Rekord}			- max-Anzahl Besucher mit Datum des Tages

Beispiel:

Eintrag in Feld:
----------------
{Heute}{Gesamt}

Ausgabe:
--------
1 Heute
85 Gesamt

5.3.2 InLine-Modus (Modus inline in admin)
- Freie Eingabe in einer Zeile mglich (z.B. Footer; frei im Text etc.)
- Zur Verfgung stehen:
A) Platzhalter Standard; liefern Wert + Bezeichner (z.B. 55 Heute)
{UserOnline}
{Heute}
{Woche}
{Monat}
{Jahr}
{Gesamt}
{Rekord}

B) Platzhalter fr Bezeichner (liefern z.B. Heute)
{OnlineLabel}
{HeuteLabel}
{WocheLabel}
{MonatLabel}
{JahrLabel}
{GesamtLabel}
{RekordLabel}

C) Platzhalter fr Werte (liefern z.B. 55)

{UserOnlineWert}
{HeuteWert}
{WocheWert}
{MonatWert}
{JahrWert}
{GesamtWert}
{RekordWert}
{RekordDatum}

Beispiel:

Eintrag in Feld:
----------------
Gezhlte Besucher: {HeuteLabel} - {HeuteWert} | {GesamtLabel} - {GesamtWert} | {RekordLabel} - {RekordWert} {RekordDatum}

Ausgabe:
--------
Gezhlte Besucher: Heute - 1 | Gesamt - 85 | Max. - 7 28.08.2025

Eintrag in Feld:
----------------
Besucherstatistik: Heute - {HeuteWert} / Summe Besucher - {GesamtWert} / Besucherrekord - {RekordWert} ({RekordDatum})

Ausgabe:
--------
Besucherstatistik: Heute - 1 / Summe Besucher - 85 / Besucherrekord - 7 (28.08.2025)

5.4 Besonderheiten

- Ausgabe kann ber eigenes Template vollstndig angepasst werden.
- Wird der Salt gendert, ndern sich alle Hashwerte; gleiche Besucher werden innerhalb 24 Std.  erneut gezhlt.
- Beim Umzug: data.txt und aktuellen Salt sichern und bertragen.
- Zurcksetzen des Counters: Inhalt von data.txt leeren, Datei nicht lschen.

6. Autor und Lizenz
- Autor: hausl78, A. Fleischman
- berarbeitung: G. Fischer
- Lizenz: siehe Projektseite
- Projekt / Kontakt / Source: https://www.mozilo.de/media

7. Changelog (Auszug)

- Version 3.0.3: Erste verffentlichte Version von SimpleCounter-2


