Extension:Interwiki

From MediaWiki.org
(Redirected from Extension:SpecialInterwiki)
Jump to: navigation, search
This extension is bundled with MediaWiki 1.21 and above. Thus you do not have to download it again.
This extension should not be confused with Extension:InterWiki.
MediaWiki extensions manual - list
Crystal Clear action run.png
Interwiki

Release status: stable

MediaWiki extension Interwiki.png
Implementation Special page
Description Adds a special page to view and manipulate the interwiki table.
Author(s) Stephanie Amanda Stevens, SPQRobin
Latest version 2.3 20140327 (2014-03-28)
MediaWiki 1.16+ (see Download)
Database changes no
License GNU General Public License 2.0 or later
Download
Example see here
Parameters

$wgInterwikiViewOnly

Added rights

interwiki

Translate the Interwiki extension if possible

Check usage and version matrix; code metrics
Bugs: list open list all report

This is an extension to add a Special:Interwiki page to MediaWiki, to view and edit the interwiki table, and a log of any actions made with it. It was made by Stephanie Amanda Stevens a.k.a Phroziac, because she was annoyed at forgetting the interwiki prefixes.

Since Interwiki version 2.1, it works with the $wgInterwikiCache, and the CSS uses ResourceLoader. This version is only compatible with MW 1.19+.

The list of Special:Interwiki is identical to the API action=query&meta=siteinfo&siprop=interwikimap.

Download[edit | edit source]

These are recommended versions to use per MediaWiki version. If the recommended version does not work with a certain MediaWiki version, please let us know. Click the "(snapshot)" link to the right of your MediaWiki version in the table below.

Optionally, You can download the extension directly from the MediaWiki source code repository (browse code). You can get:

One of the extensions tags

Not all extensions have tags. Some extensions have tags for each release, in which case those tags have the same stability as the release. To download a tag

  • Go to the tags list
  • Click the name of the tag you want to download
  • Click "snapshot"
The latest version of one of the extensions branches

Each extension has a master branch containing the latest code (might be unstable). Extensions can have further branches as well.

  • Go to the branches list
  • Click the branch name
  • Click "snapshot"
A snapshot made during the release of a MediaWiki version.

This might be unstable and is not guaranteed to work with the associated MediaWiki version.

After you've got the code, save it into the extensions/Interwiki directory of your wiki.

If you are familiar with git and have shell access to your server, you can obtain the extension, with all its tags and branches, as follows:

cd extensions
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/Interwiki.git

Installation[edit | edit source]

  • Download and extract the files in a directory called Interwiki in your extensions/ folder. If you're a developer and this extension is in a Git repository, then instead you should clone the repository.
  • Add the following code at the bottom of your LocalSettings.php:
require_once( "$IP/extensions/Interwiki/Interwiki.php" );
// To grant sysops permissions to edit interwiki data
$wgGroupPermissions['sysop']['interwiki'] = true;
 
// To create a new user group that may edit interwiki data
// (bureaucrats can add users to this group)
#$wgGroupPermissions['developer']['interwiki'] = true;    #<---delete the comment indicator as appropriate
  • Done! Navigate to "Special:Version" on your wiki to verify that the extension is successfully installed.

To enable transclusion from other sites, you'll need to enable $wgEnableScaryTranscluding

To disable adding prefixes through the Special:Interwiki interface, set $wgInterwikiViewOnly to true.

This extension's entry in the list of Special pages is not the name of the extension. The entry in the list is defined by the interwiki message item defined per locale in SpecialInterwiki.i18n.php. For English locales, its value is View and edit interwiki data.

Setting up interlanguage links[edit | edit source]

To set up interlanguage links using this extension, make sure that $wgInterwikiMagic is set to true and $wgHideInterlanguageLinks is set to false (they are like this by default, you don't need to change them usually). Then go to Special:Interwiki as a user with the appropriate permissions. For example, if the French version of your wiki was located at http://fr.foowiki.tld/wiki/, you could add http://fr.foowiki.tld/wiki/$1 to the interwiki table with values trans 0 and local 0. Then the interlanguage link to the French version would work, but a #REDIRECT to a French-language page from a page in some other language would be refused.

See Manual:Interwiki table for a full explanation of the forward (iw_local) and transclude (iw_trans) bits.

In brief:

  • Enabling forwarding ('local' true) is normally done between all languages and projects in the same group, as it allows a link to any one of the languages to be used as a gateway to the others. The English-language Wikipedia, for instance, sets the 'local' bit true for all of the other-language Wikipedias and for projects like commons:, wikinews: or wikivoyage:. A user on a wiki outside Wikipedia where the wikipedia: interwiki prefix points to en.wikipedia.org could create a link like wikipedia:fr:Encyclopédie. That link goes initially to "fr:Encyclopédie" on the English-language Wikipedia. The en.wikipedia server immediately recognises fr: as a 'local' interwiki link, so replies with a redirect to la Wikipédia where fr.wikipedia.org/wiki/Encyclopédie displays the requested French-language Wikipédia page [[Encyclopédie]] et voilà.
  • Enabling transclusion is rarely done, as it allows an article on one wiki to use templates from some other wiki. This is referred to as 'scary transclusion' as it will cause problems if the other wiki changes the template unexpectedly. A few wiki farms use this to create one 'central wiki' with various templates which are made available to other wikis in the same farm. If you don't need this, don't enable it.

Protocol-relative URLs[edit | edit source]

MediaWiki supports protocol-relative URLs (PRURLs), beginning with version 1.18. To use PRURLs, simply remove the http: portion of the URLs in the default link table. Ensure the server supports HTTPS before you do that. For example, this

http://en.wikipedia.org/wiki/$1

should be changed to this:

//en.wikipedia.org/wiki/$1

See also[edit | edit source]


Language: English  • 日本語