Moving "doc/db-backend.txt" to the administrator's manual (again).
[squirrelmail.git] / doc / themes.txt
1 Themes
2 ======
3 SquirrelMail users are able to customize the look of the interface by selecting
4 a custom theme and the font style.
5
6 SquirrelMail themes define interface colors. Each theme is a set of 17 or more
7 colors.
8
9 You can easily create your own theme. It is very simple. Just go into the
10 themes/ directory and create a file called yourtheme_theme.php.
11 You then need to create an array with 17 elements (0-16). Below is a blank theme
12 sample followed by a description of what the different entries are for.
13
14 ---<START>--- 
15 <?php
16
17 /**
18  * My Theme
19  *
20  * Author: My name
21  * Date:   Today's date
22  *
23  * Optional description
24  */
25
26 global $color;
27 $color[0]   = '#xxxxxx';
28 $color[1]   = '#xxxxxx';
29 $color[2]   = '#xxxxxx';
30 $color[3]   = '#xxxxxx';
31 $color[4]   = '#xxxxxx';
32 $color[5]   = '#xxxxxx';
33 $color[6]   = '#xxxxxx';
34 $color[7]   = '#xxxxxx';
35 $color[8]   = '#xxxxxx';
36 $color[9]   = '#xxxxxx';
37 $color[10]  = '#xxxxxx';
38 $color[11]  = '#xxxxxx';
39 $color[12]  = '#xxxxxx';
40 $color[13]  = '#xxxxxx';
41 $color[14]  = '#xxxxxx';
42 $color[15]  = '#xxxxxx';
43 $color[16]  = '#xxxxxx';
44
45 ---<END>---
46
47 Here is descriptions of what the different entries in the array are colors of.
48 The letter before the number denotes 'b' for background and 'f' for foreground
49 colors.
50
51 b  0: Title bar at the top of the page header
52 f  1: Error messages border, usually red
53 f  2: Error messages, usually red
54 b  3: Left folder list background color
55 b  4: Normal background color
56 b  5: Header of the message index [From, Date, Subject]
57 f  6: Normal text on the left folder list
58 f  7: Links in the right frame
59 f  8: Normal text [usually black]
60 b  9: Darker version of #0
61 b 10: Darker version of #9
62 f 11: Special folders color [Inbox, Trash, Sent]
63 b 12: Alternate color for message list [alters between #4 and this one]
64 f 13: Color for single-quoted text ('> text') when reading (default: #800000)
65 f 14: Color for text with more than one quote (default: #ff0000)
66 f 15: Non-selectable folders in the left frame (default: $color[6])
67 b 16: Highlight color (default: $color[2])
68
69 Next all you have to do is run SquirrelMail configuration utility and add the
70 theme to the list of themes available to you.
71
72
73 $Id$