How to White-Label the Application and Change Theme and Branding

Theme and Language

Theme

A theme is the application’s color scheme. By default, the GetCertified default theme is applied, but you can create new themes that match your branding.

On the theme tab, you can:

1. View the list of already created themes. The Default column shows which theme is set as the default theme. The Active column displays themes marked as active. The System column identifies system themes that are always present in the application and cannot be deleted.
2. Create a new theme.
3. Apply one of the already created themes.
4. Edit an existing theme.
5. Delete a theme.

To create a new theme:

1. Enter the Name of a new theme.
2. Select the Set as default option if you want the currently selected theme to become the default theme applied when users log in to the application. Note that only one theme can be set as default at a time. If another theme was previously set as default, enabling this option on another theme will turn off the default setting on the previous theme.
   Note: To set a theme as the default, it must also be marked as Active.
3. Set the theme as Active, and it will appear in the list of themes on the user’s profile, allowing them to choose it for their profile. The default theme is applied if no other theme is selected in the user’s profile. If the theme is not set as Active, it will not be displayed on the user’s profile.
4. Adjust theme colors.
5. Select between detailed 3D icons or simple flat icons.
6. You can adjust the font size by dragging the circle to the right if needed.
7. Save the new theme using one of the following options:
   • Create
   • Save as new

In YouTestMe, you can use the existing Glass theme or create your own Glass theme, giving your interface a fully personalized look and feel. Whether you prefer sleek minimalism, sophisticated transparency effects, or a completely unique combination of colors and styles, our customization tools allow every interface to reflect your individual style and preferences.

To use an existing Glass Theme, click on the pen icon next to its name and:

1. Make sure the theme is set as Active and Default.
2. Click Save to apply your changes.

To create your own Glass theme, click on the Create new button:

To create and customize a theme, follow these steps:

1. Enter a name for your theme.
2. Enable all options as illustrated in the image below to ensure the theme is Active, Default, and Glass.
3. Select or update the background image.
4. Adjust the brightness of the chosen background to your preference.

After that, you can further customize your theme by:

1. Selecting the theme’s primary color.
2. Adjusting the primary color’s transparency.
3. Choosing a secondary color.
4. Adjusting the secondary color’s transparency.
5. Setting the font size according to your preference.
6. Saving the theme by clicking the Create button.

After that, your theme is ready and will be applied to all users of the application.

Candidate’s Perspective

Additionally, another way to change the color is by choosing between RGB, HSL, or HEX formats and selecting their respective option names.

White labeling

On the White Labeling tab, you can customize the login page text, the privacy policy display, links, system naming, and more.

The following options are available:

1. Web browser’s tab title – Modify the application name in the web browser’s tab title, right beside the favicon.
2. Confirmation label – Modify the acknowledgment text presented on the instructions screen before the test begins. Additionally, this text can be customized for each test separately under the Test instructions dialog settings. To include an acknowledgment checkbox for candidates, make sure to enable the Require instructions acknowledgment option.
   Note: Changing the application language will result in the translation of the default text. However, modifying the default text itself will not be translated when altering the application language.
3. Emails sent from – The name entered here will be presented as the sender’s name in the email body, replacing the $from$ parameter.
4. Application link – The URL entered here will be used to generate necessary links for email notifications. The YouTestMe team will update this link if you have configured a custom application domain. This ensures that the email links will be presented using the new custom domain.
5. Login instructions – Provide detailed guidelines or include useful links for users to be displayed on the login screen.
6. Display privacy policy – Enable this option and a privacy policy link will be displayed on the user registration page.
7. Privacy policy link – Enter your custom privacy policy link instead of the default one.
8. Display personal report animation – Show/Hide animation on the left side of the candidate’s personal report page

Logo and favicon

On this tab, you can change the application’s logo and favicon.

1. Click the Change logo button to upload a logo representing your company or organization. The recommended image size is 270 x 69 pixels.
2. Click Reset to default to restore the application logo to the default one.
3. Click the Change favicon button to replace the favicon displayed in the web browser’s tab title.
4. Click Reset to default to restore the favicon to its default setting.

Note: Changes become visible the next time you log in. To see them immediately, log out of the application. The new logo is displayed on the login page.

For more information, please watch this video.

Language settings

To set up the desired language, do the following:

1. Go to the System/System and customization/Theme and language/Language settings tab.
2. Check the checkbox Enable additional languages.
3. Enable/disable the test language.
4. Enable/disable interface language.
5. Click on the Confirm button.

Language bundles settings

Users can customize the application interface text in the Language bundles tab to meet their needs, change label names, create new hints, and modify notification content.

A language bundle is a file containing key/value pairs. Each property is connected to one or more UI components via a property key.

Note: It is impossible to delete default language bundles, but you can create new ones based on them. You also cannot have two active bundles of the same type.

There are two ways to create a custom language bundle:

1. Changing the language bundle by editing one-by-one property values.
2. Download the language bundle, edit the file offline using your preferred text editor, and import it into the application.

Note: The keys must not be changed. Otherwise, the changes will not be visible.

To create a new language bundle by editing one-by-one property values:

1. Click the pencil icon in the Actions column for the language bundle you want to create a new one from.
2. Search for the property value or key you want to change.
3. To identify the language bundle file containing a specific text, use the Activate Preview Keys Mode button. Once activated, the interface displays text keys instead of their corresponding text, allowing you to identify the relevant key and locate it in the language bundle where it is stored.

3. Edit the text.
4. Confirm or discard the changes you made in the property value field.

Country Settings

You can manage the countries available in the application, including those used for Dynamic Tax configuration, by navigating to Country Settings. In the table, you’ll find:

1. Country Code – The standardized code for each country.
2. Country Name – The full name of the country.
3. Enabled Status – Indicates if a country is active. Disabled countries won’t appear in the Dynamic Tax list when adding a new tax.

Translation Settings

The Translation settings feature lets authorized users integrate the application with Google Translate so that questions and tests can be translated on demand. Once enabled and configured with a valid API key, translations are available without manually recreating content in other languages.

Important: Google Translate is a third-party service. When you enable this feature, a consent notice is displayed. Review it carefully before entering your API key, as content sent for translation is processed by Google.

1. Enable Translation. Turn on the Enable Translation toggle. A consent notice about the use of a third-party service (Google) will be displayed. Accept it to continue.
2. Enter the API key. In the API key configuration section, paste your Google Translate API key into the Google Translate API key field.
3. Verify the key. Click Check key validity to confirm the key works. If it is valid, translation is ready to use. If not, re-check the key and try again.

Message Templates

Message templates let you define reusable instructions for testing sessions and exams. Instead of retyping the same instructions every time you create a session, you create a template once and apply it to any exam. You can also set default templates so the right instructions are applied automatically.

1. Self-enrollment sessions. In Default instructions for self-enrollment sessions, select the template to be used by default for sessions where candidates enroll themselves.
2. Manually assigned candidates. In Default session instructions for manually assigned candidates, select the template to be used by default when candidates are assigned by an administrator.
3. Create a template. Click Create new in the Message templates section, then enter the template’s name, description, and instructions, and save it.
4. Edit or delete a template. In the Actions column, click the pencil icon to edit a template or the trash icon to delete it.