X-Git-Url: https://vcs.fsf.org/?p=squirrelmail.git;a=blobdiff_plain;f=plugins%2Fsquirrelspell%2Fsetup.php;h=13e75748202d7bff7faa2123a7952086761fba81;hp=daa8c1982ce470f04fddbbdd8745158ea8c47879;hb=598294a727a2789b7c562ee7083da703c8bb0628;hpb=cbe5423b30fd1c50b7dd9546778cbebf48804953
diff --git a/plugins/squirrelspell/setup.php b/plugins/squirrelspell/setup.php
index daa8c198..13e75748 100644
--- a/plugins/squirrelspell/setup.php
+++ b/plugins/squirrelspell/setup.php
@@ -1,70 +1,87 @@
($Author$)
+ * @version $Date$
+ * @package plugins
+ * @subpackage squirrelspell
+ */
- /**
- ** setup.php -- Squirrelspell setup file
- **
- ** Copyright (c) 1999-2001 The SquirrelMail development team
- ** Licensed under the GNU GPL. For full terms see the file COPYING.
- **
- ** This is a standard Squirrelmail-1.2 API for plugins.
- **
- ** $Id$
- **/
+/**
+ * Standard SquirrelMail plugin initialization API.
+ *
+ * @return void
+ */
+function squirrelmail_plugin_init_squirrelspell() {
+ global $squirrelmail_plugin_hooks;
+ $squirrelmail_plugin_hooks['compose_button_row']['squirrelspell'] =
+ 'squirrelspell_setup';
+ $squirrelmail_plugin_hooks['optpage_register_block']['squirrelspell'] =
+ 'squirrelspell_optpage_register_block';
+ $squirrelmail_plugin_hooks['options_link_and_description']['squirrelspell'] =
+ 'squirrelspell_options';
+}
+/**
+ * This function formats and adds the plugin and its description to the
+ * Options screen.
+ *
+ * @return void
+ */
+function squirrelspell_optpage_register_block() {
+ global $optpage_blocks;
/**
- * This function checks whether the user's USER_AGENT is known to
- * be broken. If so, returns true and the plugin is invisible to the
- * offending browser.
+ * Check if this browser is capable of using the plugin
*/
- function soupNazi(){
-
- global $HTTP_USER_AGENT, $SQSPELL_SOUP_NAZI;
-
- require_once('../plugins/squirrelspell/sqspell_config.php');
-
- $soup_menu = explode( ',', $SQSPELL_SOUP_NAZI );
- return( in_array( trim( $HTTP_USER_AGENT ), $soup_menu ) );
- }
-
- function squirrelmail_plugin_init_squirrelspell() {
- /* Standard initialization API. */
- global $squirrelmail_plugin_hooks;
-
- $squirrelmail_plugin_hooks['compose_button_row']['squirrelspell'] = 'squirrelspell_setup';
- $squirrelmail_plugin_hooks['optpage_register_block']['squirrelspell'] = 'squirrelspell_optpage_register_block';
- $squirrelmail_plugin_hooks['options_link_and_description']['squirrelspell'] = 'squirrelspell_options';
- }
-
- function squirrelspell_optpage_register_block() {
- // Gets added to the user's OPTIONS page.
- global $optpage_blocks;
-
- if ( !soupNazi() ) {
-
- /* Register Squirrelspell with the $optionpages array. */
- $optpage_blocks[] = array(
- 'name' => _("SpellChecker Options"),
- 'url' => '../plugins/squirrelspell/sqspell_options.php',
- 'desc' => _("Here you may set up how your personal dictionary is stored, edit it, or choose which languages should be available to you when spell-checking."),
- 'js' => TRUE
- );
- }
+ if (checkForJavascript()) {
+ /**
+ * The browser checks out.
+ * Register Squirrelspell with the $optionpages array.
+ */
+ $optpage_blocks[] =
+ array(
+ 'name' => _("SpellChecker Options"),
+ 'url' => '../plugins/squirrelspell/sqspell_options.php',
+ 'desc' => _("Here you may set up how your personal dictionary is stored, edit it, or choose which languages should be available to you when spell-checking."),
+ 'js' => TRUE);
}
+}
- function squirrelspell_setup() {
- /* Gets added to the COMPOSE buttons row. */
- if ( !soupNazi() ) {
- /*
- ** using document.write to hide this functionality from people
- ** with JavaScript turned off.
- */
- echo "\n";
- }
+/**
+ * This function adds a "Check Spelling" link to the "Compose" row
+ * during message composition.
+ *
+ * @return void
+ */
+function squirrelspell_setup() {
+ /**
+ * Check if this browser is capable of displaying SquirrelSpell
+ * correctly.
+ */
+ if (checkForJavascript()) {
+ /**
+ * Some people may choose to disable javascript even though their
+ * browser is capable of using it. So these freaks don't complain,
+ * use document.write() so the "Check Spelling" button is not
+ * displayed if js is off in the browser.
+ */
+ echo "\n";
}
-
-?>
+}
+?>
\ No newline at end of file