tweaks, fixed some misspellings, added a few hooks
[squirrelmail.git] / doc / themes.txt
1 Themes
2 ======
3
4 To create a theme, it is very simple. Just go into the themes/ directory
5 and create a file called yourtheme_theme.php. You then need to create an
6 array with 12 elements (0-11). Below is an example followed by a
7 description of what the different entries are for.
8
9 ---<START>---
10 <?php
11
12 # My Theme
13 # Author: My Name
14 # Date: Today's Date
15 #
16 # Optional description
17
18 $color[0] = "#xxxxxx";
19 $color[1] = "#xxxxxx";
20 $color[2] = "#xxxxxx";
21 $color[3] = "#xxxxxx";
22 $color[4] = "#xxxxxx";
23 $color[5] = "#xxxxxx";
24 $color[6] = "#xxxxxx";
25 $color[7] = "#xxxxxx";
26 $color[8] = "#xxxxxx";
27 $color[9] = "#xxxxxx";
28 $color[10] = "#xxxxxx";
29 $color[11] = "#xxxxxx";
30
31 ?>
32 ---<END>---
33
34 And here is a description of what the different entries in the array
35 are color of:
36
37 0: Title Bar at the top of the page header
38 1: <not currently used>
39 2: Error messages (usually red)
40 3: Left folder list background color
41 4: Normal background color
42 5: Header of the message index (From, Date, Subject)
43 6: Normal text on the left folder list
44 7: Links in the right frame
45 8: Normal text (usually black)
46 9: Darker version of #0
47 10: Darker version of #9
48 11: Special folders color (Inbox, Trash, Sent)
49
50 Next all you have to do is run conf.pl and add the theme to the list
51 of themes available to you. If you would like your theme to be
52 included in the distribution of SquirrelMail, just email it to
53 <luke@squirrelmail.org> and I will review it.