Template:User/sandbox
 | This is the template sandbox page for Template:User (diff). |
|
This template uses TemplateStyles: |
Inserts links to an OpenStreetMap.org user's profile, traces, edits (after the user page on this wiki if that OSM user has one here).
Usage
- {{User|Preferred displayed name|wiki= [Wiki user name] |osm= [OSM user name] |noedits= [1] |ohm= [OpenHistoricalMap user name] }}
The first parameter is mandatory. It is usually an OSM registered user name (used for edits, notes, etc.). It may also be used as the user name on the OSM wiki.
Note that this template assumes the user name is the same for both OSM.org and the OSM wiki:
- If a OSM user does not have an account on this wiki, you can specify
wiki=explicitly (and no link will be generated to a user page on this wiki). - If a OSM user uses an account named differently on this wiki, you can specify
wiki=Wiki user nameexplicitly to generate a link to his correct user page on this wiki). - Otherwise the OSM user name given in the first parameter will be used to generate a link to his identically named user page on this wiki.
You may also set the first parameter for specifying the username used on this wiki, and specify the alternate user name of OSM in the "osm=" parameter:
- If the
osm=parameter is set to an empty value, there will be no links to any OSM account and its edit histories. The first parameter is only used for the wiki user name.
There are various reasons why the account names don't match between this wiki, and the OSM website/database, notably because user names don't have exactly the same requirements, and because the first letter of a user name is not case-sensiteon this wiki, but is case sensive on the OSM website and database. Some characters are also accepted in user names on one site but not another (this wiki does not allow "/" and does not differentiate a space with underscores, but still allows "%" and "+" in user names). Another reason is that OSM edits may require you use a separate account for mechanical edits, when this wiki may have only one user page for both OSM accounts. Also there are contributors on this wiki that do not contribute on OSM directly: the two projects are in fact separate, allowing distinct identities.
In all cases the first mandatory parameter will be the preferred name actually displayed, independantly of the account names used to logon or find users:
- on the wiki (changed by parameter
wiki=), or - on the OSM database for submitting data or notes (changed by parameter
osm=),
and both effective account names take their default value from this first parameter.
- Important:
- Don't attempt to URL-encode any user names (notably those containing spaces or non-ASCII characters), just use the normal, readable user names, with standard spaces and standard UTF-8 encoding (as used for normal text on this wiki): the effective encoding depends on the kind of targets for URLs or wikilinks, and where the user names are used in URLs (in the "/resource/path" or in a "?query" string, or in an "#anchor").
- Unlike wiki account names, OSM account names are fully case-sensitive, and make a distinction between space, underscore, plus, or %20.
- This template will determine the appropriate encoding for each generated URL on rendered links, depending on what each target site expects.
Optional parameters
wiki=with an empty value will remove the link for users without account on this wiki, keeping only the link to user's page on OSM. If set to a non-empty value, it sets the actual title of the user's page in this wiki.osm=with an empty value will remove the link for users without account on OSM, keeping only the link to user's page on this wiki. If set to a non-empty value, it sets the actual title of the user's page on OSM.noedits=1will still show links to user's page on this wiki (unless it is removed bywiki=set to an empty value) and on OSM (unless it is removed byosm=set to an empty value), but will will remove links to their edits and history on OSM (ifosm=is not set to an empty value).ohm=adds a link to the user's page on OpenHistoricalMap, using the value of the parameter as the user name.- (Deprecated)
f=1changes the default icon (which may be interpreted as a male user) to a more appropriate icon for a female user. Note in absence of this parameter, and if the user has an account on this wiki, the appropriate gender may be determined automatically from the local user's preferences on this wiki (but many users don't define it and this setting remains "neutral"). Normally this parameter is not needed if the user has an account on this wiki (i.e. the parameterwiki=is not set to an empty value), where their gender is set in their preference. - (Deprecated)
m=1changes the default icon to a more appropriate icon for a male user. This is especially useful for users without any account on this wiki (wiki=set to an empty value), whose default icon displayed is gender-neutral. Normally this parameter is not needed if the user has an account on this wiki (i.e. the parameterwiki=is not set to an empty value), where their gender is set in their preference. This parameter should not be used simultaneously withf=1(which will silently take precedence, i.e. will render a icon for a female user).
Examples
| You type | You get |
|---|---|
| 1. Examples for users with an account on wiki and on OSM (with additional external tools): | |
{{User|Harry Wood}} |
|
{{User|phobie}} |
|
| Some users have distinct account names on wiki and on OSM, you can select the prefered one to show first: | |
{{User|Sean de Basti|osm=Seandebasti}} |
|
{{User|Seandebasti|wiki=Sean de Basti}} |
|
| 2. Examples for users with an account on OSM only (with additional external tools): | |
{{User|Seandebasti|wiki=}} |
|
{{User|Harry Wood|wiki=}} |
|
{{User|phobie|wiki=}} |
|
| 3. Examples for users with an account on wiki and on OSM (reduced version): | |
{{User|Sean de Basti|osm=Seandebasti|noedits=1}} |
|
{{User|Seandebasti|wiki=Sean de Basti|noedits=1}} |
|
{{User|Sean de Basti|noedits=1}} |
|
{{User|Harry Wood|noedits=1}} |
|
{{User|phobie|noedits=1}} |
|
| 4. Examples for users with an account on OSM only (reduced version): | |
{{User|Sean de Basti|osm=Seandebasti|wiki=|noedits=1}} |
|
{{User|Seandebasti|wiki=|noedits=1}} |
|
{{User|Harry Wood|wiki=|noedits=1}} |
|
{{User|phobie|wiki=|noedits=1}} |
|
| 5. Examples for users with an account on wiki only (no external tools): | |
{{User|Sean de Basti|osm=}} |
|
{{User|Harry Wood|osm=}} |
|
| Lettercase does not matter for the initial on wiki, choose which one you prefer to display | |
{{User|phobie|osm=}} |
|
{{User|Phobie|osm=}} |
|
| You can still override the prefered name to display: | |
{{User|(Mrs) Phobie|wiki=Phobie|osm=}} |
|
Localization
This template's link labels are localizable. To localize this template, submit translations for the following messages to Wiki:Requests for administrator attention or post them to Template talk:User/sandbox with {{Edit request}}:
- MediaWiki:Osm-wiki-user-osm-link
- MediaWiki:Osm-wiki-user-edits-link
- MediaWiki:Osm-wiki-user-heatmap-link
- MediaWiki:Osm-wiki-user-comments-link
- MediaWiki:Osm-wiki-user-ohm-link
See also
- {{OSM user}} - a simple link to the user's page on OSM (not the OSM wiki), without traces and edits.
- {{U}} - a plain link to a wiki user's page.
Inserts links to an OpenStreetMap.org user's profile, traces, edits (after the user page on this wiki if that OSM user has one here).
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Preferred display name | 1 | Usually an OSM registered user name (used for edits, notes, etc.) but may also be used as the user name on the OSM wiki.
| Line | required |
| Wiki user name | wiki | An empty value will remove the link for users without account on this wiki, keeping only the link to user's page on OSM. A non-empty value sets the actual title of the user's page in this wiki. | User | optional |
| OpenStreetMap user name | osm | An empty value will remove the link for users without account on OSM, keeping only the link to user's page on this wiki. A non-empty value sets the actual title of the user's page on OSM. | Line | optional |
| OpenHistoricalMap user name | ohm | A non-empty value adds a link to the user's page on OpenHistoricalMap, using the value as the user name. | Line | optional |
| Male (gender icon control) | m | Changes the default icon to a more appropriate icon for a male user. Especially useful for users without any account on this wiki. 1 = male; b = bot; n = no icon.
| String | deprecated |
| Female | f | Changes the default icon (which may be interpreted as a male user) to a more appropriate icon for a female user. In the absence of this parameter, and if the user has an account on this wiki, the appropriate gender may be determined automatically from the local user's preferences on this wiki (but many users don't define it and this setting remains "neutral"). Normally this parameter is not needed if the user has an account on this wiki (i.e. the parameter wiki= is not set to an empty value), where their gender is set in their preference. | Boolean | deprecated |
| Hide OSM edit links | noedits | Disabling this option still links to user's page on this wiki (unless it is removed by wiki= set to an empty value) and on OSM (unless it is removed by osm= set to an empty value), but will remove links to their edits and history on OSM (if osm= is not set to an empty value). | Boolean | optional |