Attachments (Common) -- Version 2.2

This adds a View button and changes the default link for supported
attachment types.


Features
========

* Keeps the look and feel of SquirrelMail when viewing images
* Views several recognized text types
* Views several image types, if the browser supports them
* Can add a "vcard" Business Card into your address book


Description
===========

When you get a message with an attachment of an image or a text message
in your mail, this plugin will help you to view it properly.  It auto-detects
the images the browser can view, and will only add the "view" link if the
browser supports that type.

If the type is "application/octet-stream", then this plugin attempts to
determine the correct extension for the file types it can view, and will
run the appropriate one.

If you are a plugin developer, your attachment plugin can tie into
attachment_common very easily.  See DEVELOPER for more information.


Future Work
===========

* Other common attachments?
* Detect other extensions and call their hook (whether we catch it or not)
* Maybe automatically generate an appropriate HTTP_ACCEPT for brain-dead
  browsers
   - Regular expression:  "Mozilla/5.0 .* Gecko/20010"


Installation
============

As with other plugins, just uncompress the archive in the plugins
directory, go back to the main directory, run configure and add the plugin.

Questions/comments/flames/etc can be sent to the SquirrelMail plugins list.


Changes
=======
2.2 - Fixed inline image viewing

2.1 - Fixed caching
    - Added better debug info
    - Added option to view images inline
    
2.0 - Now should work correctly for text/html attachment types
    - Adds a new way other plugins can tie into this one
    - Added DEVELOPER documentation

1.9 - Uses validate.php in SquirelMail 1.1.1
    - Cached http_accept for faster loads

1.8 - Now works for HTTP_ACCEPT lines that have ';q=1.0' in them.
  
1.7 - Bugfixes
    - Major code cleanup for application/octet-stream
    - Auto-detects .php
    - More advanced $HTTP_ACCEPT stuff (caused problems before)
    - Debugging information if it's set in functions/plugin.php
  
1.6 - Rewrote vCard parsing.  Outlook 2000's cards now work.
  
1.5 - Stupid bugfixes.
    - Outlook 2000's vcards now work
  
1.4 - 1.0.1 (and later) will not call the plugin with the data passed by
      reference.  We have to code around that inside the plugin (put a &
      before the $Data).  This should still work with pre-1.0.1
    
1.3 - Oops.  Fixed another bug with the application/octet-stream stuff.
    - Added text/x-vcard handling.  Lots of code is thanks to Stefan Sels.
      <stefan (at) sels (dot) com>

1.2 - Forgot to finish a function I was writing for application/octet-stream
      type attachments to automatically scan the extension of the file to
      try to determine which attachment handler to use.

1.1 - "application/octet-stream" type now searches the extension of the file
      to possibly determine correct hook to run
