Difference between revisions of "Template:If pagename/doc"

Latest revision as of 14:36, 23 January 2013

This template is used on 2,100,000+ pages. To avoid large-scale disruption and unnecessary server load, any changes to this template should first be tested in the template's /sandbox or /testcases subpages, or in your own user space. The tested changes can then be added in one single edit to the template. Please consider discussing any changes on the talk page before implementing them.

This is the {{if pagename}} meta-template.

It helps other templates detect what page they are on. It uses pattern matching on the pagename.

See also the extended version: {{if pagename multi}}. That one can reuse the same input on multiple matching patterns.

Usage

This template takes one or more parameters. Most of the parameters don't have fixed names, instead they are part of the pattern matching. Like this:

{{if pagename
| /doc = Doc page text
| other = Other pages text
}}

If the template is on "Template:Example/doc" the code above will return this:

Doc page text

If the template is on any other page than a /doc page it will return this:

Other pages text

Here is a description of the full pattern matching:

{{if pagename
<!-- Match on full pagename -->
| User:Example/test = Text for "User:Example/test".
| User:Example = Text for "User:Example".
| User talk:Example = Text for "User talk:Example".

<!-- Match on full basepage name, when on a basepage or its subpages -->
| User:Example/+ = Matches "User:Example" and "User:Example/test".

<!-- Match on pagename, when on a basepage -->
| Example = Matches "User:Example", "User talk:Example", "Template:Example" 
            and so on, but not "User:Example/something".

<!-- Match on full basepage name, when on a subpage -->
| User:Example/* = Matches "User:Example/something", but not "User:Example".
| User talk:Example/* = Matches "User talk:Example/something".

<!-- Match on basepage name, when on a subpage -->
| Example/* = Matches "User:Example/something" and "User talk:Example/something".

<!-- Match on subpage name -->
| /something = Any pagename that ends in "/something".
| /doc = Any pagename that ends in "/doc".

<!-- Match on partial subpage name (case-insensitive) -->
| /some* = Any subpage name beginning with "/some" or "/Some".
| /arch* = Matches "User talk:Example/Archive 1".

<!-- Default fallbacks -->
| basepage = Text for any basepage.
| subpage = Text for any subpage.
| other = Text for any page.
}}

The matching goes from top to bottom, and returns the first parameter that matches. "Top to bottom" means the order shown above, not the order you happen to feed the parameters.

There's no limit to the number of parameters that you can use, other than what the servers and MediaWiki system can handle.

Most of the matching is case-sensitive. For instance "/test" matches "User:Example/test" but not "User:Example/Test".

Matching on partial subpage names such as "/some*" has some limitations, see its own section below.

If an empty (but defined) parameter matches, the matching stops and the template returns an empty string. That's on purpose and can be used like this:

{{if pagename
| /doc =
| /sandbox = Sandbox text
| other = Other pages text
}}

The code above will render nothing when on a /doc page. But when on a /sandbox page it will return this:

Sandbox text

And when on any other page it will return this:

Other pages text

Partial subpage names

This template can also match on partial subpage names. Like this:

{{if pagename
| /archiv* = Archive page text
| other = Other pages text
}}

If on "User:Example/Archive 1" the code above will return this:

Archive page text

The parameter name "/some*" must be lower case. But it matches subpage names in both upper and lower case such as "User:Example/SomeThing" and "User:Example/something".

The partial matching only supports matching on 4, 6 and 8 characters. Thus using "/some*", "/someth*" and "/somethin*" works, but using "/som*" or "/somet*" doesn't work.

Longer patterns match first, thus if both "/somethin*" and "/some*" are defined, and the current page is "User:Example/Something", then the data from "/somethin*" will be used.

The "page" parameter

For testing and demonstration purposes this template can take a parameter named page. Like this:

{{if pagename
| /test = Test pages text
| other = Other pages text
| page = Template:Example/test
}}

No matter on what kind of page the code above is used it will return this:

Test pages text

The page parameter makes this template behave exactly as if on that page. The pagename doesn't have to be an existing page.

If the page parameter is empty or undefined, the name of the current page determines the result.

You can make it so your template also understands the page parameter. That means you can demonstrate the different appearances of your template in the documentation for your template. Then do like this:

{{if pagename
| /test = Test pages text
| other = Other pages text
| page = {{{page|}}}
}}

Namespace matching

This template doesn't have namespace matching. If you need that then combine this template with one of the namespace-detection templates such as {{template other}}. Like this:

{{template other
| {{if pagename
  | /doc = Template doc page text.
  }}
| <!-- Other space, do nothing -->
}}

If on "User:Example/doc" the code above will return nothing. But if on "Template:Example/doc" it will return this:

Template doc page text.

Technical details

This template detects subpages even when used in namespaces that doesn't have the MediaWiki subpage feature enabled. Thus this template works the same in all namespaces.

For more technical details see the talk page.

See also

Pagename-handling and detection templates:

• {{basepage subpage}} – For detecting if on a basepage, subpage or subsubpage.
• {{pgn}} – Can take apart and put together pagenames in several ways.
• {{if pagename}} – For pattern matching on the pagename.
• {{if pagename multi}} – For pattern matching on the pagename, has input reuse.
• {{IP-user other}} – For detecting IP-user pages.
• {{IP-talk}} - Return: 1) IP user talk page 2) registered user talk page 3) not user talk page.

Easy to use namespace-detection templates:

• {{main other}} – For article templates.
• {{talk other}} – For talk page templates.
• {{user other}} – For user page templates.
• {{wikipedia other}} – For detecting "Wikipedia:" pages.
• {{file other}} – For file (image) templates.
• {{template other}} – For detecting template pages.
• {{help other}} – For help page templates.
• {{category other}} – For category templates.
• {{portal other}} – For portal templates.
• {{book other}} – For detecting book pages.

More complex namespace-detection templates:

• {{namespace detect}} – The very versatile one.
• {{namespace detect showall}} – The extremely versatile one, has input reuse.
• {{talkspace detect}} - For detecting talk pages on various namespaces.
• {{main talk other}} – Separates some namespaces.
• {{main talk category other}} – Separates some namespaces.

Technical stuff:

• Namespace – Lists all the namespaces.
• Help:Magic words – About {{NAMESPACE}} etc.
• Help:Extension:ParserFunctions – About {{#ifeq:|||}} etc.