Dlstats: Unterschied zwischen den Versionen

Version vom 1. April 2013, 18:58 Uhr

Zählt die Anzahl von Datei-Downloads über die Standard Content Elemente Download und Downloads.

• Download Statistiken für die Standard Content Elemente Download und Downloads.
• Zählt die Anzahl der Downloads pro Datei und protokolliert die letzte Downloadzeit.
• Optionaler Log jedes einzelnen Downloads mit Zeitstempel, IP und Benutzername.
• Anonymisierung der IP-Adresse (ab 2.1.0)
• Insert-Tag für Anzahl des Downloads im Frontend (ab 2.1.0)

Installation

Installation erfolgt über das Extension Repository im Backend der Contao Installation. Bei manueller Installation, wie dabei üblich /contao/install.php aufrufen um ein eventuelles Update der Datenbank durchführen.

Da das Modul "dlstats" abhängig ist (ab 2.1.0) vom Modul "Bot Detection", muß dieses bei der manuellen Installation mit installiert werden.

Erste Schritte

Im Backend bei "System" - "Einstellungen" in den Bereich "Download-Statistiken" gehen und dort einen Haken setzen bei "Download-Statistiken aktivieren". Mit nur dieser Einstellung bekommt als Statistik angezeigt, welche Datei wie oft geladen wurde. Dazu gibt es nach der Installation einen neuen Menüpunkt im Backend unter Inhalte: Download-Statistiken

Mit setzen eines Hakens bei "Detailierte Download-Statistiken aktivieren" werden zusätzlich Infomationen bereitgestellt wie IP Adresse, Zeitstempel für jeden Download und der Benutzername. Benutzername natürlich nur, wenn der Download von einem angemeldeten Frontend Nutzer erfolgte.

Für dlstats 2.1.x: Über den Punkt "Anonymisierung der IP-Adresse von Besuchern abschalten" kann die Anonymisierung der IP-Adresse abgeschaltet werden, was jedoch nur der Admin darf.
Ab dlstats 2.2.0 ist dieser Punkt nicht mehr vorhanden, da Contao nun selbst ab Version 2.11 die Anonymisierung steuert. Es wird nun diese Einstellung übernommen.
(System - Einstellungen - Datenschutz-Einstellungen - IP-Adressen anonymisieren)

Insert-Tag Nutzung

Der Inser-Tag "cache_dlstats::totaldownloads::..." unterstützt sowohl den Source der Datei (relativer Pfad + Dateiname) wie auch in Verbindung mit dem Artikel Alias wie es in ce_download und ce_downloads generiert wird. Daher ist die Nutzung gut in den Templates der beiden CEs verwendbar, siehe Beispiele. Rückgabe ist nur die Anzahl als Zahl.

{{cache_dlstats::totaldownloads::tl_files/cdc2010.pdf}}
{{cache_dlstats::totaldownloads::CDC_2010.html?file=tl_files/cdc2010.pdf}}
 
// im ce_download template:
{{cache_dlstats::totaldownloads::<?php echo $this->href; ?>}}
 
// im ce_downloads template:
{{cache_dlstats::totaldownloads::<?php echo $file['href']; ?>}}

IPs ignorieren

Sollen Downloads von bestimmten IP-Adressen nicht gezählt werden, kann dies definiert werden in der localconfig.php wie folgt:

$GLOBALS['DLSTATS']['BOT_IPV4'][] = '192.168.1.2';
$GLOBALS['DLSTATS']['BOT_IPV4'][] = '192.168.0.0/24';
//bzw.
$GLOBALS['DLSTATS']['BOT_IPV6'][] = '2001:0db8::1';
$GLOBALS['DLSTATS']['BOT_IPV6'][] = '2001:0db8:85a3:0800::/56';

Hinweise

• gezählt werden nur Downloads, die über die Content-Elemente "Datei-Download" oder "Datei-Downloads" erstellt wurden.
• direkte Links auf Dateien werden somit nicht gezählt!
• keine Zählung, wenn man selber im BE eingeloggt ist (ab 2.1.0)
• in den Contao Templates zum Download sind keine rel="nofollow" gesetzt, die Downloads der Crawler werden somit mitgezählt!
  (ab 2.1.0 erledigt die Verhinderung der Zählung das Modul BotDetection, wovon "dlstats" nun abhängig ist)

--BugBuster 20:43, 28. Jul. 2012 (CEST)