Erweiterung:Missbrauchsfilter
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 | |
|
|
|
|
|
|
|
|
Quarterly downloads | 139 (Ranked 42nd) |
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 |
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 Ordnerextensions/
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.
- Erledigt – Navigiere zu Special:Version in deinem Wiki, um zu überprüfen, ob die Erweiterung erfolgreich installiert wurde.
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.
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;
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.
- Regelformat - Die Grundlagen zum Schreiben eines Filters
- Aktionen
- Globale Regeln
- Leitfaden zur Optimierung der Verwendung von Bedingungsgrenzen
- So importierst du Filter aus Wikipedia: Wenn du die Erweiterung installiert hast, gehe zu w:Special:AbuseFilter, wähle einen Filter aus (beispielsweise w:Special:AbuseFilter/3) und klicke auf "Diesen Filter in ein anderes Wiki exportieren". Kopiere den Text. Gehe in deinem Wiki auf "Special:AbuseFilter/import" und füge den Text ein.
- m:Small wiki toolkits/Starter kit/AbuseFilter - Ein Leitfaden für kleine Wiki-Communities im Meta-Wiki
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 sollabfendid
- Die Filter-ID, bei der die Aufzählung beendet werden sollabfdir
- 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 Filterabfprop
- 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
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 sollaflend
- Der Zeitstempel, bei dem die Aufzählung beendet werden sollafldir
- 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 habenafllimit
- Die maximale Anzahl aufzulistender Einträgeaflprop
- Welche Eigenschaften erhalten werden sollen: (ids|filter|user|ip|title|action|details|result|timestamp|hidden|revid|wiki)
- Beispiel
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, wobeivariable_name
der Name der Variablen undi18n-key
das Fragment eines i18n-Schlüssels ist. Der vollständige Schlüssel istabusefilter-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 dirglobal_user_groups
von CentralAuth ansehen.
- Der „direkte“ Weg ist der Aufruf von
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
- Help:BlockedExternalDomains
- Liste der WMF-Wikis mit Bearbeitungsfilter (mit der jeweiligen Konfiguration)
Diese Erweiterung wird in einem oder mehreren Wikis von Wikimedia verwendet. Das bedeutet mit hoher Wahrscheinlichkeit, dass die Erweiterung stabil ist und gut genug funktioniert, um auf solch häufig besuchten Webseiten benutzt zu werden. Suche nach dem Erweiterungs-Namen in den Wikimedia CommonSettings.php und den InitialiseSettings.php-Konfigurations-Dateien, um nachzusehen, wo es installiert ist. Eine vollständige Liste der installierten Erweiterungen in einem bestimmten Wiki wird auf Special:Version im Wiki generiert und angezeigt. |
Diese Erweiterung ist in den folgenden Softwarepaketen enthalten und/oder wird von den folgenden Wiki-Farmen, bzw. Wiki-Hostern verwendet: Dies ist keine maßgebliche Liste. Softwarepakete und/oder Wiki-Farmen, bzw. Wiki-Hoster nutzen diese Erweiterung ggf., obwohl sie nicht in dieser Liste enthalten sind. Prüfe daher stets die Nutzung im verwendeten Softwarepaket und/oder bei der Wiki-Farm, bzw. dem Wiki-Hoster. |