Partially update README

Bug: T224803
Change-Id: I02ef7215b9c0d231fbd91b84978fe43e3940cdfc
This commit is contained in:
MarcoAurelio 2019-06-01 09:49:30 +00:00 committed by D3r1ck01
parent 81ae3d404d
commit abc36ab304

24
README
View file

@ -10,7 +10,15 @@ To enable it, first download a copy of the SpamBlacklist directory and put it
into your extensions directory. Then put the following at the end of your
LocalSettings.php:
require_once( "$IP/extensions/SpamBlacklist/SpamBlacklist.php" );
wfLoadExtension ( 'SpamBlacklist' );
To users running MediaWiki 1.24 or earlier:
The instructions above describe the new way of installing this extension using wfLoadExtension().
If you need to install this extension on these earlier versions (MediaWiki 1.24 and earlier),
instead of `wfLoadExtension( 'SpamBlacklist' );`, you need to use:
require_once "$IP/extensions/SpamBlacklist/SpamBlacklist.php";
The list of bad URLs can be drawn from multiple sources. These sources are
configured with the $wgSpamBlacklistFiles global variable. This global variable
@ -23,13 +31,11 @@ specifier is "DB: <db name> <title>".
Example:
require_once( "$IP/extensions/SpamBlacklist/SpamBlacklist.php" );
$wgSpamBlacklistFiles = array(
wfLoadExtension ( 'SpamBlacklist' );
$wgSpamBlacklistFiles = [
"$IP/extensions/SpamBlacklist/wikimedia_blacklist", // Wikimedia's list
// database title
"DB: wikidb My_spam_blacklist",
);
"DB: wikidb My_spam_blacklist", // database (wikidb), title (My_spam_blacklist)
];
The local pages [[MediaWiki:Spam-blacklist]] and [[MediaWiki:Spam-whitelist]]
will always be used, whatever additional files are listed.
@ -114,7 +120,7 @@ Obtaining or making blacklists
The primary source for a MediaWiki-compatible blacklist file is the Wikimedia
spam blacklist on meta:
http://meta.wikimedia.org/wiki/Spam_blacklist
https://meta.wikimedia.org/wiki/Spam_blacklist
In the default configuration, the extension loads this list from our site
once every 10-15 minutes.
@ -125,7 +131,7 @@ hence the Wikimedia blacklist is comparatively conservative in the links it
blocks. You may want to add your own keyword blocks or even ccTLD blocks.
You may suggest modifications to the Wikimedia blacklist at:
http://meta.wikimedia.org/wiki/Talk:Spam_blacklist
https://meta.wikimedia.org/wiki/Talk:Spam_blacklist
To make maintenance of local lists easier, you may wish to add a DB: source to
$wgSpamBlacklistFiles and hence create a blacklist on your wiki. If you do this,