phpDocumentor updates
[squirrelmail.git] / plugins / squirrelspell / sqspell_config.php
index e0405b4bfadb296aeebb6ca091a69dbeacb6f5bf..73260b255d49766014bb1bf9d990c4f68e863650 100644 (file)
@@ -1,88 +1,98 @@
 <?php
-/** SquirrelSpell Configuration file. **/
 
-// Just for poor wretched souls with E_ALL. :)
-global $username, $data_dir;
-
-/** 
-   SPELL-CHECKING APPLICATIONS:
-   ----------------------------
-   This feature was added/changed in 0.3. Use this array to set up
-   which dictionaries are available to users. If you only have 
-   English spellchecker on your system, then let this line be:
-
-   $SQSPELL_APP = array("English" => "ispell -a");
-
-   or
-
-   $SQSPELL_APP = array("English" => "/usr/local/bin/aspell -a");
-
-   Sometimes you have to specify full path for PHP to find it.
-   Aspell is a better spell-checker than Ispell, so you're encouraged
-   to use it.
+/**
+ * sqspell_config.php -- SquirrelSpell Configuration file.
+ *
+ * @copyright &copy; 1999-2005 The SquirrelMail Project Team
+ * @license http://opensource.org/licenses/gpl-license.php GNU Public License
+ * @version $Id$
+ * @package plugins
+ * @subpackage squirrelspell
+ */
 
-   If you want to have more than one dictionary available to users,
-   configure the array to look something like this:
+/** @ignore */
+if (! defined('SM_PATH')) define('SM_PATH','../../');
 
-   $SQSPELL_APP = array(
-                       "English" => "aspell -a",
-                        "Russian" => "ispell -d russian -a",
-                       ...
-                       "Swahili" => "ispell -d swahili -a"
-                      );
-   
-   Watch the commas, making sure there isn't one after your last
-   dictionary declaration. Also, make sure all these dictionaries
-   are available on your system before you specify them here.
-   
-   Whatever your setting is, don't omit the "-a" flag.
+/** getHashedFile() function for SQSPELL_WORDS_FILE and sqgetGlobalVar() from global.php */
+include_once(SM_PATH . 'functions/prefs.php');
 
-                                                               **/
-$SQSPELL_APP = array("English" => "ispell -a");
+/** vars needed for getHashedFile() */
+global $data_dir;
+sqgetGlobalVar('username', $username, SQ_SESSION);
 
 /**
-   DEFAULT DICTIONARY
-   -------------------
-   Even if you're only running one dictionary, still specify which one 
-   is the default. Watch the case -- it has to be exactly as in array
-   you declared in $SQSPELL_APP.       
-                                                               **/
-$SQSPELL_APP_DEFAULT="English";
+ * List of configured dictionaries
+ *
+ * This feature was added/changed in 0.3. Use this array to set up
+ * which dictionaries are available to users. If you only have
+ * English spellchecker on your system, then let this line be:
+ *<pre>
+ *   $SQSPELL_APP = array('English' => 'ispell -a');
+ *     or
+ *   $SQSPELL_APP = array('English' => '/usr/local/bin/aspell -a');
+ *</pre>
+ * Sometimes you have to specify full path for PHP to find it.
+ * 
+ * You can use Aspell or Ispell spellcheckers. Aspell might provide
+ * better spellchecking for Western languages.
+ *
+ * If you want to have more than one dictionary available to users,
+ * configure the array to look something like this:
+ *<pre>
+ *   $SQSPELL_APP = array('English' => 'aspell -a',
+ *                        'Russian' => 'ispell -d russian -a',
+ *                        ...
+ *                        'Swahili' => 'ispell -d swahili -a'
+ *                        );
+ *</pre>
+ * WARNINGS:
+ * <ul>
+ * <li>Watch the commas, making sure there isn't one after your last
+ *     dictionary declaration. Also, make sure all these dictionaries
+ *     are available on your system before you specify them here.</li>
+ * <li>Whatever your setting is, don't omit the "-a" flag.</li>
+ * <li>Remember to keep same array keys during upgrades. Don't rename them.
+ *   Users' dictionary settings use it.</li>
+ * <li>Interface might translate array key, if used key is present in 
+ *   SquirrelMail translations.</li>
+ * </ul>
+ * <pre>
+ * Example:
+ * $SQSPELL_APP = array('English' => 'ispell -a',
+ *                      'Spanish' => 'ispell -d spanish -a' );
+ * </pre>
+ *
+ * @global array $SQSPELL_APP
+ */
+$SQSPELL_APP = array('English' => 'ispell -a',
+                     'Spanish' => 'ispell -d spanish -a');
 
 /**
-   USER DICTIONARY:
-   -----------------
-   $SQSPELL_WORDS_FILE is a location and mask of a user dictionary file. 
-   The default setting should be OK for most everyone. Read PRIVACY and
-   CRYPTO in the "doc" directory.
-                                                               **/
-$SQSPELL_WORDS_FILE = "$data_dir/$username.words";
+ * Default dictionary
+ * @global string $SQSPELL_APP_DEFAULT
+ */
+$SQSPELL_APP_DEFAULT = 'English';
 
 /**
-   CASE SENSITIVITY:
-   ------------------
-   Use $SQSPELL_EREG="ereg" for case-sensitive matching of user 
-   dictionary, or $SQSPELL_EREG="eregi" for case-insensitive 
-   matching. It is advised to use case-sensitive matching.
-                                                               **/
-$SQSPELL_EREG="ereg";
+ * File that stores user's dictionary
+ *
+ * $SQSPELL_WORDS_FILE is a location and mask of a user dictionary file.
+ * The default setting should be OK for most everyone.
+ *     
+ * This setting is used only when SquirrelSpell is upgraded from
+ * older setup. Since SquirrelMail 1.5.1 SquirrelSpell stores all settings in
+ * same place that stores other SquirrelMail user preferences.
+ * @global string $SQSPELL_WORDS_FILE
+ * @deprecated setting is still needed in order to handle upgrades
+ */
+$SQSPELL_WORDS_FILE =
+   getHashedFile($username, $data_dir, "$username.words");
 
 /**
-   SOUP NAZI (AVOIDING BAD BROWSERS)
-   -------------------------------------
-   Since some browsers choke on JavaScript, here is an option to disable the
-   browsers with known problems. All you do is add some part of an USER_AGENT 
-   string of an offending browser which you want to disable and users will not
-   know about this plugin. E.g. browsers with "Mozilla/4.61 (Macintosh, I, PPC)"
-   USER_AGENT string will get weeded out if you provide "Macintosh" in the 
-   config string.
-  
-   Mozilla/2 -- You're kidding, right?
-   Mozilla/3 -- known not to work
-   Opera -- known not to work
-   Macintosh -- Netscape 4.x on Macintosh chokes for some reason. 
-                Adding until resolved.
-                                                               **/
-$SQSPELL_SOUP_NAZI = "Mozilla/3, Mozilla/2, Opera 4, Opera/4, Macintosh";
+ * Function used for checking words in user's dictionary
+ * @global string $SQSPELL_EREG
+ * @deprecated It is not used since 1.5.1 (sqspell 0.5)
+ */
+$SQSPELL_EREG = 'ereg';
 
-?>
+?>
\ No newline at end of file