Customize WMT Theme

This feature enables organizations to brand their Where is My Technician tracking page by using a configurable domain name. Instead of the default Oracle-generated URL, customers receive a link that reflects the company’s domain, improving brand consistency and trust. The setup involves configuring the WMT theme with a configurable domain and preparing the HTTPS web server to route requests appropriately.

Here's how you can customize the WMT theme:

  1. Go to Configuration > Themes.
  2. In the Where is My Technician section, click Edit on the Actions icon for the Where is My Technician theme of your choice.
  3. To add branding to the theme, click Branding and complete these fields:
    Field Name Action or Description
    Theme description Enter a description for the theme that helps you identify its purpose.
    Template Select the template that you want to use from Bright, Hero, and Minimal templates. Notice that the Scheduled, Days before, On the way, Arrived, and Feedback pages refresh with each detail that you add to the theme.
    Main color Click the hexadecimal number and select a color of your choice. Depending on the template you select, the Main color applies to the elements on the page and some text that must be highlighted. Some text is inverted based on the background color and the placement of the text. If the background is dark then the text can be white, if the background is light colored, then the text is black.
    Background color Click the hexadecimal number and select a color of your choice. This is the background color of the page. Your customers may access this page from their mobile phones and the screen width is limited, so choose the colors carefully. If you've selected the Hero template, then the Background picture field becomes available and you can upload a custom picture.
    Company logo Click Browse and select a file with the extension JPEG, PNG, GIF, TIFF, or SVG. You can select a file of maximum size 100 KB. This logo is displayed at the top of the page.
    Company favicon Click Browse and select a file with the extension ICO or PNG. You can select a file of maximum size 30 KB. This small icon is displayed on the web page header. It is typically a smaller image of your organization or product logo.

    You can configure the browser tab name in the Company field on the Localization tab. It will be shown next to the favicon.

    Configurable domain name Enter the domain name that you want to use in the Where is My Technician URL. For example, https://wmt.example.com/k694jg. Here, k694g is the unique token.
    Note: If the configurable domain name field is empty, then the Where is My Technician URL can't be opened in an iFrame. For more information, refer to the steps below.

    1. Add a domain name for the Where is My Technician theme.
      1. Click Configuration > Themes.
      2. Click the menu and then click Edit for the theme in which you want to add the custom domain.
      3. Click Branding.
      4. In the Domain Name field, type the name that you want to display in the Where is My Technician URL.
        For example, type <https://wmt.example.com/k694jg>, where <wmt.example.com> is the domain and <k694jg> is a unique token.
        Note: If the Custom domain name field is empty, then the Where is My Technician URL cannot be opened in an iFrame.
    2. Configure the HTTPS web server with a proxy page.
      1. Configure your web server to route all the requests to the index page.
      2. Add the index.html page to the root of the web server.
        For more information on an example of NGINX configuration, see Example of NGINX Configuration and for information on how to open the Where is My Technician URL with a custom domain in an iFrame, see How you can open a Where is My Technician URL with a Customer Domain in IFRAME. This flowchart shows how a custom domain is opened in an iFrame:
        This flowchart shows how a custom domain is opened in an iFrame.