====== OpenDocMan Themes ======
OpenDocMan DMS includes some pre-designed themes which can be chosen by the site admin. While these themes are sufficient for most purposes there may be a time where you would like to create your own theme, or customize one of the included themes. This document will try and explain that process to make it easier for the community to build their own OpenDocMan themes.
OpenDocMan theme files are build using a combination of HTML, CSS, JavaScript, and use the Smarty template language for any code-generated values.
===== File Structure =====
OpenDocMan themes are contained inside the "templates" folder. There are currently three themes that come with OpenDocMan:
* **default** - The original OpenDocMan theme design.
* **tweeter** - A new design based on Twitter Bootstrap
* **common** - This is a collection of common theme files that are typically shared with all themes.
Inside each of the them folders are the bare-minimum files:
* **footer.tpl** - The site-wide Smarty footer file. This file will be displayed for every page, and will be rendered last.
* **header.tpl** - The site-wide Smarty header file. This file will be displayed for every page, and will be rendered AFTER the common header
* **README** - A readme file which contains copyright information and details about your theme which might be helpful to other developers
Aside from the mandatory files, you can also include the following folders to help separate your assets:
* **css** - A folder which can hold your CSS files
* **img** - A folder that holds any images your theme might require
* **js** - A folder for JavaScript assets specific to your theme
==== Customization of a Theme ====
The best way to start off with OpenDocMan themes is to customize one of the included themes. To customize the "default" theme:
- Copy the "default" folder contents into a new folder "mynewtheme"
- You can edit the header.tpl file which links to the default/css/default.css file and change it to point to the new location (ex. mynewthtme/css/default.css).
- Login as the OpenDocMan site root user, select "Admin->Site Settings" then select your new theme file as the "theme" setting.
- On the next page-load you should now be using your new theme.
=== Creating a New Theme ===
If you are interested in creating a new theme from scratch:
- Create a new theme folder (ex. templates/mynewtheme)
- Create the header.tpl file - This should contain all of your HTML starting with
but should not include the