What is Smarty?
Why use it?
Use Cases and Work Flow
Syntax Comparison
Template Inheritance
Best Practices
Crash Course
What is Smarty?
Why use it?
Use Cases and Work Flow
Syntax Comparison
Template Inheritance
Best Practices
Crash Course
Quick Install
Documentation
Discussion
Mailing Lists
Github
Example App
www.phpinsider.com
Smarty Icon
You may use the Smarty logo according to the trademark notice.
For sponsorship, advertising, news or other inquiries, contact us at:
Sites Using Smarty
Advertisement
{html_image} is a
custom function
that generates an HTML <img> tag.
The height and width
are automatically calculated from the image file if they are not supplied.
| Attribute Name | Type | Required | Default | Description |
|---|---|---|---|---|
| file | string | Yes | n/a | name/path to image |
| height | string | No | actual image height | Height to display image |
| width | string | No | actual image width | Width to display image |
| basedir | string | no | web server doc root | Directory to base relative paths from |
| alt | string | no | “” | Alternative description of the image |
| href | string | no | n/a | href value to link the image to |
| path_prefix | string | no | n/a | Prefix for output path |
basediris the base directory that relative image paths are based from. If not given, the web server's document root$_ENV['DOCUMENT_ROOT']is used as the base. If$securityis enabled, the path to the image must be within a secure directory.hrefis the href value to link the image to. If link is supplied, an<a href="LINKVALUE"><a>tag is placed around the image tag.path_prefixis an optional prefix string you can give the output path. This is useful if you want to supply a different server name for the image.All parameters that are not in the list above are printed as name/value-pairs inside the created
<img>tag.
Technical Note
{html_image} requires a hit to the disk to read the
image and calculate the height and width. If you don't use template
caching,
it is generally better to avoid {html_image} and leave
image tags static for optimal performance.
Example 8.11. {html_image} example
{html_image file='pumpkin.jpg'}
{html_image file='/path/from/docroot/pumpkin.jpg'}
{html_image file='../path/relative/to/currdir/pumpkin.jpg'}
Example output of the above template would be:
<img src="pumpkin.jpg" alt="" width="44" height="68" /> <img src="/path/from/docroot/pumpkin.jpg" alt="" width="44" height="68" /> <img src="../path/relative/to/currdir/pumpkin.jpg" alt="" width="44" height="68" />