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





                  **************





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.
Return current item: VaMoLà - Validator