Image Buttons plugin -- Version 1.32 (copyleft Brad Donison 2003, GPL v2)

This is a plugin for SquirrelMail 1.4 and higher to optionally
display graphic images on the top menu bar instead of plain text.


Requirements
============
* SquirrelMail 1.4.x or higher
* The compatibility plugin
* optionally the GD libs compiled into your PHP install
* using an included patch

(this plugin MAY also work with a patched version of SquirrelMail 1.2.x)


Features
========
* Creates button images according to user's colour prefs
* Can use site wide image files for menu bar icons
* Optionally adds text beside images
* Text and Text Buttons can be resized according to user prefs
* Site wide prefs can override user prefs
* Has tooltips for browsers that can handle them


Future Work
===========
* Adding a scheme to select images according to the user's theme
* Add icon for the SM attributions (if visible)
* How about 3-D Buttons
* User selectable icon themes???
* Include png icons
* Dump reliance on older GD for Text Buttons (or drop the Buttons)
* Add the translation code
* Show menu text below the icon images


Upgrade Information
===================
If you are upgrading from version 1.3 then you should have already applied
the patches or made the code changes to the core SM code already, so you
don't need to apply any more patches.

1) If you have customised image files in the images directory, you may wish
   to move that directory or just the specific customized files out of the
   way before proceeding.

2) Simply ungzip and untar this into your plugins directory right overtop
   of the exiting installation.

3) If you have moved any customized images out of the way in step 1, then
   you'll want to move them back into the images directory.


Installation
============
1) As with other plugins, uncompress the archive in the plugins directory.


2) Copy config.php.sample to config.php and edit global prefs therein.
   Place any customer incom images within the images directory and change
   the config file accordingly. The config file has comments on how to
   modify it.


3) Included are some diff files for the 1.4x and 1.5x renditions of
   SquirrelMail. Apply whichever diff file via the patch command that
   corresponds to your installed version of SM. The sm14x.diff is known
   to work against version 1.4.2 and later of SquirrelMail. The patches
   affect the following files in the SM_PATH/functions directory:

   page_header.php
   AND
   strings.php

   example of using the patch command:
   cd ../../functions/
   patch < ../plugins/image_buttons/sm1[4|5]x.diff


4) Go back to the main SquirrelMail directory and run configure to
   enable the plugin.


NOTES: Feel free to contibute more icons for new menu items or different
       ones for existing menu items. If you have a patch for another
       version of SquirrelMail then feel free to offer that up as well,
       Thx... For the record I do not prefer plugins or features that
       require patches to the core code to add functionality. I prefer
       sticking with the core code, but as a hook was added to 1.5
       versions of SquirrelMail I thought that I would try to make use
       of it.


Credits
=======
Thx to those who have put time and effort into prior versions of this
plugin. Unfortunately I have no idea who created version 1.1 of image_buttons
or earlier versions. For the included graphic icons thx goes to Andy Morris
for some of the icons, Cool Archive and Icon Archive for others, and myself
for some. Thx also to those on the plugins list who suggested enhancements
and contributed diffs: John B., Tomas Kuliavas and Simon Bryan.

Questions/comments/etc can be sent to:
    Brad Donison <bucovina@users.sourceforge.net>

Flames can be sent to:
    Brad Donison </dev/null>


Changes
=======
1.32  - got rid of using _GET
      - added link info for createbutton for future use
      - new diff file for 1.5.1
      - updated README for better install instructions
      = (Brad Donison)

1.31  - added a diff file for SM version 1.5x
      - fixed a web server log error for newer PHP versions
      - applied fix for button colours from Tomas
      = (Brad Donison)

1.3   - fixed folder index bug (cut and paste can be the enemy too;-)
      - made caching of Text Buttons a user preference
      - added "Default" for size of text
      - added tooltips
      - site prefs can now take precident over user prefs
      - added more contributed icons
      = (Brad Donison)

1.2   - made this into a real plugin using the defined hooks
      - uses the version API
      - users can select desired text size
      - real icons can be used along with text and/or generated buttons
      = (Brad Donison)

1.1   - version history unknown for this version and older ones
      = (original author unknown)

