﻿This is the Andreas09 theme for Tiki CMS (Tikiwiki). This is an adaptation of Andreas Viklund's freely released Andreas09 template (http://www.andreasviklund.com) for Tiki CMS (http://tikiwiki.org). It's been tested with Tiki 1.9.8. 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=-

!! Background color options
The background color of this theme is provided by one image -- styles/andreas09/bodybg.jpg -- which is specified by andreas09.css as the background of the body element. Six alternate images (bodybg-black.jpg, bodybg-blue.jpg, etc.) are included with the theme files and can be found in the styles/andreas09/alt-img/ directory. To change the background color, simply move the desired image to the styles/andreas09/ directory and change its name to bodybg.jpg.

There is a corresponding hover-state background image for the horizontal menu, buttons and title bar for each of the body background images -- menuhover-black.jpg, menuhover-blue.jpg, etc. Similarly one of these can be moved to the style's main image directory and renamed to menuhover.jpg to change the color used by the theme. 

!! Site Identity in this theme
The Site Identity feature for the Andreas09 theme is configured to be displayed within the colored header section of the page, not above it. This is probably the smoothest integration with the theme's design.

Turning Site Identity on, for use with this theme, makes it possible to replace the site title and subtitle text lines with a logo in the colored area, and also enables a banner in that area. These can be specified on the Site Identity admin page. To consistently center these two items -- which can be various heights -- vertically in the header space, I went retro and put them in a table. To position the logo image, banner zone, etc, more precisely, or to add other elements, or avoid using a table for layout, use the Custom Code box in the Site Identity configuration page instead of activating the logo and banner items. Here you can use specific margin heights, etc., for your particular logo image, etc.

Because the theme's tiki.tpl already contains a search box and facility for a horizontal navbar, activating these on the Site Identity admin page won't have any effect as the code was removed from the template file. The breadcrumbs code is also not implemented.

!!! Editing tiki-site_identity.tpl
If another way of handling Site Identity is preferred, the templates/andreas09/tiki-site_identity.tpl file can be edited. (This file is a much simplified version of the default tiki-site_identity.tpl.) Be aware, though, that the page background image is attached to the page body, not to the header section, and if the height of the header (Site Identity) contents is greater than 52px, the contents that follow will be pushed down the page and will no longer properly overlay the background image. (This will causes problems especially with the navbar).

To get the result shown in the default layout of Andreas09 -- the two lines of text -- but without having to edit templates/styles/andreas09, just activate Site Identity and its Custom Code, using as content something like:

<h1>First Line of Text</h1>
<h2>second line of text</h2>

!! Horizontal menu
The horizontal menu can be changed by editing the templates/styles/tiki.tpl file. If this menu needs to be changed often, a dynamic content block tag could be put in the template instead of hard-coded links.

Or a PHP Layers menu can be used in this space by uncommenting the tag in tiki.tpl, specifying the menu id to be used, and commenting out or deleting the other menu code in tiki.tpl.

!!! Horizontal menu space on error page
The error page (such as for 404 page-not-found errors) also shows the header and horizontal menu sections (tiki.tpl and error.tpl are identical except for the center-middle section of the page). To have the horizontal menu links display on the error page, error.tpl will also have to be edited. But if the links are not needed there especially, by default the error page will just repeat the error message in that space, so no editing of the file is necessary. If the horizontal links, etc. are wanted on that page, edit error.tpl the same way tiki.tpl was edited (or copy and paste the tiki.tpl customization into the same section of error.tpl).

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

-=About the module template files=-
The files in Andreas09's templates/modules/ directory aren't specifically styled for this theme, but have been modified in these ways:
* The parentheses character has been removed from the item list style (for last comments, top objects, etc.), so 1) is just 1, followed by a space. This is for a cleaner appearance.
* Tables have been replaced by divs and spans. This may cause slight visual changes from Tiki's default styles.
* Some additional text styling is used in a few cases.
These module files could be used with any theme, if the above changes are desired.

-=Printing=-
Print styling is provided for wiki pages, articles, and blog posts, specified by the styles/andreas09/print.css file. The page will be printed as set by the CSS files, not necessarily as they are displayed by tiki-print.php, etc. 

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.

The Site Identity header is specified not to display on printed pages. This can be changed by editing 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.

Andreas Viklund, the designer of the original Andreas09 template, kindly requests (not requires) that he be given credit for the design by means of a link to his web site be displayed in the footer of the page.