Manual installation of mods

Mods are installed on the default theme's template files. It is hard for a Mod's author as well as a theme creator to make Mods work with other themes especially if they have several of their own template files. When a template file is not found in a custom non-default theme the theme will rollback and use the default theme's template file. But for the template files that the custom theme does use, you will need to manually install the mod on to your custom themes template files if the mod edited the same template file in the default theme. To apply a Mod to any theme manually use the following steps.


 * 1) Unzip the Mod package, and look for the file package-info.xml and open it with a text editor
 * 2) Identify the files with the instructions to do the modifications (for details on package-info.xml structure, please see Package SDK: package-info.xml
 * 3) Search in the extracted package for the .mod or .xml file identified in the previous step and open it with a text editor.
 * 4) .mod and .xml files can have different syntax:
 * 5) * .mod files:
 * 6) ** Open the .mod file with any text editor and search for ..., you will find a file name after the tag. What we need here is looking for a template file i.e. index.template.php, BoardIndex.template.php ..etc.
 * 7) ** If you locate any template after the tag, you will find the ... tag below it. It will contain a block of code that must be located in the specified template.
 * 8) ** After the tag, you will find one of these: ..., which add a block of code after the code found. ... , which add a block of code before the code found. ... , which replace a block of code with the code found.
 * 9) * .xml file: please see Package SDK: modification.xml for detailed instructions on how to read and use the instructions of a .xml file

.mod files syntax example
For example: Themes/default/Display.template.php

// Show the anchor for the top and for the first message. If the first message is new, say so.

global $bar_exps, $bar_posts;

// Show the anchor for the top and for the first message. If the first message is new, say so.

.xml files syntax example
 <![CDATA[// Show the anchor for the top and for the first message. If the first message is new, say so.]]> <![CDATA[global $bar_exps, $bar_posts;

// Show the anchor for the top and for the first message. If the first message is new, say so.]]>
 * undefined

Example explanation
In both examples the operations is the same, we need to open Display.template.php and look for:

// Show the anchor for the top and for the first message. If the first message is new, say so. and replace it with:

global $bar_exps, $bar_posts;

// Show the anchor for the top and for the first message. If the first message is new, say so.