Location: PHPKode > projects > VaMoLà - Validator > vamola-validator/themes/themes_readme.txt

      ATutor Themes Documentation


In this file:

	- Introduction

	- Installing a New Theme

	- File & Directory Structure

	- Theme Configuration File

	- Creating a Theme




An ATutor theme is a set of template files with images and a stylesheet that 

change the overall look and feel of an ATutor installation. An installation 

may have one or more themes installed at one time; a user is given the ability 

of selecting a single theme to be used while they are logged-in.

This document briefly explains the structure of an individual theme directory.


Installing a New Theme


Access the Themes area of the Administration section.


File & Directory Sturcture


All themes go in /themes/.

All theme specific files are in /themes/[theme_name]/, where 

`[theme_name]` is the directory name of the theme. The `theme_name` need not be

the exact name of the theme (ie. a theme named `Blueberry Cheesecake` may exist

in a directory called `bb_cc`). The actual name of the theme is specified

in that theme's configuration file.

The theme may be renamed however, if another theme by the same name already exists.

The files below are in the theme directory:

  - theme_info.xml             - The configuration file (see "Theme Configuration File" below)

  - screenshot.jpg             - 200x125 pixel screenshot of the theme

Any additional files or images may be placed in sub-directories. 

Example: /[theme_name]/images/ may be used for theme specific images.


Theme Configuration File - theme_info.xml


Each theme has a configuration file that must exist and must be named 'theme_info.xml' .

If the theme_info.xml file cannot be found in the theme's directory then the theme will

not be made available to use. The fields in the theme_info.xml file are documented in the 

file; they describe such things as the name of the theme, its author, and the default

course banner style.


Creating a Theme


The best way to start your own theme is by exporting one of the themes displayed on the Theme Manager.

The theme is exported onto your desktop as a '.zip' file.

You must extract the contents of this file in order to change them.

You should then edit the theme_info.xml file to give it a name.

Once those changes are made you should zip the files and import them using the import theme function.

The name of the zip file should be the name you want to give your theme, sunstituting '_' for spaces.

The theme files described above are basically PHP files. You do not need to know a lot 

about PHP to create a theme; most of the syntax if straight forward and uses mostly

if-statements and foreach-loops. For additional information on PHP check out: php.net .

The theme files contain variables which look like $this->[something]. Those variables get

set by ATutor and may contain simple text or in some cases arrays (or vectors) of text.

The first theme files that should be created are the header.tmpl.php, footer.tmpl.php and

styles.css . Editing those three files alone will let you dramatically change the look

and feel of an ATutor installation. Once those files are complete you can move on to the 

in-AChecker files; those are files that only get used when using or administering AChecker. 

The in-AChecker files format the dropdowns and the overall look of AChecker.
Return current item: VaMoLà - Validator