View source for Template:WBF/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{cs1 wrapper|base=Cite web}}
{{Lua|Module:Citation/CS1|Module:EditAtWikidata|Module:WikidataCheck}}
{{Uses Wikidata|P3172}}
{{Tracks Wikidata|P3172}}
__TOC__
{{clear}}

'''{{NAMESPACE}}:{{BASEPAGENAME}}''' displays an external link to a [[contract bridge]] player's international record at the website of the [[World Bridge Federation]] (WBF), which is the international [[sport governing body|governing body]] for contract bridge. The template is usually placed in the "[[Wikipedia:External links|External links]]" or "[[Wikipedia:References|References]]" section of the player's Wikipedia article. 

== Usage ==
; Unnamed parameters
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|<var>ID</var><nowiki>}}</nowiki></code>
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|<var>ID</var>|<var>NAME</var><nowiki>}}</nowiki></code>
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|<var>ID</var>|<var>NAME</var>|<var>ACCESS DATE</var><nowiki>}}</nowiki></code>

; Named parameters
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|id=<var>ID</var><nowiki>}}</nowiki></code>
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|id=<var>ID</var>|name=<var>NAME</var><nowiki>}}</nowiki></code>
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|id=<var>ID</var>|name=<var>NAME</var>|access-date=<var>ACCESS DATE</var><nowiki>}}</nowiki></code>

; Using Wikidata property
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>}}</nowiki></code>
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|name=<var>NAME</var><nowiki>}}</nowiki></code>
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|name=<var>NAME</var>|access-date=<var>ACCESS DATE</var><nowiki>}}</nowiki></code>

== Parameters ==
# {{para|id}}
#: The "id" parameter (or unnamed parameter "1") should contain the ID portion of the URL. Example: 1122 is the ID portion of http://<nowiki/>www.worldbridge.org/people/person.asp?qryid=1122 ([https://web.archive.org/web/20160430192222/http://www.worldbridge.org/people/person.asp?qryid=1122 archived]) or http://db.worldbridge.org/Repository/peopleforscrap/person.asp?qryid=1122. This parameter is optional if [[Wikidata]] property [[d:Property:P3172|P3172]] exists, but required if not. If not provided, the template will attempt to fetch it from Wikidata.
# {{para|name}}
#: The "name" parameter (or unnamed parameter "2") may be used to specify the [[link text]], which should be the name of the athlete. This parameter is optional when the template is used in the player's Wikipedia article; it defaults to the article name, without any disambiguation such as "(bridge)". It should be provided if the template is used other articles.
# {{para|access-date}}
#: The "access-date" parameter (or unnamed parameter "3") is for use in references.

=== How to find the "id" ===
One of the following methods may be used to find a player's WBF page and determine the ''id'' number:
# Go to the [http://www.worldbridge.org/people-finder/ WBF People Finder] and search for the player's [[surname]]. If the surname is unknown, try different parts of the known name separately.
# Use a [[web search engine]] such as [[Google (search engine)|Google]] or [[Bing (search engine)|Bing]] (examples for [[Riki Markus]]):
#: Google search: <code>[https://www.google.com/search?q=Rixi+Markus+site:worldbridge.org Rixi Markus site:worldbridge.org]</code>
#: Bing search: <code>[https://www.bing.com/search?q=Rixi+Markus+site:worldbridge.org Rixi Markus site:worldbridge.org]</code>

The ''id'' number for the person can be seen at the end of the URL, such as 1122:
: <code>http://<nowiki/>www.worldbridge.org/people/person.asp?qryid={{hilite|1122}}</code> ([https://web.archive.org/web/20160430192222/http://www.worldbridge.org/people/person.asp?qryid=1122 archived])
: <code>[http://db.worldbridge.org/Repository/peopleforscrap/person.asp?qryid=1122 http://db.worldbridge.org/Repository/peopleforscrap/person.asp?qryid={{hilite|1122}}]</code>

== Examples ==

=== External link ===
When only the first unnamed parameter (or "id") is used, the [[link text]] includes the article name.

:<code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | 1122 }}</code>
:* {{{{BASEPAGENAME}} | 1122 }}

:<code><nowiki>* {{</nowiki>{{BASEPAGENAME}} |id= 553 }}</code>
:* {{{{BASEPAGENAME}} |id= 553 }}

When the article name is different than the player's name, the second unnamed parameter (or "name") should be included.

:<code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | 1122 | Rixi Markus }}</code>
:* {{{{BASEPAGENAME}} | 1122 | Rixi Markus }}

:<code><nowiki>* {{</nowiki>{{BASEPAGENAME}} |id= 553 |name= Omar Sharif }}</code>
:* {{{{BASEPAGENAME}} |id= 553 |name= Omar Sharif }}

=== Citation ===
When the template is being used as a citation, the third unnamed parameter (or "accessdate" or "access-date") should be included.

:<code><nowiki>{{</nowiki>{{BASEPAGENAME}} | 1122 | Rixi Markus | September 14, 2012 }}</code>
: {{{{BASEPAGENAME}} | 1122 | Rixi Markus | September 14, 2012 }}

:<code><nowiki>{{</nowiki>{{BASEPAGENAME}} |id= 553 |name= Omar Sharif |accessdate= 29 December 2016 }}</code>
: {{{{BASEPAGENAME}} |id= 553 |name= Omar Sharif |accessdate= 29 December 2016 }}

: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} |id= 553 |name= Omar Sharif |access-date= 2016-12-29 }}</code>
: {{{{BASEPAGENAME}} |id= 553 |name= Omar Sharif |access-date= 2016-12-29 }}

=== No parameters ===
When no parameters are included, the template will use the player's ID from Wikidata or display an error message.

: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>}}</nowiki></code>
: {{ {{BASEPAGENAME}} }}

== Tracking categories ==
; "id" parameter exists
* {{clc|World Bridge Federation ID not in Wikidata}}
* {{clc|World Bridge Federation ID different from Wikidata}}
; "id" parameter does not exist
* {{clc|WBF template missing ID}}

== See also ==
* {{tl|WBF Master Points}}

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Contract bridge templates]]
[[Category:People and person external link templates]]
[[Category:Sports governing body external link templates]]
[[Category:External link templates with accessdate parameter]]
[[Category:External link templates using Wikidata]]
[[Category:Templates that add a tracking category]]
[[Category:Templates that wrap Cite web]]
}}</includeonly>