Prints the URL address of a banner image.

Description

You can directly print the banner image in an <img> element by using the {BannerImage} tag.

If you use image size attributes such as width, height or imagesize, the image will appear in the size specified by the attributes.

If a banner doesn't have an image, the URL address of the image defined as noImage in theme settings will be printed instead.

This tag cannot use the global or attribute.

Syntax

{BannerImageURL(
    id: int,
    name: string,
    imagesize: string,
    height: int,
    width: int
)}

Scope

Required scope: banneri

You can use the tag as a global tag or in the helper attribute of the {Banner} and {Banners} tags.

If you use the tag globally, select a banner by setting a value either to the id or name attribute.

Attribuutit

id:

The banner's ID number.

The banner ID number can be found in a browser's address bar when the banner is being edited or viewed in the admin panel.

Allowed values: the banner's ID number expressed as an integer

name:

The banner's codename.

The codename can be found in the banner details in the admin panel.

Allowed values: the banner's codename expressed as a string

imagesize:

Defines printed image's dimensions.

The used values are determined by the values of the ImageSizes element of the theme settings.

Allowed values: names of image sizes defined in the theme.xml file's ImageSizes element.

E.g. imagesize:'Large'

height:

Defines image height given in pixels.

Allowed values:integers

width:

Defines image width given in pixels.

Allowed values:integers

after/before:

By using the after and before attributes you can define content that is output either after or before the tag's output.

Allowed values:The HTML and Interface markup

E.g.

  • before: '<p>Tämä merkkaus näkyy ennen tagin omaa sisältöä.</p>'
  • after: '<p>Tämä taas näkyy tagin oman sisällön jälkeen.</p>'

If the tag does not produce any content, neither the content of the after and before attributes will be output.

escape:

Adds an escape character before quotation marks in the output.

The attribute makes it easier to process the tag-produced content when using JavaScript.

Allowed values:true/false. The default value is false.