Jump to content

Erweiterung:Missbrauchsfilter

From mediawiki.org
This page is a translated version of the page Extension:AbuseFilter and the translation is 84% complete.
Outdated translations are marked like this.
This extension comes with MediaWiki 1.38 and above. Daher muss sie nicht erneut heruntergeladen werden. Allerdings müssen die folgenden Anweisungen trotzdem beachtet werden.
MediaWiki-Erweiterungen
AbuseFilter
Freigabestatus: stabil
Einbindung Benutzeraktivität , Spezialseite , API
Beschreibung Ermöglicht es, bestimmte verhaltensbasierte Einschränkungen für Wiki-Aktivitäten zu setzen
Autor(en)
Kompatibilitätspolitik Snapshots werden zusammen mit MediaWiki veröffentlicht. Der Master ist nicht abwärtskompatibel.
MediaWiki >= 1.43.0
Datenbankänderungen Ja
Composer mediawiki/abuse-filter
Tabellen abuse_filter
abuse_filter_action
abuse_filter_history
abuse_filter_log
Lizenz GNU General Public License 2.0 oder neuer
Herunterladen
  • $wgAbuseFilterConditionLimit
  • $wgAbuseFilterRangeBlockSize
  • $wgAbuseFilterAnonBlockDuration
  • $wgAbuseFilterLogIPMaxAge
  • $wgAbuseFilterCentralDB
  • $wgAbuseFilterDefaultWarningMessage
  • $wgAbuseFilterEmergencyDisableAge
  • $wgAbuseFilterEnableBlockedExternalDomain
  • $wgAbuseFilterActionRestrictions
  • $wgAbuseFilterActions
  • $wgAbuseFilterProtectedVariables
  • $wgAbuseFilterLogIP
  • $wgAbuseFilterPrivateDetailsForceReason
  • $wgAbuseFilterEmergencyDisableCount
  • $wgAbuseFilterLogPrivateDetailsAccess
  • $wgAbuseFilterSlowFilterRuntimeLimit
  • $wgAbuseFilterEmergencyDisableThreshold
  • $wgAbuseFilterLocallyDisabledGlobalActions
  • $wgAbuseFilterBlockDuration
  • $wgAbuseFilterDefaultDisallowMessage
  • $wgAbuseFilterValidGroups
  • $wgAbuseFilterNotificationsPrivate
  • $wgAbuseFilterBlockAutopromoteDuration
  • $wgAbuseFilterIsCentral
  • $wgAbuseFilterNotifications
  • abusefilter-modify
  • abusefilter-log-detail
  • abusefilter-view
  • abusefilter-log
  • abusefilter-privatedetails
  • abusefilter-privatedetails-log
  • abusefilter-modify-restricted
  • abusefilter-revert
  • abusefilter-view-private
  • abusefilter-log-private
  • abusefilter-hidden-log
  • abusefilter-hide-log
  • abusefilter-modify-global
  • abusefilter-modify-blocked-external-domains
  • abusefilter-bypass-blocked-external-domains
  • abusefilter-access-protected-vars
  • abusefilter-protected-vars-log
Quarterly downloads 140 (Ranked 45th)
Public wikis using 2,939 (Ranked 186th)
Übersetze die AbuseFilter-Erweiterung, wenn sie auf translatewiki.net verfügbar ist
Probleme Offene Aufgaben · Einen Fehler melden

AbuseFilter

2020 Coolest Tool
Award Winner

in the category
Quality


Die Missbrauchsfilter-Erweiterung erlaubt privilegierten Benutzern, bestimmte Maßnahmen festzusetzen, die getroffen werden, wenn von Benutzern durchgeführte Handlungen, wie Bearbeitungen, bestimmte Kriterien erfüllen.

Beispielsweise könnte ein Filter erstellt werden, um zu verhindern, dass anonyme Benutzer externe Links hinzufügen, oder um einen Benutzer zu blockieren, der mehr als 2000 Zeichen entfernt.

Installation

  • Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens AbuseFilter im Ordner extensions/ ablegen.
    Entwickler und Code-Beitragende sollten stattdessen die Erweiterung von Git installieren, mit:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/AbuseFilter
  • Wird von git aus installiert, ist Composer auszuführen, um PHP-Abhängigkeiten zu installieren, indem composer install --no-dev im Erweiterungsverzeichnis ausgeführt wird. (Siehe task T173141 für mögliche Komplikationen.)
  • Folgenden Code am Ende deiner LocalSettings.php -Datei einfügen:
    wfLoadExtension( 'AbuseFilter' );
    
  • Führe das Aktualisierungsskript aus, welches automatisch die notwendigen Datenbanktabellen erstellt, die diese Erweiterung braucht.
  • Konfiguriere nach Bedarf.
  • Yes Erledigt – Navigiere zu Special:Version in deinem Wiki, um zu überprüfen, ob die Erweiterung erfolgreich installiert wurde.
Wenn du von Git installierst, beachte bitte, dass diese Erweiterung Composer benötigt.

Wechsle also nach der Installation von Git in das Verzeichnis, das die Erweiterung enthält, z.B. "../extensions/AbuseFilter/", und führe composer install --no-dev aus, oder beim Aktualisieren: composer update --no-dev.

Alternativ und vorzugsweise fügst du die Zeile "extensions/AbuseFilter/composer.json" in die Datei "composer.local.json" im Stammverzeichnis deines Wikis ein, z.B.

{
	"extra": {
		"merge-plugin": {
			"include": [
				"extensions/AbuseFilter/composer.json"
			]
		}
	}
}

Konfiguration

Benutzerrechte

Sobald Du die Erweiterung installiert hast, musst Du die Benutzerrechte in "LocalSettings.php" einrichten.

User rights for AbuseFilter
Recht Beschreibung Notes User groups that have this right by default
abusefilter-modify Missbrauchsfilter erstellen oder bearbeiten Requires the abusefilter-view right sysop
abusefilter-view Missbrauchsfilter ansehen *
abusefilter-log Missbrauchsfilter-Logbuch einsehen *
abusefilter-log-detail Erweitertes Missbrauchsfilter-Logbuch einsehen Requires the abusefilter-log right sysop
abusefilter-privatedetails Private Daten im Missbrauchsfilter-Logbuch einsehen Prior to 1.34 this right was named abusefilter-private - Requires the abusefilter-log-detail right
abusefilter-modify-restricted Missbrauchsfilter mit privilegierten Aktionen bearbeiten Requires the abusefilter-modify right sysop
abusefilter-modify-global Globale Missbrauchsfilter erstellen oder verändern Requires the abusefilter-modify right
abusefilter-revert Alle Bearbeitungen durch einen bestimmten Missbrauchsfilter zurücksetzen sysop
abusefilter-view-private Als privat markierte Missbrauchsfilter einsehen Requires the abusefilter-view right (not needed if the group already has the abusefilter-modify right) sysop
abusefilter-log-private Als privat markierte Einträge im Missbrauchsfilter einsehen Requires the abusefilter-log right (not needed if the group already has the abusefilter-modify or abusefilter-view-private rights) sysop
abusefilter-hide-log Einträge aus dem Missbrauchsfilter-Logbuch ausblenden Requires the abusefilter-log right suppress
abusefilter-hidden-log Versteckte Einträge im Missbrauchsfilter-Logbuch einsehen Requires the abusefilter-log right suppress
abusefilter-privatedetails-log Das Missbrauchsfilter-Private-Einzelheiten-Zugriffs-Logbuch ansehen Prior to 1.34 this right was named abusefilter-private-log
abusefilter-modify-blocked-external-domains Erstellen oder Ändern, welche externen Domänen für die Verknüpfung gesperrt sind sysop
abusefilter-bypass-blocked-external-domains Umgehung gesperrter externer Domains Requires the edit right bot
abusefilter-access-protected-vars Anzeigen und Erstellen von Filtern, die geschützte Variablen verwenden sysop
abusefilter-protected-vars-log Anzeigen von Logbüchern zum Zugriff auf geschützte Variablenwerte sysop

Die folgende Beispielkonfiguartion würde zum Beispiel Administratoren erlauben, alles mit den Missbrauchsfiltern zu machen, und jedem, das Logbuch und die Einstellungen öffentlicher Filter einzusehen.

$wgGroupPermissions['sysop']['abusefilter-modify'] = true;
$wgGroupPermissions['*']['abusefilter-log-detail'] = true;
$wgGroupPermissions['*']['abusefilter-view'] = true;
$wgGroupPermissions['*']['abusefilter-log'] = true;
$wgGroupPermissions['sysop']['abusefilter-privatedetails'] = true;
$wgGroupPermissions['sysop']['abusefilter-modify-restricted'] = true;
$wgGroupPermissions['sysop']['abusefilter-revert'] = true;
$wgGroupPermissions['sysop']['abusefilter-access-protected-vars'] = true;
$wgGroupPermissions['sysop']['abusefilter-protected-vars-log'] = true;
Filter, die als privat markiert sind, können nur von Benutzern angesehen werden, die entweder das Recht abusefilter-modify oder das Recht abusefilter-view-private besitzen.
Protected filters can only be created and viewed by users with the abusefilter-access-protected-vars permission. Logs pertaining to these filters can only be viewed by users with the abusefilter-protected-vars-log permission. For more information, see Rules format .

Parameter

Name der Variablen Standardwert Beschreibung
$wgAbuseFilterActions
[
    'throttle' => true,
    'warn' => true,
    'disallow' => true,
    'blockautopromote' => true,
    'block' => true,
    'rangeblock' => false,
    'degroup' => false,
    'tag' => true
]
Die möglichen Aktionen, die durch Missbrauchsfilter getätigt werden können. Prüfe beim Hinzufügen einer neuen Aktion, ob sie in $wgAbuseFilterActionRestrictions eingeschränkt ist. Falls das der Fall ist, vergiss nicht das Recht abusefilter-modify-restricted zu den entsprechenden Benutzergruppen hinzuzufügen.
$wgAbuseFilterConditionLimit
1000
Die maximale Anzahl von 'Bedingungen', die jedes Mal verwendet werden können, wenn die Filter gegen eine Änderung ausgeführt werden. (Komplexere Filter erfordern mehr 'Bedingungen').
$wgAbuseFilterValidGroups
[
    'default'
]
Die Liste der "Gruppen", in die Filter unterteilt werden können. Standardmäßig gibt es nur eine Gruppe. Andere Erweiterungen können weitere Gruppen hinzufügen.
$wgAbuseFilterEmergencyDisableThreshold
[
    'default' => 0.05
]
Deaktiviere einen Filter, wenn er mit mehr als zwei Bearbeitungen übereinstimmt. Dies entspricht mehr als 5 % der Aktionen, die im "beobachteten" Zeitraum (höchstens einen Tag) gegen die Filtergruppe geprüft wurden, wenn der Filter in den letzten 86400 Sekunden (einem Tag) geändert wurde. Siehe Notfalldrosselung.
$wgAbuseFilterEmergencyDisableCount
[
    'default' => 2
]
$wgAbuseFilterEmergencyDisableAge
[
    'default' => 86400
]
$wgAbuseFilterActionRestrictions
[
	"throttle" => false,
	"warn" => false,
	"disallow" => false,
	"blockautopromote" => true,
	"block" => true,
	"rangeblock" => true,
	"degroup" => true,
	"tag" => false
]
Benutzer müssen über das Benutzerrecht "abusefilter-modify-restricted" sowie "abusefilter-modify" verfügen, um Filter erstellen oder ändern zu können, die diese Aktionen ausführen.
$wgAbuseFilterNotifications
false
Ermöglicht die Konfiguration der Erweiterung zum Senden von Trefferbenachrichtigungen an Special:RecentChanges oder UDP. Verfügbare Einstellungen: rc, udp, rcandudp
Um Änderungen an Missbrauchsfiltern an Special:RecentChanges zu senden, nutze unset($wgLogRestrictions['abusefilter']);.
$wgAbuseFilterNotificationsPrivate
false
Aktiviere Benachrichtigungen für private Filter.
$wgAbuseFilterCentralDB
null
MW 1.41+ Name einer Datenbank, in der globale Missbrauchsfilter gespeichert werden (nur in der neuesten Entwicklungsversion unterstützt). Erfordert, dass CentralAuth installiert ist, sonst werden globale Filter auf einer Wikifarm nicht funktionieren.
$wgAbuseFilterIsCentral
false
MW 1.41+ Setze diese Variable für das Wiki, in dem globale Missbrauchsfilter gespeichert sind, auf "true" (nur in der neuesten Entwicklungsversion unterstützt). Erfordert, dass CentralAuth installiert ist, sonst werden globale Filter auf einer Wikifarm nicht funktionieren.
$wgAbuseFilterLocallyDisabledGlobalActions
[
	"throttle" => false,
	"warn" => false,
	"disallow" => false,
	"blockautopromote" => false,
	"block" => false,
	"rangeblock" => false,
	"degroup" => false,
	"tag" => false
]
Verhindern, dass zentralisierte Filter Aktionen ausführen, die in dieser Variablen auf "true" gesetzt sind.
$wgAbuseFilterBlockDuration
'indefinite'
Dauer der von Missbrauchsfiltern vorgenommenen Sperren.
ab 1.31.0-wmf.25 können Sperrdauern für jeden einzelnen Filter angegeben werden und überschreiben diese Variable. Diese Variable wird nur verwendet, wenn die Sperre aktiviert wird, um eine Standarddauer vorzuwählen.
$wgAbuseFilterAnonBlockDuration
null
Dauer von Sperren, die von Missbrauchsfiltern auf Benutzer angewendet werden, die nicht angemeldet sind. Der Wert von $wgAbuseFilterBlockDuration wird verwendet, wenn dies nicht festgelegt ist.
ab 1.31.0-wmf.25 können Sperrdauern für jeden einzelnen Filter angegeben werden und überschreiben diese Variable. Diese Variable wird nur verwendet, wenn die Sperre aktiviert wird, um eine Standarddauer vorzuwählen.
$wgAbuseFilterBlockAutopromoteDuration
5
Dauer in Tagen, für die die Autopromotion von Nutzern durch Filter blockiert wird.
$wgAbuseFilterDefaultWarningMessage
[
    'default' => 'abusefilter-warning'
]
Standard-Warnmeldungen pro Filtergruppe
$wgAbuseFilterDefaultDisallowMessage
[
    'default' => 'abusefilter-disallowed'
]
Standardmäßig nicht erlaubte Nachrichten, pro Filtergruppe
$wgAbuseFilterLogIP
true
Ob die IP in das Missbrauchsfilter-Logbuch aufgenommen werden soll
$wgAbuseFilterLogIPMaxAge
3 * 30 * 24 * 3600
Alter, das als Abschaltzeit verwendet wird, wenn alte IP-Protokolldaten gelöscht werden. Standardeinstellung 3 Monate. Wird vom Wartungsskript purgeOldLogIPData.php verwendet.
$wgAbuseFilterProfileActionsCap
10000
Anzahl der Aktionen, die bestimmen, wann Statistiken zurückgesetzt werden sollen.
$wgAbuseFilterLogPrivateDetailsAccess
false
Ob der Zugriff auf private Informationen aus einem Filterlogbucheintrag protokolliert wird.
$wgAbuseFilterPrivateDetailsForceReason
false
Ob Benutzer gezwungen sind, einen Grund für den Zugriff auf private Informationen aus einem Filterlogbucheintrag anzugeben.
$wgAbuseFilterSlowFilterRuntimeLimit
500
Laufzeit in Millisekunden, bevor ein Filter als langsam gilt.
$wgAbuseFilterRangeBlockSize
[
    'IPv4' => '16',
    'IPv6' => '19',
]
Größe der Range, die durch die Aktion 'rangeblock' gesperrt wird.
$wgAbuseFilterProtectedVariables
[ "user_unnamed_ip" ]
Array of variables that are be considered protected (limited access) and require the abusefilter-access-protected-vars right to use/view.

Notfalldrosselung

Missbrauchsfilter verfügt über eine Funktion, die Filter, die kürzlich bearbeitet wurden und die einen bestimmten Schwellenwert der letzten Aktionen erreichen, automatisch drosselt (deaktiviert).

Dies geschieht, um schädliche Änderungen an den Filtern zu verhindern, um jeden Benutzer zu sperren, der eine Aktion im Wiki ausführt oder ähnliches.

Die Bedingung zum Deaktivieren des Filters hängt von diesen Variablen ab:

  • $wgAbuseFilterEmergencyDisableThreshold - Prozentualer Anteil der Übereinstimmungen an der Gesamtanzahl der Aktionen im beobachteten Zeitraum.
  • $wgAbuseFilterEmergencyDisableCount - Anzahl der Treffer des Filters im beobachteten Zeitraum.
  • $wgAbuseFilterEmergencyDisableAge - Alter des Filters, um ihn zu berücksichtigen. Wenn die letzte Bearbeitung des Filters älter als diese Anzahl von Sekunden ist, wird der Filter nicht gedrosselt, es sei denn, er ist bereits gedrosselt.

Gedrosselte Filter sind in der Filterliste (Spezial:Missbrauchsfilter) mit dem Status Aktiviert, Hohe Trefferquote gekennzeichnet. Die Drosselung erfolgt im Hintergrund und es gibt keine Möglichkeit festzustellen, wann ein Filter gedrosselt wurde, außer wenn Erweiterung:Echo installiert ist. In diesem Fall wird eine Benachrichtigung an den Benutzer gesendet, der den Filter zuletzt geändert hat.

Wenn ein Filter gedrosselt wird, führt er keine gefährlichen Aktionen aus (Aktionen, die normalerweise auf spezielle Rechte beschränkt sind, wie etwa das Sperren des Benutzers oder das Entfernen aus Gruppen, die durch $wgAbuseFilterActionRestrictions kontrolliert werden) und nur „sichere“ Aktionen sind zulässig (solche, die vor der aktuellen Aktion warnen oder sie verhindern können). Gedrosselte Filter werden nicht automatisch wieder aktiviert. Um die Drosselung zu deaktivieren, musst du den Filter bearbeiten. Beachte, dass du tatsächlich etwas am Filter ändern musst: Es reicht aus, etwas in den Notizen des Filters zu ändern.

Beachte, dass durch das Bearbeiten des Filters dessen Alter aktualisiert wird. Dies kann dazu führen, dass er deaktiviert wird, wenn er innerhalb kurzer Zeit seit der letzten Bearbeitung erneut die Bedingungen für eine Drosselung erreicht. Dies führt zu einem unbrauchbaren Filter, wenn dein Wiki mehr missbräuchliche Bearbeitungen als legitime Bearbeitungen aufweist.

Filter erstellen und verwalten

Ist die Erweiterung einmal installiert, können Filter über die Missbrauchsfilter-Verwaltungsseite Spezial:Missbrauchsfilter erstellt, getestet, geändert und gelöscht werden. Dort kann auch auf die Logbücher zugegriffen werden.

API

AbuseFilter fügt zwei API-Listenmodule hinzu, eines für Details zu Missbrauchsfiltern ("abusefilters") und eines für das Missbrauchsfilter-Logbuch, da es von anderen MediaWiki-Logbüchern ("abuselog") getrennt ist. Es ist nicht möglich, Missbrauchsfilter mithilfe der API zu erstellen oder zu ändern.

list = abusefilters

Liste Informationen über die Filter auf

Parameter
  • abfstartid - Die Filter-ID, ab der die Aufzählung beginnen soll
  • abfendid - Die Filter-ID, bei der die Aufzählung beendet werden soll
  • abfdir - Die Richtung, in der aufgezählt werden soll (älter, neuer)
  • abfshow - Nur Filter anzeigen, die diese Kriterien erfüllen (aktiviert|!aktiviert|gelöscht|!gelöscht|privat|!privat)
  • abflimit - Die maximale Anzahl aufzulistender Filter
  • abfprop - Welche Eigenschaften abgerufen werden sollen (ID|Beschreibung|Muster|Aktionen|Treffer|Kommentare|Letzter Bearbeiter|Zeitpunkt der letzten Bearbeitung|Status|Privat)

Wenn Filter privat sind, fehlen einige der mit abfprop angegebenen Eigenschaften, sofern du nicht die entsprechenden Benutzerrechte hast.

Beispiele
Nicht-private Missbrauchsfilter auflisten
Ergebnis
{
    "batchcomplete": "",
    "continue": {
        "abfstartid": 18,
        "continue": "-||"
    },
    "query": {
        "abusefilters": [
            {
                "id": 1,
                "hits": 41430
            },
            {
                "id": 3,
                "hits": 957485
            },
            {
                "id": 5,
                "hits": 5931
            },
            {
                "id": 6,
                "hits": 19
            },
            {
                "id": 8,
                "hits": 7
            },
            {
                "id": 9,
                "hits": 41354
            },
            {
                "id": 11,
                "hits": 132971
            },
            {
                "id": 12,
                "hits": 139693
            },
            {
                "id": 14,
                "hits": 63
            },
            {
                "id": 15,
                "hits": 15
            }
        ]
    }
}

list = abuselog

Fälle auflisten, in denen Aktionen einen Missbrauchsfilter ausgelöst haben.

Parameter
  • aflstart - Der Zeitstempel, ab dem die Aufzählung beginnen soll
  • aflend - Der Zeitstempel, bei dem die Aufzählung beendet werden soll
  • afldir - Die Richtung, in der aufgezählt werden soll (älter, neuer)
  • afluser - Nur Einträge anzeigen, bei denen die Aktion von einem bestimmten Benutzer oder einer bestimmten IP-Adresse versucht wurde.
  • afltitle - Nur Einträge anzeigen, bei denen die Aktion eine bestimmte Seite betraf.
  • aflfilter - Nur Einträge anzeigen, die eine bestimmte Filter-ID ausgelöst haben
  • afllimit - Die maximale Anzahl aufzulistender Einträge
  • aflprop - Welche Eigenschaften erhalten werden sollen: (ids|filter|user|ip|title|action|details|result|timestamp|hidden|revid|wiki)
Beispiel
Fälle auflisten, in denen der Missbrauchsfilter als Reaktion auf Aktionen des Benutzers „SineBot“ ausgelöst wurde
Ergebnis
{
    "batchcomplete": "",
    "continue": {
        "aflstart": "2018-03-06T02:34:18Z",
        "continue": "-||"
    },
    "query": {
        "abuselog": [
            {
                "id": 27219261,
                "filter_id": "1073"
            },
            {
                "id": 26938051,
                "filter_id": ""
            },
            {
                "id": 23388942,
                "filter_id": "1"
            },
            {
                "id": 22044912,
                "filter_id": ""
            },
            {
                "id": 22032235,
                "filter_id": ""
            },
            {
                "id": 22032196,
                "filter_id": ""
            },
            {
                "id": 21983882,
                "filter_id": ""
            },
            {
                "id": 20594818,
                "filter_id": "904"
            },
            {
                "id": 20593489,
                "filter_id": "904"
            },
            {
                "id": 20590442,
                "filter_id": "904"
            }
        ]
    }
}

Mögliche Fehler

  • Bei einigen Benutzern kann es vorkommen, dass das Erstellen neuer Filter oder das Ändern alter Filter fehlschlägt und der Benutzer einfach auf die ursprüngliche Seite umgeleitet wird. Wenn das Wiki SSL-Zertifikate verwendet, liegt dieser Fehler möglicherweise am Wert von $wgServer , der möglicherweise „http://“ statt „https://“ verwendet. Ein Hinweis auf diesen Fehler ist, dass der Browser eine https-Warnung für Special:AbuseFilter-Seiten ausgibt. (Topic:T23dyyih0ofjada5)

Integration mit anderen Erweiterungen

Du kannst AbuseFilter auf verschiedene Weise mit anderen Erweiterungen integrieren.

Hinzufügen von Variablen zum Filtern

Es ist möglich, neue Variablen hinzuzufügen, die in Missbrauchsfiltern verwendet werden können. Eine Liste mit Beispielen ist verfügbar . Dazu solltest du:

  • Einen Handler für den Hook AbuseFilter-builder hinzufügen. Um eine Variable hinzuzufügen, solltest du $builder['vars']['variable_name'] = 'i18n-key'; verwenden, wobei variable_name der Name der Variablen und i18n-key das Fragment eines i18n-Schlüssels ist. Der vollständige Schlüssel ist abusefilter-edit-builder-vars-{$your_key}.
  • Die i18n-Nachrichten hinzufügen, die du im vorherigen Punkt ausgewählt hast.
  • Einen Hook-Handler auswählen, in dem die Variable berechnet wird. Abhängig von deinem Anwendungsfall könntest du:
    • Den Hook AbuseFilter-generateTitleVars implementieren; dieser ist speziell für seitenbezogene Variablen gedacht;
    • Den Hook AbuseFilter-generateUserVars implementieren; dieser ist speziell für benutzerbezogene Variablen gedacht;
    • Den Hook AbuseFilter-generateGenericVars implementieren; dieser ist für Variablen gedacht, die nicht an eine bestimmte Seite oder einen bestimmten Benutzer gebunden sind;
    • Den Hook AbuseFilterAlterVariables implementieren; dieser ist etwas flexibler als die anderen Hooks, hat aber einen Nachteil: Deine Variable ist bei der Untersuchung früherer Einträge in den letzten Änderungen nicht verfügbar. Wenn du diese Funktion implementieren möchtest (und dies wird empfohlen), solltest du einen der oben aufgeführten Hooks und dessen dritten Parameter ($RCRow) verwenden.
  • Innerhalb des Hook-Handlers gibt es zwei Möglichkeiten, eine Variable hinzuzufügen:
    • Der „direkte“ Weg ist der Aufruf von $vars->setVar( 'var_name', var_value );. Dies ist nur dann ideal, wenn der Wert einfach und schnell zu berechnen ist: Der Wert wird berechnet, auch wenn kein aktiver Filter ihn verwendet.
    • Der „faule“ Weg ist der Aufruf von $vars->setLazyLoadVar( 'var_name', 'method_name', $params );. Hier ist „method_name“ eine (eindeutige) Kennung, die zur Berechnung der Variablen verwendet wird (es wird empfohlen, ihr den Namen deiner Erweiterung voranzustellen). Um die Methode zu registrieren, solltest du einen Handler für den Hook AbuseFilter-computeVariable hinzufügen; darin solltest du prüfen, ob die übergebene $method mit deinem „method_name“ übereinstimmt, und wenn ja, die Variable berechnen. Schließlich ist $params ein Array von Parametern, die du zum Berechnen der Variable benötigst; diese werden an den Hook-Handler calculateVariable übergeben. Als Beispiel hierfür kannst du dir global_user_groups von CentralAuth ansehen.

Hinzufügen von benutzerdefinierten Aktionen

Du kannst benutzerdefinierte Aktionshandler hinzufügen, sodass jeder Filter weitere Aktionen ausführen kann. Wähle dazu einen Namen für die Aktion (ab jetzt „my-action“) und dann:

  • Erstelle eine Klasse mit z. B. dem Namen MyAction, die \MediaWiki\Extension\AbuseFilter\Consequence erweitern soll, die auch HookAborterConsequence oder ConsequencesDisablerConsequence implementieren kann
  • Füge zu dem Hook AbuseFilterCustomActions einen Abonnenten hinzu. Der Abonnent sollte einen Rückruf bereitstellen, wie in der Hook-Dokumentation beschrieben, der eine Instanz der oben erstellten Klasse zurückgibt, zum Beispiel:
class MyAction extends \MediaWiki\Extension\AbuseFilter\Consequence {
    public function run() {
        throw new \Exception( 'Write me' );
    }
}
public function onAbuseFilterCustomActions( &$actions ) {
    $actions[] = function ( \MediaWiki\Extension\AbuseFilter\Consequence\Parameters $params, array $rawParams ) : MyConsequence {
        return new MyAction( $params, $rawParams );
    };
}

Dann solltest du die folgenden i18n-Nachrichten hinzufügen; du kannst „my_action“ z. B. durch „block“ ersetzen, um zu sehen, wozu die Nachrichten dienen:

  • 'abusefilter-edit-action-${my_action}'
  • 'abusefilter-action-${my_action}'

Regelgruppen hinzufügen

Darüber hinaus kannst du zusätzliche Regelgruppen hinzufügen, mit denen sich vorhandene Missbrauchsfilter gruppieren lassen. Beachte, dass sich jeder Filter derzeit nur in einer einzigen Gruppe befinden kann (T116642). Derzeit ist Erweiterung:StructuredDiscussions der einzige bekannte Verwender dieser Funktion. Dazu solltest du:

  • Den Namen der Gruppe an $wgAbuseFilterValidGroups anhängen
  • Code hinzufügen, um die Filter mit deiner Gruppe auszuführen. Beachte, dass AbuseFilter dies nicht alleine tut. Um dies zu tun, solltest du ein Objekt AbuseFilterRunner erstellen und den Namen deiner Gruppe übergeben.

Siehe auch