View source for Template:Find a Grave/doc

{{Documentation subpage}}
<!--Categories where indicated at the bottom of this page, please; interwikis at Wikidata (see [[Wikipedia:Wikidata]])-->
{{High-use|37906}}
{{warning|Per [[WP:FINDAGRAVE-EL]], this template should be used very sparingly and in most cases the template (or links to Findagrave not using this template) should be removed from articles.}}
{{Tracks and uses Wikidata|P535}}
{{Lua|Module:EditAtWikidata|Module:WikidataCheck}}

'''{{NAMESPACE}}:{{BASEPAGENAME}}''' displays an external link or a reference to a memorial on the [[Find a Grave]] website.

== Usage ==

===External link===
; 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>

; Named parameters
: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | id= <nowiki>}}</nowiki></code>
: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | id= | name= <nowiki>}}</nowiki></code>
: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | id= | name= | work= <nowiki>}}</nowiki></code>

; Using Wikidata property
: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}}<nowiki>}}</nowiki></code>
: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | name= <nowiki>}}</nowiki></code>
: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | name= | work= <nowiki>}}</nowiki></code>

===Reference===
; Two unnamed parameters
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | <var>ID</var> | <var>NAME</var> | work= | last= | first= | date= | access-date= <nowiki>}}</nowiki></code>

; Named parameters
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | id= | name= | work= | last= | first= | date= | access-date= <nowiki>}}</nowiki></code>

; Using Wikidata property
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | work= | last= | first= | date= | access-date= <nowiki>}}</nowiki></code>
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}} | name= | work= | last= | first= | date= | access-date= <nowiki>}}</nowiki></code>

== Usage guidance ==
{{See also|Wikipedia:External links/Perennial websites#Find a Grave}}

Care should be taken when deciding to make a link to the Find a Grave website. While photographs of gravestones provide useful information, the biographical and other additional details may not be reliable. If there are fully [[WP:RS|reliable sources]] which may be used, then the Find a Grave link should not be used, or should be removed in place of the more reliable source.

===As an [[WP:External link]]===

To comply with [[WP:ELNO]], only place in External links section if the website contains unique information not already mentioned and cited in the body of the article and is not a [[WP:COPYLINK]] violation. Remove from External links if Find a Grave is already cited in main body, if burial information is provided in main body by a more reliable source, or if the page contains any unlicensed copyrighted information (e.g., professional [[portrait photography]] or copies of [[obituaries]] from a newspaper).

===As a reference for article content===

With rare exceptions, [[WP:FINDAGRAVE-EL|do not]] use Find a Grave as a source. Find a Grave is not [[WP:RS|reliable]] because it relies on user-generated input without vetting by an editorial body.

If any of the parameters:
* access-date
* author
* date
* last
are specified, this template will produce a citation with {{tl|Cite web}}. Otherwise, it produces a format for use in an "External links" section. If used as a reference, it should not be duplicated in the "External links" section.

== Parameters ==
* <code>id</code> or <code>grid</code> (parameter 1, required unless using Wikidata)&nbsp;– The Find a Grave Memorial ID number, found at the bottom of the Find a Grave article or in the URL (e.g., "1234" for https://www.findagrave.com/memorial/1234/henri-langlois, formerly https://www.findagrave.com/cgi-bin/fg.cgi?page=gr&GRid=1234). This parameter is optional if Wikidata property P535 exists, but required if not.
* <code>name</code> (parameter 2, optional)&nbsp;– The name of the deceased. Defaults to <code>{{mwl|PAGENAME}}</code> if not specified.
* <code>work</code>&nbsp;– A group or category within the Find a Grave site.
* <code>check-wikidata</code>&nbsp;– Include {{para|check-wikidata|no}} to prevent the template comparing the provided ID against the value from Wikidata. Use mainly when this template is used on list, place or other people's articles.
* Parameters for {{tl|Cite web}}
** <code>last</code>&nbsp;– The surname of the original author of the Find a Grave article.
*** <code>author</code>&nbsp;– Alias for <code>last</code>. If both <code>last</code> and <code>author</code> are specified, <code>last</code> takes precedence.
** <code>first</code>&nbsp;– The given name of the original author of the Find a Grave article. Requires <code>last</code>.
** <code>display-authors</code>&nbsp;– If the Find a Grave article has more than one author, use {{para|display-authors|et al}} to display "et al." after the name of the first author.
** <code>date</code>&nbsp;– The date of the Find a Grave article.
** <code>access-date</code>&nbsp;– The date this citation was added or last updated.

== Examples ==

=== External link with unnamed parameters ===
; Usage
: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | 1234 | Henri Langlois <nowiki>}}</nowiki></code>
; Output
:* {{ {{BASEPAGENAME}} | 1234 | Henri Langlois }}
; Current URL:
: <kbd>[https://www.findagrave.com/memorial/1234/henri-langlois https://www.findagrave.com/memorial/{{Highlight|1234}}/henri-langlois]</kbd>
; Alternate URLs (redirect to URL above):
: <kbd>[https://www.findagrave.com/memorial/1234 https://www.findagrave.com/memorial/{{Highlight|1234}}]</kbd> (used in template)
: <kbd>[https://www.findagrave.com/cgi-bin/fg.cgi?page=gr&GRid=1234 https://www.findagrave.com/cgi-bin/fg.cgi?page=gr&GRid={{Highlight|1234}}]</kbd> (former URL)

=== External link with named parameters ===
; Usage
: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}} | id= 94078737 | name= Sally Kristen Ride | work= American Astronaut <nowiki>}}</nowiki></code>
; Output
:* {{ {{BASEPAGENAME}} | id= 94078737 | name= Sally Kristen Ride | work= American Astronaut }}
; Current URL:
: <kbd>[https://www.findagrave.com/memorial/94078737/sally-ride https://www.findagrave.com/memorial/{{Highlight|94078737}}/sally-ride]</kbd>
; Alternate URLs (redirect to URL above):
: <kbd>[https://www.findagrave.com/memorial/94078737 https://www.findagrave.com/memorial/{{Highlight|94078737}}]</kbd> (used in template)
: <kbd>[https://www.findagrave.com/cgi-bin/fg.cgi?page=gr&GRid=94078737 https://www.findagrave.com/cgi-bin/fg.cgi?page=gr&GRid={{Highlight|94078737}}]</kbd> (former URL)

=== External link using Wikidata property ===
; Usage in [[Henri Langlois#External links|Henri Langlois]]
: <code><nowiki>* {{</nowiki>{{BASEPAGENAME}}<nowiki>}}</nowiki></code>
; Output
:* {{ {{BASEPAGENAME}}|1234|Henri Langlois}} [[File:OOjs UI icon edit-ltr-progressive.svg |frameless |text-top |10px |alt=Edit this at Wikidata |link=https://www.wikidata.org/wiki/Q745858#P535 |Edit this at Wikidata]]

=== Missing ID and no Wikidata ===
; Usage
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>}}</nowiki></code>
; Output
: {{ {{BASEPAGENAME}} }}

=== Reference using all of the parameters ===
; Usage
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>
 | id          = 94078737
 | name        = Sally Kristen Ride
 | work        = American Astronaut
 | last        = Daniluke
 | first       = Marc J.
 | display-authors = et al
 | date        = July 23, 2012
 | access-date = </nowiki>{{CURRENTMONTHNAME}} {{CURRENTDAY}}, {{CURRENTYEAR}}<nowiki>
 }}</nowiki></code>
; Output
: {{ {{BASEPAGENAME}}
 | id          = 94078737
 | name        = Sally Kristen Ride
 | work        = American Astronaut
 | last        = Daniluke
 | first       = Marc J.
 | display-authors = et al
 | date        = July 23, 2012
 | access-date = {{CURRENTMONTHNAME}} {{CURRENTDAY}}, {{CURRENTYEAR}}
 }}

== TemplateData ==
{{collapse top|[[Wikipedia:TemplateData|TemplateData]] documentation used by [[Wikipedia:VisualEditor|VisualEditor]] and other tools}}
{{TemplateData header|noheader=1}}
<templatedata>
{
	"description": "This template displays an external link or a reference to a memorial on the Find a Grave website.",
	"params": {
		"id": {
			"aliases": ["grid","1"],
			"label": "GRid #",
			"description": "The Find a Grave Memorial ID number, found at the bottom of the Find a Grave article or in the URL (e.g., '1234' for https://www.findagrave.com/memorial/1234/henri-langlois, formerly https://www.findagrave.com/cgi-bin/fg.cgi?page=gr&GRid=1234). This parameter is optional if Wikidata property P535 exists, but required if not.",
			"type": "number",
			"required": false,
			"default": "Wikidata property P2601"
		},
		"name": {
			"aliases": ["2"],
			"label": "Name of deceased",
			"description": "The name of the deceased. This parameter is optional; it defaults to the Wikipedia article name, without any disambiguation.",
			"type": "line",
			"suggested": true,
			"default": "{{PAGENAMEBASE}}"
		},
		"work": {
			"description": "A group or category within the Find a Grave site",
			"type": "line"
		},
		"last": {
			"aliases": ["author"],
			"label": "Author surname",
			"description": "The surname of the original author of the Find a Grave article.",
			"type": "line"
		},
		"first": {
			"label": "Author given name",
			"description": "The given name of the original author of the Find a Grave article. Requires <code>last</code>.",
			"type": "line"
		},
		"display-authors": {
			"label": "Display authors",
			"description": "If the Find a Grave article has more than one author, use |display-authors=et al to display 'et al.' after the name of the first author.",
			"type": "string",
			"example": "et al"
		},
		"date": {
			"description": "The date of the Find a Grave article.",
			"type": "date"
		},
		"access-date": {
			"aliases": ["accessdate"],
			"label": "Access date",
			"description": "The date this citation was added or last updated.",
			"type": "date"
		},
		"check-wikidata": {
			"label": "check-wikidata",
			"description": "Include \"|check-wikidata=no\" to prevent the template comparing the provided ID against the value from Wikidata. Use mainly when this template is used on list, place or other people's articles.",
			"type": "string",
			"example": "|check-wikidata=no"
		}
	},
	"paramOrder": [
		"id",
		"name",
		"work",
		"last",
		"first",
		"display-authors",
		"date",
		"access-date",
		"check-wikidata"
	]
}
</templatedata>
{{collapse bottom}}

== Tracking categories ==
; template with ID
: ID is converted to numeric value before comparison with Wikidata
: 1234/henri-langlois → {{#invoke:String|match|s=1234/henri-langlois|pattern=^%d+|ignore_errors=true}}
: 1234 → {{#invoke:String|match|s=1234|pattern=^%d+|ignore_errors=true}}
* {{clc|Find a Grave template with ID different from Wikidata}}
* {{clc|Find a Grave template with ID not in Wikidata}}
; template missing ID
* {{clc|Find a Grave template missing ID and not in Wikidata}}

== See also ==
* [[Wikipedia:FINDAGRAVE]]
* {{tl|Find a Grave cemetery}} to link to a cemetery at Find a Grave

<includeonly>{{Sandbox other||
<!--Categories below this line, please; interwikis at Wikidata-->
[[Category:People and person 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>