Jump to content

Erweiterung:Missbrauchsfilter

Issue-Tracker: #AbuseFilter
From mediawiki.org
This page is a translated version of the page Extension:AbuseFilter and the translation is 100% complete.
Languages:
Diese Erweiterung ist in MediaWiki 1.38 und darüber enthalten. 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.
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
Erweiterung herunterladen
Git [?]:
Parameter
  • $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
Hinzugefügte Rechte
  • 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
Verwendete Hooks
Bereitgestellte Hooks
Quarterly downloads 126 (Ranked 44th)
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.

Benutzerrechte für AbuseFilter
Recht Beschreibung Anmerkungen Benutzergruppen, die dieses Recht standardmäßig haben Versions
abusefilter-modify Missbrauchsfilter erstellen oder bearbeiten Erfordert das „abusefilter-view“-Recht sysop 1.19+
abusefilter-view Missbrauchsfilter ansehen * 1.19+
abusefilter-log Missbrauchsfilter-Logbuch einsehen * 1.19+
abusefilter-log-detail Erweitertes Missbrauchsfilter-Logbuch einsehen Erfordert das „abusefilter-log“-Recht sysop 1.19+
abusefilter-privatedetails Private Daten im Missbrauchsfilter-Logbuch einsehen Vor 1.34 wurde dieses Recht abusefilter-private genannt. - Erfordert das „abusefilter-log-detail“-Recht — 1.19+
abusefilter-modify-restricted Missbrauchsfilter mit privilegierten Aktionen bearbeiten Erfordert das „abusefilter-modify“-Recht sysop 1.19+
abusefilter-revert Alle Bearbeitungen durch einen bestimmten Missbrauchsfilter zurücksetzen sysop 1.19+
abusefilter-view-private Als privat markierte Missbrauchsfilter einsehen Erfordert das „abusefilter-view“-Recht (nicht erforderlich, wenn die Gruppe bereits das abusefilter-modify-Recht hat) sysop 1.19+
abusefilter-hide-log Einträge aus dem Missbrauchsfilter-Logbuch ausblenden Erfordert das „abusefilter-log“-Recht suppress 1.19+
abusefilter-hidden-log Versteckte Einträge im Missbrauchsfilter-Logbuch einsehen Erfordert das „abusefilter-log“-Recht suppress 1.19+
abusefilter-log-private Als privat markierte Einträge im Missbrauchsfilter einsehen Erfordert das „abusefilter-log“-Recht (nicht erforderlich, wenn die Gruppe bereits die abusefilter-modify oder abusefilter-view-private Rechte hat) sysop 1.20+
abusefilter-modify-global Globale Missbrauchsfilter erstellen oder verändern Erfordert das „abusefilter-modify“-Recht — 1.21+
abusefilter-privatedetails-log Das Missbrauchsfilter-Private-Einzelheiten-Zugriffs-Logbuch ansehen Vor 1.34 wurde dieses Recht abusefilter-private-log genannt. — 1.31+
abusefilter-modify-blocked-external-domains Erstellen oder Ändern, welche externen Domänen für die Verknüpfung gesperrt sind sysop 1.41+
abusefilter-bypass-blocked-external-domains Umgehung gesperrter externer Domains Erfordert das „edit“-Recht bot 1.41+
abusefilter-access-protected-vars Anzeigen und Erstellen von Filtern, die geschützte Variablen verwenden sysop 1.43+
abusefilter-protected-vars-log Anzeigen von Logbüchern zum Zugriff auf geschützte Variablenwerte sysop 1.43+

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.
Geschützte Filter können nur von Benutzern mit der Berechtigung abusefilter-access-protected-vars erstellt und angezeigt werden. Die Protokolle zu diesen Filtern können nur von Benutzern mit der Berechtigung abusefilter-protected-vars-log eingesehen werden. Für mehr Informationen, siehe Missbrauchsfilter/Regelformat .

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. Erfordert, dass CentralAuth installiert ist, sonst werden globale Filter auf einer Wikifarm nicht funktionieren.
$wgAbuseFilterIsCentral 
false
MW 1.41+ Setzen Sie diese Variable auf true für das Wiki, in dem globale AbuseFilters gespeichert sind. 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 von Variablen, die als geschützt (begrenzt zugänglich) angesehen werden und das Benutzer-/Anzeigungsrecht von abusefilter-access-protected-vars erfordern.

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|geschützt|!geschützt)
  • 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
api.php?action=query&list=abusefilters&abfshow=!private&abfprop=id|hits [In der ApiSandbox ausprobieren]
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
api.php?action=query&list=abuselog&afluser=SineBot&aflprop=ids [In der ApiSandbox ausprobieren]
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

Retrieved from "https://www.mediawiki.org/w/index.php?title=Extension:AbuseFilter/de&oldid=6884913"