﻿This is the Zuka theme for Tiki CMS (Tikiwiki). It's been tested with Tiki 1.9.6. Maintained by Gary Cunningham-Lee (chibaguy). For the latest information on and updates of this theme for TikiCMS, visit http://themes.tikiwiki.org or http://zukakakina.com. This theme is released under the GNU/LGPL License.

This readme describes things to be aware of and do BEFORE installing/selecting this theme at your site, how to install the theme, and license information.

-=Before Installing/Selecting this theme=-

* Site Identity feature

This theme is compatible with Tiki's Site Identity feature, and the "Module Controls" can also be used. 

* Menus

This theme's templates don't contain any PHP Layers menus tags by default. A PHP Layers menu can be used in a module, as configured on the site admin's Admin Modules and Admin Menus pages, or can be added to Site Identity custom code. In the case of a horizontal type menu, be careful not to have too many section items, so the menu won't stretch the page too wide.

This theme doesn't implement the Site Identity option to use menu id=42 because that makes a menu that is too wide for normal page views. 

-=Site logo image=-

To work smoothly with the theme (without editing tiki.tpl) the logo image must be named logo.jpg. For the "tab" to be half the height of the logo, the logo should be 57px high. Various image heights and widths is possible but if too wide or tall, other content may be overlapped.  If another logo image  name or file type, such as .png or .gif, is used, edit templates/styles/tiki.tpl accordingly. 

If the height of the logo image is not 57px, there may be display problems because the left and right borders of the logo image "tab" are made to work with a logo image of that height. 

Alternatively, using text for the site title should work (by editing templates/zuka/tiki.tpl), and should fit within the graphics if an appropriate font size is used, but that hasn't been tested.

-=About the left and right columns=-
The Zuka theme is designed to use Tiki's left and right columns normally, and specifies margins for the page and columns in each column configuration. The "column flipping" code for column displays as configured on Admin > Features page is not implemented, however, because the feature isn't fully functional.

-=Installation=-
Copy or upload zuka.css and the zuka/ images directory to the styles/ directory of your Tiki site.
Copy or upload the zuka templates directory to the templates/styles/ directory of your Tiki site.
Select "zuka.css" as the site default theme on the Admin > General page, or assign it to objects, categories, etc. with the Theme Control feature.

-=Printing=-
Print styling is provided for wiki pages, articles, and blog posts, specified by the styles/zuka/zuka-print.css file. 

The php file for printing articles is a little out of date, so the top line, subtitle, and source items will not show up on printed pages. This should be corrected in an upcoming Tiki release.

Printed pages are specified to display logo.jpg at the top. (This is an image in the page content itself and not a background image, and so will continue to appear if "show background images"is turned off  when printing.) If you prefer not to have the site logo displayed on printed pages, or are using a file named something other than "logo.jpg," or want a text header of some kind instead, edit templates/zuka/tiki-print.tpl, /tiki-print_article.tpl, and /tiki-print_blog_post.tpl accordingly.

The Site Identity header is specified not to display on printed pages. This can be changed by editing zuka-print.css.

-=License/copying=-

This theme and is offered under the LGPL license. This is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation.

This software is distributed in the hope that it will be useful, but without any warranty, without even the implied warranty of merchantability or fitness for a particular purpose. See the GNU Lesser General Public License (http://www.gnu.org/copyleft/lesser.txt) for more details.