plugins/squirrelspell/INSTALL

   1 SquirrelSpell-v0.3.1
   2 ---------------------
   3
   4 Untar SquirrelSpell into your squirrelmail/plugins directory. Modify the
   5 sqspell_config.php file making sure you have ispell or aspell
   6 available on your system and located in PHP's path. The squirrelspell
   7 doesn't check for that and if it is not available, you're just going to
   8 get a "No errors found"  message every time. :) Quite pleasing, but not
   9 very useful.
  10
  11 Read files in "doc" directory -- they explain some features.
  12
  13 Enable the plugin either by hand or by running the configure script from
  14 your squirrelmail install directory.
  15
  16 Enjoy and report bugs. ;)
  17
  18 This is an options commented sqspell_config.php
  19
  20 <?php
  21
  22    /**
  23     **  sqspell_config.php -- SquirrelSpell Configuration file.
  24     **
  25     **  Copyright (c) 1999-2000 The SquirrelMail development team
  26     **  Licensed under the GNU GPL. For full terms see the file COPYING.
  27     **
  28     **
  29     **
  30     **  $Id$
  31     **/
  32
  33     /* Just for poor wretched souls with E_ALL. :) */
  34     global $username, $data_dir;
  35
  36     /**
  37        SPELL-CHECKING APPLICATIONS:
  38        ----------------------------
  39        This feature was added/changed in 0.3. Use this array to set up
  40        which dictionaries are available to users. If you only have
  41        English spellchecker on your system, then let this line be:
  42
  43        $SQSPELL_APP = array("English" => "ispell -a");
  44
  45        or
  46
  47        $SQSPELL_APP = array("English" => "/usr/local/bin/aspell -a");
  48
  49        Sometimes you have to specify full path for PHP to find it.
  50        Aspell is a better spell-checker than Ispell, so you're encouraged
  51        to use it.
  52
  53        If you want to have more than one dictionary available to users,
  54        configure the array to look something like this:
  55
  56        $SQSPELL_APP = array(
  57                         "English" => "aspell -a",
  58                             "Russian" => "ispell -d russian -a",
  59                         ...
  60                         "Swahili" => "ispell -d swahili -a"
  61                        );
  62
  63        Watch the commas, making sure there isn't one after your last
  64        dictionary declaration. Also, make sure all these dictionaries
  65        are available on your system before you specify them here.
  66
  67        Whatever your setting is, don't omit the "-a" flag.
  68
  69     **/
  70     $SQSPELL_APP = array('English' => 'ispell -a');
  71
  72     /**
  73        DEFAULT DICTIONARY
  74        -------------------
  75        Even if you're only running one dictionary, still specify which one
  76        is the default. Watch the case -- it has to be exactly as in array
  77        you declared in $SQSPELL_APP.
  78     **/
  79     $SQSPELL_APP_DEFAULT='English';
  80
  81     /**
  82        USER DICTIONARY:
  83        -----------------
  84        $SQSPELL_WORDS_FILE is a location and mask of a user dictionary file.
  85        The default setting should be OK for most everyone. Read PRIVACY and
  86        CRYPTO in the "doc" directory.
  87     **/
  88     $SQSPELL_WORDS_FILE = "$data_dir/$username.words";
  89
  90     /**
  91        CASE SENSITIVITY:
  92        ------------------
  93        Use $SQSPELL_EREG="ereg" for case-sensitive matching of user
  94        dictionary, or $SQSPELL_EREG="eregi" for case-insensitive
  95        matching. It is advised to use case-sensitive matching.
  96     **/
  97     $SQSPELL_EREG="ereg";
  98
  99     /**
 100        SOUP NAZI (AVOIDING BAD BROWSERS)
 101        -------------------------------------
 102        Since some browsers choke on JavaScript, here is an option to disable the
 103        browsers with known problems. All you do is add some part of an USER_AGENT
 104        string of an offending browser which you want to disable and users will not
 105        know about this plugin. E.g. browsers with "Mozilla/4.61 (Macintosh, I, PPC)"
 106        USER_AGENT string will get weeded out if you provide "Macintosh" in the
 107        config string.
 108
 109        Mozilla/2 -- You're kidding, right?
 110        Mozilla/3 -- known not to work
 111        Opera -- known not to work
 112        Macintosh -- Netscape 4.x on Macintosh chokes for some reason.
 113                     Adding until resolved.
 114     **/
 115     $SQSPELL_SOUP_NAZI = 'Mozilla/3, Mozilla/2, Opera 4, Opera/4, Macintosh';
 116 ?>