6.1Custom UI-files and file structures

Every cmsWorks server comes with a (web) service called WebUI. This service provides you with the cmsWorks editors desktop. That desktop can be customized to fullfill your needs respecting functionality and look-and-feel using JavaScript, CSS and Images.

Therefore every WebUI-folder which is located in the filesystem at <cmsWorks-installdir>/htdocs/webui has a subfolder cmsdesk.custom with another subfolder named after the customer parameter - called the customer folder resulting in:

<cmsWorks-installdir>/htdocs/webui/cmsdesk.custom/<myCustomerName>/

Withing this folder resides:

q-custom.js

The q-custom.js file provides control over functionalities of the desktop. Especially it controls the different properties of the input window of documents, configures the richtext editor, provides content scripts and external windows in the desktop environment. This is explained in the chapter found here.

q-custom.css

Fill CSS declarations here to customize the look of the richtext elements while editing content in the cmsWorks editors desktop. Either apply a style more similar to the Website to be produced or maybe apply a more generic style since well structured content enables to not only create a website but other products too.

Also optionally place a product logo at any position on the editors desktop on top of a chosen background picture for a nice branding. Examples are listed in the CSS chapter.

doctypeicons

This folder contains the icons to be assigned to document types. So in any document list in the cmsWorks editors desktop or on the window title bar this icon appears giving a hint on the document type. (The currently provided icons are 16x16px PNG files)

backgrounds

Place any selection of background pictures in any folder depth here to let the cmsWorks editors desktop user choose from. Declare the first impression or even a default background color in the q-custom.js