Editing Module:Param Parse/doc

{{documentation}}

These params and functions are used to validate and format information passed into an Infobox. See [[Module:Infobox]] for details and instructions on creating an Infobox. If the information is missing or not valid, the functions here should return nil.

Here is a summary of all the params:
{| class="wikitable"
! param
! explanation
|-
| parse.image
| <nowiki>[[File:IMAGE.png]]</nowiki>. Use the class '''infobox-image''' in the table
|-
| parse.episode
| Episode name
|-
| parse.premium
| Premium (Yes, No, N/A)
|-
| parse.release
| TODO
|}

Here are some general use functions that can be used for custom or new params:
{| class="wikitable"
! function name
! explanation
|-
| has_content(arg)
| Returns arg if any non-whitespace character is found in the string.
|-
| number(num)
| Removes any commas and parses the string as a number
|-
| yes_no(text)
| Only accepts "Yes", "No" and "N/A"
|-
| yes_no_smw(text)
| Maps "Yes", "No" to true and false respectively
|}

== Creating New Params ==
Ideally, params should be defined here so that they can be reused between different Infoboxes. Here is how to create a new param:

<syntaxhighlight lang="lua">
param.paramname = {
	name = <param>,
    func = <func>,
    empty = 'empty', -- optional
    category_never = 'category', -- optional
    category_partial = 'category', -- optional
    category_incomplete = 'category', -- optional
    category_complete = 'category', -- optional
    smw_property = 'Property', -- optional
    smw_func = <func>, -- optional
}
</syntaxhighlight>


{| class="wikitable"
! key
! value
|-
| name
| parameter name as used in the Template
|-
| func
| A function in [[Module:Param Parse]] to validate and process the Template argument. You can also use a local function, but this is not recommended.
If func is a function, will call func(Infobox.raw_param(name)):
<syntaxhighlight lang="lua">
	{name = <param>, func = <func>, ... },
</syntaxhighlight>
If func is a table, it takes the following parameters:
<syntaxhighlight lang="lua">
	{name = <param>, func = { name = <func>, params = <func_params>}, ... },
</syntaxhighlight>
{| class="wikitable"
| name
| function in [[Module:Param Parse]]
|-
| params
| a list of parameters to pass the the function, in the form of constants, or Infobox.raw_param(name), Infobox.param(name), Infobox.smw_param(name)
|}
|-
| empty (optional)
| text to display in the infobox if func returns nil; defaults to "? (edit)"
|-
| category_never (optional)
| category to add if func returns nil for all versions
|-
| category_partial (optional)
| category to add if func returns nil for some versions, but a value for other versions
|-
| category_incomplete (optional)
| category to add if func returns nil for at least 1 version (i.e. category_never and category_partial combined)
|-
| category_complete (optional)
| category to add if func returns a value for all versions
|-
| smw_property (optional)
| if this string is defined, the parameter will be saved into SMW
|-
| smw_func (optional)
| function to validate and process the Template argument to save into SMW. func is used by default if smw_func is not defined
|}
@@ Line 7: / Line 7: @@
 ! param
 ! explanation
-|-
-| parse.actions
-| Actions listed in the action menu
-|-
-| parse.name
-| Title
-|-
-| parse.description
-| Description of the entity in its card
 |-
 | parse.image
 | <nowiki>[[File:IMAGE.png]]</nowiki>. Use the class '''infobox-image''' in the table
-|-
-| parse.image_size300
-| <nowiki>[[File:IMAGE.png|300x300px]]</nowiki> by default unless overridden. Use the class '''infobox-image''' in the table
 |-
 | parse.episode
-| Episode name
-|-
-| parse.additional_episode
 | Episode name
 |-
@@ Line 33: / Line 18: @@
 |-
 | parse.release
-| Release Date in the format YYYY-MM-DD
-|-
-| parse.value
-| Shows the value as a denomination of coins
-|-
-| parse.profession
 | TODO
-|-
-| parse.profession_bubble_a, parse.profession_bubble_b
-| Takes parameters profession_a + profession_a_level, or profession_b + profession_b_level
-|-
-| parse.profession_a_smw, parse.profession_a_level_smw, parse.profession_b_smw, parse.profession_b_level_smw
-| Exports the data from profession_bubble_a and profession_bubble_b to smw
-|-
-| parse.variant
-| TODO - Which category the subject is a variant of
-|-
-| parse.passive
-| Passiveness (Yes, No, N/A)
-|-
-| parse.duration
-| Number of hours to complete the [[Ventures|venture]]
-|-
-| parse.aggressive
-| Aggressive (Yes, No, N/A)
-|-
-| parse.difficulty
-| Quest difficulty (0-5)
-|-
-| parse.quest
-| Quest name (or No)
-|-
-| parse.unlock_level
-| Unlocked at
-|-
-| parse.knowledge
-| Knowledge
 |}
@@ Line 94: / Line 43: @@
 <syntaxhighlight lang="lua">
-parse.paramname = {
+param.paramname = {
 	name = <param>,
     func = <func>,