Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

You can override almost any heading or wording in the default interface using javascript.

Override values

greenID Web is highly customisable, and a customer can override almost heading or wording element of the default interface.  This is a simple and straightforward process using javascript.

The full list of names that may be overridden and their default values can be found at https://simpleui-test-au.vixverify.com/df/javascripts/greenidConfig.js.  The file contains all of the client-overridable strings in greenID Web.  Simply use any of the names, as per the example below, to customise the wording.

Any of these names may be overridden using the greenidConfig.setOverrides function.  This function takes a single javascript map as the only parameter, and the values are used to override the default values found in the greenidConfig object.

An example fragment of javascript that overrides the main title at the top of the greenID frame is below:

greenidConfig.setOverrides({"intro_title" : "<h1>My custom heading</h1>"});

Any of the defaults in the greenidConfig object can be overridden.

Customising introductory wording

The introductory wording is very general by default to cater for as many of our customers as possible, but can (and should) be customised to be more specific to your actual Rule Set and therefore provide the user with very clear advice about what's expected of them.

Depending upon how many background sources have been passed when the user first sees the Simple UI, you can show different wording to make it clear to the customer what the remaining requirements for verification are. In this way, you can be quite specific when they arrive about how many sources you expect they'll need to complete.

The "intro_introText" properties allow for this.  The number at the end of the property (e.g. "intro_introText0") indicates the number of background sources passed.  So:
if 0 background sources have been passed: intro_introText0 is displayed
if 1 background source has been passed: intro_introText1 is displayed
if 2 or more background sources have been passed: intro_introText2 is displayed

Then, when a user passes their first (or subsequent) interactive source, the "intro_completed_source_ introText" wording is displayed.

Customising the "Save & Complete Later" option

A common requirement is to add or remove the "Save & Complete Later" option, which is found in the "Choose a different ID option" drop-down. It's enabled by default. This is achieved by setting the "enable_save_and_complete_later" property to true (enable it) or false (disable it) as follows:

greenidConfig.setOverrides({"enable_save_and_complete_later" : false});

Customising the Dun & Bradstreet Credit Header consent wording


The consent text for the Dun & Bradstreet Credit Header data source must be customised prior to going live.  By default, it looks like this, including "XXXX" placeholders:

By accepting these terms and conditions you give consent for XXXX to disclose your name, residential address and date of birth to a credit reporting agency and ask the credit reporting agency to provide an assessment of whether the personal information so provided matches (in whole or in part) personal information contained in a credit information file in the possession or control of the credit reporting agency to assist in verifying your identity for the purposes of the Anti-Money Laundering and Counter-Terrorism Act 2006. The credit reporting agency may prepare and provide XXXX with such an assessment and may use your personal information including the names, residential addresses and dates of birth contained in credit information files of you and other individuals for the purposes of preparing such an assessment. If you disagree with having your identity verified by a credit reporting agency, please select another data source or contact XXXX so that we can discuss other options with you.

If you use this data source, at a minimum you need to replace the placeholders with your company's name.  You can modify this wording as you see fit in line with your obligations under the AML/CTF legislation. 

To modify this wording, set the "dnb_tandc_text" parameter via the "greenidConfig.setOverrides()" function as above.

  • No labels