| Nombre del Atributo | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
| file | string | Si | n/a | nombre/ruta de la imagen |
| height | string | No | Altura actual de la imagen | altura con la cual la imagen debe ser mostrada |
| width | string | No | Largo actual de la imagen | largo con el cual la imagen debe ser mostrada |
| basedir | string | no | document root del servidor web | ruta relativa para la base del directorio |
| alt | string | no | "" | descripción alternativa de la imagen |
| href | string | no | n/a | valor href a donde la imagen será ligada |
{html_image} es una función habitual que genera una etiqueta HTML para una imagen. La altura y lo largo son automáticamente calculadas a partir del archivo de la imagen si ningún valor suplido.
basedir es el directorio base en el cual las rutas relativas de las imagenes estan basados. Si no lo proporciona, el document root del servidor (env variable de ambiente DOCUMENT_ROOT) es usada como el directorio base. Si la $security esta habilitada, la ruta para la imagen debe estar dentro de un directorio seguro.
href es el valor href a donde la imagen
sera ligada. Si un link es proporcionado, una etiqueta <a
href="LINKVALUE"><a> es puesta alrededor de la imagen.
Todos los parametros que no esten dentro de la lista de arriba son mostrados como pares de nombre/valor dentro de la etiqueta creada <img>.
Nota Técnica
{html_image} requiere un acceso a disco para leer la imagen y calcular la altura y el largo. Si usted no usa cache en el template, generalmente es mejor evitar {html_image} y utilizar las etiquetas de imagen estáticas para un optimo funcionamiento.
Example 8.9. html_image example
where index.tpl is:
-------------------
{html_image file="pumpkin.jpg"}
{html_image file="/path/from/docroot/pumpkin.jpg"}
{html_image file="../path/relative/to/currdir/pumpkin.jpg"}
la posible saldida puede ser:
<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" />