Loading...
 
Skip to main content

History: How To Add a New Theme

Source of version: 4

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
*** {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 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 neste .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 create 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 store 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}



-=Alias=-
(alias(How To Add a New Bootstrap Theme))
        

History

Advanced
Information Version
Mon 24 of Jan, 2022 11:53 GMT-0000 Gary Cunningham-Lee Small corrections. 16
Mon 24 of Jan, 2022 11:45 GMT-0000 Gary Cunningham-Lee 15
Mon 24 of Jan, 2022 11:44 GMT-0000 Gary Cunningham-Lee Removed ancient info and adjusted heading sizes. 14
Mon 24 of Jan, 2022 11:43 GMT-0000 Gary Cunningham-Lee Replaced missing images with icon plugin. Updated text. 13
Mon 11 of Feb, 2019 12:43 GMT-0000 Serge Kishiko Add the js folder in the default theme layout and the explanation of its purpose 12
Thu 28 of Jan, 2016 10:28 GMT-0000 Gary Cunningham-Lee Gave the folder images the responsive=n parameter so they will be inline. Minor text clarifications. The page seems to have some duplicate information compared to at least one other page. 11
Thu 28 of Jan, 2016 00:18 GMT-0000 Jean-Marc Libs 10
Sun 25 of Jan, 2015 13:23 GMT-0000 gezza update to recent changes in the theme concept 9
Sat 13 of Sep, 2014 13:01 GMT-0000 Gary Cunningham-Lee Corrected info about LESS files and minor editing. 8
Fri 12 of Sep, 2014 20:55 GMT-0000 Torsten Fabricius Apllying your new theme 7
Fri 12 of Sep, 2014 20:36 GMT-0000 Torsten Fabricius found more typos ... sorry 6
Fri 12 of Sep, 2014 20:32 GMT-0000 Torsten Fabricius typo 5
Fri 12 of Sep, 2014 20:31 GMT-0000 Torsten Fabricius typos and added minor hints 4
Fri 12 of Sep, 2014 20:29 GMT-0000 Torsten Fabricius adde basic information about the themes directory structure 3
Fri 12 of Sep, 2014 19:40 GMT-0000 Torsten Fabricius closing tag of remarksbox was missing 2
Fri 12 of Sep, 2014 19:39 GMT-0000 Torsten Fabricius created page with remarksbox and alias 1