Add phpdoc doc blocks to some files.
[squirrelmail.git] / functions / mailbox_display.php
1 <?php
2
3 /**
4 * mailbox_display.php
5 *
6 * Copyright (c) 1999-2003 The SquirrelMail Project Team
7 * Licensed under the GNU GPL. For full terms see the file COPYING.
8 *
9 * This contains functions that display mailbox information, such as the
10 * table row that has sender, date, subject, etc...
11 *
12 * $Id$
13 * @package squirrelmail
14 */
15
16 /** The standard includes.. */
17 require_once(SM_PATH . 'functions/strings.php');
18 require_once(SM_PATH . 'functions/html.php');
19 require_once(SM_PATH . 'class/html.class.php');
20 require_once(SM_PATH . 'functions/imap_mailbox.php');
21 require_once(SM_PATH . 'functions/imap_messages.php');
22 require_once(SM_PATH . 'functions/mime.php');
23
24 /**
25 * default value for page_selector_max
26 */
27 define('PG_SEL_MAX', 10);
28
29 /**
30 * @param mixed $start UNDOCUMENTED
31 */
32 function elapsed($start)
33 {
34 $end = microtime();
35 list($start2, $start1) = explode(" ", $start);
36 list($end2, $end1) = explode(" ", $end);
37 $diff1 = $end1 - $start1;
38 $diff2 = $end2 - $start2;
39 if( $diff2 < 0 ){
40 $diff1 -= 1;
41 $diff2 += 1.0;
42 }
43 return $diff2 + $diff1;
44 }
45
46 function printMessageInfo($imapConnection, $t, $not_last=true, $key, $mailbox,
47 $start_msg, $where, $what) {
48 global $checkall,
49 $color, $msgs, $msort, $td_str, $msg,
50 $default_use_priority,
51 $message_highlight_list,
52 $index_order,
53 $indent_array, /* indent subject by */
54 $pos, /* Search postion (if any) */
55 $thread_sort_messages, /* thread sorting on/off */
56 $server_sort_order, /* sort value when using server-sorting */
57 $row_count,
58 $allow_server_sort, /* enable/disable server-side sorting */
59 $truncate_sender, /* number of characters for From/To field (<= 0 for unchanged) */
60 $email_address,
61 $show_recipient_instead; /* show recipient name instead of default identity */
62
63 $color_string = $color[4];
64
65 if ($GLOBALS['alt_index_colors']) {
66 if (!isset($row_count)) {
67 $row_count = 0;
68 }
69 $row_count++;
70 if ($row_count % 2) {
71 if (!isset($color[12])) {
72 $color[12] = '#EAEAEA';
73 }
74 $color_string = $color[12];
75 }
76 }
77 $msg = $msgs[$key];
78
79 if($mailbox == 'None') {
80 $boxes = sqimap_mailbox_list($imapConnection);
81 $mailbox = $boxes[0]['unformatted'];
82 unset($boxes);
83 }
84 $urlMailbox = urlencode($mailbox);
85
86 $bSentFolder = handleAsSent($mailbox);
87 if ((!$bSentFolder) && ($show_recipient_instead)) {
88 // If the From address is the same as $email_address, then handle as Sent
89 $from_array = parseAddress($msg['FROM'], 1);
90 if (!isset($email_address)) {
91 global $datadir, $username;
92 $email_address = getPref($datadir, $username, 'email_address');
93 }
94 $bHandleAsSent = ((isset($from_array[0][0])) && ($from_array[0][0] == $email_address));
95 }
96 else
97 $bHandleAsSent = $bSentFolder;
98 // If this is a Sent message, display To address instead of From
99 if ($bHandleAsSent)
100 $msg['FROM'] = $msg['TO'];
101 // Passing 1 below results in only 1 address being parsed, thus defeating the following code
102 $msg['FROM'] = parseAddress($msg['FROM']/*,1*/);
103
104 /*
105 * This is done in case you're looking into Sent folders,
106 * because you can have multiple receivers.
107 */
108 $senderNames = $msg['FROM'];
109 $senderName = '';
110 $senderAddress = '';
111 if (sizeof($senderNames)){
112 foreach ($senderNames as $senderNames_part) {
113 if ($senderName != '') {
114 $senderName .= ', ';
115 $senderAddress .= ', ';
116 }
117 $sender_address_part = htmlspecialchars($senderNames_part[0]);
118 $sender_name_part = str_replace('&nbsp;',' ', decodeHeader($senderNames_part[1]));
119 if ($sender_name_part) {
120 $senderName .= $sender_name_part;
121 $senderAddress .= $sender_name_part . ' <' . $sender_address_part . '>';
122 } else {
123 $senderName .= $sender_address_part;
124 $senderAddress .= $sender_address_part;
125 }
126 }
127 }
128 // If Sent, prefix with To: but only if not Sent folder
129 if ($bHandleAsSent ^ $bSentFolder) {
130 $senderName = _("To:") . ' ' . $senderName;
131 $senderAddress = _("To:") . ' ' . $senderAddress;
132 }
133
134 if ($truncate_sender > 0)
135 $senderName = truncateWithEntities($senderName, $truncate_sender);
136
137 echo html_tag( 'tr','','','','VALIGN="top"') . "\n";
138
139 if (isset($msg['FLAG_FLAGGED']) && ($msg['FLAG_FLAGGED'] == true)) {
140 $flag = "<font color=\"$color[2]\">";
141 $flag_end = '</font>';
142 } else {
143 $flag = '';
144 $flag_end = '';
145 }
146 if (!isset($msg['FLAG_SEEN']) || ($msg['FLAG_SEEN'] == false)) {
147 $bold = '<b>';
148 $bold_end = '</b>';
149 } else {
150 $bold = '';
151 $bold_end = '';
152 }
153 if ($bHandleAsSent) {
154 $italic = '<i>';
155 $italic_end = '</i>';
156 } else {
157 $italic = '';
158 $italic_end = '';
159 }
160 if (isset($msg['FLAG_DELETED']) && $msg['FLAG_DELETED']) {
161 $fontstr = "<font color=\"$color[9]\">";
162 $fontstr_end = '</font>';
163 } else {
164 $fontstr = '';
165 $fontstr_end = '';
166 }
167
168 if ($where && $what) {
169 $searchstr = '&amp;where='.$where.'&amp;what='.$what;
170 } else {
171 $searchstr = '';
172 }
173
174 if (is_array($message_highlight_list) && count($message_highlight_list)) {
175 $msg['TO'] = parseAddress($msg['TO']);
176 $msg['CC'] = parseAddress($msg['CC']);
177 foreach ($message_highlight_list as $message_highlight_list_part) {
178 if (trim($message_highlight_list_part['value']) != '') {
179 $high_val = strtolower($message_highlight_list_part['value']);
180 $match_type = strtoupper($message_highlight_list_part['match_type']);
181 if($match_type == 'TO_CC') {
182 $match = array('TO', 'CC');
183 } else {
184 $match = array($match_type);
185 }
186 foreach($match as $match_type) {
187 switch($match_type) {
188 case('TO'):
189 case('CC'):
190 case('FROM'):
191 foreach ($msg[$match_type] as $address) {
192 $address[0] = decodeHeader($address[0], true, false);
193 $address[1] = decodeHeader($address[1], true, false);
194 if (strstr('^^' . strtolower($address[0]), $high_val) ||
195 strstr('^^' . strtolower($address[1]), $high_val)) {
196 $hlt_color = $message_highlight_list_part['color'];
197 break 4;
198 }
199 }
200 break;
201 default:
202 $headertest = strtolower(decodeHeader($msg[$match_type], true, false));
203 if (strstr('^^' . $headertest, $high_val)) {
204 $hlt_color = $message_highlight_list_part['color'];
205 break 3;
206 }
207 break;
208 }
209 }
210 }
211 }
212 }
213
214 if (!isset($hlt_color)) {
215 $hlt_color = $color_string;
216 }
217 $checked = ($checkall == 1) ? ' CHECKED' : '';
218 $col = 0;
219 $msg['SUBJECT'] = str_replace('&nbsp;', ' ', decodeHeader($msg['SUBJECT']));
220 $subject = processSubject($msg['SUBJECT'], $indent_array[$msg['ID']]);
221 if (sizeof($index_order)) {
222 foreach ($index_order as $index_order_part) {
223 switch ($index_order_part) {
224 case 1: /* checkbox */
225 echo html_tag( 'td',
226 "<input type=checkbox name=\"msg[$t]\" value=\"".$msg['ID']."\"$checked>",
227 'center',
228 $hlt_color );
229 break;
230 case 2: /* from */
231 if ($senderAddress != $senderName) {
232 $senderAddress = strtr($senderAddress, array_flip(get_html_translation_table(HTML_SPECIALCHARS)));
233 $title = ' title="' . str_replace('"', "''", $senderAddress) . '"';
234 }
235 else
236 $title = '';
237 echo html_tag( 'td',
238 $italic . $bold . $flag . $fontstr . $senderName .
239 $fontstr_end . $flag_end . $bold_end . $italic_end,
240 'left',
241 $hlt_color, $title );
242 break;
243 case 3: /* date */
244 $date_string = $msg['DATE_STRING'] . '';
245 if ($date_string == '') {
246 $date_string = _("Unknown date");
247 }
248 echo html_tag( 'td',
249 $bold . $flag . $fontstr . $date_string .
250 $fontstr_end . $flag_end . $bold_end,
251 'center',
252 $hlt_color,
253 'nowrap' );
254 break;
255 case 4: /* subject */
256 $td_str = $bold;
257 if ($thread_sort_messages == 1) {
258 if (isset($indent_array[$msg['ID']])) {
259 $td_str .= str_repeat("&nbsp;&nbsp;&nbsp;&nbsp;",$indent_array[$msg['ID']]);
260 }
261 }
262 $td_str .= '<a href="read_body.php?mailbox='.$urlMailbox
263 . '&amp;passed_id='. $msg["ID"]
264 . '&amp;startMessage='.$start_msg.$searchstr.'"';
265 $td_str .= ' ' .concat_hook_function('subject_link', array($start_msg, $searchstr));
266 if ($subject != $msg['SUBJECT']) {
267 $title = get_html_translation_table(HTML_SPECIALCHARS);
268 $title = array_flip($title);
269 $title = strtr($msg['SUBJECT'], $title);
270 $title = str_replace('"', "''", $title);
271 $td_str .= " title=\"$title\"";
272 }
273 $td_str .= ">$flag$subject$flag_end</a>$bold_end";
274 echo html_tag( 'td', $td_str, 'left', $hlt_color );
275 break;
276 case 5: /* flags */
277 $stuff = false;
278 $td_str = "<b><small>";
279
280 if (isset($msg['FLAG_ANSWERED']) && $msg['FLAG_ANSWERED'] == true) {
281 $td_str .= _("A");
282 $stuff = true;
283 }
284 if ($msg['TYPE0'] == 'multipart') {
285 $td_str .= '+';
286 $stuff = true;
287 }
288 if ($default_use_priority) {
289 if ( ($msg['PRIORITY'] == 1) || ($msg['PRIORITY'] == 2) ) {
290 $td_str .= "<font color=\"$color[1]\">!</font>";
291 $stuff = true;
292 }
293 if ($msg['PRIORITY'] == 5) {
294 $td_str .= "<font color=\"$color[8]\">?</font>";
295 $stuff = true;
296 }
297 }
298 if (isset($msg['FLAG_DELETED']) && $msg['FLAG_DELETED'] == true) {
299 $td_str .= "<font color=\"$color[1]\">D</font>";
300 $stuff = true;
301 }
302 if (!$stuff) {
303 $td_str .= '&nbsp;';
304 }
305 do_hook("msg_envelope");
306 $td_str .= '</small></b>';
307 echo html_tag( 'td',
308 $td_str,
309 'center',
310 $hlt_color,
311 'nowrap' );
312 break;
313 case 6: /* size */
314 echo html_tag( 'td',
315 $bold . $fontstr . show_readable_size($msg['SIZE']) .
316 $fontstr_end . $bold_end,
317 'right',
318 $hlt_color );
319 break;
320 }
321 ++$col;
322 }
323 }
324 if ($not_last) {
325 echo '</tr>' . "\n" . '<tr><td COLSPAN="' . $col . '" BGCOLOR="' .
326 $color[0] . '" HEIGHT="1"></td></tr>' . "\n";
327 } else {
328 echo '</tr>'."\n";
329 }
330 }
331
332 function getServerMessages($imapConnection, $start_msg, $show_num, $num_msgs, $id) {
333 if ($id != 'no') {
334 $id = array_slice($id, ($start_msg-1), $show_num);
335 $end = $start_msg + $show_num - 1;
336 if ($num_msgs < $show_num) {
337 $end_loop = $num_msgs;
338 } else if ($end > $num_msgs) {
339 $end_loop = $num_msgs - $start_msg + 1;
340 } else {
341 $end_loop = $show_num;
342 }
343 return fillMessageArray($imapConnection,$id,$end_loop,$show_num);
344 } else {
345 return false;
346 }
347 }
348
349 function getThreadMessages($imapConnection, $start_msg, $show_num, $num_msgs) {
350 $id = get_thread_sort($imapConnection);
351 return getServerMessages($imapConnection, $start_msg, $show_num, $num_msgs, $id);
352 }
353
354 function getServerSortMessages($imapConnection, $start_msg, $show_num,
355 $num_msgs, $server_sort_order, $mbxresponse) {
356 $id = sqimap_get_sort_order($imapConnection, $server_sort_order,$mbxresponse);
357 return getServerMessages($imapConnection, $start_msg, $show_num, $num_msgs, $id);
358 }
359
360 function getSelfSortMessages($imapConnection, $start_msg, $show_num,
361 $num_msgs, $sort, $mbxresponse) {
362 $msgs = array();
363 if ($num_msgs >= 1) {
364 $id = sqimap_get_php_sort_order ($imapConnection, $mbxresponse);
365 if ($sort < 6 ) {
366 $end = $num_msgs;
367 $end_loop = $end;
368 /* set shownum to 999999 to fool sqimap_get_small_header_list
369 and rebuild the msgs_str to 1:* */
370 $show_num = 999999;
371 } else {
372 /* if it's not sorted */
373 if ($start_msg + ($show_num - 1) < $num_msgs) {
374 $end_msg = $start_msg + ($show_num - 1);
375 } else {
376 $end_msg = $num_msgs;
377 }
378 if ($end_msg < $start_msg) {
379 $start_msg = $start_msg - $show_num;
380 if ($start_msg < 1) {
381 $start_msg = 1;
382 }
383 }
384 $id = array_slice(array_reverse($id), ($start_msg-1), $show_num);
385 $end = $start_msg + $show_num - 1;
386 if ($num_msgs < $show_num) {
387 $end_loop = $num_msgs;
388 } else if ($end > $num_msgs) {
389 $end_loop = $num_msgs - $start_msg + 1;
390 } else {
391 $end_loop = $show_num;
392 }
393 }
394 $msgs = fillMessageArray($imapConnection,$id,$end_loop, $show_num);
395 }
396 return $msgs;
397 }
398
399
400
401 /*
402 * This function loops through a group of messages in the mailbox
403 * and shows them to the user.
404 */
405 function showMessagesForMailbox($imapConnection, $mailbox, $num_msgs,
406 $start_msg, $sort, $color, $show_num,
407 $use_cache, $mode='') {
408 global $msgs, $msort, $auto_expunge, $thread_sort_messages,
409 $allow_server_sort, $server_sort_order;
410
411 /*
412 * For some reason, on PHP 4.3+, this being unset, and set in the session causes havoc
413 * so setting it to an empty array beforehand seems to clean up the issue, and stopping the
414 * "Your script possibly relies on a session side-effect which existed until PHP 4.2.3" error
415 */
416
417 if (!isset($msort)) {
418 $msort = array();
419 }
420
421 if (!isset($msgs)) {
422 $msgs = array();
423 }
424
425 //$start = microtime();
426 /* If autoexpunge is turned on, then do it now. */
427 $mbxresponse = sqimap_mailbox_select($imapConnection, $mailbox);
428 $srt = $sort;
429 /* If autoexpunge is turned on, then do it now. */
430 if ($auto_expunge == true) {
431 $exp_cnt = sqimap_mailbox_expunge($imapConnection, $mailbox, false, '');
432 $mbxresponse['EXISTS'] = $mbxresponse['EXISTS'] - $exp_cnt;
433 $num_msgs = $mbxresponse['EXISTS'];
434 }
435
436 if ($mbxresponse['EXISTS'] > 0) {
437 /* if $start_msg is lower than $num_msgs, we probably deleted all messages
438 * in the last page. We need to re-adjust the start_msg
439 */
440
441 if($start_msg > $num_msgs) {
442 $start_msg -= $show_num;
443 if($start_msg < 1) {
444 $start_msg = 1;
445 }
446 }
447
448 /* This code and the next if() block check for
449 * server-side sorting methods. The $id array is
450 * formatted and $sort is set to 6 to disable
451 * SM internal sorting
452 */
453
454 if ($thread_sort_messages == 1) {
455 $mode = 'thread';
456 } elseif ($allow_server_sort == 1) {
457 $mode = 'serversort';
458 } else {
459 $mode = '';
460 }
461
462 if ($use_cache) {
463 sqgetGlobalVar('msgs', $msgs, SQ_SESSION);
464 sqgetGlobalVar('msort', $msort, SQ_SESSION);
465 } else {
466 sqsession_unregister('msort');
467 sqsession_unregister('msgs'); }
468 switch ($mode) {
469 case 'thread':
470 $id = get_thread_sort($imapConnection);
471 $msgs = getServerMessages($imapConnection, $start_msg, $show_num, $num_msgs, $id);
472 if ($msgs === false) {
473 echo '<b><small><center><font color=red>' .
474 _("Thread sorting is not supported by your IMAP server.<br>Please report this to the system administrator.").
475 '</center></small></b>';
476 $thread_sort_messages = 0;
477 $msort = $msgs = array();
478 } else {
479 $msort= $msgs;
480 $sort = 6;
481 }
482 break;
483 case 'serversort':
484 $id = sqimap_get_sort_order($imapConnection, $sort, $mbxresponse);
485 $msgs = getServerMessages($imapConnection, $start_msg, $show_num, $num_msgs, $id);
486 if ($msgs === false) {
487 echo '<b><small><center><font color=red>' .
488 _( "Server-side sorting is not supported by your IMAP server.<br>Please report this to the system administrator.").
489 '</center></small></b>';
490 $sort = $server_sort_order;
491 $allow_server_sort = FALSE;
492 $msort = $msgs = array();
493 $id = array();
494 } else {
495 $msort = $msgs;
496 $sort = 6;
497 }
498 break;
499 default:
500 if (!$use_cache) {
501 $msgs = getSelfSortMessages($imapConnection, $start_msg, $show_num,
502 $num_msgs, $sort, $mbxresponse);
503 $msort = calc_msort($msgs, $sort);
504 } /* !use cache */
505 break;
506 } // switch
507 sqsession_register($msort, 'msort');
508 sqsession_register($msgs, 'msgs');
509
510 } /* if exists > 0 */
511
512 $res = getEndMessage($start_msg, $show_num, $num_msgs);
513 $start_msg = $res[0];
514 $end_msg = $res[1];
515
516 $paginator_str = get_paginator_str($mailbox, $start_msg, $end_msg,
517 $num_msgs, $show_num, $sort);
518
519 $msg_cnt_str = get_msgcnt_str($start_msg, $end_msg, $num_msgs);
520
521 do_hook('mailbox_index_before');
522 echo '<table border="0" width="100%" cellpadding="0" cellspacing="0">';
523 echo '<tr><td>';
524
525 mail_message_listing_beginning($imapConnection, $mailbox, $sort,
526 $msg_cnt_str, $paginator_str, $start_msg);
527 echo '</td></tr>';
528 /* line between the button area and the list */
529 echo '<tr><td HEIGHT="5" BGCOLOR="'.$color[4].'"></td></tr>';
530
531 echo '<tr><td>';
532 echo ' <table width="100%" cellpadding="1" cellspacing="0" align="center"'.' border="0" bgcolor="'.$color[9].'">';
533 echo ' <tr><td>';
534 echo ' <table width="100%" cellpadding="1" cellspacing="0" align="center" border="0" bgcolor="'.$color[5].'">';
535 echo '<tr><td>';
536 printHeader($mailbox, $srt, $color, !$thread_sort_messages);
537
538 displayMessageArray($imapConnection, $num_msgs, $start_msg,
539 $msort, $mailbox, $sort, $color, $show_num,0,0);
540 echo '</td></tr></table></td></tr></table>';
541
542 mail_message_listing_end($num_msgs, $paginator_str, $msg_cnt_str, $color);
543 echo '</td></tr></table>';
544 //$t = elapsed($start);
545 //echo("elapsed time = $t seconds\n");
546 }
547
548 function calc_msort($msgs, $sort) {
549
550 /*
551 * 0 = Date (up)
552 * 1 = Date (dn)
553 * 2 = Name (up)
554 * 3 = Name (dn)
555 * 4 = Subject (up)
556 * 5 = Subject (dn)
557 */
558
559 if (($sort == 0) || ($sort == 1)) {
560 foreach ($msgs as $item) {
561 $msort[] = $item['TIME_STAMP'];
562 }
563 } elseif (($sort == 2) || ($sort == 3)) {
564 foreach ($msgs as $item) {
565 $msort[] = $item['FROM-SORT'];
566 }
567 } elseif (($sort == 4) || ($sort == 5)) {
568 foreach ($msgs as $item) {
569 $msort[] = $item['SUBJECT-SORT'];
570 }
571 } else {
572 $msort = $msgs;
573 }
574 if ($sort < 6) {
575 if ($sort % 2) {
576 asort($msort);
577 } else {
578 arsort($msort);
579 }
580 }
581 return $msort;
582 }
583
584 function fillMessageArray($imapConnection, $id, $count, $show_num=false) {
585 return sqimap_get_small_header_list($imapConnection, $id, $show_num);
586 }
587
588
589 /* Generic function to convert the msgs array into an HTML table. */
590 function displayMessageArray($imapConnection, $num_msgs, $start_msg,
591 $msort, $mailbox, $sort, $color,
592 $show_num, $where=0, $what=0) {
593 global $imapServerAddress, $use_mailbox_cache, $index_order,
594 $indent_array, $thread_sort_messages, $allow_server_sort,
595 $server_sort_order, $PHP_SELF;
596
597 $res = getEndMessage($start_msg, $show_num, $num_msgs);
598 $start_msg = $res[0];
599 $end_msg = $res[1];
600
601 $urlMailbox = urlencode($mailbox);
602
603 /* get indent level for subject display */
604 if ($thread_sort_messages == 1 && $num_msgs) {
605 $indent_array = get_parent_level($imapConnection);
606 }
607
608 $real_startMessage = $start_msg;
609 if ($sort == 6) {
610 if ($end_msg - $start_msg < $show_num - 1) {
611 $end_msg = $end_msg - $start_msg + 1;
612 $start_msg = 1;
613 } else if ($start_msg > $show_num) {
614 $end_msg = $show_num;
615 $start_msg = 1;
616 }
617 }
618 $endVar = $end_msg + 1;
619
620 /*
621 * Loop through and display the info for each message.
622 * ($t is used for the checkbox number)
623 */
624 $t = 0;
625
626 /* messages display */
627
628 if (!$num_msgs) {
629 /* if there's no messages in this folder */
630 echo html_tag( 'tr',
631 html_tag( 'td',
632 "<BR><b>" . _("THIS FOLDER IS EMPTY") . "</b><BR>&nbsp;",
633 'center',
634 $color[4],
635 'COLSPAN="' . count($index_order) . '"'
636 )
637 );
638 } elseif ($start_msg == $end_msg) {
639 /* if there's only one message in the box, handle it differently. */
640 if ($sort != 6) {
641 $i = $start_msg;
642 } else {
643 $i = 1;
644 }
645 reset($msort);
646 $k = 0;
647 do {
648 $key = key($msort);
649 next($msort);
650 $k++;
651 } while (isset ($key) && ($k < $i));
652 printMessageInfo($imapConnection, $t, true, $key, $mailbox,
653 $real_startMessage, $where, $what);
654 } else {
655 $i = $start_msg;
656 reset($msort);
657 $k = 0;
658 do {
659 $key = key($msort);
660 next($msort);
661 $k++;
662 } while (isset ($key) && ($k < $i));
663 $not_last = true;
664 do {
665 if (!$i || $i == $endVar-1) $not_last = false;
666 printMessageInfo($imapConnection, $t, $not_last, $key, $mailbox,
667 $real_startMessage, $where, $what);
668 $key = key($msort);
669 $t++;
670 $i++;
671 next($msort);
672 } while ($i && $i < $endVar);
673 }
674 }
675
676 /*
677 * Displays the standard message list header. To finish the table,
678 * you need to do a "</table></table>";
679 *
680 * $moveURL is the URL to submit the delete/move form to
681 * $mailbox is the current mailbox
682 * $sort is the current sorting method (-1 for no sorting available [searches])
683 * $Message is a message that is centered on top of the list
684 * $More is a second line that is left aligned
685 */
686
687 function mail_message_listing_beginning ($imapConnection,
688 $mailbox = '', $sort = -1,
689 $msg_cnt_str = '',
690 $paginator = '&nbsp;',
691 $start_msg = 1) {
692 global $color, $auto_expunge, $base_uri, $thread_sort_messages,
693 $allow_thread_sort, $allow_server_sort, $server_sort_order,
694 $PHP_SELF;
695
696 $php_self = $PHP_SELF;
697 /* fix for incorrect $PHP_SELF */
698 if (strpos($php_self, 'move_messages.php')) {
699 $php_self = str_replace('move_messages.php', 'right_main.php', $php_self);
700 }
701 $urlMailbox = urlencode($mailbox);
702
703 if (preg_match('/^(.+)\?.+$/',$php_self,$regs)) {
704 $source_url = $regs[1];
705 } else {
706 $source_url = $php_self;
707 }
708
709 if (!isset($msg)) {
710 $msg = '';
711 }
712 $moveFields = '<input type="hidden" name="msg" value="'.htmlspecialchars($msg).'">' .
713 '<input type="hidden" name="mailbox" value="'.htmlspecialchars($mailbox).'">' .
714 '<input type="hidden" name="startMessage" value="'.htmlspecialchars($start_msg).'">';
715
716 // $moveURL = "move_messages.php?msg=$msg&amp;mailbox=$urlMailbox"
717 // . "&amp;startMessage=$start_msg";
718 /*
719 * This is the beginning of the message list table.
720 * It wraps around all messages
721 */
722 $safe_name = preg_replace("/[^0-9A-Za-z_]/", '_', $mailbox);
723 $form_name = "FormMsgs" . $safe_name;
724 echo '<form name="' . $form_name . '" method="post" action="move_messages.php">' ."\n"
725 . $moveFields
726 . html_tag( 'table' ,
727 html_tag( 'tr',
728 html_tag( 'td' ,
729 html_tag( 'table' ,
730 html_tag( 'tr',
731 html_tag( 'td', $paginator, 'left' ) .
732 html_tag( 'td', $msg_cnt_str, 'right' )
733 )
734 , '', $color[4], 'border="0" width="100%" cellpadding="1" cellspacing="0"' )
735 , 'left', '', '' )
736 , '', $color[0] )
737 , '', '', 'border="0" width="100%" cellpadding="1" cellspacing="0"' );
738 /* line between header and button area */
739 echo '<tr><td HEIGHT="5" BGCOLOR="'.$color[4].'"></td></tr>';
740
741 echo '<tr><td>';
742 echo html_tag( 'tr' ) . "\n"
743 . html_tag( 'td' ,'' , 'left', '', '' )
744 . html_tag( 'table' ,'' , '', $color[9], 'border="0" width="100%" cellpadding="1" cellspacing="0"' )
745 . '<tr><td>'
746 . html_tag( 'table' ,'' , '', $color[0], 'border="0" width="100%" cellpadding="1" cellspacing="0"' )
747 . html_tag( 'tr',
748 getSmallStringCell(_("Move Selected To"), 'left', 'nowrap') .
749 getSmallStringCell(_("Transform Selected Messages"), 'right')
750 )
751 . html_tag( 'tr' ) ."\n"
752 . html_tag( 'td', '', 'left', '', 'valign="middle" nowrap' );
753 getMbxList($imapConnection);
754 echo getButton('SUBMIT', 'moveButton',_("Move")) . "\n";
755 echo getButton('SUBMIT', 'attache',_("Forward")) . "\n";
756
757 echo " </TD>\n"
758 . html_tag( 'td', '', 'right', '', 'nowrap' );
759
760
761
762 if (!$auto_expunge) {
763 echo getButton('SUBMIT', 'expungeButton',_("Expunge"))
764 .'&nbsp;' . _("mailbox") . "\n";
765 }
766 do_hook('mailbox_display_buttons');
767 echo getButton('SUBMIT', 'markRead',_("Read"));
768 echo getButton('SUBMIT', 'markUnread',_("Unread"));
769 echo getButton('SUBMIT', 'delete',_("Delete")) ."&nbsp;\n";
770 if (!strpos($php_self,'mailbox')) {
771 $location = $php_self.'?mailbox=INBOX&amp;startMessage=1';
772 } else {
773 $location = $php_self;
774 }
775 echo '<INPUT TYPE="HIDDEN" NAME="location" VALUE="'.$location.'">';
776 echo "</TD>\n"
777 . " </TR>\n";
778
779 /* draws thread sorting links */
780 if ($allow_thread_sort == TRUE) {
781 if ($thread_sort_messages == 1 ) {
782 $set_thread = 2;
783 $thread_name = _("Unthread View");
784 } elseif ($thread_sort_messages == 0) {
785 $set_thread = 1;
786 $thread_name = _("Thread View");
787 }
788 echo html_tag( 'tr' ,
789 html_tag( 'td' ,
790 '&nbsp;<a href=' . $source_url . '?sort='
791 . "$sort" . '&start_messages=1&set_thread=' . "$set_thread"
792 . '&mailbox=' . urlencode($mailbox) . '><small>' . $thread_name
793 . '</a></small>&nbsp;'
794 , '', '', '' ) . html_tag( 'td', _("Bypass Trash") . '<input type="checkbox" name="bypass_trash">','right','','')
795
796 , '', '', '' );
797 }
798
799 echo "</TABLE></td></tr></table></td></tr>\n";
800
801 do_hook('mailbox_form_before');
802
803 /* if using server sort we highjack the
804 * the $sort var and use $server_sort_order
805 * instead. but here we reset sort for a bit
806 * since its easy
807 */
808 if ($allow_server_sort == TRUE) {
809 $sort = $server_sort_order;
810 }
811 }
812
813 function mail_message_listing_end($num_msgs, $paginator_str, $msg_cnt_str, $color) {
814 if ($num_msgs) {
815 /* space between list and footer */
816 echo '<tr><td HEIGHT="5" BGCOLOR="'.$color[4].'" COLSPAN="1">';
817
818 echo '</td></tr><tr><td>';
819 echo html_tag( 'table',
820 html_tag( 'tr',
821 html_tag( 'td',
822 html_tag( 'table',
823 html_tag( 'tr',
824 html_tag( 'td', $paginator_str ) .
825 html_tag( 'td', $msg_cnt_str, 'right' )
826 )
827 , '', $color[4], 'width="100%" border="0" cellpadding="1" cellspacing="0"' )
828 )
829 )
830 , '', $color[9], 'width="100%" border="0" cellpadding="1" cellspacing="0"' );
831 echo '</td></tr>';
832 }
833 /* End of message-list table */
834
835 do_hook('mailbox_index_after');
836 echo "</FORM>\n";
837 }
838
839 function printHeader($mailbox, $sort, $color, $showsort=true) {
840 global $index_order;
841 echo html_tag( 'tr' ,'' , 'center', $color[5] );
842
843 /* calculate the width of the subject column based on the
844 * widths of the other columns */
845 $widths = array(1=>1,2=>25,3=>5,4=>0,5=>1,6=>5);
846 $subjectwidth = 100;
847 foreach($index_order as $item) {
848 $subjectwidth -= $widths[$item];
849 }
850
851 foreach ($index_order as $item) {
852 switch ($item) {
853 case 1: /* checkbox */
854 case 5: /* flags */
855 echo html_tag( 'td' ,'&nbsp;' , '', '', 'width="1%"' );
856 break;
857 case 2: /* from */
858 if (handleAsSent($mailbox)) {
859 echo html_tag( 'td' ,'' , 'left', '', 'width="25%"' )
860 . '<b>' . _("To") . '</b>';
861 } else {
862 echo html_tag( 'td' ,'' , 'left', '', 'width="25%"' )
863 . '<b>' . _("From") . '</b>';
864 }
865 if ($showsort) {
866 ShowSortButton($sort, $mailbox, 2, 3);
867 }
868 echo "</td>\n";
869 break;
870 case 3: /* date */
871 echo html_tag( 'td' ,'' , 'left', '', 'width="5%" nowrap' )
872 . '<b>' . _("Date") . '</b>';
873 if ($showsort) {
874 ShowSortButton($sort, $mailbox, 0, 1);
875 }
876 echo "</td>\n";
877 break;
878 case 4: /* subject */
879 echo html_tag( 'td' ,'' , 'left', '', 'width="'.$subjectwidth.'%"' )
880 . '<b>' . _("Subject") . '</b>';
881 if ($showsort) {
882 ShowSortButton($sort, $mailbox, 4, 5);
883 }
884 echo "</td>\n";
885 break;
886 case 6: /* size */
887 echo html_tag( 'td', '<b>' . _("Size") . '</b>', 'center', '', 'width="5%" nowrap' );
888 break;
889 }
890 }
891 echo "</tr>\n";
892 }
893
894
895 /*
896 * This function shows the sort button. Isn't this a good comment?
897 */
898 function ShowSortButton($sort, $mailbox, $Up, $Down ) {
899 global $PHP_SELF;
900 /* Figure out which image we want to use. */
901 if ($sort != $Up && $sort != $Down) {
902 $img = 'sort_none.png';
903 $which = $Up;
904 } elseif ($sort == $Up) {
905 $img = 'up_pointer.png';
906 $which = $Down;
907 } else {
908 $img = 'down_pointer.png';
909 $which = 6;
910 }
911
912 if (preg_match('/^(.+)\?.+$/',$PHP_SELF,$regs)) {
913 $source_url = $regs[1];
914 } else {
915 $source_url = $PHP_SELF;
916 }
917
918 /* Now that we have everything figured out, show the actual button. */
919 echo ' <a href="' . $source_url .'?newsort=' . $which
920 . '&amp;startMessage=1&amp;mailbox=' . urlencode($mailbox)
921 . '"><img src="../images/' . $img
922 . '" border="0" width="12" height="10" alt="sort" title="'
923 . _("Click here to change the sorting of the message list") .'"></a>';
924 }
925
926 function get_selectall_link($start_msg, $sort) {
927 global $checkall, $what, $where, $mailbox, $javascript_on;
928 global $PHP_SELF, $PG_SHOWNUM;
929
930 $result = '';
931 if ($javascript_on) {
932 $safe_name = preg_replace("/[^0-9A-Za-z_]/", '_', $mailbox);
933 $func_name = "CheckAll" . $safe_name;
934 $form_name = "FormMsgs" . $safe_name;
935 $result = '<script language="JavaScript" type="text/javascript">'
936 . "\n<!-- \n"
937 . "function " . $func_name . "() {\n"
938 . " for (var i = 0; i < document." . $form_name . ".elements.length; i++) {\n"
939 . " if(document." . $form_name . ".elements[i].type == 'checkbox' && "
940 . "document." . $form_name . ".elements[i].name != 'bypass_trash'){\n"
941 . " document." . $form_name . ".elements[i].checked = "
942 . " !(document." . $form_name . ".elements[i].checked);\n"
943 . " }\n"
944 . " }\n"
945 . "}\n"
946 . "//-->\n"
947 . '</script><a href="javascript:void(0)" onClick="' . $func_name . '();">' . _("Toggle All")
948 /* . '</script><a href="javascript:' . $func_name . '()">' . _("Toggle All")*/
949 . "</a>\n";
950 } else {
951 if (strpos($PHP_SELF, "?")) {
952 $result .= "<a href=\"$PHP_SELF&amp;mailbox=" . urlencode($mailbox)
953 . "&amp;startMessage=$start_msg&amp;sort=$sort&amp;checkall=";
954 } else {
955 $result .= "<a href=\"$PHP_SELF?mailbox=" . urlencode($mailbox)
956 . "&amp;startMessage=$start_msg&amp;sort=$sort&amp;checkall=";
957 }
958 if (isset($checkall) && $checkall == '1') {
959 $result .= '0';
960 } else {
961 $result .= '1';
962 }
963
964 if (isset($where) && isset($what)) {
965 $result .= '&amp;where=' . urlencode($where)
966 . '&amp;what=' . urlencode($what);
967 }
968 $result .= "\">";
969
970 if (isset($checkall) && ($checkall == '1')) {
971 $result .= _("Unselect All");
972 } else {
973 $result .= _("Select All");
974 }
975 $result .= "</A>\n";
976 }
977
978 /* Return our final result. */
979 return ($result);
980 }
981
982 /*
983 * This function computes the "Viewing Messages..." string.
984 */
985 function get_msgcnt_str($start_msg, $end_msg, $num_msgs) {
986 /* Compute the $msg_cnt_str. */
987 $result = '';
988 if ($start_msg < $end_msg) {
989 $result = sprintf(_("Viewing Messages: <B>%s</B> to <B>%s</B> (%s total)"),
990 $start_msg, $end_msg, $num_msgs);
991 } else if ($start_msg == $end_msg) {
992 $result = sprintf(_("Viewing Message: <B>%s</B> (1 total)"), $start_msg);
993 } else {
994 $result = '<br>';
995 }
996 /* Return our result string. */
997 return ($result);
998 }
999
1000 /*
1001 * Generate a paginator link.
1002 */
1003 function get_paginator_link($box, $start_msg, $use, $text) {
1004 global $PHP_SELF;
1005
1006 $result = "<A HREF=\"right_main.php?use_mailbox_cache=$use"
1007 . "&amp;startMessage=$start_msg&amp;mailbox=$box\" "
1008 . "TARGET=\"right\">$text</A>";
1009 return ($result);
1010 /*
1011 if (preg_match('/^(.+)\?.+$/',$PHP_SELF,$regs)) {
1012 $source_url = $regs[1];
1013 } else {
1014 $source_url = $PHP_SELF;
1015 }
1016
1017 $result = '<A HREF="'. $source_url . "?use_mailbox_cache=$use"
1018 . "&amp;startMessage=$start_msg&amp;mailbox=$box\" "
1019 . "TARGET=\"right\">$text</A>";
1020 return ($result);
1021 */
1022 }
1023
1024 /*
1025 * This function computes the paginator string.
1026 */
1027 function get_paginator_str($box, $start_msg, $end_msg, $num_msgs,
1028 $show_num, $sort) {
1029 global $username, $data_dir, $use_mailbox_cache, $color, $PG_SHOWNUM;
1030
1031 /* Initialize paginator string chunks. */
1032 $prv_str = '';
1033 $nxt_str = '';
1034 $pg_str = '';
1035 $all_str = '';
1036 $tgl_str = '';
1037
1038 $box = urlencode($box);
1039
1040 /* Create simple strings that will be creating the paginator. */
1041 $spc = '&nbsp;'; /* This will be used as a space. */
1042 $sep = '|'; /* This will be used as a seperator. */
1043
1044 /* Get some paginator preference values. */
1045 $pg_sel = getPref($data_dir, $username, 'page_selector', SMPREF_ON);
1046 $pg_max = getPref($data_dir, $username, 'page_selector_max', PG_SEL_MAX);
1047
1048 /* Make sure that our start message number is not too big. */
1049 $start_msg = min($start_msg, $num_msgs);
1050
1051 /* Decide whether or not we will use the mailbox cache. */
1052 /* Not sure why $use_mailbox_cache is even passed in. */
1053 if ($sort == 6) {
1054 $use = 0;
1055 } else {
1056 $use = 1;
1057 }
1058
1059 /* Compute the starting message of the previous and next page group. */
1060 $next_grp = $start_msg + $show_num;
1061 $prev_grp = $start_msg - $show_num;
1062
1063 /* Compute the basic previous and next strings. */
1064 if (($next_grp <= $num_msgs) && ($prev_grp >= 0)) {
1065 $prv_str = get_paginator_link($box, $prev_grp, $use, _("Previous"));
1066 $nxt_str = get_paginator_link($box, $next_grp, $use, _("Next"));
1067 } else if (($next_grp > $num_msgs) && ($prev_grp >= 0)) {
1068 $prv_str = get_paginator_link($box, $prev_grp, $use, _("Previous"));
1069 $nxt_str = "<FONT COLOR=\"$color[9]\">"._("Next")."</FONT>\n";
1070 } else if (($next_grp <= $num_msgs) && ($prev_grp < 0)) {
1071 $prv_str = "<FONT COLOR=\"$color[9]\">"._("Previous") . '</FONT>';
1072 $nxt_str = get_paginator_link($box, $next_grp, $use, _("Next"));
1073 }
1074
1075 /* Page selector block. Following code computes page links. */
1076 if ($pg_sel && ($num_msgs > $show_num)) {
1077 /* Most importantly, what is the current page!!! */
1078 $cur_pg = intval($start_msg / $show_num) + 1;
1079
1080 /* Compute total # of pages and # of paginator page links. */
1081 $tot_pgs = ceil($num_msgs / $show_num); /* Total number of Pages */
1082 $vis_pgs = min($pg_max, $tot_pgs - 1); /* Visible Pages */
1083
1084 /* Compute the size of the four quarters of the page links. */
1085
1086 /* If we can, just show all the pages. */
1087 if (($tot_pgs - 1) <= $pg_max) {
1088 $q1_pgs = $cur_pg - 1;
1089 $q2_pgs = $q3_pgs = 0;
1090 $q4_pgs = $tot_pgs - $cur_pg;
1091
1092 /* Otherwise, compute some magic to choose the four quarters. */
1093 } else {
1094 /*
1095 * Compute the magic base values. Added together,
1096 * these values will always equal to the $pag_pgs.
1097 * NOTE: These are DEFAULT values and do not take
1098 * the current page into account. That is below.
1099 */
1100 $q1_pgs = floor($vis_pgs/4);
1101 $q2_pgs = round($vis_pgs/4, 0);
1102 $q3_pgs = ceil($vis_pgs/4);
1103 $q4_pgs = round(($vis_pgs - $q2_pgs)/3, 0);
1104
1105 /* Adjust if the first quarter contains the current page. */
1106 if (($cur_pg - $q1_pgs) < 1) {
1107 $extra_pgs = ($q1_pgs - ($cur_pg - 1)) + $q2_pgs;
1108 $q1_pgs = $cur_pg - 1;
1109 $q2_pgs = 0;
1110 $q3_pgs += ceil($extra_pgs / 2);
1111 $q4_pgs += floor($extra_pgs / 2);
1112
1113 /* Adjust if the first and second quarters intersect. */
1114 } else if (($cur_pg - $q2_pgs - ceil($q2_pgs/3)) <= $q1_pgs) {
1115 $extra_pgs = $q2_pgs;
1116 $extra_pgs -= ceil(($cur_pg - $q1_pgs - 1) * 3/4);
1117 $q2_pgs = ceil(($cur_pg - $q1_pgs - 1) * 3/4);
1118 $q3_pgs += ceil($extra_pgs / 2);
1119 $q4_pgs += floor($extra_pgs / 2);
1120
1121 /* Adjust if the fourth quarter contains the current page. */
1122 } else if (($cur_pg + $q4_pgs) >= $tot_pgs) {
1123 $extra_pgs = ($q4_pgs - ($tot_pgs - $cur_pg)) + $q3_pgs;
1124 $q3_pgs = 0;
1125 $q4_pgs = $tot_pgs - $cur_pg;
1126 $q1_pgs += floor($extra_pgs / 2);
1127 $q2_pgs += ceil($extra_pgs / 2);
1128
1129 /* Adjust if the third and fourth quarter intersect. */
1130 } else if (($cur_pg + $q3_pgs + 1) >= ($tot_pgs - $q4_pgs + 1)) {
1131 $extra_pgs = $q3_pgs;
1132 $extra_pgs -= ceil(($tot_pgs - $cur_pg - $q4_pgs) * 3/4);
1133 $q3_pgs = ceil(($tot_pgs - $cur_pg - $q4_pgs) * 3/4);
1134 $q1_pgs += floor($extra_pgs / 2);
1135 $q2_pgs += ceil($extra_pgs / 2);
1136 }
1137 }
1138
1139 /*
1140 * I am leaving this debug code here, commented out, because
1141 * it is a really nice way to see what the above code is doing.
1142 * echo "qts = $q1_pgs/$q2_pgs/$q3_pgs/$q4_pgs = "
1143 * . ($q1_pgs + $q2_pgs + $q3_pgs + $q4_pgs) . '<br>';
1144 */
1145
1146 /* Print out the page links from the compute page quarters. */
1147
1148 /* Start with the first quarter. */
1149 if (($q1_pgs == 0) && ($cur_pg > 1)) {
1150 $pg_str .= "...$spc";
1151 } else {
1152 for ($pg = 1; $pg <= $q1_pgs; ++$pg) {
1153 $start = (($pg-1) * $show_num) + 1;
1154 $pg_str .= get_paginator_link($box, $start, $use, $pg) . $spc;
1155 }
1156 if ($cur_pg - $q2_pgs - $q1_pgs > 1) {
1157 $pg_str .= "...$spc";
1158 }
1159 }
1160
1161 /* Continue with the second quarter. */
1162 for ($pg = $cur_pg - $q2_pgs; $pg < $cur_pg; ++$pg) {
1163 $start = (($pg-1) * $show_num) + 1;
1164 $pg_str .= get_paginator_link($box, $start, $use, $pg) . $spc;
1165 }
1166
1167 /* Now print the current page. */
1168 $pg_str .= $cur_pg . $spc;
1169
1170 /* Next comes the third quarter. */
1171 for ($pg = $cur_pg + 1; $pg <= $cur_pg + $q3_pgs; ++$pg) {
1172 $start = (($pg-1) * $show_num) + 1;
1173 $pg_str .= get_paginator_link($box, $start, $use, $pg) . $spc;
1174 }
1175
1176 /* And last, print the forth quarter page links. */
1177 if (($q4_pgs == 0) && ($cur_pg < $tot_pgs)) {
1178 $pg_str .= "...$spc";
1179 } else {
1180 if (($tot_pgs - $q4_pgs) > ($cur_pg + $q3_pgs)) {
1181 $pg_str .= "...$spc";
1182 }
1183 for ($pg = $tot_pgs - $q4_pgs + 1; $pg <= $tot_pgs; ++$pg) {
1184 $start = (($pg-1) * $show_num) + 1;
1185 $pg_str .= get_paginator_link($box, $start, $use, $pg) . $spc;
1186 }
1187 }
1188 } else if ($PG_SHOWNUM == 999999) {
1189 $pg_str = "<A HREF=\"right_main.php?PG_SHOWALL=0"
1190 . "&amp;use_mailbox_cache=$use&amp;startMessage=1&amp;mailbox=$box\" "
1191 . "TARGET=\"right\">" ._("Paginate") . '</A>' . $spc;
1192 }
1193
1194 /* If necessary, compute the 'show all' string. */
1195 if (($prv_str != '') || ($nxt_str != '')) {
1196 $all_str = "<A HREF=\"right_main.php?PG_SHOWALL=1"
1197 . "&amp;use_mailbox_cache=$use&amp;startMessage=1&amp;mailbox=$box\" "
1198 . "TARGET=\"right\">" . _("Show All") . '</A>';
1199 }
1200
1201 /* Last but not least, get the value for the toggle all link. */
1202 $tgl_str = get_selectall_link($start_msg, $sort);
1203
1204 /* Put all the pieces of the paginator string together. */
1205 /**
1206 * Hairy code... But let's leave it like it is since I am not certain
1207 * a different approach would be any easier to read. ;)
1208 */
1209 $result = '';
1210 $result .= ($prv_str != '' ? $prv_str . $spc . $sep . $spc : '');
1211 $result .= ($nxt_str != '' ? $nxt_str . $spc . $sep . $spc : '');
1212 $result .= ($pg_str != '' ? $pg_str : '');
1213 $result .= ($all_str != '' ? $sep . $spc . $all_str . $spc : '');
1214 $result .= ($result != '' ? $sep . $spc . $tgl_str: $tgl_str);
1215
1216 /* If the resulting string is blank, return a non-breaking space. */
1217 if ($result == '') {
1218 $result = '&nbsp;';
1219 }
1220
1221 /* Return our final magical paginator string. */
1222 return ($result);
1223 }
1224
1225 function truncateWithEntities($subject, $trim_at)
1226 {
1227 $ent_strlen = strlen($subject);
1228 if (($trim_at <= 0) || ($ent_strlen <= $trim_at))
1229 return $subject;
1230
1231 global $languages, $squirrelmail_language;
1232
1233 /*
1234 * see if this is entities-encoded string
1235 * If so, Iterate through the whole string, find out
1236 * the real number of characters, and if more
1237 * than $trim_at, substr with an updated trim value.
1238 */
1239 $trim_val = $trim_at;
1240 $ent_offset = 0;
1241 $ent_loc = 0;
1242 while ( $ent_loc < $trim_val && (($ent_loc = strpos($subject, '&', $ent_offset)) !== false) &&
1243 (($ent_loc_end = strpos($subject, ';', $ent_loc+3)) !== false) ) {
1244 $trim_val += ($ent_loc_end-$ent_loc);
1245 $ent_offset = $ent_loc_end+1;
1246 }
1247 if (($trim_val > $trim_at) && ($ent_strlen > $trim_val) && (strpos($subject,';',$trim_val) < ($trim_val + 6))) {
1248 $i = strpos($subject,';',$trim_val);
1249 if ($i) {
1250 $trim_val = strpos($subject,';',$trim_val);
1251 }
1252 }
1253 // only print '...' when we're actually dropping part of the subject
1254 if ($ent_strlen <= $trim_val)
1255 return $subject;
1256
1257 if (isset($languages[$squirrelmail_language]['XTRA_CODE']) &&
1258 function_exists($languages[$squirrelmail_language]['XTRA_CODE'])) {
1259 return $languages[$squirrelmail_language]['XTRA_CODE']('strimwidth', $subject, $trim_val);
1260 }
1261
1262 return substr_replace($subject, '...', $trim_val);
1263 }
1264
1265 function processSubject($subject, $threadlevel = 0) {
1266 /* Shouldn't ever happen -- caught too many times in the IMAP functions */
1267 if ($subject == '') {
1268 return _("(no subject)");
1269 }
1270
1271 global $truncate_subject; /* number of characters for Subject field (<= 0 for unchanged) */
1272 $trim_at = $truncate_subject;
1273
1274 /* if this is threaded, subtract two chars per indentlevel */
1275 if (($threadlevel > 0) && ($threadlevel <= 10))
1276 $trim_at -= (2*$threadlevel);
1277
1278 return truncateWithEntities($subject, $trim_at);
1279 }
1280
1281 function getMbxList($imapConnection, $boxes = 0) {
1282 global $lastTargetMailbox;
1283 echo ' <small>&nbsp;<tt><select name="targetMailbox">';
1284 echo sqimap_mailbox_option_list($imapConnection, array(strtolower($lastTargetMailbox)), 0, $boxes);
1285 echo ' </SELECT></TT>&nbsp;';
1286 }
1287
1288 function getButton($type, $name, $value) {
1289 return '<INPUT TYPE="'.$type.'" NAME="'.$name.'" VALUE="'.$value . '">';
1290 }
1291
1292 function getSmallStringCell($string, $align) {
1293 return html_tag('td',
1294 '<small>' . $string . ':&nbsp; </small>',
1295 $align,
1296 '',
1297 'nowrap' );
1298 }
1299
1300 function getEndMessage($start_msg, $show_num, $num_msgs) {
1301 if ($start_msg + ($show_num - 1) < $num_msgs){
1302 $end_msg = $start_msg + ($show_num - 1);
1303 } else {
1304 $end_msg = $num_msgs;
1305 }
1306
1307 if ($end_msg < $start_msg) {
1308 $start_msg = $start_msg - $show_num;
1309 if ($start_msg < 1) {
1310 $start_msg = 1;
1311 }
1312 }
1313 return (array($start_msg,$end_msg));
1314 }
1315
1316 // This should go in imap_mailbox.php
1317 function handleAsSent($mailbox) {
1318 global $handleAsSent_result;
1319
1320 /* First check if this is the sent or draft folder. */
1321 $handleAsSent_result = isSentMailbox($mailbox) || isDraftMailbox($mailbox);
1322
1323 /* Then check the result of the handleAsSent hook. */
1324 do_hook('check_handleAsSent_result', $mailbox);
1325
1326 /* And return the result. */
1327 return $handleAsSent_result;
1328 }
1329
1330 ?>