Home

Download this help site
(PDF 80MB)

Download

Customizing theme elements

This functionality is only intended for experienced web designers

Icon

Please read this page before you proceed: Advanced customization warning
Theme override is intended for people with advanced web design skills. Incorrect use may result in your website malfunctioning.
Note: our technical support team does not provide support related to theme overrides.

Theme overrides involve replacing or overriding theme files – the files that control the appearance and behavior of your current theme. For an overview of theme file structure, see below. For instructions on customizing specific theme elements, follow the links on the right.

Theme file structure

Theme files for all themes use the following folder structure. For information on how you can customize the theme files stored in these folders, click one of the links under For more information below.

Folder/File

Description

For more information, see...

ArtTextTemplates

Folder containing ArtText style files.

Customizing ArtText styles in themes

CMS

Folder containing files that define wrapper templates for the basic minimal building blocks for themes – custom layouts, layouts, placeholders, gadgets. Please do not modify these without deep understanding of what you are doing – it might lead to editing issues.

Customizing theme controls

Controls

Folder containing files that define the appearance and behavior of various controls, including Captcha, Divs, Form, FormHelpers, MessageBox, and StyledWrapers. Please do not modify these without deep understanding of what you are doing.

Customizing theme controls

Gadgets

Folder containing files defining the appearance and behavior of gadgets. To add new gadget to the system, you need to create a new folder within the Gadgets folder.

Customizing theme gadgets

BackgroundImages

Folder containing image and configuration files for theme backgrounds.

Customizing theme background options

Images

Folder containing images for the theme, including all the icons and images used on the sample pages (e.g. DefaultLogo.png).

 

MasterLayouts

Folder containing the master layouts for the theme.

Customizing master layouts

PointAndClickSettings

Folder containing files defining the options and default values appearing on the Colors and Styles screen.

Customizing Colors and Styles options for themes

Scripts

Folder containing JavaScript files that are added to the PageModel.Scripts collection, which is referenced in Head.tpl and iterated in Links.tpl.

CSS, LESS, and JavaScript processing

Styles

Folder containing CSS and/or Less files defining the theme's HTML styles.

CSS, LESS, and JavaScript processing

SystemContentTemplates

Folder containing dummy  template placeholders for gadgets without valid HTML templates. Please do not modify these without deep understanding of what you are doing.

 

__SystemConfig.cfg

Stores the themeset name which current theme belongs to. Do not modify this file when customizing an existing theme.

Customizing other aspects of the theme

Colors.cfg

List of colors used in or compatible with the theme. These colors appear at top of the color window when setting text or background colors.

Customizing other aspects of the theme

DividerStyles.cfg

List of dividers for the theme.

Customizing other aspects of the theme

FontStyles.cfg

List of text styles that are available from the content editor.

Customizing other aspects of the theme

FormatStyles.cfg

List of paragraph styles that are available from the content editor.

Customizing other aspects of the theme

GadgetStyles.cfg

List of gadget styles. Does not apply to system gadgets or singular gadgets. If you want to add special styles or different set of styles for a specific gadget, you can add your own GadgetStyles.cfg to the appropriate gadget folder (within the Gadgets folder).

Customizing gadget styles in themes

Head.tpl

Common template called by MainTemplate.tpl.

Theme and page generation process

Links.tpl

Iterator template called from Head.tpl to process a collection of elements (e.g. a list of menu items).

Theme and page generation process

LinkStyles.cfgButton styles for links. 

MainConfig.cfg

Main configuration file. Do not modify this file when customizing an existing theme.

Customizing main theme parameters

MainTemplate.tpl

Main theme template, and your site page's main entry point.

Theme and page generation process

preview.jpg

Theme preview image (348 x 312 pixels) appearing on theme selection screen. Its name can be changed in MainConfig.cfg.

Customizing main theme parameters

preview_thumb.jpg

Theme preview thumbnail (103 x 92 pixels) appearing on theme selection screen. Its name can be changed in MainConfig.cfg.

Customizing main theme parameters

  • No labels
 
Wild Apricot Inc. 144 Front Street West Suite 725, Toronto, Ontario, Canada M5J 2L7