6 * Copyright (c) 1999-2005 The SquirrelMail Project Team
7 * Licensed under the GNU GPL. For full terms see the file COPYING.
9 * Displays all optinos about display preferences
12 * @package squirrelmail
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);
20 // load icon themes if in use
24 $dirName = SM_PATH
. 'images/themes';
25 if (is_readable($dirName) && is_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");
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
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;
54 /* Build a simple array into which we will build options. */
58 /******************************************************/
59 /* LOAD EACH GROUP OF OPTIONS INTO THE OPTIONS ARRAY. */
60 /******************************************************/
62 /*** Load the General Options into the array ***/
63 $optgrps[SMOPT_GRP_GENERAL
] = _("General Display Options");
64 $optvals[SMOPT_GRP_GENERAL
] = array();
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'];
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'
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 );
94 if ( count( $css_values ) > 1 ) {
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
106 // config.php can be unupdated.
107 if (! isset($available_languages) ||
$available_languages=="" ) {
108 $available_languages="ALL"; }
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'];
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'];
136 asort($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
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
. '\';"'
165 $optvals[SMOPT_GRP_GENERAL
][] = array(
166 'name' => 'js_autodetect_results',
168 'type' => SMOPT_TYPE_HIDDEN
,
169 'refresh' => SMOPT_REFRESH_NONE
170 //'post_script' => $js_autodetect_script,
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"))
182 /*** Load the General Options into the array ***/
183 $optgrps[SMOPT_GRP_MAILBOX
] = _("Mailbox Display Options");
184 $optvals[SMOPT_GRP_MAILBOX
] = array();
186 $optvals[SMOPT_GRP_MAILBOX
][] = array(
187 'name' => 'show_num',
188 'caption' => _("Number of Messages on one Page"),
189 'type' => SMOPT_TYPE_INTEGER
,
190 'refresh' => SMOPT_REFRESH_NONE
,
191 'size' => SMOPT_SIZE_TINY
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
202 global $icon_themes, $icon_theme;
204 for ($count = 0; $count < sizeof($icon_themes); $count++
) {
205 $temp[$count] = $icon_themes[$count]['NAME'];
206 if ($icon_theme == $icon_themes[$count]['PATH'])
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
,
216 'initial_value' => $value,
217 'save' => 'icon_theme_save'
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
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
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
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
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
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
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
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
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
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
299 /*** Load the General Options into the array ***/
300 $optgrps[SMOPT_GRP_MESSAGE
] = _("Message Display Options");
301 $optvals[SMOPT_GRP_MESSAGE
] = array();
303 $optvals[SMOPT_GRP_MESSAGE
][] = array(
305 'caption' => _("Wrap Incoming Text At"),
306 'type' => SMOPT_TYPE_INTEGER
,
307 'refresh' => SMOPT_REFRESH_NONE
,
308 'size' => SMOPT_SIZE_TINY
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
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
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
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
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
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
355 /* Assemble all this together and return it as our result. */
363 /******************************************************************/
364 /** Define any specialized save functions for this option page. ***/
365 /******************************************************************/
367 function save_option_header($option) {
371 * This function saves a new theme setting.
372 * It updates the theme array.
374 function save_option_theme($option) {
377 /* Do checking to make sure $new_theme is in the array. */
378 $theme_in_array = false;
379 for ($i = 0; $i < count($theme); ++
$i) {
380 if ($theme[$i]['PATH'] == $option->new_value
) {
381 $theme_in_array = true;
386 if (!$theme_in_array) {
387 $option->new_value
= '';
390 /* Save the option like normal. */
391 save_option($option);
395 * This function saves the javascript detection option.
397 function save_option_javascript_autodetect($option) {
398 save_option($option);
399 checkForJavascript(TRUE);
403 * This function saves the user's icon theme setting
405 function icon_theme_save($option) {
407 global $icon_themes, $data_dir, $username;
410 // Don't assume the new value is there, double check
411 // and only save if found
413 if (isset($icon_themes[$option->new_value
]['PATH']))
414 setPref($data_dir, $username, 'icon_theme', $icon_themes[$option->new_value
]['PATH']);
416 setPref($data_dir, $username, 'icon_theme', 'none');
421 * This function saves the reply prefix (body_quote) character(s)
423 function save_option_reply_prefix($option) {
425 // save as "NONE" if it was blanked out
427 if (empty($option->new_value
)) $option->new_value
= 'NONE';
430 // Save the option like normal.
432 save_option($option);