Benutzer:PerfektesChaos/js/watchCategories

watchCategories ist ein JavaScript-Gadget – um die Anzahl von Seiten in Kategorien zu zeigen.

Das zielt auf Wartungskategorien ab, von denen erwartet wird, dass sie meistens leer sind. Wenn nicht, könntest du dich veranlasst sehen, einzugreifen und den Anlass zu beseitigen.

Einbindung

• Wenn das Projekt dieses Gadget bereits registriert haben sollte, genügt ein Häkchen auf der Seite Einstellungen („Helferlein“).
• Sonst wären die folgenden Zeilen in das persönliche JS wie etwa common.js einzufügen:

mw.loader.load("//en.wikipedia.org/w/index.php?title=User:PerfektesChaos/js/watchCategories/r.js&action=raw&bcache=1&maxage=604800&ctype=text/javascript",
               "text/javascript");

Außerdem werden (oberhalb der eben genannten, sofern vorhanden) die folgenden Zeilen gebraucht:

if ( typeof mw.libs.watchCategories  !==  "object"  ||  ! mw.libs.watchCategories ) {
   mw.libs.watchCategories  =  { };
}

Diesem Block sollte die Definition der von gewünschten Kategorien und Optionen folgen. Im allereinfachsten Fall ist das eine Zeile:

mw.libs.watchCategories.cats  =  "Wikipedia:Seite mit Einzelnachweisfehlern";

Diese löst die Kategorie:Wikipedia:Seite mit Einzelnachweisfehlern aus, die im Moment #8 Einträge hat (auf dieser statischen Seite hier könnte eine veraltete Anzahl aus dem Cache stehen).

Wirkung

Auf der angeforderten Seite wird eine kleine Box angezeigt, mit einem Link auf die Kategorie und die Zahl der Einträge.

• Standardmäßig ist die Zielseite die Beobachtungsliste (Änderungen). Die Box erscheint im Kopfbereich, oberhalb der Anzeigeoptionen.
• Standardmäßig wird die Box nur gezeigt, wenn in einer Kategorie mindestens eine Seite einsortiert ist.
• Es werden nur die unmittelbar vorhandenen Seiten gezählt; keine Unterkategorien und auch keine Dateien.

Format der Definitionen

Vom Konfigurationselement mw.libs.watchCategories.cats wird einer der folgenden Datentypen erwartet:

• ein string mit dem Titel der Kategorie
• eine number mit der curid der Kategoriebeschreibungsseite
• ein Array mit einer Sammlung von Elementen vom Typ
  • string mit dem Titel der Kategorie
  • number mit curid
  • object mit einer detaillierten Spezifikation

object mit detaillierter Spezifikation

Komponente	Vorgabe	Beschreibung
cat	Pflichtkomponente	string mit dem Titel der Kategorie number mit der curid der Kategoriebeschreibungsseite
min	1	Mindestanzahl der Einträge in der Kategorie, um die Anzeige auszulösen. min=0 zeigt eine grüne Box, wenn die Kategorie leer ist; das bestätigt auch eine erfolgreiche Abfrage.
ns	-1	Nummer des Namensraums der Zielseite
title	Watchlist (Beobachtungsliste)	Titel der Seite, auf der die Anzeige erfolgen soll Bei Spezialseiten (ns=-1): Kanonischer Seitenname
append		Selektor des Elements oder jQuery-Objekt, nach dem die Box eingefügt werden soll.
before	mw.util.$content #mw-content-text (nur bei Watchlist)	Selektor des Elements oder jQuery-Objekt, vor dem die Box eingefügt werden soll. Wird überschrieben durch gleichzeitige Definition von append. Falls die Beobachtungsliste (Watchlist) genutzt und nichts spezifiziert wurde, wird die Box zu Beginn des Inhaltsbereichs eingefügt.
text	Kategorie-Titel cat	Dargestellter Linktitel
style1	rote Box, roter Text	CSS zuweisen, wenn Mitglieder gefunden
style0	grüne Box	CSS zuweisen, wenn ohne Mitglieder (min=0)
id		Fragment des einzelnen Eintrags

Beispiele

Einfachster Fall:

if ( typeof mw.libs.watchCategories  !==  "object"  ||  ! mw.libs.watchCategories ) {
   mw.libs.watchCategories  =  { };
}
mw.libs.watchCategories.cats  =  "Wikipedia:Seite mit Einzelnachweisfehlern";
mw.loader.load("//en.wikipedia.org/w/index.php?title=User:PerfektesChaos/js/watchCategories/r.js&action=raw&bcache=1&maxage=604800&ctype=text/javascript",
               "text/javascript");

Ein komplexeres Beispiel, das das Laden auch noch von Bedingungen abhängig macht, um die Ausführung auf allen anderen Seiten zu beschleunigen:

if ( typeof mw.libs.watchCategories  !==  "object"  ||  ! mw.libs.watchCategories ) {
   mw.libs.watchCategories  =  { };
}
mw.libs.watchCategories.meineFunktion  =  function () {
   "use strict";
   this.cats  =  [ "Wikipedia:Seite mit Einzelnachweisfehlern",
                   { cat:   "Wikipedia:Qualitätssicherung BKS",
                     ns:    4,
                     title: "WikiProjekt Begriffsklärungsseiten/Fließband",
                     min:   3,
                     text:  "BKS"
                   }
                 ];
   mw.loader.load("//en.wikipedia.org/w/index.php?title=User:PerfektesChaos/js/watchCategories/r.js&action=raw&bcache=1&maxage=604800&ctype=text/javascript",
                  "text/javascript");
};   // .meineFunktion()
switch ( mw.config.get( "wgNamespaceNumber" ) ) {
   case -1 :   // Spezialseite
      if ( mw.config.get( "wgCanonicalSpecialPageName" ) === "Watchlist" ) {
         mw.libs.watchCategories.meineFunktion();
      }
      break;
   case 4 :   // WPNR
      if ( mw.config.get( "wgTitle" ) === "WikiProjekt Begriffsklärungsseiten/Fließband" ) {
         mw.libs.watchCategories.meineFunktion();
      }
}   // switch   aktuelle Nummer des Namensraums

• Es wird eine Funktion meineFunktion definiert, die die eigentliche Arbeit macht.
• Nach Nummer des Namensraums kann effizient entschieden werden, ob sich eine weitere Untersuchung lohnt.
• Nur wenn auch der Seitenname dazu passt, wird meineFunktion auch aufgerufen und lädt das Gadget.
• Die gleichen Betrachtungen werden auch innerhalb des Gadgets angestellt anhand der in .cats enthaltenen Definitionen.

Damit wird auf allen anderen Seiten (etwa bei allen Artikeln und Diskussionen) das Laden des Gadgets vermieden und die Auswertungszeit maximal verkürzt.

• Innerhalb der Funktion wird ein Array mit zwei Elementen definiert:
  1. Kategorie:Wikipedia:Seite mit Einzelnachweisfehlern auf der Beobachtungsliste
  2. Kategorie:Wikipedia:Qualitätssicherung BKS auf Wikipedia:WikiProjekt Begriffsklärungsseiten/Fließband
     • Zwei Einträge sind keine Wartungsfälle; bei weniger als zwei Seiten verschwindet die Box.
     • Als Linktitel wird nur kurz „BKS“ verwendet.

Codes und Stammseite

Die Stammseite ist en:User:PerfektesChaos/js/watchCategories mit:

Quellcode	JavaScript – Komprimierter Code zum Laden Kommentiertes Skript – zum Lesen durch Menschen und Debuggen
ResourceLoader	ext.gadget.watchCategories Dependencies: user, mediawiki.api, mediawiki.util
Namensräume	-1   (Watchlist) Jede Seite, definiert über Nummer des Namensraums und Titel
mw.libs	watchCategories