9.3. Customising the default theme

It is likely that some users will use ProsePoint with the default theme (as of writing, this is tma2), but with some modifications. Users should not edit files which are part of the default theme. Their changes will be lost when these files are overwritten by future ProsePoint upgrades.

Instead, there are two ways of safely making customisations to the default theme. The first is to make a higher priority copy of the theme and customise the copy. The second is to create a subtheme of the default theme and customise the subtheme.

9.3.1. Customising a copy of the default theme

  • Make a copy of the default theme and place it under sites/default/themes.
  • Visit Administer => Site building => Themes with your web browser.

    Visiting this page will prompt ProsePoint to rescan the file system for themes.

  • Make any desired customisations to this copy of the theme. You should change the version number to distinguish your copy from the original theme.

Themes found under sites/default/themes have a higher priority than those found under profiles/prosepoint/themes. Your copy of the theme (with your customisations) will be used by ProsePoint in preference to the original theme.

9.3.2. Customising a subtheme

Users can create a subtheme which inherits the behaviour of the default theme, and then make their own customisations. This has the following advantages:

  • It is simpler as the developer only needs to implement theme changes - Much can be achieved by just a few CSS declarations.
  • Any improvements to the parent theme in future versions of ProsePoint will also apply to the subtheme.

The subtheme should be placed under sites/all/themes or sites/default/themes.

For detailed information on creating subthemes, please see the Drupal 6 Theme guide and the Zen theme documentation.

9.3.2.1. Example customised subtheme

Instead of creating a subtheme from scratch, developers may prefer to download a sample subtheme and work from there.