Difference between revisions of "Template:PropVals/Print Entry/doc"

From Salem Wiki
Jump to: navigation, search
m (→‎Examples: updated with change in default value of showamount)
m (→‎Syntax: added 'userparam', and changed default-value of showamount)
Line 17: Line 17:
 
:**'''showamount'''
 
:**'''showamount'''
 
:**:Optional; Controls the display of the amount-field.
 
:**:Optional; Controls the display of the amount-field.
:**:Any value that differs from "no" will make it display the amount-field.
+
:**:<u>Any value</u> that differs from "'''no'''" will make it display the amount-field.
:**:Defaults to "no".
+
:**:Defaults to "yes".
 +
:**'''userparam'''
 +
:**:Optional; Controls the display of the amount-field, when used as a '''result-formater in SMW-Queries'''.
 +
:**:<u>Any value</u> that differs from "'''no'''" will make it display the amount-field.
 +
:**:Defaults to value of '''showamount''' including the default of that.
 
:*1 '''''entry''''' as unnamed-parameter:
 
:*1 '''''entry''''' as unnamed-parameter:
 
:*:An entry has the following structure: '<nowiki/>''Objectname'''''sep'''''Amount''<nowiki/>'
 
:*:An entry has the following structure: '<nowiki/>''Objectname'''''sep'''''Amount''<nowiki/>'
 
:*:Using the default '''sep''' that could look like 'Board;10'
 
:*:Using the default '''sep''' that could look like 'Board;10'
 +
 
==Examples==
 
==Examples==
 
#{{t|PropVals/Print Entry|Anvil;10}} or {{t|PropVals/Print Entry|sep<nowiki>=</nowiki>;|Anvil;10}} gives:<br/>{{PropVals/Print Entry|sep=;|Anvil;10}}
 
#{{t|PropVals/Print Entry|Anvil;10}} or {{t|PropVals/Print Entry|sep<nowiki>=</nowiki>;|Anvil;10}} gives:<br/>{{PropVals/Print Entry|sep=;|Anvil;10}}

Revision as of 19:08, 6 July 2012

Description

This template is used to display an entry of a grouped-record in a visually appealing way, by outputting an icon-image followed by a link to the page of the object followed by the amount when requested.
It uses {{PropVals/Split}} to extract the name- and amount-fields from the entry.
It uses {{HasProp|Has icon}}, on the page of the entry to be displayed, and use that as icon-image to display.
If it can't find that property then it will auto-compose a filename for the icon-image to use:
The composed filename of the icon-image is composed of the name-field followed by "_icon.png".
The generated-output will be used by {{PropVals/List}}.
This template will also be used by the embedded SMW-Query inside {{Infobox}} as a result-formater to display values of RequiredBy.

Syntax

Type the below code somewhere inside your code: {{PropVals/Print Entry}}
It accepts the following parameters:
  • named-parameters:
    • sep
      Optional; The separator to use for splitting the fields inside the entry.
      Defaults to a dot-colon ';'
    • showamount
      Optional; Controls the display of the amount-field.
      Any value that differs from "no" will make it display the amount-field.
      Defaults to "yes".
    • userparam
      Optional; Controls the display of the amount-field, when used as a result-formater in SMW-Queries.
      Any value that differs from "no" will make it display the amount-field.
      Defaults to value of showamount including the default of that.
  • 1 entry as unnamed-parameter:
    An entry has the following structure: 'ObjectnamesepAmount'
    Using the default sep that could look like 'Board;10'

Examples

  1. {{PropVals/Print Entry|Anvil;10}} or {{PropVals/Print Entry|sep=;|Anvil;10}} gives:
    Anvil icon.png Anvil x10
  2. {{PropVals/Print Entry|showamount=no|Anvil;10}} or {{PropVals/Print Entry|sep=;|showamount=no|Anvil;10}} gives:
    Anvil icon.png Anvil