Dlstats: Unterschied zwischen den Versionen
Aus Contao Community Documentation
K |
|||
| (21 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 | + | * 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= | + | | Dev=Glen Langer ([[User:BugBuster|BugBuster]]) |
| − | | DevSite= | + | | DevSite=http://contao.ninja |
| − | | ExtVersion=1.0.0 | + | | 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= | + | | 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 /> | |
| − | + | <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. | ||
| − | + | '''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: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 |
Inhaltsverzeichnis
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)
