Converting standard Smartframe templates to Newlook 11

This guide is intended to assist those users who would like to convert existing Smartframe templates that are based on the default templates installed with Newlook 10.7.

Newlook 11 includes new Smartframe templates that take advantage of many of the features supported in modern browsers. They are designed to be flexible and easy to use. Where practical, we recommend using one of the new v11 Smartframe templates, instead of upgrading your existing templates. Be aware that the new Smartframe templates in version 11 are not backwards compatible, they can only be used in v11 onwards.

However, if you would like to retain your existing template, this guide identifies some of the common items that will need to be updated to get it working in version 11.

Key differences to note between Newlook 11 templates and older templates

In previous versions of Newlook (version 10 and below), the top-level Smartframe container was an MS Internet Explorer browser window, containing a HTML page. This HTML page instantiated a Newlook Active X control.

From Newlook 11.0 onwards, the top-level Smartframe container is no longer an IE browser window. It is now a stand-alone executable, looksoftware.SmartFrame.exe, which contains it's own Chromium-based browser, used to render and execute the specified Smartframe template's HTML, CSS and Javascript files. The Newlook Active X control has been replaced with the Smartframe Newlook Control, which interacts with the HTML page, based on the properties specified in the newlook object tag, within the parent HTML. There is no need to have any browser installed on your end user machines, Smartframe will run on a clean Windows environment.

BE AWARE:

It is no longer possible to start Smartframe by opening a HTML or HTA file containing the Newlook object. To start Smartframe you will now need to configure the Smartframe URL for your solution (in General Settings), then run the executable looksoftware.SmartFrame.exe, pointing to your solution. For end users, shortcuts can be configured during the deployment process, however for administrators and developers, you can start Smartframe from the executable shortcut or via the Smartframe preview button in Developer (which will automatically load the current solution).

PLEASE NOTE:

Not all legacy Smartframe functionality is supported in Newlook 11. If you have Smartframe templates that have been heavily customized (for example portal-style templates), then this guide will not be applicable and we recommend that you contact the Fresche support team at [email protected] for advice about your migration options.

IMPORTANT

Don't forget to back up your template files before attempting to convert them!

Assumptions:

The following guide assumes that you have a template that is based on the Samples/BrowserTemplates/SmartFrame template that shipped with Newlook version 10.5 or earlier. Any template based on the Samples/BrowserTemplates/SmartFrame template that was included in the Newlook 10.6 or 10.7 install should be compatible with version 11.0 (although you will need to open Smartframe.htm instead of Smartframe.hta).

The legacy Smartframe template consists of the following files:


Files


© 2004-2021 looksoftware. All rights reserved.