A newer version of this documentation is available.

View Latest

WLD Buttons

It is possible to specify any number of buttons.

The presentation is limited by the size of the screen. Buttons that end up outside the screen are not visible because there is no scrolling function.
[WLD Buttons]
01=About;tile.png;{string:1003};always
02=

Values

Of the four button configurations, only <action> is mandatory.

Set the value to none to deactivate the button.

[WLD Buttons]
1=<action>;<image>;<description>;<mode>
action

This setting tells which action to make when the button is pressed. See Actions for more information.

No check is made that the specified action exists. If the specified action is missing, nothing happens when the button is pressed.

image

The image to show on the button. The image is stored as a resource in Net iD Client. See the resource command for more information. If the image cannot be found, no image is shown.

description

The description tooltip of the button. That is, the text to show when hovering over the button. See Descriptions for more information. The text can be given directly as a string or as a string ID. For more information about string IDs for different languages see Language. Let this field be empty if you do not want to show any text.

mode

When to show each button is controlled with the mode argument.

always

The button is always shown. If no value or if an incorrect value is given, the value always is used.

token-present

Shows the button if a token is present. For information on how to control which tokens to present, see TokenModelList.

token-logged-on

Shows the button if a token is present and PIN1 is logged in.

Examples

Example 1. Setting button value to None.

The value none can be given to the Buttons entry. Otherwise it will be difficult to remove the value in the static configuration.

[WLD Buttons]
01=About;tile.png;{string:1003};always
02=none
03=Admin;tile.png;{string:1018};always
Example 2. Polling the status based on mode settings.

Polling to detect the mode status is only done if there is a button that requires that. If a button uses token-present, polling is done when a card is inserted or removed. If a button uses token-logged-on, a check of the PIN1 logging in status is done, as well as for when a card is inserted or removed.

[WLD Buttons]
1=MyButton1;wld_button1.png;{string:2001};always
2=MyButton2;wld_button2.png;{string:2002};token-present
3=MyButton3;wld_button3.png;{string:2003};token-logged-on