Template:MW file
MediaWiki file: {{{1}}} | |
---|---|
Location: | / |
Source code: | master • 1.44.0 • 1.43.3 • 1.39.13 |
Classes: | Find code • Find documentation |
To avoid large-scale disruption and unnecessary server load, any changes to this template should first be tested in its /sandbox or /testcases subpages or in your own user subpage. The tested changes can then be added to this page in one single edit.
Please consider discussing any changes on the talk page before implementing them.Displays an informative box about a file in MediaWiki core, with links to its source code in master, stable, and legacy branches, and links to its classes and interfaces in the generated PHP documentation.
{{MW file|FILENAME|PATH |class1=CLASS |class2=CLASS |class3=CLASS |... |interface1=INTERFACE |interface2=INTERFACE |interface3=INTERFACE |NotInGit=REASON }}
- FILENAME is the name of the file, including extension.
- If the file has been recently renamed, you can use the
stable=
and thelegacy=
parameters to provide the old name so links work; you'll need to update the template invocation as the release in which the file was renamed moves from master->stable->legacy.
- If the file has been recently renamed, you can use the
- PATH is the path to the file; do not include a leading slash, include the trailing slash. Leave it blank for files in the root directory.
- The
class
arguments are all optional, and if supplied will link to the generated documentation. CLASS should be the class name, as used in the URL. E.g. "Parser" would generate a link to "classParser.html". The template allows up to six class parameters,class1
-class6
- INTERFACE is similar. The template allows up to three interface parameters
- The
NotInGit
argument is optional and should only be used if the file is not in Git for some reason (I think this only applies toLocalSettings.php
). REASON is the reason that is displayed in the infobox. Note thatNotInGit
is case sensitive!
The Manual uses this template extensively.
Examples
{{MW file|index.php|}}
MediaWiki file: index.php | |
---|---|
Location: | |
Source code: | master • 1.44.0 • 1.43.3 • 1.39.13 |
Classes: | Find code • Find documentation |
{{MW file|Article.php|includes/page/ |class1=Article }}
MediaWiki file: Article.php | |
---|---|
Location: | includes/page/ |
Source code: | master • 1.44.0 • 1.43.3 • 1.39.13 |
Classes: | Article |
{{MW file|WikiPage.php|includes/page/ |class1=WikiPage |interface1=Page }}
MediaWiki file: WikiPage.php | |
---|---|
Location: | includes/page/ |
Source code: | master • 1.44.0 • 1.43.3 • 1.39.13 |
Classes: | WikiPage • Page |
{{MW file|LocalSettings.php| |NotInGit=created during installation }}
MediaWiki file: LocalSettings.php | |
---|---|
Location: | |
Source code: | not in Git (created during installation) |
Classes: |
See also
- {{Git file }} — a simple link to a file on gerrit (from mediawiki/core or otherwise)
- Category:MediaWiki code pages without class names — incompletely filled pages are automatically listed by this template
Displays an informative box about a file in MediaWiki core, with links to its source code in master, stable, and legacy branches, and links to its classes and interfaces in the generated PHP documentation.
Parameter | Description | Type | Status | |
---|---|---|---|---|
File name | 1 | Name of the file, including extension. If the file has been recently renamed, you can use the stable= and the legacy= parameters to provide the old name so links work; you'll need to update the template invocation as the release in which the file was renamed moves from master → stable → legacy.
| String | required |
File path | 2 | Path to the file; do not include a leading slash, include the trailing slash. Leave it blank for files in the root directory.
| String | required |
Not in Git? | NotInGit | Whether the version is in Git version control (only rarely used for files like LocalSettings.php and DevelopmentSettings.php). Optional and should only be used if the file is not in Git for some reason. Reason= is the reason that is displayed in the infobox. Note that NotInGit is CASE-SENSITIVE.
| String | optional |
Stable MediaWiki version | stable | no description | Unknown | optional |
Legacy MediaWiki version | legacy | no description | Unknown | optional |
LTS MediaWiki Version | lts | Long-Term Support version for MediaWiki | Unknown | optional |
Class 1 | class1 | Class arguments are all optional, and if supplied will link to the generated documentation. Class should be the class name, as used in the URL. The template allows up to six class parameters
| String | suggested |
Class 2 | class2 | no description | Unknown | optional |
Class 3 | class3 | no description | Unknown | optional |
Class 4 | class4 | no description | Unknown | optional |
Class 5 | class5 | no description | Unknown | optional |
Class 6 | class6 | no description | Unknown | optional |
Interface 1 | interface1 | Similar to Class. The template allows up to three interface parameters. | Unknown | suggested |
Interface 2 | interface2 | no description | Unknown | optional |
Interface 3 | interface3 | no description | Unknown | optional |
Example | example | no description | Unknown | optional |
nodisplaytitle | nodisplaytitle | no description | Unknown | optional |
Maintenance: noslash
Subpages of this template.