Handbuch:Erweiterung/BlueSpiceExtendedStatistics

Mit BlueSpiceExtendedStatistics bekommen Sie einen besseren Einblick in die Nutzung Ihres Wikis. Die Darstellungsart der Ergebnisse variiert von grafisch bis Liste und das Ergebnis kann exportiert werden.

Wo finde ich die erweiterte Statistik?

Der Navigationslink Erweiterte Statistik im Register Globale Aktionen lädt die Seite Spezial:Erweiterte_Statistik.

Datei:ExtendedStatistics1.png

Navigationslink zur Seite Erweiterte Statistik

Abfrage auswählen

• Anzahl erstellter Nutzer: Summe aller Benutzer, die sich im ausgewählten Zeitraum registriert haben.
• Anzahl erstellter Seiten: Summe aller Seiten, die in dem ausgewählten Zeitraum erstellt wurden.
• Anzahl erstellter Inhaltsseiten: Summe aller Artikel in Inhaltsnamensräumen, die im ausgewählten Zeitraum erstellt wurden.
• Anzahl der Bearbeitungen: Summe aller Bearbeitungen im gewählten Zeitraum.
• Bearbeitungen pro Benutzer: Summe aller Bearbeitungen pro Benutzer im ausgewählten Zeitraum
• Suchanfragen: Alle Begriffe, nach denen Benutzer im ausgewählten Zeitraum gesucht haben. Nur verfügbar, wenn BlueSpiceExtendedSearch installiert ist. Hinweis: Suchanfragen sind aufgrund der "auto-complete" Funktion schwer zu analysieren, da hier häufig nur die Anfangsbuchstaben eingegeben werden, before ein Suchtreffer ausgewählt wird.

Filter setzen

• Von - Datum, ab dem Daten angezeigt werden sollen
• Bis - Datum, bis zu dem Daten angezeigt werden sollen

Für einige Datenquellen sind zusätzliche Filter verfügbar, z. B. ein Namensraum-Filter für Daten, die auf Wiki-Seiten basieren.

• Intervall - legt fest, wie die Daten gruppiert werden (Tage, Kalenderwoche, Monat etc.)
• Modus - Anzeigetyp:
  1. Absolut - zeigt die absoluten Zahlen
     
     Datei:erweiterteStatistik Ergebnisbild.jpg

     Angelegte Inhaltsseiten in absoluten Zahlen
  2. Aggregiert - zeigt die aufsummierten Zahlen an
  3. Liste - zeigt Daten in tabellarischer Ansicht an - nur für Suchstatistiken verfügbar
     
     Datei:erweiterteStatistik Ergebnisbild2.jpg

     Begriffe, nach denen in einem bestimmten Zeitraum gesucht wurde (Listenansicht)
     
     

Ergebnisse anzeigen

Klicken Sie auf die Schaltfläche Ergebnis, um die Anzeige aufzurufen.

Datei:erweiterteStatistik Klick auf Ergebnis.jpg

Ergebnis aufrufen

Export der Resultatsansicht

Die Resultatsansicht beinhaltet eine Export-Schaltfläche. Über diese Schaltfläche kann die Ergebnisansicht als SVG (bei Listenansicht als csv/xlsx) exportiert werden.

Datenexport

Wartungsskript

Auf dem Server steht ein php-Wartungsskript zur Verfügung:

<mw-root>/extensions/BlueSpiceExtendedStatistics/maintenance/ExportCollection.php

Anwendung

Dieses Skript muss über die Befehlszeile des Servers aufgerufen werden. Es nimmt den Pfad einer Konfigurationsdatei im JSON-Format an.

Beispiel

php <mw-root>/extensions/BlueSpiceExtendedStatistics/maintenance/ExportCollection.php \
    --config=<path-to-file>/myConfig.json \
    --exportto=/tmp/myExport.xslx

Parameter

• --config - Pfad zur Konfigurationsdatei
• --exportto - Pfad zur Datei, in die die Daten exportiert werden. Mögliche Dateiformate sind xsl, xslx and csv.

Skript-Konfiguration

Die Skript-Konfiguration verwendet dieselben Parameter wie die API, die in Special:ExtendedStatistics verwendet wird.

Parameter

• aggregate
• filter

Beispielinhalte

Die folgenden Beispiele zeigen den Inhalt der JSON-Datei, die --config zur Verfügung gestellt wird.

"Seitenaufrufe" aggregiert nach Datum im Zeitraum von einem bestimmten Jahr:

{
	"aggregate": [
		{
			"property": "timestampcreated",
			"type": "daily",
			"targets": [
				"pagetitle",
				"numberhits",
				"numberhitsaggregated"
			]
		}
	],
	"filter": [
		{
			"property": "type",
			"type": "string",
			"value": "hitcounter",
			"comparison": "eq"
		},
		{
			"property": "timestampcreated",
			"type": "date",
			"value": "20200707120000",
			"comparison": "gt"
		},
		{
			"property": "timestampcreated",
			"type": "date",
			"value": "20210707120000",
			"comparison": "lt"
		}
	]
}

"Begutachtete Seiten nach Namensräumen" aggregieren nach Namensraum im Zeitraum von einem bestimmten Jahr:

{
	"aggregate": [
		{
			"property": "namespacename",
			"type": "string",
			"targets": [
				"ongoingpages",
				"expiredpages",
				"notrunningpages",
				"ongoingpagesaggregated",
				"expiredpagesaggregated",
				"notrunningpagesaggregated"
			]
		}
	],
	"filter": [
		{
			"property": "type",
			"type": "string",
			"value": "reviewedpages-ns",
			"comparison": "eq"
		},
		{
			"property": "timestampcreated",
			"type": "date",
			"value": "20200707120000",
			"comparison": "gt"
		},
		{
			"property": "timestampcreated",
			"type": "date",
			"value": "20210707120000",
			"comparison": "lt"
		}
	]
}

Konfiguration

In der Konfigurationsverwaltung können Administratoren folgende Einstellungen vornehmen:

• Diese Benutzer ausschließen: Einige Benutzergruppen wie WikiSysop können die Statistiken verzerren, z. B. die Statistiken für Suchanfragen oder weil sie automatisierte Wartungsaufgaben ausführen. Diese Arten von Benutzergruppen können aus den statistischen Ergebnissen ausgeschlossen werden.
• Maximale Anzahl von Intervallschritten: Legt die Größe der x-Achse für die Ergebnisse fest. Wählen Sie für einige Tage das Intervall Tag oder Kalenderwoche aus, für Zeiträume über ein Jahr Monat oder Jahr. Wenn Sie für Ihre Abfrage keine Ergebnisse erhalten, versuchen Sie, das Intervall entsprechend anzupassen.

Weiterführende Links

• Referenz:BlueSpiceExtendedStatistics

Wird im Wiki von einem "Artikel" gesprochen, so ist damit in der Regel der Inhalt einer Einzelseite gemeint. Im Zusammenhang mit im Wiki erstellten Büchern ist ein Artikel oft gleichbedeutend mit einem Buchkapitel.

Im Wiki abgetrennter Bereich, dessen Inhalte über spezielle Berechtigungen gelesen und bearbeitet werden können. Einen Namensraum erkennt man an einem Präfix vor dem Artikeltitel.

Tag: XML-Tags, welche beliebig parametrisiert werden können und eine vom Programmierer gewünschte Ausgabe produzieren. Fügt man beispielsweise das <bs:bookshelf>-Tag ein, dann erhält der Artikel die Kapitelnavigation des PDF-Buches, in dem der Artikel verlinkt ist.

Technische Referenz: BlueSpiceExtendedStatistics

---

Feedback zur Dokumentation ist im Community-Forum möglich.