Difference between revisions of "Template:Facebook/doc"
imported>Zyxw (note module used, add intro text and usage section, update examples and TemplateData) |
imported>Zyxw (add URLs to examples, add category, misc formatting) |
||
| Line 4: | Line 4: | ||
{{Uses Wikidata|P2013}} | {{Uses Wikidata|P2013}} | ||
{{Lua|Module:EditAtWikidata}} | {{Lua|Module:EditAtWikidata}} | ||
| − | {{See also|Wikipedia:External links/Perennial websites}} | + | {{See also|Template:Facebook Page|Wikipedia:External links/Perennial websites}} |
'''{{NAMESPACE}}:{{BASEPAGENAME}}''' displays an external link to a page at [[Facebook]], a [[social networking]] website. It is intended for use in the [[Wikipedia:External links|external links]] section of an article. | '''{{NAMESPACE}}:{{BASEPAGENAME}}''' displays an external link to a page at [[Facebook]], a [[social networking]] website. It is intended for use in the [[Wikipedia:External links|external links]] section of an article. | ||
| Line 12: | Line 12: | ||
==Usage== | ==Usage== | ||
; Unnamed parameters | ; Unnamed parameters | ||
| − | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | '' | + | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | ''user name or number'' }}</code> |
| − | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | '' | + | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | ''user name or number'' | ''Displayed Name'' }}</code> |
; Named parameters | ; Named parameters | ||
| − | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | id= '' | + | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | id= ''user name or number'' }}</code> |
| − | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | id= '' | + | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | id= ''user name or number'' | name= ''Displayed Name'' }}</code> |
| − | ; Using [[Wikidata]] property {{ | + | ; Using [[Wikidata]] property ''{{Property|P2013}}'' |
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>}}</nowiki></code> | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>}}</nowiki></code> | ||
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | name= ''Displayed Name'' }}</code> | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | name= ''Displayed Name'' }}</code> | ||
| Line 26: | Line 26: | ||
=== Linking to a profile or page === | === Linking to a profile or page === | ||
| − | In this example, the Facebook user | + | In this example, the Facebook user name is ''zuck'' and the [[link text]] is ''Mark Zuckerberg'': |
| − | : <code><nowiki>{{Facebook|zuck|Mark Zuckerberg}}</nowiki></code> | + | : <samp>https://<nowiki/>www.facebook.com/{{Hilite|zuck}}</samp> |
| − | : {{{{BASEPAGENAME}}|zuck|Mark Zuckerberg}} | + | : <code><nowiki>* {{Facebook | zuck | Mark Zuckerberg }}</nowiki></code> |
| + | :* {{{{BASEPAGENAME}} | zuck | Mark Zuckerberg }} | ||
| − | In this example, there | + | In this example, there is a Facebook user number instead of a user name: |
| − | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}} |id=4 |name=Mark Zuckerberg}}</code> | + | : <samp>https://<nowiki/>www.facebook.com/{{Hilite|4}}</samp> |
| − | : {{{{BASEPAGENAME}}|id=4|name=Mark Zuckerberg}} | + | : <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} |id= 4 |name= Mark Zuckerberg }}</code> |
| + | :* {{{{BASEPAGENAME}} |id= 4 |name= Mark Zuckerberg }} | ||
On the article about an individual, the display name and the article title will usually be identical and can be omitted. For example, on the article page [[Facebook]], linking to their own Facebook profile could be done with: | On the article about an individual, the display name and the article title will usually be identical and can be omitted. For example, on the article page [[Facebook]], linking to their own Facebook profile could be done with: | ||
| − | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|facebook}}</code> | + | : <samp>https://<nowiki/>www.facebook.com/{{Hilite|facebook}}</samp> |
| − | : {{{{BASEPAGENAME}}|facebook}} | + | : <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | facebook }}</code> |
| + | :* {{{{BASEPAGENAME}} | facebook }} | ||
=== Linking to a specific section === | === Linking to a specific section === | ||
Links to specific sections on a Facebook page used to include the '=' symbol in the URL but no longer need to. Because '=' is a special character in Wikipedia template syntax (which separates a parameter's name from its value), it cannot be used directly in the id. If you want the link to arrive at a specific section, use the newer URL syntax, for example to link directly to the Photos section of a profile, add <code>/photos</code> to the username: | Links to specific sections on a Facebook page used to include the '=' symbol in the URL but no longer need to. Because '=' is a special character in Wikipedia template syntax (which separates a parameter's name from its value), it cannot be used directly in the id. If you want the link to arrive at a specific section, use the newer URL syntax, for example to link directly to the Photos section of a profile, add <code>/photos</code> to the username: | ||
| − | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|zuck/photos|name=Mark Zuckerberg}}</code> | + | : <samp>https://<nowiki/>www.facebook.com/{{Hilite|zuck/photos}}</samp> |
| − | : {{{{BASEPAGENAME}}|zuck/photos|name=Mark Zuckerberg}} | + | : <code><nowiki>* {{</nowiki>{{BASEPAGENAME}}|zuck/photos|name=Mark Zuckerberg}}</code> |
| + | :* {{{{BASEPAGENAME}}|zuck/photos|name=Mark Zuckerberg}} | ||
=== Using Wikidata === | === Using Wikidata === | ||
| − | Generally, [[Wikidata]] should contain article subjects' Facebook IDs in property {{ | + | Generally, [[Wikidata]] should contain article subjects' Facebook IDs in property {{Property|P2013}}, allowing the ID parameter to be omitted: |
| − | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>}}</nowiki></code> | + | : <code><nowiki>* {{</nowiki>{{BASEPAGENAME}}<nowiki>}}</nowiki></code> |
| − | : <code><nowiki>{{</nowiki>{{BASEPAGENAME}} |name=''NAME'' }}</code> | + | : <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} |name=''NAME'' }}</code> |
If the Wikidata property is not defined, the output is: | If the Wikidata property is not defined, the output is: | ||
| − | : {{ {{BASEPAGENAME}} }} | + | :* {{ {{BASEPAGENAME}} }} |
== TemplateData == | == TemplateData == | ||
| Line 85: | Line 89: | ||
== See also == | == See also == | ||
| − | * | + | * {{tl|Facebook Page}} which uses Wikidata property ''{{property|P4003}}'' |
* [[Wikipedia:FACEBOOK]] | * [[Wikipedia:FACEBOOK]] | ||
* {{tl|Facebook navbox}} | * {{tl|Facebook navbox}} | ||
| Line 92: | Line 96: | ||
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | | | <includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | | | ||
<!-- Categories below this line, please; interwikis at Wikidata --> | <!-- Categories below this line, please; interwikis at Wikidata --> | ||
| − | [[Category:Social media external link templates | + | [[Category:Social media external link templates]] |
| + | [[Category:External link templates using Wikidata]] | ||
[[Category:Templates that add a tracking category]] | [[Category:Templates that add a tracking category]] | ||
}}</includeonly> | }}</includeonly> | ||
Revision as of 18:30, 5 August 2018
| File:Edit-copy green.svg | This is a documentation subpage for Template:Facebook. It contains usage information, categories and other content that is not part of the original template page. |
| The external links guideline recommends avoiding links to Facebook unless the profile is an official account, "controlled by the subject (organization or individual person) of the Wikipedia article" and when the links to Facebook "provide the reader with unique content and are not prominently linked from other official websites". Wikipedia is not a directory for helping Facebook users find pages on Facebook. |
| 30px | This template uses Lua: |
Template:Facebook displays an external link to a page at Facebook, a social networking website. It is intended for use in the external links section of an article.
Contents
Usage
- Unnamed parameters
{{Facebook | user name or number }}{{Facebook | user name or number | Displayed Name }}
- Named parameters
{{Facebook | id= user name or number }}{{Facebook | id= user name or number | name= Displayed Name }}
- Using Wikidata property Template:Property
{{Facebook}}{{Facebook | name= Displayed Name }}
Examples
Linking to a profile or page
In this example, the Facebook user name is zuck and the link text is Mark Zuckerberg:
- https://www.facebook.com/zuck
* {{Facebook | zuck | Mark Zuckerberg }}- Mark Zuckerberg on FacebookScript error: No such module "EditAtWikidata".
In this example, there is a Facebook user number instead of a user name:
- https://www.facebook.com/4
* {{Facebook |id= 4 |name= Mark Zuckerberg }}- Mark Zuckerberg on FacebookScript error: No such module "EditAtWikidata".
On the article about an individual, the display name and the article title will usually be identical and can be omitted. For example, on the article page Facebook, linking to their own Facebook profile could be done with:
- https://www.facebook.com/facebook
* {{Facebook | facebook }}- Template:PAGENAMEBASE on FacebookScript error: No such module "EditAtWikidata".
Linking to a specific section
Links to specific sections on a Facebook page used to include the '=' symbol in the URL but no longer need to. Because '=' is a special character in Wikipedia template syntax (which separates a parameter's name from its value), it cannot be used directly in the id. If you want the link to arrive at a specific section, use the newer URL syntax, for example to link directly to the Photos section of a profile, add /photos to the username:
- https://www.facebook.com/zuck/photos
* {{Facebook|zuck/photos|name=Mark Zuckerberg}}- Mark Zuckerberg on FacebookScript error: No such module "EditAtWikidata".
Using Wikidata
Generally, Wikidata should contain article subjects' Facebook IDs in property Template:Property, allowing the ID parameter to be omitted:
* {{Facebook}}* {{Facebook |name=NAME }}
If the Wikidata property is not defined, the output is:
- Template:PAGENAMEBASE on FacebookScript error: No such module "EditAtWikidata".
TemplateData
TemplateData for Facebook
Generate a link to a Facebook profile in a standard format.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Account ID | id 1 | ID of the Facebook account (part of the web page address, for www.facebook.com/example/ the account id is "example"). This parameter is optional if Wikidata property P2013 exists, but required if not.
| Line | optional |
| Display name | name 2 | Display name for the Facebook account
| Line | optional |
Tracking category
See also
- {{Facebook Page}} which uses Wikidata property Template:Property
- Wikipedia:FACEBOOK
- {{Facebook navbox}}
- {{Google+}}