include/options/display.php

   1 <?php
   2
   3 /**
   4  * options_display.php
   5  *
   6  * Copyright (c) 1999-2005 The SquirrelMail Project Team
   7  * Licensed under the GNU GPL. For full terms see the file COPYING.
   8  *
   9  * Displays all optinos about display preferences
  10  *
  11  * @version $Id$
  12  * @package squirrelmail
  13  */
  14
  15 /** Define the group constants for the display options page. */
  16 define('SMOPT_GRP_GENERAL', 0);
  17 define('SMOPT_GRP_MAILBOX', 1);
  18 define('SMOPT_GRP_MESSAGE', 2);
  19
  20 // load icon themes if in use
  21 global $use_icons;
  22 if ($use_icons) {
  23     global $icon_themes;
  24     $dirName = SM_PATH . 'images/themes';
  25     if (is_readable($dirName) && is_dir($dirName)) {
  26         $d = dir($dirName);
  27         while($dir = $d->read()) {
  28             if ($dir != "." && $dir != "..") {
  29                 if (is_dir($dirName."/".$dir) && file_exists("$dirName/$dir/theme.php"))
  30                     include("$dirName/$dir/theme.php");
  31             }
  32         }
  33     }
  34 }
  35
  36 /**
  37  * This function builds an array with all the information about
  38  * the options available to the user, and returns it. The options
  39  * are grouped by the groups in which they are displayed.
  40  * For each option, the following information is stored:
  41  * - name: the internal (variable) name
  42  * - caption: the description of the option in the UI
  43  * - type: one of SMOPT_TYPE_*
  44  * - refresh: one of SMOPT_REFRESH_*
  45  * - size: one of SMOPT_SIZE_*
  46  * - save: the name of a function to call when saving this option
  47  * @return array all option information
  48  */
  49 function load_optpage_data_display() {
  50     global $theme, $language, $languages,
  51     $default_use_mdn, $squirrelmail_language, $allow_thread_sort,
  52     $show_alternative_names, $available_languages, $use_icons;
  53
  54     /* Build a simple array into which we will build options. */
  55     $optgrps = array();
  56     $optvals = array();
  57
  58     /******************************************************/
  59     /* LOAD EACH GROUP OF OPTIONS INTO THE OPTIONS ARRAY. */
  60     /******************************************************/
  61
  62     /*** Load the General Options into the array ***/
  63     $optgrps[SMOPT_GRP_GENERAL] = _("General Display Options");
  64     $optvals[SMOPT_GRP_GENERAL] = array();
  65
  66     /* Load the theme option. */
  67     $theme_values = array();
  68     foreach ($theme as $theme_key => $theme_attributes) {
  69         $theme_values[$theme_attributes['NAME']] = $theme_attributes['PATH'];
  70     }
  71     ksort($theme_values);
  72     $theme_values = array_flip($theme_values);
  73     $optvals[SMOPT_GRP_GENERAL][] = array(
  74         'name'    => 'chosen_theme',
  75         'caption' => _("Theme"),
  76         'type'    => SMOPT_TYPE_STRLIST,
  77         'refresh' => SMOPT_REFRESH_ALL,
  78         'posvals' => $theme_values,
  79         'save'    => 'save_option_theme'
  80     );
  81
  82     $css_values = array( 'none' => _("Default" ) );
  83     $css_dir = SM_PATH . 'themes/css';
  84     if (is_readable($css_dir) && is_dir($css_dir)) {
  85         $handle=opendir($css_dir);
  86         while ($file = readdir($handle) ) {
  87             if ( substr( $file, -4 ) == '.css' ) {
  88                 $css_values[$file] = substr( $file, 0, strlen( $file ) - 4 );
  89             }
  90         }
  91         closedir($handle);
  92     }
  93
  94     if ( count( $css_values ) > 1 ) {
  95
  96         $optvals[SMOPT_GRP_GENERAL][] = array(
  97             'name'    => 'custom_css',
  98             'caption' => _("Custom Stylesheet"),
  99             'type'    => SMOPT_TYPE_STRLIST,
 100             'refresh' => SMOPT_REFRESH_ALL,
 101             'posvals' => $css_values
 102         );
 103
 104     }
 105
 106     // config.php can be unupdated.
 107     if (! isset($available_languages) || $available_languages=="" ) {
 108      $available_languages="ALL"; }
 109
 110     $language_values = array();
 111     if ( strtoupper($available_languages)=='ALL') {
 112         foreach ($languages as $lang_key => $lang_attributes) {
 113             if (isset($lang_attributes['NAME'])) {
 114                 $language_values[$lang_key] = $lang_attributes['NAME'];
 115                 if ( isset($show_alternative_names) &&
 116                      $show_alternative_names &&
 117                      isset($lang_attributes['ALTNAME']) ) {
 118                     $language_values[$lang_key] .= " / " . $lang_attributes['ALTNAME'];
 119                 }
 120             }
 121         }
 122     } else if (strtoupper($available_languages)!='NONE') {
 123         // admin can set list of available languages in config
 124         $available_languages_array=explode (" ",$available_languages);
 125         foreach ($available_languages_array as $lang_key ) {
 126             if (isset($languages[$lang_key]['NAME'])) {
 127                 $language_values[$lang_key] = $languages[$lang_key]['NAME'];
 128                 if ( isset($show_alternative_names) &&
 129                      $show_alternative_names &&
 130                      isset($languages[$lang_key]['ALTNAME']) ) {
 131                     $language_values[$lang_key] .= " / " . $languages[$lang_key]['ALTNAME'];
 132                 }
 133             }
 134         }
 135     }
 136     asort($language_values);
 137     $language_values =
 138         array_merge(array('' => _("Default")), $language_values);
 139     $language = $squirrelmail_language;
 140     if (strtoupper($available_languages)!='NONE') {
 141         // if set to 'none', interface will use only default language
 142         $optvals[SMOPT_GRP_GENERAL][] = array(
 143             'name'    => 'language',
 144             'caption' => _("Language"),
 145             'type'    => SMOPT_TYPE_STRLIST,
 146             'refresh' => SMOPT_REFRESH_ALL,
 147             'posvals' => $language_values,
 148             'htmlencoded' => true
 149             );
 150     }
 151
 152     /* Set values for the "use javascript" option. */
 153     $optvals[SMOPT_GRP_GENERAL][] = array(
 154         'name'    => 'javascript_setting',
 155         'caption' => _("Use Javascript"),
 156         'type'    => SMOPT_TYPE_STRLIST,
 157         'refresh' => SMOPT_REFRESH_ALL,
 158         'posvals' => array(SMPREF_JS_AUTODETECT => _("Autodetect"),
 159                            SMPREF_JS_ON         => _("Always"),
 160                            SMPREF_JS_OFF        => _("Never")),
 161         'save'    => 'save_option_javascript_autodetect',
 162         'script'  => 'onclick="document.forms[0].new_js_autodetect_results.value = \'' . SMPREF_JS_ON . '\';"'
 163     );
 164
 165     $optvals[SMOPT_GRP_GENERAL][] = array(
 166         'name'    => 'js_autodetect_results',
 167         'caption' => '',
 168         'type'    => SMOPT_TYPE_HIDDEN,
 169         'refresh' => SMOPT_REFRESH_NONE
 170         //'post_script' => $js_autodetect_script,
 171     );
 172
 173     $optvals[SMOPT_GRP_GENERAL][] = array(
 174         'name'    => 'hour_format',
 175         'caption' => _("Hour Format"),
 176         'type'    => SMOPT_TYPE_STRLIST,
 177         'refresh' => SMOPT_REFRESH_FOLDERLIST,
 178         'posvals' => array(SMPREF_TIME_12HR => _("12-hour clock"),
 179                            SMPREF_TIME_24HR => _("24-hour clock"))
 180     );
 181
 182     /*** Load the General Options into the array ***/
 183     $optgrps[SMOPT_GRP_MAILBOX] = _("Mailbox Display Options");
 184     $optvals[SMOPT_GRP_MAILBOX] = array();
 185
 186     $optvals[SMOPT_GRP_MAILBOX][] = array(
 187         'name'    => 'show_num',
 188         'caption' => _("Number of Messages per Page"),
 189         'type'    => SMOPT_TYPE_INTEGER,
 190         'refresh' => SMOPT_REFRESH_NONE,
 191         'size'    => SMOPT_SIZE_TINY
 192     );
 193
 194     $optvals[SMOPT_GRP_MAILBOX][] = array(
 195         'name'    => 'alt_index_colors',
 196         'caption' => _("Enable Alternating Row Colors"),
 197         'type'    => SMOPT_TYPE_BOOLEAN,
 198         'refresh' => SMOPT_REFRESH_NONE
 199     );
 200
 201     if ($use_icons) {
 202         global $icon_themes, $icon_theme;
 203         $temp = array();
 204         for ($count = 0; $count < sizeof($icon_themes); $count++) {
 205             $temp[$count] = $icon_themes[$count]['NAME'];
 206             if ($icon_theme == $icon_themes[$count]['PATH'])
 207                 $value = $count;
 208         }
 209         if (sizeof($icon_themes) > 0) {
 210             $optvals[SMOPT_GRP_MAILBOX][] = array(
 211                 'name'          => 'icon_theme',
 212                 'caption'       => _("Message Flags Icon Theme"),
 213                 'type'          => SMOPT_TYPE_STRLIST,
 214                 'refresh'       => SMOPT_REFRESH_NONE,
 215                 'posvals'       => $temp,
 216                 'initial_value' => $value,
 217                 'save'          => 'icon_theme_save'
 218             );
 219         }
 220     }
 221
 222     $optvals[SMOPT_GRP_MAILBOX][] = array(
 223         'name'    => 'show_flag_buttons',
 224         'caption' => _("Show Flag / Unflag Buttons"),
 225         'type'    => SMOPT_TYPE_BOOLEAN,
 226         'refresh' => SMOPT_REFRESH_NONE
 227     );
 228
 229     $optvals[SMOPT_GRP_MAILBOX][] = array(
 230         'name'    => 'page_selector',
 231         'caption' => _("Enable Page Selector"),
 232         'type'    => SMOPT_TYPE_BOOLEAN,
 233         'refresh' => SMOPT_REFRESH_NONE
 234     );
 235
 236     $optvals[SMOPT_GRP_MAILBOX][] = array(
 237         'name'    => 'compact_paginator',
 238         'caption' => _("Use Compact Page Selector"),
 239         'type'    => SMOPT_TYPE_BOOLEAN,
 240         'refresh' => SMOPT_REFRESH_NONE
 241     );
 242
 243     $optvals[SMOPT_GRP_MAILBOX][] = array(
 244         'name'    => 'page_selector_max',
 245         'caption' => _("Maximum Number of Pages to Show"),
 246         'type'    => SMOPT_TYPE_INTEGER,
 247         'refresh' => SMOPT_REFRESH_NONE,
 248         'size'    => SMOPT_SIZE_TINY
 249     );
 250
 251     $optvals[SMOPT_GRP_MAILBOX][] = array(
 252         'name'    => 'show_full_date',
 253         'caption' => _("Always Show Full Date"),
 254         'type'    => SMOPT_TYPE_BOOLEAN,
 255         'refresh' => SMOPT_REFRESH_NONE
 256     );
 257
 258     $optvals[SMOPT_GRP_MAILBOX][] = array(
 259         'name'    => 'truncate_sender',
 260         'caption' => _("Length of From/To Field (0 for full)"),
 261         'type'    => SMOPT_TYPE_INTEGER,
 262         'refresh' => SMOPT_REFRESH_NONE,
 263         'size'    => SMOPT_SIZE_TINY
 264     );
 265
 266     $optvals[SMOPT_GRP_MAILBOX][] = array(
 267         'name'    => 'truncate_subject',
 268         'caption' => _("Length of Subject Field (0 for full)"),
 269         'type'    => SMOPT_TYPE_INTEGER,
 270         'refresh' => SMOPT_REFRESH_NONE,
 271         'size'    => SMOPT_SIZE_TINY
 272     );
 273
 274     $optvals[SMOPT_GRP_MAILBOX][] = array(
 275         'name'    => 'show_recipient_instead',
 276         'caption' => _("Show recipient name if the message is from your default identity"),
 277         'type'    => SMOPT_TYPE_BOOLEAN,
 278         'refresh' => SMOPT_REFRESH_NONE,
 279         'size'    => SMOPT_SIZE_TINY
 280     );
 281
 282     $optvals[SMOPT_GRP_MAILBOX][] = array(
 283         'name'    => 'internal_date_sort',
 284         'caption' => _("Sort by Received Date"),
 285         'type'    => SMOPT_TYPE_BOOLEAN,
 286         'refresh' => SMOPT_REFRESH_ALL
 287     );
 288     if ($allow_thread_sort == TRUE) {
 289         $optvals[SMOPT_GRP_MAILBOX][] = array(
 290             'name'    => 'sort_by_ref',
 291             'caption' => _("Enable Thread Sort by References Header"),
 292             'type'    => SMOPT_TYPE_BOOLEAN,
 293             'refresh' => SMOPT_REFRESH_ALL
 294         );
 295     }
 296
 297
 298
 299     /*** Load the General Options into the array ***/
 300     $optgrps[SMOPT_GRP_MESSAGE] = _("Message Display Options");
 301     $optvals[SMOPT_GRP_MESSAGE] = array();
 302
 303     $optvals[SMOPT_GRP_MESSAGE][] = array(
 304         'name'    => 'wrap_at',
 305         'caption' => _("Wrap Incoming Text At"),
 306         'type'    => SMOPT_TYPE_INTEGER,
 307         'refresh' => SMOPT_REFRESH_NONE,
 308         'size'    => SMOPT_SIZE_TINY
 309     );
 310
 311     $optvals[SMOPT_GRP_MESSAGE][] = array(
 312         'name'    => 'show_html_default',
 313         'caption' => _("Show HTML Version by Default"),
 314         'type'    => SMOPT_TYPE_BOOLEAN,
 315         'refresh' => SMOPT_REFRESH_NONE
 316     );
 317
 318     $optvals[SMOPT_GRP_MESSAGE][] = array(
 319         'name'    => 'enable_forward_as_attachment',
 320         'caption' => _("Enable Forward as Attachment"),
 321         'type'    => SMOPT_TYPE_BOOLEAN,
 322         'refresh' => SMOPT_REFRESH_NONE
 323     );
 324
 325     $optvals[SMOPT_GRP_MESSAGE][] = array(
 326         'name'    => 'show_xmailer_default',
 327         'caption' => _("Enable Mailer Display"),
 328         'type'    => SMOPT_TYPE_BOOLEAN,
 329         'refresh' => SMOPT_REFRESH_NONE
 330     );
 331
 332     $optvals[SMOPT_GRP_MESSAGE][] = array(
 333         'name'    => 'attachment_common_show_images',
 334         'caption' => _("Display Attached Images with Message"),
 335         'type'    => SMOPT_TYPE_BOOLEAN,
 336         'refresh' => SMOPT_REFRESH_NONE
 337     );
 338
 339     if ($default_use_mdn) {
 340         $optvals[SMOPT_GRP_MESSAGE][] = array(
 341             'name'    => 'mdn_user_support',
 342             'caption' => _("Enable Mail Delivery Notification"),
 343             'type'    => SMOPT_TYPE_BOOLEAN,
 344             'refresh' => SMOPT_REFRESH_NONE
 345         );
 346     }
 347
 348     $optvals[SMOPT_GRP_MESSAGE][] = array(
 349         'name'    => 'delete_prev_next_display',
 350         'caption' => _("Show 'Delete & Prev/Next' Links"),
 351         'type'    => SMOPT_TYPE_BOOLEAN,
 352         'refresh' => SMOPT_REFRESH_ALL
 353     );
 354
 355     /* Assemble all this together and return it as our result. */
 356     $result = array(
 357         'grps' => $optgrps,
 358         'vals' => $optvals
 359     );
 360     return ($result);
 361 }
 362
 363 /******************************************************************/
 364 /** Define any specialized save functions for this option page. ***/
 365 /******************************************************************/
 366
 367 /**
 368  * This function saves a new theme setting.
 369  * It updates the theme array.
 370  */
 371 function save_option_theme($option) {
 372     global $theme;
 373
 374     /* Do checking to make sure $new_theme is in the array. */
 375     $theme_in_array = false;
 376     for ($i = 0; $i < count($theme); ++$i) {
 377         if ($theme[$i]['PATH'] == $option->new_value) {
 378             $theme_in_array = true;
 379             break;
 380         }
 381     }
 382
 383     if (!$theme_in_array) {
 384         $option->new_value = '';
 385     }
 386
 387     /* Save the option like normal. */
 388     save_option($option);
 389 }
 390
 391 /**
 392  * This function saves the javascript detection option.
 393  */
 394 function save_option_javascript_autodetect($option) {
 395     save_option($option);
 396     checkForJavascript(TRUE);
 397 }
 398
 399 /**
 400  * This function saves the user's icon theme setting
 401  */
 402 function icon_theme_save($option) {
 403
 404     global $icon_themes, $data_dir, $username;
 405
 406
 407     // Don't assume the new value is there, double check
 408     // and only save if found
 409     //
 410     if (isset($icon_themes[$option->new_value]['PATH']))
 411         setPref($data_dir, $username, 'icon_theme', $icon_themes[$option->new_value]['PATH']);
 412     else
 413        setPref($data_dir, $username, 'icon_theme', 'none');
 414
 415 }
 416
 417 ?>