Dlstats: Unterschied zwischen den Versionen

Aus Contao Community Documentation

K
K
 
(22 dazwischenliegende Versionen von einem Benutzer werden nicht angezeigt)
Zeile 1: Zeile 1:
Zählt die Anzahl von Datei-Downloads
+
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.
 
* Download Statistiken für die Standard Content Elemente Download und Downloads.
* Zählt die Anzahl der Downloads pro Datei und protokolliert die letzte Downloadzeit.
+
* Zählt die Anzahl der Downloads pro Datei und protokolliert die letzte Download-Zeit.
 
* Optionaler Log jedes einzelnen Downloads mit Zeitstempel, IP und Benutzername.
 
* Optionaler Log jedes einzelnen Downloads mit Zeitstempel, IP und Benutzername.
 +
* Anonymisierung der IP-Adresse
 +
* Insert-Tag für Anzahl des Downloads im Frontend
 +
 +
'''Der Nachfolger für Contao 4: bugbuster/contao-dlstats-bundle'''
 +
  
 
{{ExtInfo
 
{{ExtInfo
| Dev=Peter Koch
+
| Dev=Glen Langer ([[User:BugBuster|BugBuster]])
| DevSite=
+
| DevSite=http://contao.ninja
| ExtVersion=1.0.0 stable
+
| ExtVersion=2.4.1 / 3.9.2 / 1.0.0
| Version=2.9
+
| Version=ab 2.9
| TLVersion=2.7
+
| TLVersion=2.7.6 - 2.8.4
 +
| Depending=[[Bot Detection|Bot Detection]]
 
| ERLink=http://www.contao.org/erweiterungsliste/view/dlstats.de.html
 
| ERLink=http://www.contao.org/erweiterungsliste/view/dlstats.de.html
| Comment=Planung die Erweiterung zu übernehmen durch BugBuster
+
| DonateLink=http://www.amazon.de/wishlist/26HHEJOU03G76
 +
| TrackerLink=https://github.com/BugBuster1701/dlstats/issues
 +
| Comment=Contao 4 Version verfügbar
 
}}
 
}}
 
[[en:dlstats]]
 
[[en:dlstats]]
 
[[Kategorie:Extensions]]
 
[[Kategorie:Extensions]]
  
==Installation==
+
==Installation in Contao 4==
 +
Siehe: https://github.com/BugBuster1701/contao-dlstats-bundle/blob/master/INSTALLATION_DE.md<br />
 +
Handbuch für Contao 4 contao-dlstats-bundle: https://docs.contao.ninja/de/download-statistik.html
 +
 
 +
==Installation in Contao 3==
 
Installation erfolgt über das Extension Repository im Backend der Contao 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.<br /><br />
Derzeit ist die Erweiterung nur bis Contao 2.9 freigegeben. Sie funktioniert aber ohne Problem auch in Contao 2.10. Damit diese über den ER Katalog gefunden wird, muss in den Einstellung eingeschaltet werden, dass inkompatible Erweiterungen angezeigt werden.
+
<span style="color:red">'''''Da das Modul "dlstats" abhängig ist (ab 2.1.0) vom Modul "[[Bot Detection|Bot Detection]]", muß dieses bei der manuellen Installation mit installiert werden.'''''</span>
  
 
==Erste Schritte==
 
==Erste Schritte==
 
Im Backend bei "System" - "Einstellungen" in den Bereich "Download-Statistiken" gehen und dort einen Haken setzen bei "Download-Statistiken aktivieren".  
 
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.
 
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.
 
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.
  
Dazu gibt es nach der Installation einen neuen Menüpunkt im Backend unter Inhalte: Download-Statistiken
+
'''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.<br />
 +
'''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.<br />
 +
(System - Einstellungen - Datenschutz-Einstellungen - IP-Adressen anonymisieren)
 +
 
 +
==Insert-Tag Nutzung==
 +
Der Insert-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'''.
 +
<source lang="php">
 +
{{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']; ?>}}
 +
</source>
 +
 
 +
==IPs ignorieren==
 +
Sollen Downloads von bestimmten IP-Adressen nicht gezählt werden, kann dies definiert werden in der localconfig.php wie folgt:
 +
<source lang="php">
 +
$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'; 
 +
</source>
 +
 
 +
==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!<br />(ab 2.1.0 erledigt die Verhinderung der Zählung das Modul BotDetection, wovon "dlstats" nun abhängig ist)
 +
 
 +
----
 +
--[[Benutzer:BugBuster|BugBuster]] ([[Benutzer Diskussion:BugBuster|Diskussion]]) 00:09, 19. Jun. 2017 (CEST)

Aktuelle Version vom 28. März 2020, 22:24 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 Download-Zeit.
  • Optionaler Log jedes einzelnen Downloads mit Zeitstempel, IP und Benutzername.
  • Anonymisierung der IP-Adresse
  • Insert-Tag für Anzahl des Downloads im Frontend

Der Nachfolger für Contao 4: bugbuster/contao-dlstats-bundle


Erweiterungs-Übersicht
Name des Entwicklers Glen Langer (BugBuster)
Entwickler Webseite http://contao.ninja
Version der Erweiterung 2.4.1 / 3.9.2 / 1.0.0
Kompatibilität mit Contao Version ab 2.9
Kompatibilität mit TYPOlight Version 2.7.6 - 2.8.4
Link zum Extension Repository http://www.contao.org/erweiterungsliste/view/dlstats.de.html
Den Entwickler unterstützen http://www.amazon.de/wishlist/26HHEJOU03G76
Link zum Tracker https://github.com/BugBuster1701/dlstats/issues
Abhängig von ff. Erweiterungen Bot Detection
Anmerkung Contao 4 Version verfügbar

Installation in Contao 4

Siehe: https://github.com/BugBuster1701/contao-dlstats-bundle/blob/master/INSTALLATION_DE.md
Handbuch für Contao 4 contao-dlstats-bundle: https://docs.contao.ninja/de/download-statistik.html

Installation in Contao 3

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 Insert-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 (Diskussion) 00:09, 19. Jun. 2017 (CEST)

Ansichten
Meine Werkzeuge

Contao Community Documentation

Ich überlege gerade warum Contao Developer einen Hangout mit Bildübertragung machen... abgesehen von TheTril sind wir da alle relativ hässliche Typen wo Audio deutlich reichen würde. *g*

Leo Unglaub
In anderen Sprachen
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge