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$