X-Git-Url: https://vcs.fsf.org/?a=blobdiff_plain;f=doc%2Fthemes.txt;h=30130205be243f7aa4087adca55188e7be3f6d9d;hb=ab1581f28c7ee1165dfcfccdb2e2e23240d137f5;hp=aac681c530856f761f58b57ab6fc78e5b24290e8;hpb=39f79fa9ef9b2df9a927a7b04db174cab3b9080e;p=squirrelmail.git diff --git a/doc/themes.txt b/doc/themes.txt index aac681c5..30130205 100644 --- a/doc/themes.txt +++ b/doc/themes.txt @@ -1,46 +1,55 @@ Themes ====== +SquirrelMail users are able to customize the look of the interface by selecting +a custom theme and the font style. -To create a theme, it is very simple. Just go into the themes/ directory -and create a file called yourtheme_theme.php. You then need to create an -array with 13 elements (0-12). Below is an example followed by a -description of what the different entries are for. +SquirrelMail themes define interface colors. Each theme is a set of 17 or more +colors. + +You can easily create your own theme. It is very simple. Just go into the +themes/ directory and create a file called yourtheme_theme.php. +You then need to create an array with 17 elements (0-16). Below is a blank theme +sample followed by a description of what the different entries are for. ------ + +/** + * My Theme + * + * Author: My name + * Date: Today's date + * + * Optional description + */ + +global $color; +$color[0] = '#xxxxxx'; +$color[1] = '#xxxxxx'; +$color[2] = '#xxxxxx'; +$color[3] = '#xxxxxx'; +$color[4] = '#xxxxxx'; +$color[5] = '#xxxxxx'; +$color[6] = '#xxxxxx'; +$color[7] = '#xxxxxx'; +$color[8] = '#xxxxxx'; +$color[9] = '#xxxxxx'; +$color[10] = '#xxxxxx'; +$color[11] = '#xxxxxx'; +$color[12] = '#xxxxxx'; +$color[13] = '#xxxxxx'; +$color[14] = '#xxxxxx'; +$color[15] = '#xxxxxx'; +$color[16] = '#xxxxxx'; + ------ -And here is a description of what the different entries in the array -are colors of, and the letter before the number denotes 'b' for background and -'f' for foreground colors. +Here is descriptions of what the different entries in the array are colors of. +The letter before the number denotes 'b' for background and 'f' for foreground +colors. -b 0: Title Bar at the top of the page header -f 1: +b 0: Title bar at the top of the page header +f 1: Error messages border, usually red f 2: Error messages, usually red b 3: Left folder list background color b 4: Normal background color @@ -51,13 +60,14 @@ f 8: Normal text [usually black] b 9: Darker version of #0 b 10: Darker version of #9 f 11: Special folders color [Inbox, Trash, Sent] -b 12: Alternate color for message list [alters between 4 and this one] -f 13: Color for single-quoted text ('> text') when reading (default: #800000) -f 14: Color for text with more than one quote (default: #FF0000) -f 15: Non-selectable folders in the left frame (defaults to $color[6]) +b 12: Alternate color for message list [alters between #4 and this one] +f 13: Color for single-quoted text ('> text') when reading (default: #800000) +f 14: Color for text with more than one quote (default: #ff0000) +f 15: Non-selectable folders in the left frame (default: $color[6]) +b 16: Highlight color (default: $color[2]) -Next all you have to do is run conf.pl and add the theme to the list -of themes available to you. +Next all you have to do is run SquirrelMail configuration utility and add the +theme to the list of themes available to you. $Id$