1711c15537a220a4bdbff6bfc8ae863a602f3d71
6 * This file is intended to contain helper functions for template sets
7 * that would like to use them.
9 * @copyright © 1999-2006 The SquirrelMail Project Team
10 * @license http://opensource.org/licenses/gpl-license.php GNU Public License
12 * @package squirrelmail
17 * Create stylesheet links that will work for multiple browsers
19 * @param string $uri The URI to the linked stylesheet.
20 * @param string $name The title of the stylesheet (optional; default empty).
21 * @param boolean $alt Whether or not this is an alternate
22 * stylesheet (optional; default TRUE).
23 * @param string $mtype The target media display type (optional; default "screen").
25 * @return string The full text of the stylesheet link.
28 function create_css_link($uri, $name='', $alt=TRUE, $mtype='screen') {
29 // FIXME: Add closing / to link and meta elements only after
30 // switching to xhtml 1.0 Transitional.
31 // It is not compatible with html 4.01 Transitional
36 // set to lower case to avoid errors
38 sqGetGlobalVar('HTTP_USER_AGENT', $browser_user_agent, SQ_SERVER
);
39 $browser_user_agent = strtolower($browser_user_agent);
41 if (stristr($browser_user_agent, "msie 4")) {
45 } elseif (stristr($browser_user_agent, "msie")
46 && stristr($browser_user_agent, 'opera') === FALSE) {
52 if ((strpos($uri, '-ie')!== false) and !$is_IE) {
53 //not IE, so don't render this sheet
57 if ( strpos($uri, 'print') !== false )
60 $href = 'href="'.$uri.'" ';
61 $media = 'media="'.$mtype.'" ';
65 $rel = 'rel="stylesheet" ';
67 $title = 'title="'.$name.'" ';
68 $rel = 'rel="'.( $alt ?
'alternate ' : '' ).'stylesheet" ';
71 return '<link '.$media.$title.$rel.'type="text/css" '.$href." />\n";
76 * Checks for an image icon and returns a complete image tag or a text
77 * string with the text icon based on what is found and user prefs.
79 * @param string $icon_theme_path User's chosen icon set
80 * @param string $icon_name File name of the desired icon
81 * @param string $text_icon Text-based icon to display if desired
82 * @param string $alt_text Text for alt/title attribute of image
83 * @param integer $w Optional. Width of requested image.
84 * @param integer $h Optional. Height of requested image.
86 * @return string $icon String containing icon that can be echo'ed
91 function getIcon($icon_theme_path, $icon_name, $text_icon, $alt_text, $w=NULL, $h=NULL) {
93 if (is_null($icon_theme_path)) {
96 $icon_path = getIconPath($icon_theme_path, $icon_name);
98 // If we found an icon, build an img tag to display it. If we didn't
99 // find an image, we will revert back to the text icon.
100 if (!is_null($icon_path)) {
101 $icon = create_image($icon_path, $alt_text, $w, $h, '', '', '',
102 '', $alt_text, '', '', '', $text_icon);
112 * Gets the path to the specified icon or returns NULL if the image is not
113 * found. This has been separated from getIcon to allow the path to be fetched
114 * for use w/ third party packages, e.g. dTree.
116 * @param string $icon_theme_path User's chosen icon set
117 * @param string $icon_name File name of the desired icon
119 * @return string $icon String containing path to icon that can be used in
120 * an IMG tag, or NULL if the image is not found.
122 * @author Steve Brown
126 function getIconPath ($icon_theme_path, $icon_name) {
127 global $fallback_icon_theme_path;
129 if (is_null($icon_theme_path))
132 // Desired icon exists in the current theme?
133 if (is_file($icon_theme_path . $icon_name)) {
134 return $icon_theme_path . $icon_name;
136 // Icon not found, check for the admin-specified fallback
137 } elseif (!is_null($fallback_icon_theme_path) && is_file($fallback_icon_theme_path . $icon_name)) {
138 return $fallback_icon_theme_path . $icon_name;
140 // Icon not found, return the SQM default icon
141 } elseif (is_file(SM_PATH
. 'images/themes/default/'.$icon_name)) {
142 return SM_PATH
. 'images/themes/default/'.$icon_name;
150 * Display error messages for use in footer.tpl
152 * @author Steve Brown
155 function displayErrors () {
156 global $oErrorHandler;
158 if ($oErrorHandler) {
159 $oErrorHandler->displayErrors();
165 * Make the internal show_readable_size() function available to templates.
166 //FIXME: I think this is needless since there is no reason templates cannot just call directly to show_readable_size
168 * @param int size to be converted to human-readable
169 * @return string human-readable form
172 function humanReadableSize ($size) {
173 return show_readable_size($size);