Extension:MediaWikiAuth
 Release status: beta |
|||
|---|---|---|---|
| Implementation | User identity | ||
| Description | Transparently imports users from another wiki | ||
| Author(s) | Laurence "GreenReaper" Parry Ryan Schmidt (Skizzerz) Kim Schoonover |
||
| Last version | 0.7 | ||
| MediaWiki | 1.19+ recommended | ||
| License | GNU General Public License 2.0 or later | ||
| Download |
Note: no localisation updates provided by translatewiki.net. |
||
|
|||
| Check usage and version matrix; stats | |||
The MediaWikiAuth extension transparently logs a user in to a remote wiki, importing the user's account and preferences to the local wiki.
Contents |
What can this extension do?[edit]
This extension uses the MediaWiki API and AuthPlugin framework to direct login requests with no local account to a remote wiki. The account and its preferences are imported, so the remote login only has be done once. If possible, the same internal user ID is preserved.
This extension is useful for moving a community from another wiki when you do not have access to the user account database. From a user perspective, it's like they already had an account on the local wiki.
Usage[edit]
Install MediaWikiAuth as specified below, set $wgMediaWikiAuthAPIURL and $wgMediaWikiAuthPrefsURL for the remote wiki, and login using an account on the remote wiki which is not currently present on the local wiki.
Installation[edit]
- Download the files into
$IP/extensions/MediaWikiAuth - Apply the patch (
SpecialUserlogin.php-1.17alpha.r67921.patch) against your wiki's includes/specials/SpecialUserlogin.php - Add the following to LocalSettings.php:
$wgMediaWikiAuthAPIURL = 'http://www.example.com/w/api.php';
$wgMediaWikiAuthPrefsURL = 'http://www.example.com/wiki/Special:Preferences';
require_once("$IP/extensions/MediaWikiAuth/MediaWikiAuth.php");
$wgAuth = new MediaWikiAuthPlugin(); - Installation can now be verified through your wiki's Special:Version page
Configuration parameters[edit]
- $wgMediaWikiAuthAPIURL
URL to the api.php file on the target wiki. Normally in the /w/ directory (e.g. http://www.mediawiki.org/w/api.php), but not always; for example, Wikia's is at http://www.wikia.com/api.php.
- $wgMediaWikiAuthPrefsURL
URL to the Special:Preferences page on the target wiki. Remember to append ?uselang=en to the URL, like this: http://www.wikia.com/wiki/Special:Preferences?uselang=en (see MediaWikiAuth.php, line 309 for the reason why this needs to be done)
