=========================================== ATutor Themes Documentation =========================================== In this file: - Introduction - Installing a New Theme - File & Directory Structure - Theme Configuration File - Creating a Theme ************** Introduction ------------ 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.