Wikka Documentation: WikkaThemes

[2147] Latest edit on 2009-11-09 10:36:40 by YanB [adding note on custom css file]

Additions:
If your wiki runs on Apache with rewrite_mode on and depending on your server configuration, you may notice a glitch with the display of themes. The kubrick theme, for one, doesn’t seem to correctly load the embedded graphics. The fix is simple: rewrite rules should be disabled in the templates folder. Simply create a file with the following content and save it as templates/.htaccess:
Note that if you changed the name of your custom CSS file, you must edit the above code manually to replace wikka.css with the name of your custom CSS file.
You can use the stylesheet_hash value to force refresh a stylesheet after upgrading:
Deletions:
f your wiki runs on Apache with rewrite_mode on and depending on your server configuration, you may notice a glitch with the display of themes. The kubrick theme, for one, doesn’t seem to correctly load the embedded graphics. The fix is simple: rewrite rules should be disabled in the templates folder. Simply create a file with the following content and save it as templates/.htaccess:
you can use the stylesheet_hash value to force refresh a stylesheet after upgrading:

[2132] Edited on 2009-09-11 17:40:53 by DarTar [link to blog post]

Additions:

Tutorial: How to design themes for Wikka

Building custom themes is easy. Each theme consists of two files called header.php and footer.php together with optional support files such as stylesheets, images, javascript libraries etc.
Deletions:
~~Building custom themes is easy. Each theme consists of two files called header.php and footer.php together with optional support files such as stylesheets, images, javascript libraries etc.~~

[2124] Edited on 2009-09-05 02:45:20 by DarTar [mod_rewrite and themes]

Additions:
The graphics called by the stylesheets of the themes should now be loaded. The same fix may be needed to be applied to plugins/templates if you are installing custom themes.
Deletions:
~~The graphics called by the stylesheets of the themes should now be loaded. The same fix may be needed to be applied to plugins/templates if you are installing custom themes.~~

[2123] Edited on 2009-09-05 02:44:49 by DarTar [mod_rewrite and themes]

Additions:

Themes and mod_rewrite

f your wiki runs on Apache with rewrite_mode on and depending on your server configuration, you may notice a glitch with the display of themes. The kubrick theme, for one, doesn’t seem to correctly load the embedded graphics. The fix is simple: rewrite rules should be disabled in the templates folder. Simply create a file with the following content and save it as templates/.htaccess:
%%(text;1;templates/.htaccess)
<ifmodule mod_rewrite.c>

# turn on rewrite engine
RewriteEngine off

</ifmodule>
The graphics called by the stylesheets of the themes should now be loaded. The same fix may be needed to be applied to plugins/templates if you are installing custom themes.

[2094] Edited on 2009-09-02 11:19:29 by DarTar [[m] wording]

Additions:
The content, structure and layout of navigation menus are controlled by menu template files and menu widgets or "menulets".
Deletions:
~~The content, structure and layout of navigation menus are controlled by menu config files and menu widgets or "menulets".~~

[2093] Edited on 2009-09-02 11:18:33 by DarTar [[m] wording]

Additions:

Kubrick

An adaptation of Wordpress' classic Kubrick theme, to facilitate the integration of a wiki with an existing blog and to showcase the flexibility of the new theme support in Wikka
Deletions:

Kubrick
An adaptation of the classic Wordpress Kubrick theme, to facilitate the integration of a wiki with an existing blog and to showcase the flexibility of the new theme support in Wikka

[2086] Edited on 2009-09-02 06:46:31 by DarTar [[m] code blocks]

Additions:
%%(php;23;wikka.config.php)
Deletions:
~~%%(php;wikka.config.php;23)~~

[2085] Edited on 2009-09-02 06:46:09 by DarTar [[m] code blocks]

Additions:

header.php (line 24)

(php;24;header.php)
Deletions:
header.php;24

(php;header.php;24)

[2078] Edited on 2009-09-02 06:16:30 by DarTar [creating custom themes]

Additions:

you can use the stylesheet_hash value to force refresh a stylesheet after upgrading:

Customizing menus and navigation bars

The content, structure and layout of navigation menus are controlled by menu config files and menu widgets or "menulets".

[2077] Edited on 2009-09-02 06:12:03 by DarTar [selecting a global theme]

Additions:
The global theme (the one that is displayed by default to anonymous users and to new registered users) can be set in the configuration file, e.g.

wikka.config.php;23

    'theme' => 'light',

The name of the theme can be any valid folder in templates or plugins/templates. Setting the name of a non-existing folder will default to light.
Registered users can override the global theme configuration by setting a theme in their preferences.
Custom themes can be installed in the plugins/ tree. Please note that, depending on the order of paths specified for wikka_template_path in the configuration file, plugin themes may override core ones. For instance, to install a custom version of the light theme, you will need to create a folder called plugins/templates/light and copy all the relevant files from the core theme folder.

The structure of a theme

templates/

..mytheme/

....css/

....img/

....js/

....footer.php

....header.php

header.php and footer.php are used to generate a wrapper around the main wiki content that is displayed in a div called <div id="content">. The default layout can be used as a reference to customize these files.
Please note that to generate full paths to specific support files (e.g. stylesheets, images etc.) in the header and footer you will need to use the GetThemePath() method:

header.php;24

    <link rel="stylesheet" type="text/css" href="<?php echo $this->GetThemePath() ?>/css/wikka.css?<?php echo $this->htmlspecialchars_ent($this->GetConfigValue('stylesheet_hash')) ?>" />

Deletions:
(stub)
(stub)

[2076] Edited on 2009-09-02 05:55:36 by DarTar [links]

Additions:
Wikka 1.2 introduces support for 100%-modular themes. It bundles 3 core themes and can be extended by installing new themes in the plugin folder.
Deletions:
~~Wikka 1.2 introduces support for 100%-modular themes. It bundles 3 core themes and can be extended by installing new themes in the plugin folder.~~

[2075] Edited on 2009-09-02 05:50:22 by DarTar [core themes]

Additions:
Wikka 1.2 introduces support for 100%-modular themes. It bundles 3 core themes and can be extended by installing new themes in the plugin folder.

Core themes

The following themes are bundled with Wikka 1.2:

Light

A new, fixed-width theme, default in 1.2

Default

A slightly revamped theme based on the classic Wikka 1.X template

Kubrick

An adaptation of the classic Wordpress Kubrick theme, to facilitate the integration of a wiki with an existing blog and to showcase the flexibility of the new theme support in Wikka

Selecting a global theme

(stub)

Installing custom themes

(stub)
Deletions:
~~The documentation for this new feature will be uploaded soon~~

[2071] Edited on 2009-09-02 03:45:13 by DarTar [stub]

Additions: