History: How To Add a New Theme
Source of version: 7
Copy to clipboard
{REMARKSBOX(type="info" title="Self contained Bootstrap themes from Tiki14")}
In Tiki13 we integrated the 'Twitter Bootstrap' framework as base of Tiki's design.
From Tiki14 (trunk pre-14 as of 12th of Sept 2014) the new directory structure described on this page applies for themes.
''For Tiki12 LTS please visit ((How To Add a New Theme - until Tiki12))''{REMARKSBOX}
! 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:
* {img src=https://themes.tiki.org/show_image.php?id=59} themes
** {img src=https://themes.tiki.org/show_image.php?id=59} mytheme
*** {img src=https://themes.tiki.org/show_image.php?id=59} 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).
*** {img src=https://themes.tiki.org/show_image.php?id=59} 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
*** {img src=https://themes.tiki.org/show_image.php?id=59} 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 [https://lists.sourceforge.net/mailman/listinfo/tikiwiki-artwork| Tiki artwork-list on sourceforge]
*** {img src=https://themes.tiki.org/show_image.php?id=59} images
**** This would be the place to deploy images for your theme for backgrounds and other purposes.
*** {img src=https://themes.tiki.org/show_image.php?id=59} less
**** tiki.less
**** Maybe further .LESS files if necessary.
*** {img src=https://themes.tiki.org/show_image.php?id=59} 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 [https://lists.sourceforge.net/mailman/listinfo/tikiwiki-artwork| Tiki artwork-list on sourceforge]
*** {img src=https://themes.tiki.org/show_image.php?id=59} templates
**** Any customised template stored in this directory overwrites the default template with the same name.
{REMARKSBOX(type="info" title="hint")}In Tiki pre-14 trunk, the old structure ''"styles/mytheme.css - styles/mytheme/*" - "templates/styles/mytheme"'' is still working, but might become depricated before the release of Tiki14 or Tiki15 ... in case of questions please contact the Tiki artwork-list on sourceforge:
[https://lists.sourceforge.net/mailman/listinfo/tikiwiki-artwork] {REMARKSBOX}
! 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)''.
-=Alias=-
(alias(How To Add a New Bootstrap Theme))