Installing the Select Range Plugin ================================== 1) Start with untaring the file into the plugins directory. Here is a example for the 3.7 version of the Select Range plugin. $ cd plugins $ tar -zxvf select_range-3.7-1.4.4.tar.gz 2) If using SquirrelMail 1.5.2 or above or shift-click and better link placement is not needed, skip to step four. Otherwise, continue to step three. 3) Patch your SquirrelMail source code. Two simple hooks are added to the source for enhanced plugin functionality. Make sure you use the patch file that pertains to your version (or the closest one available) of SquirrelMail. Make sure you execute the patch from the select_range plugin directory. $ cd select_range $ patch -p0 < patch/select_range-squirrelmail_1.4.14.diff Note for Windows users: you can get native patch functionality by installing this very useful package: http://unxutils.sourceforge.net/ 4) If you do not want to change the default behavior of this plugin, skip to step six. 5) (OPTIONAL) Decide if you want to store the plugin configuration file in the plugin directory or in the main SquirrelMail config directory. A) To store the configuration file in the plugin directory, change into the select_range directory, copy config_example.php to config.php and edit config.php, making adjustments as you deem necessary. ----- optional ----- $ cd select_range $ cp config_example.php config.php $ vi config.php ----- optional ----- B) To store the configuration file in the main SquirrelMail config directory, change into the select_range directory, copy config_example.php to ../../config/config_select_range.php and edit ../../config/config_select_range.php, making adjustments as you deem necessary. ----- optional ----- $ cd select_range $ cp config_example.php ../../config/config_select_range.php $ vi ../../config/config_select_range.php ----- optional ----- 6) Then go to your config directory and run conf.pl. Choose option 8 and move the plugin from the "Available Plugins" category to the "Installed Plugins" category. Save and exit. $ cd ../../config/ $ ./conf.pl 7) Translations are not included in this package. To get a translation, download the language pack needed from: http://www.squirrelmail.org/download.php Upgrading Select Range ====================== 1) Start with untaring the file into the plugins directory. Here is a example for the 3.7 version of the Select Range plugin. $ cd plugins $ tar -zxvf select_range-3.7-1.4.4.tar.gz 2) Change into the select_range directory, check your config.php file against the new version, to see if there are any new settings that you must add to your config.php file. (This step only applies if you have created a config.php file under step five above when you first installed the plugin.) $ diff -u config.php config_example.php Or simply replace your config.php file with the provided example and reconfigure the plugin from scratch (see step five under the installation procedure above). 3) You never need to patch SquirrelMail again if you've done it once before (or unless the release notes/changelog say otherwise).