X-Git-Url: https://vcs.fsf.org/?p=squirrelmail.git;a=blobdiff_plain;f=plugins%2Fnewmail%2FREADME;h=a4561e95c1f3d021560828ec2890bb393a1c59ba;hp=fc6f053cf6c5b0506e6739f11086a32baa1e7e03;hb=ccb5faf0a2fbf6dc7927234a0dddeddc4217d230;hpb=70e628ef63d5e9147e1639258daffa94ee2ca315 diff --git a/plugins/newmail/README b/plugins/newmail/README index fc6f053c..a4561e95 100644 --- a/plugins/newmail/README +++ b/plugins/newmail/README @@ -1,59 +1,28 @@ -Ok, this is my first attempt at a plugin, so excuse the mess you may find -in here. +This plugin is used to notify the user when a new mail arrives. There are +several ways to do this. One is to play a sound through the browser whenever +the user has unseen messages flagged in the left window pane. There are options +available (on the options page of course) to disable this feature for each user, +and to select different media files from the users local computer. The default +is that this is NOT enabled, so you'll need to go to the options menu to turn +it on first! There are also options to show a popup window via JavaScript. -This plugin is used to play sounds (currently a WAV file) through the -browser whenever the user has unseen messages flagged in the left window -pane. There are options available (on the options page of course) to -disable this feature for each user, and to select different media files -from the users local computer. The default is that this is NOT enabled, -so you'll need to go to the options menu to turn it on first! There are -also options to show a popup window via JavaScript. - -I tried to make this fairly simple to install. To install the plugin: - - 1. Change to the plugins directory. - - $ cd plugins/ - - 2. Unarchive the plugin. - - $ tar zxvf /your/path/to/newmail-x.x.tgz - - 2. This should create a newmail/ directory under plugins. - - 4. Go to the config directory and run conf.pl - - $ cd ../../config/ - $ ./conf.pl - - 5. Choose option 8 and proceed to add the new plugin following - the instructions there. Save and exit, and your plugin should - be in place. - -Any questions, you can let me know -- - -Mike Huttinger -huttinger@ipact.com - ------------------------------------------ - -Modifications by Tyler Akins to support changing the title bar and for the -new 1.1.1 validate.php format. Also uses the new sqimap_unseen_messages() -function in 1.1.2 - ------------------------------------------ - -Modification by Wouter Teepe from Seth Randall... -to disallow the use of audio, change - $allowsound = "true"; -to - $allowsound = "false"; -on line 33 of newmail_opt.php - ------------------------------------------ +Plugin options are visible only when JavaScript is enabled or detected by +SquirrelMail JavaScript detection functions. From SquirrelMail 1.5.1 newmail plugin's site configuration can be stored in config/newmail_config.php or plugins/newmail/config.php. $allowsound setting is replaced with $newmail_allowsound and should be stored inside plugin's site configuration file. + +Plugin supports playback of WAV, SWF, MP3, OGG and SVG media files. Currently +OGG and SVG files are played only by browsers that implement w3.org nested +objects correctly and browsers that can play objects. Internet Explorer +can't play them due to broken implementation. OGG and SVG +elements specific to IE are not implemented. + +CREDITS + +This plugin has been originally created by Mike Huttinger, with contributions by +Tyler Akins and Seth Randall. It's now maintained by the SquirrelMail Project +Team.