Themes

From Habari Project

Currently, Habari supports two theme engines, the rawphpengine, which uses regular PHP for control and output, and the Hi Engine, which uses simple custom tags for output. Eventually, it may support additional engines (such as Smarty and PHPTAL).

A modified version of the popular K2 theme currently comes as the default theme upon installation, however, the goal is to offer several themes with the download. A few publicly available themes are currently available, with many more on the horizon.

Installation

Included themes are installed in system/themes. This allows for upgrading without touching the /user directory at all. If you would like to use a system theme, but make modifications, you can copy all of the files and directories into user/themes. The user/themes/k2 would override the system/k2. Again, this allows for upgrading, and any changes to the distributed version K2 not over write your modified version. You could then migrate any changes to your user copy.

Additional themes can be uploaded to your /user/themes directory. Themes must include a theme.xml file in order to be activated in /admin/themes. See Creating a Custom Theme for details about this file, and about how to create your own themes.

Additional Information about themes and customization:

• Creating a Custom Theme

• Template File Hierarchy

• Customizing Theme Behavior

• Using Excerpts

• Show Recent Comments

• Asides

• Show Pingbacks

• Alternate Comment Rows

• Template Tags