Module:Unsubst/doc - Revision history

Merc at 00:40, 6 October 2025

2025-10-06T00:40:45Z

← Older revision		Revision as of 00:40, 6 October 2025
Line 2:		Line 2:
	{{high-risk\|all=pages=yes}}		{{high-risk\|all=pages=yes}}
	{{Module rating\|protected}}		{{Module rating\|protected}}
			{{lua\|Module:Template invocation\|noprotcat=yes}}

	Maintenance templates, such as {{tl\|Citation needed}} or {{tl\|Refimprove}}, should never be substituted. A trick to avoid that is to make a template substitute to its transcluded form. This module implements that trick.		Maintenance templates, such as {{tl\|Citation needed}} or {{tl\|Refimprove}}, should never be substituted. A trick to avoid that is to make a template substitute to its transcluded form. This module implements that trick.
Line 8:		Line 9:

	=== Usage ===		=== Usage ===

	To turn a template into a self-substituting template, wrap the existing template code with:		To turn a template into a self-substituting template, wrap the existing template code with:
	<pre>		<pre>
	{{~~SAFESUBST~~:<noinclude />#invoke:Unsubst\|\|$B=		{{safesubst:<noinclude />#invoke: Unsubst\|\|$B=

	[ ... existing template code ... ]		[ ... existing template code ... ]
Line 25:		Line 25:

	<pre>		<pre>
	{{~~SAFESUBST~~:<noinclude />#invoke:Unsubst\|\|$params=[ parameters ]\|$aliases=[ aliases ]\|$flags=[ flags ]\|$B=		{{safesubst:<noinclude />#invoke: Unsubst\|\|$params=[ parameters ]\|$aliases=[ aliases ]\|$flags=[ flags ]\|$B=

	[ ... existing template code ... ]		[ ... existing template code ... ]
Line 45:		Line 45:
	Consider a template Template:Example containing the following code:		Consider a template Template:Example containing the following code:
	<pre>		<pre>
	{{~~SAFESUBST~~:<noinclude />#invoke:Unsubst\|\|foo=bar \|date=__DATE__ \|$B=		{{safesubst:<noinclude />#invoke: Unsubst\|\|foo=bar \|date=__DATE__ \|$B=

	[ ... Template code goes here ... ]		[ ... Template code goes here ... ]
Line 53:		Line 53:

	{\| class="wikitable"		{\| class="wikitable"
			\|-
	! Original !! Result		! Original !! Result
	\|-		\|-

Merc: 1 revision imported

2025-05-04T08:33:37Z

1 revision imported

← Older revision	Revision as of 08:33, 4 May 2025
(No difference)

wikipedia>Anomie: Undid revision 1263623150 by 2001:1670:18:2288:284A:9C05:EFBF:FB32 (talk) - rvv

2024-12-17T22:56:02Z

Undid revision 1263623150 by 2001:1670:18:2288:284A:9C05:EFBF:FB32 (talk) - rvv

← Older revision		Revision as of 22:56, 17 December 2024
Line 1:		Line 1:
	<!-- Categories where indicated at the bottom of this page, please. -->		<!-- Categories where indicated at the bottom of this page, please. -->
	{{~~High~~-risk\|~~2,200,000+~~}}		{{high-risk\|all=pages=yes}}
	{{Module rating\|protected}}		{{Module rating\|protected}}

	~~Helper module to facilitate a substituted template transform into a template transclusion.~~		Maintenance templates, such as {{tl\|Citation needed}} or {{tl\|Refimprove}}, should never be substituted. A trick to avoid that is to make a template substitute to its transcluded form. This module implements that trick.

	Maintenance templates, such as {{tl\|Citation needed}} or {{tl\|Refimprove}}, should never be substituted. A trick to avoid that is to make a template substitute to its transcluded form.

	Infoboxes should use [[Module:Unsubst-infobox]], as should any other templates with parameters listed in block format by default.		Infoboxes should use [[Module:Unsubst-infobox]], as should any other templates with parameters listed in block format by default.
Line 41:		Line 39:

	These parameters can be manipulated using parser functions to provide more complicated options (note that in the parameters any parser function, or template or module invocation, should also have <code><nowiki>SAFESUBST:<noinclude /></nowiki></code>).		These parameters can be manipulated using parser functions to provide more complicated options (note that in the parameters any parser function, or template or module invocation, should also have <code><nowiki>SAFESUBST:<noinclude /></nowiki></code>).

			Parameter {{para\|$template-name}} will override the subst'd template's name with the template name assigned to this parameter.

	=== Example ===		=== Example ===
Line 55:		Line 55:
	! Original !! Result		! Original !! Result
	\|-		\|-
	\| {{tlsc\|example}} \|\| {{tlc\|Example~~\|foo=bar~~\|date{{=}}{{#time:F Y}}}}		\| {{tlsc\|example}} \|\| {{tlc\|Example\|date{{=}}{{#time:F Y}}\|foo{{=}}bar}}
	\|-		\|-
	\| {{tlsc\|example\|foo{{=}}X}} \|\| {{tlc\|Example~~\|foo{{=}}X~~\|date{{=}}{{#time:F Y}}}}		\| {{tlsc\|example\|foo{{=}}X}} \|\| {{tlc\|Example\|date{{=}}{{#time:F Y}}\|foo{{=}}X}}
	\|-		\|-
	\| {{tlsc\|example\|baz{{=}}X}} \|\| {{tlc\|Example~~\|foo=bar~~\|baz{{=}}X\|date{{=}}{{#time:F Y}}}}		\| {{tlsc\|example\|baz{{=}}X}} \|\| {{tlc\|Example\|baz{{=}}X\|date{{=}}{{#time:F Y}}\|foo{{=}}bar}}
	\|-		\|-
	\| {{tlsc\|example\|date{{=}}January 2001}} \|\| {{tlc\|Example\|~~foo~~{{=}}~~bar~~\|~~date~~{{=}}~~January 2001~~}}		\| {{tlsc\|example\|date{{=}}January 2001}} \|\| {{tlc\|Example\|date{{=}}January 2001\|foo{{=}}bar}}
	\|}		\|}

Merc: 1 revision imported

2018-07-13T17:32:35Z

1 revision imported

← Older revision	Revision as of 17:32, 13 July 2018
(No difference)

Module>JJMC89: /* Usage */ ce

2018-07-11T03:06:31Z

Usage: ce

← Older revision		Revision as of 03:06, 11 July 2018
Line 1:		Line 1:
	<!-- Categories where indicated at the bottom of this page, please. -->		<!-- Categories where indicated at the bottom of this page, please. -->

	{{High-risk\|2,200,000+}}		{{High-risk\|2,200,000+}}
	{{Module rating\|protected}}		{{Module rating\|protected}}
Line 14:		Line 13:
	To turn a template into a self-substituting template, wrap the existing template code with:		To turn a template into a self-substituting template, wrap the existing template code with:
	<pre>		<pre>
	{{ ~~{{{\|safesubst~~:~~}}}~~#invoke:Unsubst\|\|$B=		{{SAFESUBST:<noinclude />#invoke:Unsubst\|\|$B=

	[ ... existing template code ... ]		[ ... existing template code ... ]
Line 21:		Line 20:
	</pre>		</pre>

	The wikitext to display when not substed must be given as "$B". All other parameters passed to the #invoke will be copied to the generated template invocation as default values. If the value of any of these default parameters is "__DATE__", that value in the generated template invocation will be the current month and year.		The wikitext to display when not substed must be given as "$B". All other parameters passed to the #invoke will be copied to the generated template invocation as default values. If the value of any of these default parameters is <code>__DATE__</code>, that value in the generated template invocation will be the current month and year.

	Some templates have a ~~<~~noinclude~~>~~ but no matching ~~</~~noinclude~~>~~ at the end of the template. In such cases the missing ~~</~~noinclude~~>~~ must be added before the ending <code>{{))}}</code>.		Some templates have a {{tag\|noinclude\|o}} but no matching {{tag\|noinclude\|c}} at the end of the template. In such cases the missing {{tag\|noinclude\|c}} must be added before the ending <code>{{))}}</code>.

	==== Advanced ====		==== Advanced ====

	<pre>		<pre>
	{{ ~~{{{\|safesubst~~:~~}}}~~#invoke:Unsubst\|\|$params=[ parameters ]\|$aliases=[ aliases ]\|$flags=[ flags ]\|$B=		{{SAFESUBST:<noinclude />#invoke:Unsubst\|\|$params=[ parameters ]\|$aliases=[ aliases ]\|$flags=[ flags ]\|$B=

	[ ... existing template code ... ]		[ ... existing template code ... ]
Line 41:		Line 40:
	Parameter {{para\|$flags}} can be used to modify other facets of the module's behaviour; entries are comma-separated. Valid flags are <code>override</code> (allows parameters in the #invoke: to take precedence over parameters in the original template invocation); <code>keep-whitespace</code> (prevents whitespace from being trimmed from unnamed parameters); and <code>remove-empty</code> (removes empty parameters).		Parameter {{para\|$flags}} can be used to modify other facets of the module's behaviour; entries are comma-separated. Valid flags are <code>override</code> (allows parameters in the #invoke: to take precedence over parameters in the original template invocation); <code>keep-whitespace</code> (prevents whitespace from being trimmed from unnamed parameters); and <code>remove-empty</code> (removes empty parameters).

	These parameters can be manipulated using parser functions to provide more complicated options (note that in the parameters any parser function, or template or module invocation, should also have <code>~~{{(((}}{{!}}safesubst~~:~~{{)))}}~~</code>).		These parameters can be manipulated using parser functions to provide more complicated options (note that in the parameters any parser function, or template or module invocation, should also have <code><nowiki>SAFESUBST:<noinclude /></nowiki></code>).

	=== Example ===		=== Example ===
	Consider a template Template:Example containing the following code:		Consider a template Template:Example containing the following code:
	<pre>		<pre>
	{{ ~~{{{\|safesubst~~:~~}}}~~#invoke:Unsubst\|\|foo=bar \|date=__DATE__ \|$B=		{{SAFESUBST:<noinclude />#invoke:Unsubst\|\|foo=bar \|date=__DATE__ \|$B=

	[ ... Template code goes here ... ]		[ ... Template code goes here ... ]
Line 56:		Line 55:
	! Original !! Result		! Original !! Result
	\|-		\|-
	\| ~~<nowiki>~~{{~~subst:~~example}}~~</nowiki>~~ \|\| ~~<nowiki>~~{{Example\|foo=bar\|date=~~</nowiki>~~{{#time:F Y}}}}		\| {{tlsc\|example}} \|\| {{tlc\|Example\|foo=bar\|date{{=}}{{#time:F Y}}}}
	\|-		\|-
	\| ~~<nowiki>~~{{~~subst:~~example\|foo=X}}~~</nowiki>~~ \|\| ~~<nowiki>~~{{Example\|foo=X\|date=~~</nowiki>~~{{#time:F Y}}}}		\| {{tlsc\|example\|foo{{=}}X}} \|\| {{tlc\|Example\|foo{{=}}X\|date{{=}}{{#time:F Y}}}}
	\|-		\|-
	\| ~~<nowiki>~~{{~~subst:~~example\|baz=X}}~~</nowiki>~~ \|\| ~~<nowiki>~~{{Example\|foo=bar\|baz=X\|date=~~</nowiki>~~{{#time:F Y}}}}		\| {{tlsc\|example\|baz{{=}}X}} \|\| {{tlc\|Example\|foo=bar\|baz{{=}}X\|date{{=}}{{#time:F Y}}}}
	\|-		\|-
	\| ~~<nowiki>~~{{~~subst:~~example\|date=January 2001}}~~</nowiki>~~ \|\| ~~<nowiki>~~{{Example\|foo=bar\|date=January 2001}}~~</nowiki>~~		\| {{tlsc\|example\|date{{=}}January 2001}} \|\| {{tlc\|Example\|foo{{=}}bar\|date{{=}}January 2001}}
	\|}		\|}

	<includeonly>{{~~#ifeq:{{SUBPAGENAME}}~~\|~~sandbox~~ \|		<includeonly>{{sandbox other\|\|
	\| <!-- Categories below this line, please; interwikis at Wikidata -->		\| <!-- Categories below this line, please; interwikis at Wikidata -->
	[[Category:Wikipedia metatemplates]]		[[Category:Wikipedia metatemplates]]
	[[Category:Modules that add a tracking category]]		[[Category:Modules that add a tracking category]]
	}}</includeonly>		}}</includeonly>

Merc: 1 revision imported

2018-05-17T22:53:13Z

1 revision imported

New page

{{High-risk|2,200,000+}}
{{Module rating|protected}}

Helper module to facilitate a substituted template transform into a template transclusion.

Maintenance templates, such as {{tl|Citation needed}} or {{tl|Refimprove}}, should never be substituted. A trick to avoid that is to make a template substitute to its transcluded form.

Infoboxes should use [[Module:Unsubst-infobox]], as should any other templates with parameters listed in block format by default.

=== Usage ===

To turn a template into a self-substituting template, wrap the existing template code with:
<pre>
{{ {{{|safesubst:}}}#invoke:Unsubst||$B=

[ ... existing template code ... ]

}}
</pre>

The wikitext to display when not substed must be given as "$B". All other parameters passed to the #invoke will be copied to the generated template invocation as default values. If the value of any of these default parameters is "__DATE__", that value in the generated template invocation will be the current month and year.

Some templates have a <noinclude> but no matching </noinclude> at the end of the template. In such cases the missing </noinclude> must be added before the ending <code>{{))}}</code>.

==== Advanced ====

<pre>
{{ {{{|safesubst:}}}#invoke:Unsubst||$params=[ parameters ]|$aliases=[ aliases ]|$flags=[ flags ]|$B=

[ ... existing template code ... ]

}}
</pre>

Due to Lua limitations, parameters are normally ordered randomly when the template is substituted. {{para|$params}} can be used in #invoke:Unsubst to list template parameters in order, comma-separated (e.g. <code>egg,bacon,sausage,cheese,spam</code>). Numbered parameters should be before others in the list. Any remaining parameters are tacked onto the end of the generated invocation.

Parameter aliases can be listed in {{para|$aliases}} (and shouldn't be listed in {{para|$params}}), and will be replaced automatically. Each alias and its replacement should be formatted as <code>alias>replacement</code>, and each of those pairs should be comma-separated (e.g. <code>œuf>egg,melt>cheese</code>). Note that this parameter can function with or without {{para|$params}}.

Parameter {{para|$flags}} can be used to modify other facets of the module's behaviour; entries are comma-separated. Valid flags are <code>override</code> (allows parameters in the #invoke: to take precedence over parameters in the original template invocation); <code>keep-whitespace</code> (prevents whitespace from being trimmed from unnamed parameters); and <code>remove-empty</code> (removes empty parameters).

These parameters can be manipulated using parser functions to provide more complicated options (note that in the parameters any parser function, or template or module invocation, should also have <code>{{(((}}{{!}}safesubst:{{)))}}</code>).

=== Example ===
Consider a template Template:Example containing the following code:
<pre>
{{ {{{|safesubst:}}}#invoke:Unsubst||foo=bar |date=__DATE__ |$B=

[ ... Template code goes here ... ]

}}
</pre>

{| class="wikitable"
! Original !! Result
|-
| <nowiki>{{subst:example}}</nowiki> || <nowiki>{{Example|foo=bar|date=</nowiki>{{#time:F Y}}}}
|-
| <nowiki>{{subst:example|foo=X}}</nowiki> || <nowiki>{{Example|foo=X|date=</nowiki>{{#time:F Y}}}}
|-
| <nowiki>{{subst:example|baz=X}}</nowiki> || <nowiki>{{Example|foo=bar|baz=X|date=</nowiki>{{#time:F Y}}}}
|-
| <nowiki>{{subst:example|date=January 2001}}</nowiki> || <nowiki>{{Example|foo=bar|date=January 2001}}</nowiki>
|}

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox |
| 
[[Category:Wikipedia metatemplates]]
[[Category:Modules that add a tracking category]]
}}</includeonly>