Theme components

A Tiki theme generally contains out of several components. as there are a .CSS stylesheet, a set of .TPL Smarty templates, icons, fonts, images etc..

As Tiki contains a full set of default templates, the minimum requirement to create a custom theme is a custom .CSS stylesheet.

Themes are deployed in the directory "themes" which is a subdirectory of the tikiroot installation directory.

Every theme has it's own directory which contains the components of the theme. The name of this directory represents the name of the theme.

Following an example of the directory structure:

• themes
  • mytheme
    • css
      • tiki.css
      • The .CSS file has to be named "tiki.css" - Tiki names the theme from the containing theme-specific folder (and not anymore from the filename, like it was in the old system).
    • fonts
      • This is the place to store your fonts which have to be provided for webmasters who do not want to use a font-API
    • icons
      • This is not in use yet, but will likely be the place for .SVG icon sets, if no glyphs will be used. Alternative glyphs might be stored here or in fonts, which is not desided yet. To be updated, please contact the Tiki artwork-list on sourceforge
    • images
      • This would be the place to deploy images for your theme for backgrounds and other purposes.
    • less
      • tiki.less
      • Maybe further .LESS files if necessary.
    • options
      • At the time of creating this wikipage (12th Sept. 2014) the old way of using options is depricated for the new system. This is to avoid loading several nested .CSS files and to avoid server side minifying on the fly. There has been a discussion to anyway allow options by adding complete tiki.css files (name optionname.css) in this options folder which could easily be created with less and then would be loaded instead of css/tiki.css . To be updated, please contact the Tiki artwork-list on sourceforge
    • templates
      • Any customised template stored in this directory overwrites the default template with the same name.

Applying your new theme

Once you created the directory structure described above, which contains at least one file named tiki.css in the folder themes/mytheme/css, you find the theme in the themes dropdown menu in Admin -> Look&Feel -> Theme.
Please mind to reload the page after you added the theme to the server and to clear the Tiki caches each time you applied a different theme (/tiki-admin_system.php?do=all).

How To Add a New Bootstrap Theme