jsvisit System Plugin

Über das jsvisit System Plugin läßt sich die Zählweise beinflussen. Ein Besucher wird immer dann neu gezählt, wenn er nach einem definierten Zeitablauf die Seite wieder besucht.

Ein Beispiel: Im jsvisit-Plugin hat man diesen Zeitraum auf 300 Minuten (5 Stunden) gesetzt. Wenn ein Besucher die Seite innerhalb der nächsten 5 Stunden wieder besucht, wird er nicht erneut gezählt, sondern erst dann, wenn seit seinem letzten Besuch mehr als 5 Stunden vergangen sind. Diese Logik verlangt allerdings, dass für die Nutzung des Zeitintrvalls Cookies auf Ihrer Website erlaubt sind. Ist dies nicht der Fall, wird aus dem Besucherzähler ein Hit-Counter, denn jeder Seitenaufruf wird gezählt

Setzt man das Zeitintervall auf "0", wird aus dem Besucherzähler ein Hit-Counter, denn jeder Seitenaufruf wird gezählt.

Mit der Option "Bots ignorieren" kann man verhindern, dass dass Bots (z.B. von Suchmaschinen) als Besucher gezählt werden.

In dem jsvisit counter plugin wird auch der Einsatz und die Nutzung von Geolocation Server definiert. Die jeweiligen Server können alle oder einzeln eingesetzt werden. Folgende Server sind unterstützt:

1. ip-api.com
2. geoplugin.net
3. ip2c.org
4. ipapi.co

Hat man keinen Server selektiert, schaltet man damit die Zuordnung und das Zählen von Länderrn aus.

jsvisit Module

Rufen Sie im Joomla admin Backend via "system->site Module" das Einrichtungs-Menu für Module auf. Klicken Sie im Menu den "Neu -Button" und selektieren Sie dann das Module "jsvisit Visitor Counter". Damit öffnet sích das HTML-Formular zum Konfigurieren des Moduls. Nutzen sie bitte in dem Formular die notwendigen Informationen für die Konfiguration mit der Option "Inline Hilfe umschalten". Damit werden Hilfetexte zu den jeweilige Moduleeinstellungen eingeblendet. Desweiteren beachten sie die anderen notwendigen Joomla Einstellungen (z. B. "Position", "Status", Menuzuweisung, etc.). Sie können z.B. über die Option "Erweitert" die verschiedenen Modul Layouts auswählen.

Optionen

Das jsvisit Module stellt 20 verschiedene Zähler-Layouts zur Verfügung. Diese Layouts können mit eigenen Zählerarten (z. B. mit Zählerlayouts von digitmania) angepasst oder ergänzt werden.

Zähler und Layout des Zählers werden duch zwei Dateien bestimmt. Zum einen das Zählerbild (image) (gespeichert im Verzeicnis "../media/mod_jsvisit_counter/images") und zum anderen die Datei für die Eigenschaften des Zählerbilds: "counter.props" (aus dem Verzeichnis "../modules/mod_jsvisit_counter").

Hier können sie alle mitgelieferten und natürlich auch ihre eigenen Zähler ausprobieren und die jeweiligen Definitionen aus "counter.props" ansehen:

Zähler auswählen:

(1) default (2) digital blue (3) gold (4) black (5) odometer black (6) odometer white (7) digital black (8) digital yellow (9) led green (10) Green (11) Vert (12) green digital (13) odometer yellow (14) red (15) boffo (16) odometer-gold (17) lightblue (18) odometer_blue (19) purple (20) hand written

Das jsvisit Module stellt folgende Optionen zur Verfügung:

• Anzeigeoptionen
• Startwert des Zählers bzw. Zähler neu setzen
• Anzahl Ziffern im Besucherzähler
• Zählerart (Layout)
• Zufallsauswahl der Zählerart
• Anzahl der angezeigten Länder
• Anzahl von Dezimalstellen für die Anzeige von Prozentwerten
• Heutige und gestrige Werte anzeigen
• Werte dieser und letzter Woche anzeigen
• Werte dieses und des letzten Monats anzeigen
• Neu: Werte dieses und des letzten Jahrs anzeigen
• Gesamt Wert aller Besucher anzeigen
• Unterstützung von verschiedenen Module Layouts


• Verwendung/Anzeige von Zählerwerten
• Heutige oder gestrige Werte verwenden
• Werte dieser oder letzter Woche verwenden
• Werte dieses oder des letzten Monats verwenden
• Neu: Werte dieses oder des letzten Jahrs verwenden
• Anzahl aller Besuche verwenden (default)
• Zähler nicht verwenden (und nicht anzeigen)

jsvisit Counter Administrator-Modul

Öffnen Sie im Joomla Admin Backend das Dashboard und wählen Sie "Modul zum Dashboard hinzufügen“ und selektieren dann das Modul "jsvisit Admin Counter“. Dadurch wird das HTML-Formular zur Konfiguration des Moduls geöffnet. Bitte nutzen Sie die notwendigen Informationen für die Konfiguration mit der Option „Inline-Hilfe umschalten“ im Formular. Hier werden Hilfetexte zu den jeweiligen Moduleinstellungen angezeigt. Achten Sie außerdem auf die weiteren notwendigen Joomla-Einstellungen (z. B. „Position“, „Status“, Menüzuordnung, etc.). Über die Option „Erweitert“ können Sie beispielsweise eines der bereitgestellten Modullayouts auswählen.

Hinweis:
Der Modultitel wird vom Modul mithilfe des Sprachenschlüssels "MOD_JSVISIT_ADMIN_TITLE“ festgelegt. Um diesen Modultitel zu ändern, wählen Sie im Admin-Backend-Menü "System" die Option "Sprachen Overrides" aus. Wählen Sie die gewünschte Sprache für den Administratorbereich aus und erstellen Sie sie den Sprachenschlüssel "MOD_JSVISIT_ADMIN_TITLE" mit Ihrem eigenen Text für den Titel.

Konfigurationsoptionen

Die Optionen sind die gleichen wie beim jsvisit Counter Site-Modul

• Version 2.1.5 (Build Level 2.1.5.0). diese Version enthält eine aktualisierte Ländernamentabelle basierend auf ISO-3166. Beachten Sie, dass Sie möglicherweise Ihre Sprachüberschreibungen (Language Overrides) anpassen müssen, da sich möglicherweise die jeweiligen Ländernamen geändert haben.
• Version 2.1.4 (Build Level 2.1.4.6) enthält nun die Unterstützung für die spanische Sprache - vielen Dank dafür an Diese E-Mail-Adresse ist vor Spambots geschützt! Zur Anzeige muss JavaScript eingeschaltet sein. für die Übersetzungen.
• Version 2.1.4 (Build Level 2.1.4.5) enthält nun auch Jahreszähler für das laufende und vergangene Jahr
• Version 2.1.4 (Build Level 2.1.4.3): Code wurde für php-Version 8.2 angepasst und unter Joomla Version 5 efrolgreich gestestet.
• Die neueste Version von jsvisit enthält jetzt ein Admin-Modul. Installation per Download/Installation von:
  • www.jschmidt-systemberatung.de/downloads/jsvisit_counter-v2.1.4.zip
  oder einfach nur das Admin-Modul.
  • www.jschmidt-systemberatung.de/downloads/mod_jsvisit_admin-v2.1.4.zip
  Um es zu verwenden, öffnen Sie über das Joomla Admin Backend das Home-Dashboard und wählen Sie "Modul zum Dashboard hinzufügen“ und wählen Sie dann das Modul "jsvisit Admin Counter“ aus. Klicken Sie nach der Konfiguration des Moduls auf Speichern und schließen.


• Mit Version 2.1.3 kann man nun verhindern, dass (Ro)Bots als Besucher gezählt werden. Das Modul "mod_jsvisit_counter" unterstützt jetzt die Auswahl und Anzeige verschiedener Zählerwerte.
  Wichtig: Die Version 2.1.3.1 enhält nun auch die Unterstützung für das Datenbank-System PostgreSQL.


• Build 2.1.2.5 korrigiert die Spachenunterstützung für die Sprachkennzeichen "de‐AT", "de‐LI", "de‐LU" und "de‐CH"


• In der Version 2.1.2.1 des jsvsit moduls wurde der Mehrsprachen Support angepasst (es wurde der Prefix "MOD_JSVISIT_COUNTER " vorangestellt). Nutzer von eigenen Module Layouts müssen folgende Schlüssel der Joomla "Text::" Funktion in diesen Layouts anpassen:

  alter Schlüssel		neuer Schlüssel
  COUNTRIES		MOD_JSVISIT_COUNTER_COUNTRIES
  COUNTRY		MOD_JSVISIT_COUNTER_COUNTRY
  VISITORS		MOD_JSVISIT_COUNTER_VISITORS
  TODAY		MOD_JSVISIT_COUNTER_TODAY
  YESTERDAY		MOD_JSVISIT_COUNTER_YESTERDAY
  THIS_WEEK		MOD_JSVISIT_COUNTER_THIS_WEEK
  LAST_WEEK		MOD_JSVISIT_COUNTER_LAST_WEEK
  THIS_MONTH		MOD_JSVISIT_COUNTER_THIS_MONTH
  LAST_MONTH		MOD_JSVISIT_COUNTER_LAST_MONTH
  TOTAL		MOD_JSVISIT_COUNTER_TOTAL

  
  Man kann nun die Anzahl von Dezimalstellen für die Anzeige von Prozentwerten in den Module Einstellungen definieren.


• Mit der Version 2.1.2 kann man nun wahlweise Server für die Länderzuordnung selektieren bzw. ausschalten. Außerdem kann man nun auch die Verbindung und die Funktionalität dieser Server überprüfen.


• Die Version 2.1.1 wurde für Joomla Version 4 angepasst und erfolgreich getestet.

Sprachen Unterstützung

Das jsvisit counter Module nutzt die Joomla Schnittstellen für verschiedene Nationalsprachen. Es verfügt über eine integrierte Unterstützung für diese Sprachen:

• Englisch (Vereinigtes Königreich)
• Deutsch (Deutschland, Österreich, Schweiz, Liechtenstein, Luxemburg)
• Französisch
• Niederländisch (Niederlande)
• Polnisch
• Spanisch

Folgendes sollte man beachten bzw. verstehen:

• Die Anzeige des Ländernamens wird aus dem Datenbankeintrag des Landes und dem zugehörigen Sprachenschlüssel erstellt.

Ein Beispiel:

Der Datenbankeintrag in der Tabelle "#__visitors_country" enthält den Wert "United States".
Daraus wird der Srachenschlüssel "MOD_JSVISIT_COUNTRY_UNITED_STATES" gebildet. Wenn nun dieser Schlüssel in den Joomla Sprachen Dateien (Sprachen ini-Datei oder in der Overides ini-Datei) für die deutsche Sprache existiert, wird der Schlüsselwert (z.B. "USA") verwendet. Sollte aber der Sprachenschlüssel nicht existieren, wird für die Anzeige der Datenbankwert verwendet (also hier "United States").

Möchte man einen eigenen Namen verwenden oder den Ländernamen korrigieren, muss man den in der Datenbank eingetragenen Namen ändern oder (viel einfacher!) einen Sprachenschlüssel via "Sprachen Override" im Joomla Admin Backend definieren. Folgende Voraussetzungen für die Erstellung müssen beachtet werden:

• Der Ländername muss in Grossbuchstaben geändert werden.
• Leerstellen im Ländernamen müssen mit einem Unterstrich ersetzt werden.
• Klammern im Ländernamen werden entfernt
• Der Schlüssel selbst wird dann aus dem Prefix "MOD_JSVISIT_COUNTRY_" und dem geänderten Ländernamen gebilldet.

So wird zum Beispiel aus "United States of America (the)" der Schlüssel: MOD_JSVISIT_COUNTRY_UNITED_STATES_OF_AMERICA_THE mit dem Text USA definiert.