4 * message_list_util.php
6 * Helper functions for message list templates.
8 * The following functions are utility functions for templates. Do not
9 * echo output in these functions.
11 * @copyright © 2005-2006 The SquirrelMail Project Team
12 * @license http://opensource.org/licenses/gpl-license.php GNU Public License
14 * @package squirrelmail
19 * @param array $aOrder
22 function calcMessageListColumnWidth($aOrder) {
24 * Width of the displayed columns
34 SQM_COL_ATTACHMENT
=> 1,
35 SQM_COL_INT_DATE
=> 15,
42 * Calculate the width of the subject column based on the
43 * widths of the other columns
45 if (isset($aOrder[SQM_COL_SUBJ
])) {
46 foreach($aOrder as $iCol) {
47 if ($iCol != SQM_COL_SUBJ
) {
48 $aWidthTpl[SQM_COL_SUBJ
] -= $aWidthTpl[$iCol];
53 foreach($aOrder as $iCol) {
54 $aWidth[$iCol] = $aWidthTpl[$iCol];
57 $iCheckTotalWidth = $iTotalWidth = 0;
58 foreach($aOrder as $iCol) { $iTotalWidth +
= $aWidth[$iCol];}
60 $iTotalWidth = ($iTotalWidth) ?
$iTotalWidth : 100; // divide by zero check. shouldn't be needed
62 // correct the width to 100%
63 foreach($aOrder as $iCol) {
64 $aWidth[$iCol] = round( (100 / $iTotalWidth) * $aWidth[$iCol] , 0);
65 $iCheckTotalWidth +
= $aWidth[$iCol];
67 if ($iCheckTotalWidth > 100) { // correction needed
68 $iCol = array_search(max($aWidth),$aWidth);
69 $aWidth[$iCol] -= $iCheckTotalWidth-100;
76 * Function to retrieve correct icon based on provided message flags. This is
77 * a merge/replacement for getFlagIcon() and getFlagText() functions.
79 * @param array $aFlags associative array with seen,deleted,anwered and flag keys.
80 * @param string $icon_theme_path path to user's currently selected icon theme.
81 * @return string $icon full HTML img tag or text icon, depending on of user prefs
84 function getFlagIcon ($aFlags, $icon_theme_path) {
92 * 6 = answered deleted
93 * 7 = answered deleted seen
96 * 10 = flagged deleted
97 * 11 = flagged deleted seen
98 * 12 = flagged answered
99 * 13 = flagged aswered seen
100 * 14 = flagged answered deleted
101 * 15 = flagged anserwed deleted seen
105 * Use static vars to avoid initialisation of the array on each displayed row
107 static $flag_icons, $flag_values;
108 if (!isset($flag_icons)) {
109 // This is by no means complete...
110 $flag_icons = array ( // Image icon name Text Icon Alt/Title Text
111 array ('msg_new.png', ' ', '('._("New").')') ,
112 array ('msg_read.png', ' ', '('._("Read").')'),
113 array ('msg_new_deleted.png', _("D"), '('._("Deleted").')'),
114 array ('msg_read_deleted.png', _("D"), '('._("Deleted").')'),
115 array ('msg_new_reply.png', _("A"), '('._("Answered").')'),
116 array ('msg_read_reply.png', _("A"), '('._("Answered").')'),
117 array ('msg_read_deleted_reply.png', _("D"), '('._("Answered").')'),
118 array ('flagged.png', _("F"), '('._("Flagged").')'),
119 array ('flagged.png', _("F"), '('._("Flagged").')'),
120 array ('flagged.png', _("F"), '('._("Flagged").')'),
121 array ('flagged.png', _("F"), '('._("Flagged").')'),
122 array ('flagged.png', _("F"), '('._("Flagged").')'),
123 array ('flagged.png', _("F"), '('._("Flagged").')'),
124 array ('flagged.png', _("F"), '('._("Flagged").')'),
125 array ('flagged.png', _("F"), '('._("Flagged").')'),
126 array ('flagged.png', _("F"), '('._("Flagged").')')
129 $flag_values = array('seen' => 1,
137 * The flags entry contain all items displayed in the flag column.
142 foreach ($aFlags as $flag => $flagvalue) {
147 case 'flagged': if ($flagvalue) $index +
= $flag_values[$flag]; break;
152 if (isset($flag_icons[$index])) {
153 $data = $flag_icons[$index];
155 $data = end($flag_icons);
158 $icon = getIcon($icon_theme_path, $data[0], $data[1], $data[2]);
164 * Function to retrieve correct priority icon based on user prefs
166 * @param integer $priority priority value of message
167 * @param string $icon_theme_path path to user's currently selected icon theme.
168 * @return string $icon full HTML img tag or text icon, depending on of user prefs
169 * @author Steve Brown
171 function getPriorityIcon ($priority, $icon_theme_path) {
177 $icon = getIcon($icon_theme_path, 'prio_high.png', create_span('!', 'high_priority'), _("High priority"));
180 $icon = getIcon($icon_theme_path, 'prio_low.png', create_span('↓', 'low_priority'), _("Low priority"));
183 $icon = getIcon($icon_theme_path, 'transparent.png', '', _("Normal priority"), 5);
192 * Function to retrieve correct attchment icon based on user prefs
194 * @param boolean $attach TRUE if the message has an attachment
195 * @param string $icon_theme_path path to user's currently selected icon theme.
196 * @return string $icon full HTML img tag or text icon, depending on of user prefs
197 * @author Steve Brown
199 function getAttachmentIcon ($attach, $icon_theme_path) {
202 $icon_file = $attach ?
'attach.png' : 'transparent.png';
203 $alt_text = $attach ?
_("Attachment") : _("No attachment");
204 $text = $attach ?
'+' : '';
205 $icon = getIcon($icon_theme_path, $icon_file, $text, $alt_text);