6 * @subpackage PluginsFunction
10 * Smarty {html_image} function plugin
13 * Name: html_image<br>
14 * Date: Feb 24, 2003<br>
15 * Purpose: format HTML tags for the image<br>
16 * Examples: {html_image file="/images/masthead.gif"}<br>
17 * Output: <img src="/images/masthead.gif" width=400 height=23><br>
20 * - file - (required) - file (and path) of image
21 * - height - (optional) - image height (default actual height)
22 * - width - (optional) - image width (default actual width)
23 * - basedir - (optional) - base directory for absolute paths, default is environment variable DOCUMENT_ROOT
24 * - path_prefix - prefix for path output (optional, default empty)
27 * @link http://www.smarty.net/manual/en/language.function.html.image.php {html_image}
28 * (Smarty online manual)
29 * @author Monte Ohrt <monte at ohrt dot com>
30 * @author credits to Duda <duda@big.hu>
32 * @param array $params parameters
33 * @param Smarty_Internal_Template $template template object
35 * @uses smarty_function_escape_special_chars()
37 function smarty_function_html_image($params, $template)
39 require_once(SMARTY_PLUGINS_DIR . 'shared.escape_special_chars.php');
49 $basedir = isset($_SERVER['DOCUMENT_ROOT']) ? $_SERVER['DOCUMENT_ROOT'] : '';
50 foreach($params as $_key => $_val) {
62 if (!is_array($_val)) {
63 $$_key = smarty_function_escape_special_chars($_val);
65 throw new SmartyException ("html_image: extra attribute '$_key' cannot be an array", E_USER_NOTICE);
71 $prefix = '<a href="' . $_val . '">';
76 if (!is_array($_val)) {
77 $extra .= ' ' . $_key . '="' . smarty_function_escape_special_chars($_val) . '"';
79 throw new SmartyException ("html_image: extra attribute '$_key' cannot be an array", E_USER_NOTICE);
86 trigger_error("html_image: missing 'file' parameter", E_USER_NOTICE);
90 if ($file[0] == '/') {
91 $_image_path = $basedir . $file;
96 // strip file protocol
97 if (stripos($params['file'], 'file://') === 0) {
98 $params['file'] = substr($params['file'], 7);
101 $protocol = strpos($params['file'], '://');
102 if ($protocol !== false) {
103 $protocol = strtolower(substr($params['file'], 0, $protocol));
106 if (isset($template->smarty->security_policy)) {
108 // remote resource (or php stream, …)
109 if(!$template->smarty->security_policy->isTrustedUri($params['file'])) {
114 if(!$template->smarty->security_policy->isTrustedResourceDir($params['file'])) {
120 if (!isset($params['width']) || !isset($params['height'])) {
121 // FIXME: (rodneyrehm) getimagesize() loads the complete file off a remote resource, use custom [jpg,png,gif]header reader!
122 if (!$_image_data = @getimagesize($_image_path)) {
123 if (!file_exists($_image_path)) {
124 trigger_error("html_image: unable to find '$_image_path'", E_USER_NOTICE);
126 } else if (!is_readable($_image_path)) {
127 trigger_error("html_image: unable to read '$_image_path'", E_USER_NOTICE);
130 trigger_error("html_image: '$_image_path' is not a valid image file", E_USER_NOTICE);
135 if (!isset($params['width'])) {
136 $width = $_image_data[0];
138 if (!isset($params['height'])) {
139 $height = $_image_data[1];
143 if (isset($params['dpi'])) {
144 if (strstr($_SERVER['HTTP_USER_AGENT'], 'Mac')) {
145 // FIXME: (rodneyrehm) wrong dpi assumption
146 // don't know who thought this up… even if it was true in 1998, it's definitely wrong in 2011.
151 $_resize = $dpi_default / $params['dpi'];
152 $width = round($width * $_resize);
153 $height = round($height * $_resize);
156 return $prefix . '<img src="' . $path_prefix . $file . '" alt="' . $alt . '" width="' . $width . '" height="' . $height . '"' . $extra . ' />' . $suffix;