Creating a Theme

Themes reside in the system/themes folder of the installation, each theme is placed into its own folder.

Themes can be built around any CSS framework but currently clearFusionCMS understands Bootstrap 3, Foundation 5 and fusionCSS 2, when creating a theme a small .ini file is created that describes the theme.

Themes can replace any system defined chunks, e.g. those used for formatting the shop, it just requires the a .html file be created of the same name as the chunk being replaced.

Theme .ini

A .ini of the same name as your theme is required in the theme folder, e.g. if your theme is called example then the description file will be system/themes/example/example.ini

[theme]
name = Example Bootstrap 3 Theme
version = 1.0.0
description = Bootstrap 3 example theme
cssframework = bootstrap3
templates[] = index
templates[] = inner

[manager]
name = Example Manager Theme

There are two sections defined, the [theme] section defines a public facing website theme, while the [manager] section defines a theme for the CMS manager. If the theme only provides templates for public or manager use then then unused section can be omitted.  

name A human readable name for the theme.
version The version of the theme.
description A human readable description of the theme.
cssframework

The CSS framework being used by the theme, this can be one of:

  • bootstrap3
  • foundation5
  • or omitted for fusionCSS / other CSS framework.
Only required in the [theme] section.
templates[]

Each template supplied by the theme is named by a templates line, you can add as many templates as you require.

Only required in the [theme] section.

Templates

Templates are simply .html files placed within the theme folder, they have no special requirement. You should also place the CSS, images and CSS framework within the theme folder.

When creating a manager theme, the templates from system/app/chunks should be copied to the theme folder and then customised, where a template is missing from the theme it will be loaded from system/app/chunks. 

Packaging Themes

Simply ZIPing up the theme folder allows you to distribute the theme to other people, they can upload the ZIP file through the Set Theme option on the dashboard. During upload the theme is unpacked ready for use.




TOP