Quelltext der Seite Visitors

[[File:Modul_visitors_fe_all.jpg|right|Besucher]]Ein kleines Modul welches die Zugriffe (Hits) und Besucher (Visits) zählt und zur Anzeige bringt.<br />
Dabei wird in der Anzeige getrennt angezeigt die Zugriffe/Besucher vom aktuellem Tag sowie die jeweilige Gesamtzahl.<br />
Der Zugriffszähler wird, wie der Name schon sagt, bei jedem Zugriff erhöht. Der Besucherzähler zeigt die Zahl der unterschiedlichen IP-Adressen, die innerhalb von 30 Minuten eine oder mehrere Seiten angefordert haben auf dem sich das Modul befindet.<br >


{{Anmerkung|...weiteres folgt in den nächsten Tagen...}}

{{ExtInfo
| Dev=Glen Langer ([[User:BugBuster|BugBuster]])
| DevSite=http://www.contao.glen-langer.de
| ExtVersion=1.7.1
| Version=ab 2.9
| TLVersion=2.7.0 - 2.8.3 (siehe Installationshinweise)
| Depending=[[Bot Detection|Bot Detection]]
| ERLink=http://www.contao.org/erweiterungsliste/view/visitors.de.html
| DonateLink=Cappuccino beim nächsten Stammtisch Treff
| TrackerLink=http://dev.typolight-forge.org/projects/visitors/issues
| Comment=Version für Contao 2.9.RC1 verfügbar
}}
[[en:Visitors]]
[[Kategorie:Extensions]]

=Forum=
Fragen zum Visitors Modul werden im Forum beantwortet: [http://www.contao-community.de/forumdisplay.php?28-visitors Forum - Subforen beliebter Third-Party Erweiterungen (Extensions) - Visitors]
<br />
Fehler und Wünsche können im [http://dev.typolight-forge.org/projects/visitors/issues Tracking System] gemeldet werden.

=Installation=
Installation erfolgt über das Extension Repository im Backend der Contao Installation.<br />
Eine manuelle Installation ist möglich, dazu die ZIP Datei [http://www.contao.org/erweiterungsliste/view/visitors.html vom Extension Repository laden], entpacken und entsprechend übertragen.<br />
Dadurch sollte ein Verzeichnis /system/modules/visitors angelegt worden sein.<br />
Danach wie dabei üblich /contao/install.php Aufrufen - Update Database durchführen.<br />
( /typolight/install.php bei älteren TYPOlight Installationen )<br /><br />
Da das Visitors Modul abhängig ist vom Modul "[[Bot Detection|Bot Detection]]", muss dieses bei der manuellen Installation mit installiert werden.

==Hinweis für ältere TYPOlight Versionen==
===TYPOlight 2.7===
Nutzer von TYPOlight 2.7.x nutzen bitte Visitors Modul Version 1.4.1 ([http://www.contao.org/erweiterungsliste/view/visitors.10040019.de.html Direktlink])

=Übersicht=
Das Visitors Modul bringt 2 Backend und ein Frontend Modul mit.<br />
Im Backend gibt es "Besucher" und "Besucher Statistik", für das Frontend ebenfalls "Besucher".

==Backend==

===Besucher===
[[Datei:Visitors_de_backend_besucher.jpg]]

===Besucher Statistik===
[[Datei:Visitors_de_backend_besucherstatistik.jpg]]

zeigt dann im Detail: (Klick aufs Bild für höhere Auflösung)
[[File:Visitors_de_backend_besucherstatistikdetail.jpg|left|thumb|Besucher Statistik im Detail]]
<br style="clear: both" />

==Frontend==
Für das Frontend werden als Beispiel zwei CSS Dateien mitgeliefert:
*mod_visitors_fe.css für die normale, zeilenweise Ausgabe
*mod_visitors_fe_horizontal.css für die horizontale Ausgabe

===Besucher Statistik===
[[Datei:Modul_visitors_fe_all.jpg]]

===Besucher Statistik horizontal===
[[Datei:Modul_visitors_fe_all_horizontal.jpg]]

=Erste Schritte=
Als erstes legt man über den Menüpunkt Besucher eine neue Besucher Kategorie an. In dieser dann den Besucherzähler.<br />
Danach legt man ein Frontend Modul an und baut es in das Layout ein der Seite.<br />
Hier nun die einzelnen Schritte, jeweils mit den Default Angaben. Feinheiten werden [[Visitors#Feinheiten|später erklärt]].

==Anlegen einer Kategorie==
Um eine neue Besucher Kategorie zu erstellen, klickt man links im Backend unter 'Inhalte' auf 'Besucher'. Im Hauptbereich dann auf den Button 'Neue Kategorie'. 
[[Datei:Visitors_de_backend_kategorie_neu.jpg]]

Am Anfang reichte es einen Kategorie Namen anzugeben, anschließend klickt man auf "Speichern und Schließen".<br />
Nun ist man in der Kategorie Übersicht. Durch Klick auf den Bleistift in der Zeile der Kategorie und nochmaligem Klick auf den Bleistift im Kopf der Kategorie gelangt man wieder zu den Einstellungen der Kategorie.

==Anlegen des Besucherzählers==
In der Kategorie Übersicht klickt man nun auf Edit (Bleistift) der Kategorie.<br />
Dort entweder auf 'Neuer Besucherzähler' und dann das Pfeil Symbol oder auf das Plus im Kopf der Kategorie:
[[Datei:Visitors_de_backend_besucherzaehler_neu.jpg]]

Nun sind einige Angaben nötig:
* Namen angeben (wird über den Zahlen als Überschrift angezeigt).
* Start Datum, ist optional, dient nur zur Anzeige im Frontend
* Optional: 'Startwerte für Zähler' eingeben
* Optional: 'Besucher pro Tag' Anzeige aktivieren
* "Veröffentlicht" aktivieren
anschließend klickt man auf "Speichern und Schließen".

==Frontend Modul==
Ein neues Frontend Modul wird angelegt über:
* Layout -> Themes -> Frontend Module -> Neues Modul (Contao ab 2.9)
* Layout -> Module -> Neues Modul (TYPOlight bis 2.8.x)
<br />
Als erstes unbedingt '''zuerst den Titel''' eingeben, erst dann bei Modultyp: 'Verschiedenes'-'Besucher' auswählen. Es ändern sich nun die Formularfelder.<br />
Bei 'Besucher Kategorie' nun die vorher angelegt Kategorie auswählen, anschließend 'Speichern und Schließen'.<br />
<br />
Nun muss das angelegte Frontend Modul noch im Layout eingebunden werden:
* Layout -> Themes -> Seitenlayout -> Edit des genutzte Layouts (Contao ab 2.9)
* Layout -> Seitenlayout -> Edit des genutzte Layouts (TYPOlight bis 2.8.x)

Bei 'Eingebundene Module' das gerade erstellte Frontend Modul einbinden (z.b in left)

=Feinheiten=
==Feinheiten in der Kategorie Definition==
===Templates===
Jede Kategorie kann per Auswahl ein Template zugeordnet werden. Zur Auswahl stehen 4 Templates.
* mod_visitors_fe_all
** Liefert alle Felder die möglich sind (siehe Beispielbild oben)
* mod_visitors_fe_hits
** Hier wurden die beiden Besucherzeilen entfernt
* mod_visitors_fe_visits
** Hier wurden die beiden Zugriffszeilen entfernt
* mod_visitors_fe_invisible.tpl
** Hier wird nichts angezeigt. Dieses Template dient dadurch zur reinen Zählung.

Es können eigene Templates erstellt werden. Diese müssen als Dateiname anfangen mit 'mod_visitors_fe_' und die Endung '.tpl' haben.

===Zählweise===
Seit Version 1.6.0 kann die Zählweise bei eingeschaltetem Seiten Cache gewählt werden:
* Last Zählung, serverseitig durch Contao
* Lese Zählung, clientseitig durch Browser
** (nur im Contao cacheModus: Server- und Browsercache / Nur Browsercache)

Mit dem zweiten Punkt kann damit auch gezählt werden, wenn die Seite im Browsercache liegt und daraus aufgerufen wird.
Die System Einstellung 'Cache-Modus' wird dabei beachtet.

{{Anmerkung|Die Anzeige der aktuellen Werte erfolgt aber weiterhin nur wenn die Seite vom Server angefordert wird.}}

==Feinheiten in der Besucherzähler Definition==
===Blockzeit===
Die Blockzeit wird in Sekunden angegeben. Nach Zugriffspause dieser Zeit wird ein Zugriff als weiterer Besucher gezählt.<br />
Voreingetragen sind 1800 Sekunden, d.h. 30 Minuten.

==Feinheiten in der Frontend Modul Definition==
===Nur Gästen anzeigen===
Nach aktivieren der Funktion wird das Modul versteckt, sobald ein Mitglied (Frontend Nutzer) angemeldet ist.

===Modul schützen===
Hier nun kann definiert werden, dass die Anzeige des Moduls nur dann erfolgt, wenn Mitglieder bestimmter Gruppen online sind.

===Selbstzählung verhindern===
Es gab einige Ideen, wie man noch verhindern kann, eigene Zugriffe nicht zu zählen. Besonders, wenn man mit dynamischen IPs ankommt.
Hier ist nun eine Möglichkeit umgesetzt, dieses über einen angepassten User Agent String des Browsers zu tun.
<br />
Über: 
* Layout -> Themes -> Frontend Module -> Modul Name (Contao ab 2.9)
* Layout -> Module -> Modul Name (TYPOlight bis 2.8.x)
vom angelegtem Besucher Modul kann im neuem Feld "Keine Zählung bei HTTP_USER_AGENT Teilkennung:" einen String eingegeben werden, dieser sollte eindeutig sein.<br />
Beispiel: CTISOK<br />
Es sind, wozu auch immer, auch mehrere Strings dort möglich, diese dann durch Komma getrennt eingeben.<br />
Im Firefox ergänzt man nun den Agent String wie folgt:<br />
# Tippe '''about:config''' in der Adresszeile ein und drücke ENTER
# Tippe '''general.useragent.extra.firefox''' in der Filter Zeile
# Doppelklick auf die gefunde Zeile
# Hier nun den Beispiel String von oben mit Leerzeichen getrennt anhängen, OK

z.B. wird so aus "Firefox/3.5.2" nun "Firefox/3.5.2 CTISOK"<br />
<br />
Die Kennung kann man sich dann durch Eingabe von '''about:''' + Enter anzeigen lassen. (letzte Zeile)<br />
<br />
Weitere Browser sind hier erläutert (eng):
[http://www.walkernews.net/2007/07/05/how-to-change-user-agent-string/ walkernews.net - how to change user agent string]

<br /><br />

----
--[[Benutzer:BugBuster|BugBuster]] 21:56, 24. Jun. 2010 (UTC)