Difference between revisions of "Template:Facebook/doc"

From blackwiki
Jump to navigation Jump to search
imported>Prince Oyelami Babatunde
imported>Zyxw
m (→‎Tracking category: update link)
 
(20 intermediate revisions by 12 users not shown)
Line 1: Line 1:
 +
{{Documentation subpage}}
 +
<!-- Place categories where indicated at the bottom of this page and interwikis at 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.}}
 +
{{Uses Wikidata|P2013}}
 +
{{Lua|Module:EditAtWikidata}}
 +
{{See also|Template:Facebook page|Wikipedia:External links/Perennial websites}}
  
Reinventing Network Management
+
'''{{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.
By Steve Broadhead on November 5, 2013 2:27 PM | No Comments | No TrackBacks
+
__TOC__
Share on email Share on twitter Share on facebook Share on linkedin Share on slashdot Share on reddit Share on stumbleupon Share on digg Share on yammer | More Sharing ServicesMore
+
{{clear}}
Network management is the proverbial bus syndrome - nothing shows up forever and then there's a whole queue of them  - in this case interesting technologies, but here's the really interesting one I'm about to start testing with - Moogsoft.
 
  
Think radical invention of network management and you're getting there - the name and website give some clues I guess that this isn't mainstream, me-too stuff...
+
==Usage==
 +
; Unnamed parameters
 +
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | ''user name or number'' }}</code>
 +
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | ''user name or number'' | ''Displayed Name'' }}</code>
  
So here's the problem - network management, even in its modern incarnation of application performance monitoring and all the variations on a theme, is all about some concept of a network configuration being stable and predictable. So the idea is that you, over time, build up a "rich database" of information regarding all elements of the network - hardware and software - so that there's a level of intelligence to access when identifying problems (and potential problems). OK, except that, if you have a network deployment that is part cloud (or managed service of some description), part-virtualised and otherwise outsourced to some extent, how can you possibly know what the shape of that network is. Even as the service provider you cannot...
+
; Named parameters
 +
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | id= ''user name or number'' }}</code>
 +
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | id= ''user name or number'' | name= ''Displayed Name'' }}</code>
  
It therefore doesn't matter how much networking data you collect  - effectively you have to start from scratch every time, because the network is dynamic, not static, so any historical data is not necessarily correct. And we all know what happens in you make decisions based on inaccurate data... Moogsoft therefore says, forget about the existing methodologies - they don't work any longer. Instead it uses algorithm-based techniques to establish concurrent relationships between all aspects of the network when an anomalous situation is identified - looking at every possible cause-effect possibility. And it works in a true, collaborative environment - after all, network management is not detached from other aspects of the network in the same way that user A in department X is not detached from user B in department Y. So every "element" of the "network" is relevant and involved.
+
; Using [[Wikidata]] property ''{{Property|P2013}}''
 +
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>}}</nowiki></code>
 +
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | name= ''Displayed Name'' }}</code>
  
Sounds like an impossible to scale scenario? Well how about handling 170m incidents a day? And taking resolution time down from hours and days to minutes? Sounds too good to be true? Maybe so, but these are recorded results involving a famous, global Internet player.
+
== Examples ==
  
Watch out for the Broadband-Testing report on the Moogsoft solution - should be somewhat interesting!!!! =
+
=== Linking to a profile or page ===
 +
In this example, the Facebook user name is ''zuck'' and the [[link text]] is ''Mark Zuckerberg'':
 +
 
 +
: <samp>https://<nowiki/>www.facebook.com/{{Hilite|zuck}}</samp>
 +
: <code><nowiki>* {{Facebook | zuck | Mark Zuckerberg }}</nowiki></code>
 +
:* {{{{BASEPAGENAME}} | zuck | Mark Zuckerberg }}
 +
 
 +
In this example, there is a Facebook user number instead of a user name:
 +
 
 +
: <samp>https://<nowiki/>www.facebook.com/{{Hilite|4}}</samp>
 +
: <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:
 +
 
 +
: <samp>https://<nowiki/>www.facebook.com/{{Hilite|facebook}}</samp>
 +
: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | facebook }}</code>
 +
:* {{{{BASEPAGENAME}} | facebook }}
 +
 
 +
=== 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:
 +
 
 +
: <samp>https://<nowiki/>www.facebook.com/{{Hilite|zuck/photos}}</samp>
 +
: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}}|zuck/photos|name=Mark Zuckerberg}}</code>
 +
:* {{{{BASEPAGENAME}}|zuck/photos|name=Mark Zuckerberg}}
 +
 
 +
=== Using Wikidata ===
 +
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}} |name=''NAME'' }}</code>
 +
 
 +
If the Wikidata property is not defined, the output is:
 +
:* {{ {{BASEPAGENAME}} }}
 +
 
 +
== TemplateData ==
 +
{{TemplateData header}}
 +
<templatedata>
 +
{
 +
    "description": "Generate a link to a Facebook profile in a standard format.",
 +
    "params": {
 +
        "id": {
 +
            "label": "Account ID",
 +
            "aliases": ["1"],
 +
            "description": "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.",
 +
            "type": "string/line",
 +
            "required": false,
 +
            "default": "Wikidata property P2013"
 +
        },
 +
        "name": {
 +
            "label": "Display name",
 +
            "aliases": ["2"],
 +
            "description": "Display name for the Facebook account",
 +
            "type": "string/line",
 +
            "required": false,
 +
            "default": "Name of the page"
 +
        }
 +
    }
 +
}
 +
</templatedata>
 +
 
 +
== Tracking category ==
 +
* {{clc|Facebook template missing ID and not in Wikidata}}
 +
 
 +
== See also ==
 +
* {{tl|Facebook page}} which uses Wikidata property ''{{property|P4003}}''
 +
* [[Wikipedia:FACEBOOK]]
 +
* {{tl|Facebook navbox}}
 +
 
 +
<includeonly>{{Sandbox other||
 +
<!-- Categories below this line, please; interwikis at Wikidata -->
 +
[[Category:Social media external link templates]]
 +
[[Category:External link templates using Wikidata]]
 +
[[Category:Templates that add a tracking category]]
 +
}}</includeonly>

Latest revision as of 17:56, 10 May 2020

Template:Uses Wikidata

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.

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 }}

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 }}

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 }}

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}}

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:

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"). This parameter is optional if Wikidata property P2013 exists, but required if not.

Default
Wikidata property P2013
Lineoptional
Display namename 2

Display name for the Facebook account

Default
Name of the page
Lineoptional

Tracking category

See also