Template:Monarch of New Zealand, current/doc

		Standardized template for use in all references to the current monarch of New Zealand.
		Permits global updating of articles when eventual succession takes place.
		Only use this template for references that should always be the most current.  Hard-code any references to events that have occurred in the past or will occur in the future.

Usage

Assigning any value to a parameter (except since) returns information in the format indicated. (e.g. gender=* yields the same results as gender=yes)

Parameter	Description	Current value
none	Returns link to Monarch of New Zealand, monarch's title and name	Monarch of New Zealand, King Charles III
gender	Returns the current monarch's gender designation (i.e. she or he)	he
genderp	Returns the current monarch's possessive gender (i.e. her or his)	his
	To capitalize, use {{ucfirst:{{Monarch of New Zealand, current|genderp=~}}}}	His
title	Returns the unlinked title of the monarch (i.e. Queen or King)	King
nameonly	Returns only the monarch's name (wikilinked to their article of the same name)	Charles III
plainname	Returns only the monarch's unlinked name (Used in image linking)	Charles III
name&title	Returns the current monarch's title & name (wikilinked)	King Charles III
ascensiondate	Returns the date of the monarch's ascension to the throne	8 September 2022
since	Returns link to Monarch of New Zealand, followed by any symbol that since= assigns, followed by "since " and the date of ascension, followed by the monarch's title & name (wikilinked)	{{Monarchy of New Zealand|since=—}}  yields
		Monarch of New Zealand—since  8 September 2022, King Charles III
, any text	Returns "Monarch of New Zealand, any text monarch's title & name" (wikilinked)	Monarch of New Zealand, any text King Charles III

Examples

[[At {{ucfirst:{{Monarch of New Zealand, current|genderp=*}}}} Majesty's pleasure]]

      yields
  At Her Majesty's pleasure  or  At His Majesty's pleasure

{{Monarch of New Zealand, current|nameonly=*}}, [[Monarchy of New Zealand|{{Monarch of New Zealand, current|title=*}} of New Zealand]]

      yields
  Charles III, King of New Zealand

Changing the Current Monarch Information

Edit the template, changing the values (a total of 7 of them) marked between the ■■►--> and <!--◄■■.  The values, in the order they appear in the template, are:

he/she
her/his                          Note: Uncapitalized
Queen/King
date of ascension to the throne  The date standard for articles using this template is day-month-year (unpunctuated)
Queen/King                       Repeat the information from above 
name of the monarch              The name is needed twice; once is used for plain text, once for a wikilink 
name of the monarch              linked (article & image are expected to exist under this name).