Module:Check for unknown parameters/doc: Difference between revisions

Revision as of 14:44, 24 June 2024

Latest revision as of 11:44, 5 June 2025

(16 intermediate revisions by 12 users not shown)

Line 1:

{{Used in system}}

{{Module rating|p}}

{{cascade-protected template|page=module}}

{{Lua|Module:If preview|noprotcat=yes}}

Line 6 ⟶ 7:

== Usage ==

=== From a template ===

* {{mlx|Check for unknown parameters|check|unknown{{=}}<nowiki>[</nowiki>[Category:Some tracking category]]|arg1|arg2|arg3|argN}}

To sort entries into a tracking category by parameter, use:

* {{mlx|Check for unknown parameters|check|unknown{{=}}<nowiki>[</nowiki>[Category:Some tracking category|_VALUE_]]|arg1|arg2|arg3|argN}}

To sort the entries ininto thea tracking category by parameter with a preview error message, use:

* {{mlx|Check for unknown parameters|check|unknown{{=}}<nowiki>[</nowiki>[Category:Some tracking category|_VALUE_]]|preview{{=}}unknown parameter "_VALUE_"|arg1|arg2|...|argN}}

Line 14 ⟶ 17:

* {{mlx|Check for unknown parameters|check|unknown{{=}}&lt;span class{{=}}"error">Sorry, I don't recognize _VALUE_&lt;/span>|arg1|arg2|...|argN}}

WithTo use Lua patterns, use:

* {{mlx|Check for unknown parameters|check|unknown{{=}}<nowiki>[</nowiki>[Category:Some tracking category|_VALUE_]]|preview{{=}}unknown parameter "_VALUE_"|arg1|arg2|...|argN|regexp1{{=}}header[%d]+|regexp2{{=}}date[1-9]}}

===From a module===

To call from a module, use:

<syntaxhighlight lang="lua">

local checkForUnknownParameters = require("Module:Check for unknown parameters")

local result = checkForUnknownParameters._check(validArgs, args)

</syntaxhighlight>

Where the first set of args are the module args below and the second set of args are the parameters that are checked.

== Parameters ==

* <code>arg1</code>, <code>arg2</code>, ..., <code>argN</code>, are the known parameters.

* Unnamed (positional) parameters can be added too: <code>|1|2|arg1|arg2|...</code>.

* [[:mw:Extension:Scribunto/Lua reference manual#Patterns|Lua patterns]] (similar to [[regular expression]]s) usage with parameters is also supported. (such as: {{para|regexp1|header[%d]+}}, {{para|regexp2|date[1-9]}}, {{para|regexp3|data[%d]+[abc]?}}). This is useful when there are many known parameters which use a systematic pattern.

* {{para|unknown}} – thewhat happens when an unknown parameter is used. Typically use either a tracking category to place pages that use uknownunknown parameters, or an error.

* {{para|preview}} – the text to be displayed when in preview mode and an unknown parameter is used.

* The <code>_VALUE_</code> keyword, if used, will be changed to the name of the parameter. This is useful for either sorting the entries in a tracking category, or for provide more explicit information.

Line 44 ⟶ 56:

-->{{#invoke:Check for unknown parameters|check

| unknown = {{Main other|[[Category:Some tracking category|_VALUE_]]}}

| preview = unknown parameter "_VALUE_" | height | name | website | weight

| name

| height | weight

| website

}}

</syntaxhighlight>

Line 69 ⟶ 78:

<!-- Categories go here and interwikis go in Wikidata. -->

[[Category:Modules that add a tracking category]]

[[Category:Template metamodules]]

}}</includeonly>

<noinclude>

[[Category:Module documentation pages]]

</noinclude>