Quick links: Content - sections - sub sections
Jelix 1.8.1

Section: Html : Image

« Miscellaneous ^ Template plugins Meta »
Switch to language: FR

If you need to display a picture, an <img> element is often enough.

But if you need to resize or transform this image, in different manners at several templates, the image plugin is very useful.

It can resize and transform the given image, store the result in a cache, and set the link to this new image in the html.

Using the plugin into a template

The plugin is a template function, accepting at first parameter the source image. The given path is relative to the root web path (corresponding to your app/www directory).

  {image 'toupie.png'}

Here the image should be stored into yourapp/www/toupie.png.

The html code:

  <img src="./toupie.png" />

Some attributes

You can add a CSS class:

  {image 'toupie.png', array('class'=>'right cadre')}

and/or an id:

  {image 'toupie.png', array('id'=>'image')}

and/or an alternate text:

  {image 'toupie.png', array('alt'=>'here picture of a whirligig')}

Some modifications

You can transform the image in several ways. You can change for example its width.

  {image 'toupie.png', array('width'=>100)}

It will call the GD librairy to change the width and generate a new image stored into "myapp/www/cache/images/"

So it will generate the following html with a link to the cached image (real url may be different):

  <img src="cache/images/toupie_XXXXXXXXXXXXXXX.png"/>

If GD is not installed, the plugin just change the size with CSS. But the browser will load the original image.

  {image 'toupie.png', array('width'=>100)}

  <img src="toupie.png" style="width:100px;height:100px;"/>

Modifying the size

You can set the width and/or the height. If you give only one of these measurement, the other will be calculated automatically.

  {image 'toupie.png', array('height'=>50)}
  {image 'toupie.png', array('width'=>100)}

You can set both, width and height, but probably the ratio will not be good and the image will be stretched.

  {image 'toupie.png', array('width'=>150, 'height'=>50)}

To change the size by indicating the width and the height, and by respecting the ratio, just add the omo attribute. If the resulting width or height are higher than the expected with and height, the image will be cropped.

  {image 'toupie.png', array('width'=>150, 'height'=>50, 'omo'=>true)}

You can also set new size of the image, by respecting the ratio and without cropping. Use maxheight and maxwidth instead of height and width. You can set a default background color for parts of the new image that are not part of the original image.

  {image 'toupie.png', array('maxwidth'=>100, 'maxheight'=>90,'background'=>'#0000ff')}
  {image 'logo_1.png', array('maxwidth'=>100, 'maxheight'=>90)}
  {image 'logo_2.png', array('maxwidth'=>100, 'maxheight'=>90,'background'=>'#ff0000')}

Faire un zoom

Changing the size of the image allow to zoom in/out on the image. But for this behavior, there is an other attribute: zoom.


  • 100 to display at the same original size (100%)
  • 10 to display at 10% of the original size
  • 110 to display at 110% of the original size

  {image 'toupie.png', array('width'=>100, 'zoom'=>50)}

Aligner et déplacer

After cropping the image, you can indicate to "move" the image inside the new frame.

You can align to the left:

  {image 'toupie.png', array('width'=>100, 'zoom'=>60, 'alignh'=>'left')}

or to the right:

  {image 'toupie.png', array('width'=>100, 'zoom'=>60, 'alignh'=>'right')}

At the top:

  {image 'toupie.png', array('width'=>100, 'zoom'=>60, 'alignh'=>'top')}*

At the bottom

  {image 'toupie.png', array('width'=>100, 'zoom'=>60, 'alignh'=>'bottom')}

Modifying the format and the quality l'extension et la qualité

You may want to convert a png to jpg for example, and to reduce the quality of the image (so the resulting image will take less bandwidth)

  {image 'toupie.png', array('width'=>100, 'ext'=>'jpg')}

Note that the jpeg format does not support transparency

  {image 'toupie.png', array('width'=>100, 'ext'=>'jpg', 'quality'=>5)}

Modifying the background color

If you want to change transparent background of a png:

  {image 'toupie.png', array('width'=>100, 'background'=>'#ff5533')}

On a jpeg converting from a png:

  {image 'toupie.png', array('width'=>100, 'ext'=>'jpg', 'background'=>'#ff5533')}

Adding a box shadow

You can add a box shadow on an image. Note that it is probably more interesting to add a box shadow with CSS instead of using this plugin. This feature was developped years ago when browsers didn't support CSS shadows.

  {image 'toupie.png', array('width'=>100, 'shadow'=>true)}

You can change the width and the angle of the shadow:

  {image 'toupie.png', array('width'=>100, 'shadow'=>true, 'soffset'=>20)}

  {image 'toupie.png', array('width'=>100, 'shadow'=>true, 'sangle'=>0)}

To change the blur of the shadow (maximum 11):

  {image 'toupie.png', array('width'=>100, 'shadow'=>true, 'sblur'=>0)}

Or to change its opacity (in %)

  {image 'toupie.png', array('width'=>100, 'shadow'=>true, 'sopacity'=>100)}

Or its color:

  {image 'toupie.png', array('width'=>100, 'shadow'=>true, 'scolor'=>'#ffff00')}