Skip to main content

Find where to edit

In order to customize the Legacy portion of the user interface, you can compile a skin in debug mode to help you find the lines of code (text, M4 macros, HTML snippets) that you want to edit.

Note

Debug mode only displays tags in the Legacy portion of the skin.

Debug skins should not be used in production. Debug skins generally have a network payload 5x greater than optimized production skins, and the code itself is not optimized. Angular also runs slower with more checks in development mode to help developers find errors.

A "Development mode" badge appears on the screen when the skin is built in debug mode.

To compile a skin in debug mode and find lines to edit:

  1. In the \<instance>\design\ directory, run the following commands to regenerate the skins in debug mode for the default skin:

    make.bat debug default en-us
make.bat install default en-us

    The M4 tag names are now included as comments in the HTML source of each Bravura Security Fabric web page.

  2. Log into Bravura Security Fabric and navigate to a web page that you want to customize.

  3. Use the "Inspect element" or an equivalent option in your web browser to see the current HTML source.

    "View page source" or an equivalent option cannot be used as it will not show the relevant HTML code and debug comments.

  4. Search for comments embedded in the HTML to find the text you want to modify.

  5. Open the file in the \<instance>\design\src\ directory relating to the web page you want to customize.

    For example, open psf.m4 in src\z\ if to find code that applies to the Front-end (psf). Or, open header.m4 in src\common\ to find page header code that applies to all pages.

    Open authchain.m4 in src\common\ to find code for authentication chains. See Authentication chains: Plugins for more information for authchain.m4 modifications.

    Some m4 files have tag names; if tag names are present in the file, then determine the tag name located above the matching text. Tag names are prefixed with three exclamation points; for example, !!!F_LOGIN .

  6. Locate the tag in the m4 or KVG file that matches the HTML code you saw in the web browser.

    Warning

    Do not make changes directly in the files in src\z\. These files will be replaced during upgrades. See Change the layout to learn how to make changes in custom files.

    To turn off debug mode, generate and install the skins without the debug argument.

In this section: