You are here: Help Topics > Practice > Templates > Customize the Template toolbar

Customize the Template toolbar

Template authors can customize the Template toolbar for users working in the template. You can add custom commands that link to scripts or URLs.

To customize the Template toolbar:

  1. Open the template in Template Design mode.
  2. On the ribbon, click Tools | Template Toolbar.
  3. To add a new command, start a new line and complete the following properties:

    Column Description
    Id

    Enter a unique identifier for the command containing up to 20 alphanumeric characters. The identifier is not visible to template users.

    Icon Attach (or copy and paste) an optional image icon for the command.
    Text

    Enter a name for the command. The name is visible to template users.

    Description

    Enter a description containing up to 60 alphanumeric characters to display as the tooltip for the command.

    Click ... to enter an extended description. Adding an extended description will overwrite the standard description text in the tooltip.

    Script Enter a script beginning with the OnClick() function to run when a user clicks on the command.
    Script File

    Enter an existing script file (.JS, .VBS, .CSP) by entering the file name. By default, the script file should be in the local client file folder, however you can call a script from the Working Papers program directory using the syntax: program/{script file name}

    URL

    Enter a cw:protocol URL to launch in Working Papers, or an external URL to launch in the Working Papers internal browser.

The command is added to the Template toolbar. You can view the customized toolbar to test the new command from View | Show | Template.

Notes:

  • When clicked, commands with multiple scripts or links activate in the following order:
    1. Script
    2. Script File
    3. URL
  • To display the Template toolbar by default, enter the following command into the browser address field: cw:templatetoolbar?visible=show. To hide the Template toolbar by default, enter: cw:templatetoolbar?visible=hide.