This article explains an older method of implementing a custom skin on SmarterTools products. More recent versions of the products include a Custom CSS section which eliminates the need for custom skinning. For more information on using custom CSS with newer versions, please see the Knowledge Base.
To do custom skinning, knowledge of CSS is necessary, as is file access on the server itself. Because of the possibility of user-created errors, skinning is at your own risk. Proper backups are recommended.
First, determine a name for your skin. In this example, we will call the skin CUSTOMSKIN.
Next, under the installation folder in the MRS tree, make copies of the following folders, using the new skin name:
- MRS\App_Themes\Default -> MRS\App_Themes\CUSTOMSKIN
- MRS\MasterPages\Default -> MRS\MasterPages\CUSTOMSKIN
At this point, you should be able to switch your interface over to the new skin from within the interface. It won't look different, but it's a good starting point to ensure that you copied everything correctly.
Edit the CSS files within your custom skin. For easiest upgrades in the future, the recommendation is to make a new CSS file under App_Themes\CUSTOMSKIN\CSS\Common called “zzz.css”. That way, you can just add your own overrides to styles without worrying about finding places in the style sheet to update or tracking them between versions.
Note that skins must be recreated EVERY TIME you upgrade your product. If you do not do this, errors will occur in the web interface. To properly upgrade a custom skin, do the following:
- Make a backup of your zzz.css file (or any other files you modified)
- Install the update of the SmarterTools product
- Delete your CUSTOMSKIN folders and recopy from Default
- Copy back in your zzz.css file and make any other custom changes you had performed to specific files
To delete a skin, log into the application and change the skin selection, then delete the two CUSTOMSKIN folders. To commit the change, it may be necessary to reset the IIS application pool or the included web server.