-ABOUT

This plugin requires javascript and provides a "select range" link
above and below the "Toggle All" links in the message list/display.
This enables the user to select two items from the list, click "select
range", and all items between the two become selected.  Useful if you
want to delete or modify messages status of a bunch of messages
quickly. I find it extremely helpful for handling high-volume mailing
lists.

You can display the link next to "toggle all" instead of above and
below the message list (more aesthetically pleasing IMHO). Optionally,
you can also show a "select range" and "toggle all" link in the
address book. To do either of these, you will need to patch. You will
find instructions and patch files in the "patch" folder of this
plugin. To see these links you will still need to enable the plugin.

There are extra features besides the auto-check-marking. If you
check-mark zero or one list items and then click the "select range"
link, you get a javascript alert asking you to select at least two
items. If you check-mark two or more items but don't leave any
un-selected items between them, you get a javascript alert asking you
to leave at least one un-selected item between the first and last
selected items. This should help familiarize new users with the
functionality of this plugin. Also, you can set a minimum number of
items in the current message view before the select range link is
shown. 

Both the javascript alerts and the minimum number of list items can be
individually configured by users in the options/display preferences.
If desired, you can disable javascript alerts and list item threshold
for everyone sitewide. This mimics the behavior of pre-2.4 versions of
this plugin. See overrides.php for information on how to do this.

You can override the text strings if you don't like the default
wording. To do this, edit the language ".po" file in the locale folder
for your locale (to override English, look in locale/en_US). Once
you've made your changes, change to the language directory and run
"msgfmt -o select_range.mo select_range.po". There is an extra feature
for the options description: if you change "Set to -1 to never show
the link" or "Set to 0 to always show the link" translations to " ",
these lines will completely disappear. Some people did not like that
this description took up multiple lines, so this addresses that
concern.



-SUPPORT/CONTACT INFORMATION

If you have support questions, you can post to the squirrelmail
plugins list. See

https://lists.sourceforge.net/lists/listinfo/squirrelmail-plugins

If you have a patch, or a comment, or an amusing anecdote about how
this plugin helped you alleviate the misery of the world, you can
email me at freespirit74@yahoo.com. Note that support questions *must*
go to the mailing list so that others may benefit from discussion of
the problem. Support requests sent to the yahoo address will at best
receive a reply requesting that you send the mail to the plugins list,
or at worst be ignored.



-INTERNATIONALIZATION

This plugin supports full i18n, so translations are helpful.  Here are
the steps to create a translation:

- subscribe to the i18n list at this url:
  http://lists.sourceforge.net/lists/listinfo/squirrelmail-i18N
- make sure your translation is OK with everyone on the i18n list and
  not duplicting someone else's efforts
- create a language directory in locale (check Squirrelmail locale
  directory for a list of available languages)
- create a subdirectory LC_MESSAGES
- copy locale/select_range.po to LC_MESSAGES directory
- change to the LC_MESSAGES directory you created
- edit select_range.po
- modify the information at the top
- add your translations between the quotes after msgstr
- run "msgfmt -o select_range.mo select_range.po"
- compress and tar the language directory you created and send it to
  me



-REVISION HISTORY

03/17/04 - ver 2.7
- change default "show when x messages" link to 4 from 3 (requested by
  Nils)
- Under options: number of messages, only show the second and third
  lines of the description if they are non-blank. This allows the
  local admin to override the strings in the locale file so that this
  string becomes whatever the admin wants *without* extra unwanted
  line breaks (requested by Nils)
- added en_US locale so English text strings can be overridden by site 
  admins
- changed layout/text of options; this adds an extra i18n string
- added Icelandic translation by sak Ben
- added Polish translation by Martin Saini
- added range/toggle links to address book, though these require a
  patch (suggested by "Alan in Toronto"); also requires extra i18n
  strings

03/15/04 - ver 2.6a
- Swedish translation was broken; fixed

03/11/04 - ver 2.6
- minor documentation changes
- Lithuanian translation from Tomas Kuliavas
- Swedish translation modifications by Fredrik Jervfors
- changed patch to add a new hook instead of adding logic to
  mailbox_display.php; this simplifies patching and makes it "pretty"
- minor code cleanup
- I think I'm supporting the version number API now?


03/01/04 - ver 2.5
- documentation revisions
- Swedish translation from Fredrik Nilsson (Fredrik Jervfors gets
  credit for the first translation, but it only had one translated
  string, so I ended up using Fredrik Nilsson's)
- disabled patch link in search form (bug reported by Fredrik
  Jervfors)
- native German translation from Simon Matter; Kuehn Markus also sent
  a translation, but I already had Simon's (sorry Kuehn)
- patch was breaking searches for some people; switched to
  "include_once" to fix (thanks to Simon Matter who pointed this out)

02/18/04 - ver 2.4
- I messed up the sample select_range.po file; fixed
- I included a horrible German translation that I generated. Have fun
  laughing all you germans, then send me a better one.
- moved sample select_range.po into locale directory
- included Tagalog/Filipino translation from my wife Mary Ann; this
  does not appear to be a supported Squirrelmail language yet (Tomas
  Kuliavas says it's supported in Squirrelmail 1.5)
- moved hardcoded threshold to a constant so it can be changed
- fixed threshold comparison; previously was comparing to total number
  of messages in mailbox as opposed to total number of *displayed*
  messages in mailbox

02/17/04 - ver 2.3
- code cleanup
- patch now uses plugin's code, so there is only one piece of code to
  maintain
- patch now also uses translation files from plugin directory
- only displays link if more than a certain number of messages in
  mailbox (saves a bit of bandwidth); this can also be disabled by
  admin sitewide
- displays i18n'ized javascript notices if user doesn't select any
  messages first or only selects two messages right next to each
  other; this can also be disabled by admin sitewide
- patch compacted to minimize extra code
- javascript function displayed only once (saves bandwidth)
- added "overrides.php" to allow admins to enable/disable various
  features
- added two preferences to allow user to control features
  (display errors and hide select range link for fewer messages)
  these are overridden by anything admin specifies in overrides.php
- added enable/disable option; set threshold to -1 to disable
  (requested by Ferdie Ferdsen)

02/12/04 - ver 2.2
- added i18n/l10n with Japanese language (patches from Kosaku Nagasaka)
- moved functions out of setup.php (suggested by pdontthink)
- simplified patching and updated instructions (thanks to pdontthink)

02/05/04 - ver 2.1
- updated with patch for 1.4.2
- added To-do list
- added "Plugin updates" compatibility (suggested by Robert V. MacQuarrie)

07/15/03 - ver 2.0
- initial public release of plugin version
- style fixes to pre-patched mailbox_display.php version 1.4.1
- revised patch README

07/08/03 - (patch only) ver 1.1
- added mailbox_display.php version 1.4.1

04/21/03 - (patch only) ver 1.0
- added mailbox_display.php version 1.4.0
- revised README

04/01/03 - (patch only) ver 0.11
- added mailbox_display.php versions 1.4.0-rc2 and 1.2.9
- modified README file

03/27/03 - (patch only) ver 0.1
- initial public release



-TO-DO

I'll get around to some of these if I can, but patches are always
welcome.

add to help file to say what it does (suggested by Ferdie Ferdsen)

add overrides_default.php and put any new overrides in there, allowing
admin to preserve their overrides in overrides.php; will need to check
for presence of overrides.php?

add support for search form; right now it is *really* messy to do so;
apparently the search form code is also undergoing revision for 1.5
that should make select_range work better within it

remove the franken-string monster of "select range options" in
functions.php once all the translations have been switched over to
include a complete translated "select range options" string
