Zählmarken ansehen

Bedienung

Die Bedienung erschließt sich in ihren Grundzügen aus den Links auf der Hauptseite dieser Erweiterung. Diese Links werden frei­geschaltet, je nach dem, welche Rechte dem Benutzer zugeteilt wurden. Die Aufgaben verteilen sich wie folgt

1. VG Wort-Autor

   Der Autor bezieht von VG Wort seine Zählmarken, die er dann importiert und anschließend einem Artikel zuordnet.

   Für die Zuordnung können die Zuordnungs­tabelle und die Seiten­aufruf-Statistik genutzt werden, um potentiell geeignete Artikel mit einer Zählmarke zu versorgen. Auch kann von einem Artikel über den Link „zuordnen“ in der Navigations­leiste die Zuordungs­seite erreicht werden.

2. VG Wort-Melder

   Der Melder kann die Zugriffszahlen sichern und eine Jahresmeldung erstellen.

   Auf der Seite „Klartext ermitteln“ können die für die Jahres­meldung benötigten Daten extrahiert werden, unter anderem der unformatierte Text des Artikels mit Textlänge.

3. Zählmarken-Administrator

   Der Administrator kann die Einstellungen dieser Erweiterung bearbeiten, die Zuordnung der Artikel zu Autoren ändern (korrigieren) oder Zählmarken nachträglich bearbeiten.

   Der Administrator kann die Gruppenzugehörigkeit eines Benutzers ändern, so den Benutzer den Gruppen „VG Wort-Autor“ oder „VG Wort-Melder“ hinzufügen, oder aus diesen Gruppen entfernen.

4. Statistiken

   Im Zusammenspiel mit der Erweiterung „Hitcounter“ und den gesicherten Zählständen vom Vorjahr lässt sich abschätzen, welche Artikel am Jahresende die erforderlichen Klickzahlen erreichen werden. Anhand von Textlänge und bereits erreichter Klickzahl wird ein Status berechnet und angezeigt. (Siehe Tabelle rechts.)

Die Verwaltung der Benutzergruppenrechte wird von einem Bürokraten vorgenommen.

Zum Verständnis: Diese Programmerweiterung verwendet zwei Benutzer-Konzepte, die nichts miteinander zu tun haben. Das eine ist der „Benutzer“ dieses Wikis und das andere ist der „Autor“ bei VG Wort.
Der „Benutzer“ des Wikis dient dem Einloggen, dem Bearbeiten der Artikel und dem Verwenden der wiki-internen Rechte­verwaltung. Das hat alles nichts mit VG Wort zu tun.
Der bei VG Wort gemeldete „Autor“ kann Zählmarken hochladen, sie verwalten und sie Artikeln zuordnen. Die Zählmarken von VG Wort, ihre Verknüpfung mit einem „Autor“ und zu einem Artikel haben wiederum nichts mit dem Wiki und seinen „Benutzern“ zu tun.
Programmtechnisch ist zu beachten, dass sowohl der Wiki-„Benutzer“ als auch der VG Wort-„Autor“ eine eigene ID-Nummer hat, die auseinander zu halten sind.
Für die Verwender dieser Programm­erweiterung reicht also eine Anmeldung im Wiki nicht aus, um Zählmarken zu verwalten. Dafür müssen sie sich erst als VG Wort-„Autor“ in die Autoren­verwaltung eintragen. Die Berechtigung dazu erteilt der vorgenannte „Bürokrat“ des Wikis.

Mit dem Tag <novgwort> können Textteile (beispielsweise Zitate) für die VGWort-Meldung ausgenommen werden.

Benutzergruppenrechte

Die Benutzergruppenrechte sind per Voreinstellung wie folgt vergeben:

1. „*“ (nicht angemeldete Leser):
   • Lesen der Infoseite (diese Seite)
   • Keine weiteren Rechte
2. „user“ (angemeldete Benutzer):
   • „countingmarker_statistic“ (Zugriff auf Statistiken)
3. „vgwortauthor“:
   • Persönliche VG Wort-Daten bearbeiten. (Name, Kartei­nummer)
   • „countingmarker_assign“ (Zählmarken zuweisen und ändern)
   • „countingmarker_import“ (Zählmarken importieren)
4. „vgwortreporter“:
   • „countingmarker_report“ (Jahresmeldung erstellen)
   • „countingmarker_save“ (Zählstände sichern)
5. „vgwortsysop“:
   • „countingmarker_admin“ (Grundeinstellungen ändern)
   • „countingmarker_import“ (Zählmarken importieren)
   • „countingmarker_save“ (Zählstände sichern)

Diese Einstellungen können in der Datei „LocalSettings.php“ geändert werden.

Reportstatus

Eine Übersicht über den Status der Artikel bezüglich Text­länge und erreichter Klickzahl unterstützt eine ziel­gerichtete Zuordnung von Zähl­marken. Folgende zehn Stufen werden unter­schieden:

Die Artikel sind in den Übersichts­tabellen über ihren Status selektierbar. Die Zähl­grenze 1 ist für eine Text­länge von 1500 Zeichen und 1800 Klicks, die Zähl­grenze 2 für eine Text­länge von 750 Zeichen und 10000 Klicks definiert.

Change Log

• Neu in Version 0.3.6:
  1. Bedienung, Benutzergruppenrechte
  2. Dem Wartungsskript „saveCounterValues.php“ wurde eine Option „Save the page_counter column for image files also“ hinzugefügt.
• Neu in Version 0.3.7:
  1. Neuer Entwicklungszweig (Branch) für MediaWiki 1.35.x
  2. Hook „SkinTemplateOutputPageBeforeExec“ ersetzt durch „SkinAddFooterLinks“.
  3. Die Rückwärtskompatibilität für MediaWiki <1.35.3 wird aufgegeben.
• Neu in Version 0.3.7.1:
  1. Verbesserte Fehlerbehandlung in Klasse „ManageMarker“. Es wird nun ausgewiesen, wenn einer Zählmarke eine ungültige Artikel-ID zugewiesen wurde.
  2. Auf der Seite „Über diese Erweiterung“ wurde mehr Text übersetzt.
• Neu in Version 0.3.7.2:
  1. Die Spalte mit dem Eintrag „PAGEID“ wurde aus Übersicht der Mediendateien entfernt, da diese nur für die Zuweisung von Zählmarken zu Artikeln von Belang ist.
  2. In der „multi“-Version wurde in der Übersicht der Artikel eine Spalte mit der Autoren-ID hinzugefügt.
  3. Auch Besuchern ohne Rechte wird nun angezeigt, wie viele Artikel im Bestand sind und wieviele Aufrufe insgesamt im aktuellen Jahr erzielt wurden.
• Neu in Version 0.3.7.3:
  1. Die URL zur VG Wort-Seite wurde aus den „i18n“-Dateien entfernt und in eine konfigurierbare globale Variable verlegt.
  2. Der Inklude-Pfad für die Datei „maintenance/Maintenance.php“ wurde in den Wartungs­skripten korrigiert.
  3. Fehlgeschlagene Datenbank-Abfragen werden in den Wartungs­skripten nun abgefangen.
• Neu in Version 0.3.7.4:
  1. Quellkodepflege: alter, toter Kode entsorgt.
  2. Die Wartungsskripte „updateArticleStatus.php“ und „updateTextlength.php“ wurden von der Erweiterung „HitCounters“ entkoppelt.
• Neu in Version 0.3.7.5:
  1. Bedienungsanleitung überarbeitet und ergänzt.
  2. Kompatibilität mit MediaWiki REL1_37 hergestellt.
• Neu in Version 0.3.7.6:
  1. Feinabstimmung bei den Benutzer­gruppen­rechten.
• Neu in Version 0.3.7.7:
  1. Umbenennungen von Variabeln von „user“ zu „wiki_user“ und „author“ zu „vgwort_autor“.
  2. Die Zählmarken waren noch mit der ID des Wiki-Accounts verknüpft. Das wurde umgestellt auf die ID der Autorenverwaltung dieser Erweiterung.
  3. Aus der Autorenverwaltung heraus können die Autoren nun direkt auf die Übersicht ihrer Artikel und Zählmarken gelangen.
• Neu in Version 0.3.7.8:
  1. In den Statistiken können die Artikel nach Autoren selektiert werden.
• Neu in Version 0.3.7.9:
  1. Neue Klasse: CountingMarkerQueryPageWithSelection.
  2. In den Statistiken können die Artikel nach dem VG Wort-Report-Status selektiert werden.
  3. In den Statistiken kann selektiert werden, ob den Artikeln bereits eine Zählmarke zugewiesen wurde oder nicht.
  4. Die Zählmarken können selektiert werden, ob sie bereits einem Artikel zugewiesen wurden oder nicht.
• Neu in Version 0.4.0:
  1. Der Reportstatus wird nun aktuell berechnet.
• Neu in Version 0.5.0:
  1. Tag <novgwort> hinzugefügt.
• Neu in Version 0.5.1:
  1. Kompatibilität mit MediaWiki REL1_38 hergestellt.
  2. Hook „PageContentSaveComplete“ ersetzt durch „PageSaveComplete“.
• Neu in Version 0.5.2:
  1. Beim „Klartext ermitteln“ wird nun erkannt, ob es sich bei dem Eintrag um eine Weiterleitung handelt.
  2. Die Beschreibung der „Benutzergruppenrechte“ präzisiert.
  3. Die Anzeige der Skriptlaufzeit kann nur noch aktiviert werden, indem die globale Variable „$wmShowScriptExecutionTime“ auf 1 gesetzt wird.
  4. Die Statistikseiten haben nun eine ausklappbare Legende.
  5. Die ID des VG-Wort-Autors wird nun bereits bei der Neuanlage eines Artikels in der Tabelle „countingmarker_page“ im Feld „author_id“ gesetzt.
• Neu in Version 0.5.3:
  1. Hook „SpecialStatsAddExtra“ hinzugefügt für Spezialseite „Statistik“.
  2. Neues Wartungsskript „cleanupCounterMarker.php“ erstellt.
• Neu in Version 0.5.4:
  1. Die Funktion „Klartext ermitteln“ kann nun in den globalen Variablen „$wmCountingMarkerRemoveLinkMarks“, „$wmCountingMarkerRemoveRefs“, „$wmCountingMarkerRemoveSeeAlso“ und „$wmCountingMarkerRemoveWeblinks“ konfiguriert werden.
  2. In der Zählmarken-Verwaltung können die Zählmarken nach „Zuordenbarkeit“ und „Aktivierung“ selektiert werden.
• Neu in Version 0.5.5:
  1. Bereit für PHP 8: Klassenvariablen mit Typen versehen.
• Neu in Version 0.5.6:
  1. In der Basis-Version wurde ein neues Feld „page_status“ in der DB-Tabelle „countingmarker_page“ hinzugefügt, deshalb hat sich die Datei „sql/update_singleauthor.sql“ geändert.
  2. Das Wartungsskript „updateTextlength“ zeigt jetzt an, wenn sich die Textlänge geändert hat.
• Neu in Version 0.5.7:
  1. Refactoring, Compatibility.
• Neu in Version 0.5.8:
  1. Neuer Hook „GetPreferences“ hinzugefügt. Voreinstellungen der Wiki-Benutzer: „ShowScriptExecutionTime“ aktivieren, „Anzahl der meistbetrachteten Seiten“ festlegen.
• Neu in Version 0.5.9:
  1. Geändertes „Konfigurationsschema“, Änderung von Manifest Version 1 auf Version 2 (unterstützt seit 1.29+) und Änderung des Prefixes der Konfigurations­variablen von Standard wg auf wm.
  2. Ersetzung der Klasse „CountingMarkerHooks“, welche eine Klasse erweitert (extends „Hooks“) durch eine Klasse, die Schnittstellen implementiert.
• Neu in Version 0.6.0:
  1. Neue Datenbank-Unterstützung für „sqlite“.
• Neu in Version 0.6.1:
  1. Refactoring, Neue Klasse „CountingMarkerUtils“.
• Neu in Version 0.6.2:
  1. Kompatibilität mit MediaWiki REL1_41 hergestellt.
• Neu in Version 0.6.3:
  1. „AddGroups“ und „RemoveGroups“ in „extension.json“ hinzugefügt.

Datenbank-Tabellen

1. Tabelle countingmarker_page
   • page_id int(10) UNSIGNED NOT NULL
     Dies ist der PRIMARY KEY und entspricht dem Feld page_id der MediaWiki-Tabelle page.
   • author_id int(10) UNSIGNED DEFAULT NULL
     Der Verweis auf den Autor des Artikels und entspricht dem Feld author_id der Tabelle countingmarker_author.
   • marker_id int(10) UNSIGNED DEFAULT NULL
     Der Verweis auf den Eintrag in der Tabelle countingmarker_marker.
   • page_date date DEFAULT NULL
     Das Datum des DB-Eintrages. Es ist nur relevant im aktuellen Jahr und wird dort zur Voraus­berechnung der Klickzahlen zum Jahresende verwendet.
   • page_length bigint(20) UNSIGNED NOT NULL DEFAULT 0
     Dieses Feld enthält die korrekte Textlänge des Artikels und wird für statistische Auswertung und Such­funktionen verwendet.
   • page_status int(1) UNSIGNED NOT NULL DEFAULT 0
     Dieses Feld enthält eine Bewertung des Artikels und wird für statistische Auswertung und Such­funktionen verwendet.
   • page_type int(2) UNSIGNED NOT NULL DEFAULT 1
     Dieses Feld enthält den Index für den Typ des Artikels und wird für Such­funktionen und ggfs. für die Jahresmeldung an VG Wort verwendet.
2. Tabelle countingmarker_marker
   • id int(10) UNSIGNED NOT NULL
     Dies ist der PRIMARY KEY der Zählmarken und entspricht dem Feld marker_id der MediaWiki-Tabelle countingmarker_page.
   • server int(2) UNSIGNED NOT NULL
     Dies ist die ID des verwendeten Servers.
   • public_key varchar(32) NOT NULL DEFAULT ""
     Der öffentliche Schlüssel der Zählmarke.
   • private_key varchar(32) NOT NULL DEFAULT ""
     Der private Schlüssel der Zählmarke.
   • url varchar(64) NOT NULL DEFAULT ""
     Dieses Feld enthält die URL des Zählpixels. (Das Feld wird nicht verwendet und dient nur zu Kontrollzwecken.)
   • page_id int(10) UNSIGNED DEFAULT NULL
     Dieses Feld enthält die ID des zugewiesenen Artikels, siehe Feld page_id der MediaWiki-Tabelle page.
   • is_assignable int(1) UNSIGNED NOT NULL DEFAULT 1
     Dieses Feld enthält eine "1", wenn die Zählmarke einem Artikel zugewiesen werden kann und "0", wenn sie – beispielsweise von VG Wort – für ungültig erklärt wurde und folglich keinem Artikel mehr zugeordnet werden soll.
   • is_counting int(1) UNSIGNED NOT NULL DEFAULT 1
     Dieses Feld enthält eine "1", wenn die Zählmarke "aktiv" ist – die Zählfunktion aktiviert ist – und "0", wenn sie "deaktiviert" wurde, etwa weil – wahrscheinlich temporär – die Zählfunktion ausgesetzt werden soll.
   • author int(10) UNSIGNED NOT NULL DEFAULT 1
     Die ID des VG Wort-Autors entspricht dem Feld author_id der Tabelle countingmarker_author.
3. Tabelle countingmarker_counter
   • Diese Tabelle enthält die Zählstände aus der Erweiterung HitCounters zu verschiedenen Zeitpunkten. Die wichtigsten sind die Zählstände jeweils zum Jahresende.
   • page_id int(10) UNSIGNED NOT NULL
     Die ID des Artikels, dem dieser Zählerstand zugeordnet ist.
   • date date DEFAULT NULL
     Das Datum des Zählerstandes.
   • expiry_date date DEFAULT "9999-12-31"
     Das Datum, ab dem geplant ist, diesen Datensatz zu entfernen.
   • page_counter bigint(20) UNSIGNED NOT NULL DEFAULT 0
     Dieses Feld enthält den Zählerstand zum gegebenen Zeitpunkt
   • page_length bigint(20) UNSIGNED NOT NULL DEFAULT 0
     Dieses Feld enthält die korrekte Textlänge in Zeichen zum gegebenen Zeitpunkt. Dieses Feld ist wenig wichtig und wird aktuell nirgends aktiv verwendet.
4. Tabelle countingmarker_author
   • Diese Tabelle enthält die Autoren-Daten.
   • author_id int(10) UNSIGNED NOT NULL
     Dies ist der PRIMARY KEY dieser Tabelle.
   • user_id int(10) UNSIGNED NOT NULL
     ID des MediaWiki Benutzerkontos.
   • first_name varchar(32) COLLATE utf8_unicode_ci NOT NULL DEFAULT ''
     Vorname
   • last_name varchar(32) COLLATE utf8_unicode_ci NOT NULL DEFAULT ''
     Nachname
   • birth_date date DEFAULT NULL
     Geburtsdatum
   • index_number int(10) UNSIGNED DEFAULT NULL
     VG Wort-Karteinummer
   • comment varchar(128) COLLATE utf8_unicode_ci DEFAULT NULL
     Ein zusätzliches Kommentarfeld.

Wartungsskripte (maintenance)

• cleanupCounterMarker.php entfernt Einträge aus der Tabelle countingmarker_page, die in der Tabelle page auf einen Eintrag verweisen, der a) nicht existiert, b) nicht im Artikel-Namensraum liegt oder c) eine Weiterleitung ist.
• saveCounterValues.php sichert Zählerstände in der Tabelle countingmarker_counter.
• deleteOldCounterValues.php entfernt Zählerstände aus der Tabelle countingmarker_counter, wenn diese ihr „Verfallsdatum“ überschritten haben.
• saveAnnualReport.php erstellt für die Jahresmeldung an VG Wort eine XML-Datei.
• updateTextlength.php berechnet die korrekte Textlänge (die für VG Wort relevante Anzahl von Zeichen) für alle Artikel.
• updateArticleStatus.php aktualisiert den Status aller Artikel. Der Status zeigt beispielsweise an, ob ein Artikel bereits die von VG Wort festgelegten Bedingungen bezüglich Textlänge und Anzahl von Aufrufen erfüllt.