Difference between revisions of "Template:Facebook/doc"

From blackwiki
Jump to navigation Jump to search
(→‎Examples: update/fix)
imported>OwenBlacker
(Updated documentation)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
 +
{{Uses Wikidata|P2013}}
 +
 
<!-- Place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
 
<!-- Place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
 
{{warning|The [[Wikipedia:External links|external links guideline]] recommends [[WP:ELNO|avoiding links to Facebook]] unless the profile is an [[WP:ELOFFICIAL|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.}}
 
{{warning|The [[Wikipedia:External links|external links guideline]] recommends [[WP:ELNO|avoiding links to Facebook]] unless the profile is an [[WP:ELOFFICIAL|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.}}
Line 5: Line 7:
 
==Usage==
 
==Usage==
 
{{See also|Wikipedia:External links/Perennial websites}}
 
{{See also|Wikipedia:External links/Perennial websites}}
 +
 +
== Linking to a profile or Page ==
 +
In this example, the Facebook user account is ''zuck'' and the description in the link is ''Mark Zuckerberg'':
 +
 +
: <code><nowiki>{{Facebook|zuck|Mark Zuckerberg}}</nowiki></code>
 +
: {{Facebook|zuck|Mark Zuckerberg}}
 +
 +
In this example, there's an ID instead of user name:
 +
 +
: <code><nowiki>{{Facebook |id=4 |name=Mark Zuckerberg}}</nowiki></code>
 +
: {{Facebook|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:
 +
 +
: <code><nowiki>{{Facebook|facebook}}</nowiki></code>
 +
: {{Facebook|facebook}}
 +
 +
Generally, [[Wikidata]] should contain article subjects' Facebook IDs in property [[d:Property:P2013|P2013]], allowing the ID parameter to be omitted:
 +
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>}}</nowiki></code>
 +
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} |name=''NAME'' }}</code>
 +
 +
=== 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:
 +
 +
: <code><nowiki>{{Facebook|zuck/photos|name=Mark Zuckerberg}}</nowiki></code>
 +
: {{Facebook|zuck/photos|name=Mark Zuckerberg}}
 +
 +
==See also==
 +
* [[Template:Facebook Page]]
 +
* [[Wikipedia:FACEBOOK]]
 +
* {{tl|Facebook navbox}}
 +
* {{tl|Google+}}
  
 
== TemplateData ==
 
== TemplateData ==
Line 16: Line 50:
 
             "description": "ID of the Facebook account (part of the web page address, for www.facebook.com/example/ the account id is \"example\").",
 
             "description": "ID of the Facebook account (part of the web page address, for www.facebook.com/example/ the account id is \"example\").",
 
             "type": "string/line",
 
             "type": "string/line",
             "required": true,
+
             "required": false,
 +
            "default": "Wikidata property P2013",
 
             "aliases": ["1"]
 
             "aliases": ["1"]
 
         },
 
         },
Line 30: Line 65:
 
}
 
}
 
</templatedata>
 
</templatedata>
 
== Examples ==
 
In this example, the Facebook user account is ''markzuckerberg'' and the description in the link is ''Mark Zuckerberg'':
 
  <nowiki>{{Facebook|markzuckerberg|Mark Zuckerberg}}</nowiki>
 
{{Facebook|markzuckerberg|Mark Zuckerberg}}
 
 
In this example, there's an ID instead of user name:
 
  <nowiki>{{Facebook|id=markzuckerberg/4|name=Mark Zuckerberg}}</nowiki>
 
{{Facebook|id=markzuckerberg/4|name=Mark Zuckerberg}}
 
 
===Links containing the {{=}} sign===
 
Links to specific sections on a Facebook page may include the '=' symbol in the URL. For example, the string '?v=wall' would indicate the "Wall" section. 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 [[Template:=]] instead. For example, to link to the "Notes" section:
 
 
  <nowiki>{{Facebook|id=markzuckerberg/4?v{{=}}notes|name=Mark Zuckerberg}}</nowiki>
 
{{Facebook|id=markzuckerberg/4?v{{=}}notes|name=Mark Zuckerberg}}
 
 
==See also==
 
* [[Template:Facebook Page]]
 
* [[Wikipedia:FACEBOOK]]
 
* {{tl|Facebook navbox}}
 
* {{tl|Google+}}
 
  
 
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |
 
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |

Revision as of 19:20, 17 September 2016

Template:Uses Wikidata

Usage

Linking to a profile or Page

In this example, the Facebook user account is zuck and the description in the link is Mark Zuckerberg:

{{Facebook|zuck|Mark Zuckerberg}}
Mark Zuckerberg on FacebookScript error: No such module "EditAtWikidata".

In this example, there's an ID instead of user name:

{{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:

{{Facebook|facebook}}
Template:PAGENAMEBASE on FacebookScript error: No such module "EditAtWikidata".

Generally, Wikidata should contain article subjects' Facebook IDs in property P2013, allowing the ID parameter to be omitted:

{{Facebook}}
{{Facebook |name=NAME }}

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:

{{Facebook|zuck/photos|name=Mark Zuckerberg}}
Mark Zuckerberg on FacebookScript error: No such module "EditAtWikidata".

See also

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for Facebook

Generate a link to a Facebook profile in a standard format.

Template parameters

ParameterDescriptionTypeStatus
Account IDid 1

ID of the Facebook account (part of the web page address, for www.facebook.com/example/ the account id is "example").

Default
Wikidata property P2013
Lineoptional
Display namename 2

Display name for the Facebook account

Default
Name of the page
Lineoptional