Prism Custom HTML Files

Prism enables retailers to customize the UI and workflow via customizations. For example, retailers can incorporate company logos or a coloring scheme that matches the company's colors. Retailers can also add buttons or other custom UI elements that trigger customizations when clicked. This document provides information about a new Prism feature that leaves custom .html pages unchanged when installing a Prism update. Previously, installing a Prism update would overwrite custom .html pages, resulting in an adverse impact on customizations.
To make use of this feature, retailers will have to manually create a \customizations folder at each workstation that uses the customization and copy the specific .html files used by the customization to that folder.  When installing a Prism update, any file that is in the \customizations folder with the same directory structure and file name of the Prism default .html file will be served in lieu of the default file.
Example: WebClient\customizations\views\default\customer-history.htm

When it is time to load the customer-history.htm file, Prism will use the copy in the \customizations folder instead of the copy in the views\default folder.
This document assumes that you already have a customization and know which .html files in the \views\default folder are used by the customization. For information about creating and registering a customization, see the Prism Admin Console Guide document.

The following instructions apply to a new install of Prism.

1. Create a \customizations folder at each workstation
2. Open Windows Explorer and navigate to the \WebClient folder.    
3. Open Windows Explorer and create a new folder called \customizations in the \WebClient folder.    
4. Copy the specific .html file from the \views\default folder that you want to modify. Paste the copy to the \customizations folder. Do not change the file name. Modify the custom .html file as needed for your customization.   
5. Install the next Prism update as an "over-the-top" installation. The update will leave the files in the \customizations folder. After the update, you can launch Prism and see that your custom .html file is still being loaded from the \customizations folder (instead of the default version that was installed by the update).     

About the Prism Default Views

The \WebClient\views\default folder has a number of individual .html files. Each file is used in a specific area of the program. It is beyond the scope of this document to explain the use of each of these files.  If your customization uses a certain .html file and you want to make sure that the file is left unchanged during Prism updates, simply copy that file to the \WebClient\customizations folder. It is important that the copy in the \customizations folder has the same name as the file in the WebClient\views\default folder. Note: The files in the \views\default folder have an .htm extension .htm is used as an alternate to .html for some operating systems and servers that do not accept four-letter extensions.