Help:User rights
From STIQ
 | Important note: When you edit this page, you agree to release your contribution into the public domain. If you don't want this or can't do this because of license restrictions, please don't edit. This page is one of the Public Domain Help Pages, which can be freely copied into fresh wiki installations and/or distributed with MediaWiki software; see Help:Contents for an overview of all pages. |
User rights are specific access and ability permissions that can be assigned to customizable groups, which can then be assigned to (or removed from) users through the Special:Userrights interface. For example, the default bureaucrat group enables the use of the User rights interface.
This feature was introduced in MediaWiki 1.5; see setting user rights in MediaWiki on the Meta-wiki for earlier methods.
Contents |
Changing group permissions
A default MediaWiki installation assigns certain rights to default groups (see below). You can change the default rights by editing the $wgGroupPermissions array in LocalSettings.php with the syntax <source lang="php">$wgGroupPermissions['group']['right'] = true /* or false */;</source>
If a member has multiple groups, they get the highest permission of any groups. All users, including anonymous users, are in the '*' group; all registered users are in the 'user' group. In addition to the default groups, you can arbitrarily create new groups using the same array.
Examples
This example will disable viewing of all pages not listed in $wgWhitelistRead, then re-enable for registered users only: <source lang="php"> $wgGroupPermissions['*']['read'] = false;
- The following line is not actually necessary, since it's in the defaults. Setting
- '*' to false doesn't disable rights for groups that have the right separately set
- to true!
$wgGroupPermissions['user']['read'] = true; </source>
This example will disable editing of all pages, then re-enable for users with confirmed e-mail addresses only: <source lang="php">
- Disable for everyone
$wgGroupPermissions['*']['edit'] = false;
- Disable for users, too: by default 'user' is allowed to edit, even if '*' is not.
$wgGroupPermissions['user']['edit'] = false;
- Finally, set it to true for the desired group.
$wgGroupPermissions['emailconfirmed']['edit'] = true; </source>
This example will create an arbitrary "ninja" group that can block users and delete pages, and whose edits are hidden by default in the recent changes log: <source lang="php"> $wgGroupPermissions['ninja']['bot'] = true; $wgGroupPermissions['ninja']['block'] = true; $wgGroupPermissions['ninja']['delete'] = true; </source>
List of rights and groups
The following user rights are available in the latest version of MediaWiki. If you are using an older version, look at "Special:Version" on your wiki and see if your version is covered in the "versions" column.
| Right | Description | Versions |
|---|---|---|
| Reading | ||
| read | allows viewing pages (when set to false, override for specific pages with $wgWhitelistRead).
| 1.5+ |
| Editing | ||
| edit | allows editing unprotected pages. | 1.5+ |
| createpage | allows the creation of new pages (requires the edit right). | 1.6+ |
| createtalk | allows the creation of new talk pages (requires the edit right). | 1.6+ |
| move | allows renaming page titles. | 1.5+ |
| createaccount | allows the creation of new user accounts. | 1.5+ |
| upload | allows the creation of new images and files. | 1.5+ |
| reupload | allows overwriting existing images and files. | 1.6+ |
| reupload-shared | allows replacing images and files from a shared repository (if one is set up) with local files. | 1.6+ |
| upload_by_url | allows uploading by entering the URL of an external image. | 1.8+ |
| Management | ||
| delete | allows the deletion of edits and pages. | 1.5+ |
| undelete | allows viewing and restoring deleted edits and pages. | |
| deletedhistory | allows viewing deleted revisions, but not restoring. | 1.6+ |
| mergehistory | allows access to Special:MergeHistory, to merge non-overlapping pages. Note: currently disabled on Wikimedia wikis. | 1.12+ |
| protect | allows locking a page to prevent edits, and editing locked pages. | 1.5+ |
| block | allows the blocking of IP addresses, CIDR ranges, and registered users. Block options include preventing editing and registering new accounts, and autoblocking other users on the same IP address. | 1.5+ |
| blockemail | allows preventing use of the Special:Emailuser interface when blocking. | |
| userrights | allows the use of the user rights interface, which allows the assignment or removal of groups to any user. | 1.5+ |
| rollback | allows one-click reversion of edits. | 1.5+ |
| markbotedits | allow rollback to be marked as bot edits (see m:Help:Administration#Rollback). | 1.12+ |
| patrol | allows marking edits as legitimate ($wgUseRCPatrol must be true). | 1.5+ |
| editinterface | allows editing the MediaWiki namespace, which contains interface messages. | 1.5+ |
| editusercssjs | allows editing user's monobook.css, monobook.js, ... subpages. | 1.12+ |
| Administration | ||
| siteadmin | allows locking and unlocking the database (which blocks all interactions with the web site except viewing). | 1.5+ |
| import | allows user to import pages from another wiki. | 1.5+ |
| importupload | allows user to import pages from XML files. | 1.5+ |
| trackback | allows removal of trackbacks (if $wgUseTrackbacks is true). | 1.7+ |
| unwatchedpages | allows access to Special:Unwatchedpages, which lists pages that no user has watchlisted. | 1.6+ |
| Technical | ||
| bot | hides edits from recent changes lists and watchlists by default (can optionally be viewed). | 1.5+ |
| purge | allows purging a page without a confirmation step (URL parameter "&action=purge").
| |
| minoredit | allows marking an edit as 'minor'. | 1.6+ |
| nominornewtalk | blocks new message notification when making minor edits to user talk pages (requires minor edit right). | |
| ipblock-exempt | makes user immune to blocks applied to his IP address. | |
| proxyunbannable | makes user immune to the open proxy blocker, which is disabled by default ($wgBlockOpenProxies). | 1.7+ |
| autopatrol | automatically marks all edits by the user as patrolled ($wgUseRCPatrol must be true). | |
The following groups are available in the latest version of MediaWiki. If you are using an older version then some of these may not be implemented.
| Group | Description | Versions |
|---|---|---|
| * | all users (including anonymous). | 1.5+ |
| user | registered accounts. | 1.5+ |
| autoconfirmed | registered accounts at least as old as $wgAutoConfirmAge and having at least as many edits as $wgAutoConfirmCount. | 1.6+ |
| emailconfirmed | registered accounts with confirmed email addresses. | 1.7+ |
| bot | accounts with the bot right (intended for automated scripts). | 1.5+ |
| sysop | users who by default can delete and restore pages, block and unblock users, et cetera. | 1.5+ |
| bureaucrat | users who by default can change other users' rights. | 1.5+ |
Note that the 'developer' group is obsolete and should no longer be used.
Default rights
The default rights are defined in DefaultSettings.php. MediaWiki 1.12alpha defines the following (for older versions see Manual:$wgGroupPermissions). <source lang="php"> /**
* Permission keys given to users in each group. * All users are implicitly in the '*' group including anonymous visitors; * logged-in users are all implicitly in the 'user' group. These will be * combined with the permissions of all groups that a given user is listed * in in the user_groups table. * * Note: Don't set $wgGroupPermissions = array(); unless you know what you're * doing! This will wipe all permissions, and may mean that your users are * unable to perform certain essential tasks or access new functionality * when new permissions are introduced and default grants established. * * Functionality to make pages inaccessible has not been extensively tested * for security. Use at your own risk! * * This replaces wgWhitelistAccount and wgWhitelistEdit */
$wgGroupPermissions = array();
// Implicit group for all visitors $wgGroupPermissions['*' ]['createaccount'] = true; $wgGroupPermissions['*' ]['read'] = true; $wgGroupPermissions['*' ]['edit'] = true; $wgGroupPermissions['*' ]['createpage'] = true; $wgGroupPermissions['*' ]['createtalk'] = true;
// Implicit group for all logged-in accounts $wgGroupPermissions['user' ]['move'] = true; $wgGroupPermissions['user' ]['read'] = true; $wgGroupPermissions['user' ]['edit'] = true; $wgGroupPermissions['user' ]['createpage'] = true; $wgGroupPermissions['user' ]['createtalk'] = true; $wgGroupPermissions['user' ]['upload'] = true; $wgGroupPermissions['user' ]['reupload'] = true; $wgGroupPermissions['user' ]['reupload-shared'] = true; $wgGroupPermissions['user' ]['minoredit'] = true; $wgGroupPermissions['user' ]['purge'] = true; // can use ?action=purge without clicking "ok"
// Implicit group for accounts that pass $wgAutoConfirmAge $wgGroupPermissions['autoconfirmed']['autoconfirmed'] = true;
// Implicit group for accounts with confirmed email addresses // This has little use when email address confirmation is off $wgGroupPermissions['emailconfirmed']['emailconfirmed'] = true;
// Users with bot privilege can have their edits hidden // from various log pages by default $wgGroupPermissions['bot' ]['bot'] = true; $wgGroupPermissions['bot' ]['autoconfirmed'] = true; $wgGroupPermissions['bot' ]['nominornewtalk'] = true; $wgGroupPermissions['bot' ]['autopatrol'] = true; $wgGroupPermissions['bot' ]['suppressredirect'] = true;
// Most extra permission abilities go to this group $wgGroupPermissions['sysop']['block'] = true; $wgGroupPermissions['sysop']['createaccount'] = true; $wgGroupPermissions['sysop']['delete'] = true; $wgGroupPermissions['sysop']['deletedhistory'] = true; // can view deleted history entries, but not see or restore the text $wgGroupPermissions['sysop']['editinterface'] = true; $wgGroupPermissions['sysop']['editusercssjs'] = true; $wgGroupPermissions['sysop']['import'] = true; $wgGroupPermissions['sysop']['importupload'] = true; $wgGroupPermissions['sysop']['move'] = true; $wgGroupPermissions['sysop']['patrol'] = true; $wgGroupPermissions['sysop']['autopatrol'] = true; $wgGroupPermissions['sysop']['protect'] = true; $wgGroupPermissions['sysop']['proxyunbannable'] = true; $wgGroupPermissions['sysop']['rollback'] = true; $wgGroupPermissions['sysop']['trackback'] = true; $wgGroupPermissions['sysop']['upload'] = true; $wgGroupPermissions['sysop']['reupload'] = true; $wgGroupPermissions['sysop']['reupload-shared'] = true; $wgGroupPermissions['sysop']['unwatchedpages'] = true; $wgGroupPermissions['sysop']['autoconfirmed'] = true; $wgGroupPermissions['sysop']['upload_by_url'] = true; $wgGroupPermissions['sysop']['ipblock-exempt'] = true; $wgGroupPermissions['sysop']['blockemail'] = true; $wgGroupPermissions['sysop']['markbotedits'] = true; $wgGroupPermissions['sysop']['suppressredirect'] = true; // wiki note: not yet used; seems to allow moving a page without automatic redirect
- $wgGroupPermissions['sysop']['mergehistory'] = true;
// Permission to change users' group assignments $wgGroupPermissions['bureaucrat']['userrights'] = true;
// Experimental permissions, not ready for production use //$wgGroupPermissions['sysop']['deleterevision'] = true; //$wgGroupPermissions['bureaucrat']['hiderevision'] = true;
/**
* The developer group is deprecated, but can be activated if need be * to use the 'lockdb' and 'unlockdb' special pages. Those require * that a lock file be defined and creatable/removable by the web * server. */
- $wgGroupPermissions['developer']['siteadmin'] = true;
</source>
See also
>== Template ==
<onlyinclude><div class="LanguageLinks">
<table width="100%">
<tr valign="top" style="background: #EEF3E2">
<td style="width: 25px; padding-left: 0.5em;">
</td>
<td style="width: 10px; white-space: nowrap; padding: 4px 1em 0 0.5em; border-right: 1px solid #aaaaaa;">Languages: </td><td style="padding: 1px 1em 0; background: #F6F9ED;">
English
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/ar | • {{#if: Help:User rights|العربية| العربية}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/br | • {{#if: Help:User rights|Brezhoneg| Brezhoneg}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/ca | • {{#if: Help:User rights|Català| Català}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/cs | • {{#if: Help:User rights|Česky| Česky}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/de | • {{#if: Help:User rights|Deutsch| Deutsch}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/el | • {{#if: Help:User rights|Ελληνικά| Ελληνικά}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/es | • {{#if: Help:User rights|Español| Español}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/fa | • {{#if: Help:User rights|فارسی| فارسی}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/fi | • {{#if: Help:User rights|Suomi| Suomi}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/fr | • {{#if: Help:User rights|Français| Français}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/he | • {{#if: Help:User rights|עברית| עברית}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/hu | • {{#if: Help:User rights|Magyar| Magyar}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/id | • {{#if: Help:User rights|Bahasa Indonesia| Bahasa Indonesia}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/it | • {{#if: Help:User rights|Italiano| Italiano}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/ja | • {{#if: Help:User rights|日本語| 日本語}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/ko | • {{#if: Help:User rights|한국어| 한국어}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/mr | • {{#if: Help:User rights|मराठी| मराठी}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/nl | • {{#if: Help:User rights|Nederlands| Nederlands}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/no | • {{#if: Help:User rights|Norsk (bokmål)| Norsk (bokmål)}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/oc | • {{#if: Help:User rights|Occitan| Occitan}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/pl | • {{#if: Help:User rights|Polski| Polski}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/pt | • {{#if: Help:User rights|Português| Português}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/ro | • {{#if: Help:User rights|Română| Română}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/ru | • {{#if: Help:User rights|Русский| Русский}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/sq | • {{#if: Help:User rights|Shqip| Shqip}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/sr | • {{#if: Help:User rights|Српски / Srpski| Српски / Srpski}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/sv | • {{#if: Help:User rights|Svenska| Svenska}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/th | • {{#if: Help:User rights|ไทย| ไทย}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/vi | • {{#if: Help:User rights|Tiếng Việt| Tiếng Việt}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/yue | • {{#if: Help:User rights|粵語| 粵語}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/zh | • {{#if: Help:User rights|中文| 中文}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/zh-hans | • {{#if: Help:User rights|中文(简体)| 中文(简体)}}|}}
{{#ifexist: {{#if: Help:User rights | Help:User rights | {{#if: Help | Help:}}User rights}}/zh-hant | • {{#if: Help:User rights|中文(繁體)| 中文(繁體)}}|}}
</td></tr></table></div></onlyinclude>
Syntax
{{{Languages|PageName}}}
- PageName (optional) - the name of the page to display language links for. If omitted then the English version of the current page is used. This parameter can normally be omitted, as it is only required if you want to link to a page other than the one you place the template on, which is very uncommon. If this parameter is used on a sub-page make sure you supply the root name, not the full page name (e.g. on MediaWiki/fr you would need to use
{{{Languages|MediaWiki}}}and not{{{Languages|MediaWiki/fr}}}).
Usage
The template should only be placed on pages that exist in more than one language, and it should be placed in the same location on each translation of the page.
The English version of a page is always the main version, with all other languages as sub-pages, named using the appropriate language code (see below).
For example, on the Main Page you would include the text {{{Languages}}}, both on Main Page itself, and on each of its language sub-pages. The template automatically creates links to any language sub-pages that exist, e.g. Main Page/ja<tt>, <tt>Main Page/fr, and ignores non-existant languages.
See Project:Language policy for further details about translating pages.
Supported languages
This shows you the name of each language's sub-page (using Main Page as an example). Other languages may be added easily as necessary. Please use the appropriate prefix, as used on Wikipedia when adding a new language. Please do not add languages for which no pages exist yet, as this will increase the time needed to include the template without adding any benefit (languages are only displayed to the user when the relevant page exists).
The link on the language names goes to the Wikipedia in that language. If no Wikipedia in your language exists, do not add pages in that language to MediaWiki.org! This wiki is not the place for language advocacy - please go through the correct channels, and once your language has a Wikipedia then please return to add content here.
| Page Name | Language |
|---|---|
| Main Page | English |
| Main Page/ar | Arabic |
| Main Page/br | Breton |
| Main Page/ca | Catalan |
| Main Page/cs | Czech |
| Main Page/de | German |
| Main Page/el | Greek |
| Main Page/es | Spanish |
| Main Page/fa | Persian |
| Main Page/fi | Finnish |
| Main Page/fr | French |
| Main Page/he | Hebrew |
| Main Page/hu | Hungarian |
| Main Page/id | Indonesian |
| Main Page/it | Italian |
| Main Page/ja | Japanese |
| Main Page/ko | Korean |
| Main Page/mr | Marathi |
| Main Page/nl | Nederlands |
| Main Page/no | Norwegian |
| Main Page/oc | Occitan |
| Main Page/pl | Polish |
| Main Page/pt | Portugese |
| Main Page/ro | Romanian |
| Main Page/ru | Russian |
| Main Page/sq | Albanian |
| Main Page/sr | Serbian |
| Main Page/sv | Swedish |
| Main Page/th | Thai |
| Main Page/vi | Vietnamese |
| Main Page/yue | Cantonese |
| Main Page/zh | Chinese |
| Main Page/zh-hans | Chinese (Simplified) |
| Main Page/zh-hant | Chinese (Traditional) |
Example
Here is how the language bar looks on the MediaWiki page:
>== Template ==
<onlyinclude><div class="LanguageLinks">
<table width="100%">
<tr valign="top" style="background: #EEF3E2">
<td style="width: 25px; padding-left: 0.5em;"></td>
<td style="width: 10px; white-space: nowrap; padding: 4px 1em 0 0.5em; border-right: 1px solid #aaaaaa;">Languages: </td><td style="padding: 1px 1em 0; background: #F6F9ED;">
English
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/ar | • {{#if: MediaWiki|العربية| العربية}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/br | • {{#if: MediaWiki|Brezhoneg| Brezhoneg}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/ca | • {{#if: MediaWiki|Català| Català}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/cs | • {{#if: MediaWiki|Česky| Česky}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/de | • {{#if: MediaWiki|Deutsch| Deutsch}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/el | • {{#if: MediaWiki|Ελληνικά| Ελληνικά}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/es | • {{#if: MediaWiki|Español| Español}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/fa | • {{#if: MediaWiki|فارسی| فارسی}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/fi | • {{#if: MediaWiki|Suomi| Suomi}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/fr | • {{#if: MediaWiki|Français| Français}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/he | • {{#if: MediaWiki|עברית| עברית}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/hu | • {{#if: MediaWiki|Magyar| Magyar}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/id | • {{#if: MediaWiki|Bahasa Indonesia| Bahasa Indonesia}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/it | • {{#if: MediaWiki|Italiano| Italiano}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/ja | • {{#if: MediaWiki|日本語| 日本語}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/ko | • {{#if: MediaWiki|한국어| 한국어}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/mr | • {{#if: MediaWiki|मराठी| मराठी}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/nl | • {{#if: MediaWiki|Nederlands| Nederlands}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/no | • {{#if: MediaWiki|Norsk (bokmål)| Norsk (bokmål)}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/oc | • {{#if: MediaWiki|Occitan| Occitan}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/pl | • {{#if: MediaWiki|Polski| Polski}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/pt | • {{#if: MediaWiki|Português| Português}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/ro | • {{#if: MediaWiki|Română| Română}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/ru | • {{#if: MediaWiki|Русский| Русский}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/sq | • {{#if: MediaWiki|Shqip| Shqip}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/sr | • {{#if: MediaWiki|Српски / Srpski| Српски / Srpski}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/sv | • {{#if: MediaWiki|Svenska| Svenska}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/th | • {{#if: MediaWiki|ไทย| ไทย}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/vi | • {{#if: MediaWiki|Tiếng Việt| Tiếng Việt}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/yue | • {{#if: MediaWiki|粵語| 粵語}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/zh | • {{#if: MediaWiki|中文| 中文}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/zh-hans | • {{#if: MediaWiki|中文(简体)| 中文(简体)}}|}}
{{#ifexist: {{#if: MediaWiki | MediaWiki | {{#if: Help | Help:}}User rights}}/zh-hant | • {{#if: MediaWiki|中文(繁體)| 中文(繁體)}}|}}
</td></tr></table></div></onlyinclude>
Syntax
{{{Languages|PageName}}}
- PageName (optional) - the name of the page to display language links for. If omitted then the English version of the current page is used. This parameter can normally be omitted, as it is only required if you want to link to a page other than the one you place the template on, which is very uncommon. If this parameter is used on a sub-page make sure you supply the root name, not the full page name (e.g. on MediaWiki/fr you would need to use
{{{Languages|MediaWiki}}}and not{{{Languages|MediaWiki/fr}}}).
Usage
The template should only be placed on pages that exist in more than one language, and it should be placed in the same location on each translation of the page.
The English version of a page is always the main version, with all other languages as sub-pages, named using the appropriate language code (see below).
For example, on the Main Page you would include the text {{{Languages}}}, both on Main Page itself, and on each of its language sub-pages. The template automatically creates links to any language sub-pages that exist, e.g. Main Page/ja<tt>, <tt>Main Page/fr, and ignores non-existant languages.
See Project:Language policy for further details about translating pages.
Supported languages
This shows you the name of each language's sub-page (using Main Page as an example). Other languages may be added easily as necessary. Please use the appropriate prefix, as used on Wikipedia when adding a new language. Please do not add languages for which no pages exist yet, as this will increase the time needed to include the template without adding any benefit (languages are only displayed to the user when the relevant page exists).
The link on the language names goes to the Wikipedia in that language. If no Wikipedia in your language exists, do not add pages in that language to MediaWiki.org! This wiki is not the place for language advocacy - please go through the correct channels, and once your language has a Wikipedia then please return to add content here.
| Page Name | Language |
|---|---|
| Main Page | English |
| Main Page/ar | Arabic |
| Main Page/br | Breton |
| Main Page/ca | Catalan |
| Main Page/cs | Czech |
| Main Page/de | German |
| Main Page/el | Greek |
| Main Page/es | Spanish |
| Main Page/fa | Persian |
| Main Page/fi | Finnish |
| Main Page/fr | French |
| Main Page/he | Hebrew |
| Main Page/hu | Hungarian |
| Main Page/id | Indonesian |
| Main Page/it | Italian |
| Main Page/ja | Japanese |
| Main Page/ko | Korean |
| Main Page/mr | Marathi |
| Main Page/nl | Nederlands |
| Main Page/no | Norwegian |
| Main Page/oc | Occitan |
| Main Page/pl | Polish |
| Main Page/pt | Portugese |
| Main Page/ro | Romanian |
| Main Page/ru | Russian |
| Main Page/sq | Albanian |
| Main Page/sr | Serbian |
| Main Page/sv | Swedish |
| Main Page/th | Thai |
| Main Page/vi | Vietnamese |
| Main Page/yue | Cantonese |
| Main Page/zh | Chinese |
| Main Page/zh-hans | Chinese (Simplified) |
| Main Page/zh-hant | Chinese (Traditional) |
Example
Here is how the language bar looks on the MediaWiki page: Languages
