Introduction

The ContentURLEx() function complements the ContentURL()function. It is also used to reference static content. However, in contrast to ContentURL(), the ContentURLEx() function always returns an absolute URL, hence is used in templates in which an absolute URL is required, such as in mail templates.

Syntax

ContentURLEx(<protocol>,[<host>],[<port>],[<server group>],[<locale>],[<contentRef>])

Example

The following ISML structure:

<img src="#contentURLEx('https','foobar.com','445','BOS','de_DE','Techno:/images/iqscrollingmouse.gif')#"/>

produces the following result:

<img src="https://foobar.xom:445/is-bin/intershop.static/BOS/PrimeTech-PrimeTechSpecials-Site/Techno/de_DE/images/iqscrollingmouse.gif"/>

Parameters

protocol

This required parameter can be used to override the default protocol (HTTP). The value is ignored (even if set) if intershop.template.WebRootURL or intershop.template.HTTPSWebRootURL(in config/cluster/appserver.properties) already specifies an absolute URL.

host, port

If these optional parameters are unspecified, the values intershop.WebServerURL(in case of HTTP) or intershop.WebServerSecureURL(in case of HTTPS) defined in the appserver.properties are default. The values for these parameters are ignored (even if set) if intershop.template.WebRootURL or intershop.template.HTTPSWebRootURL(in config/cluster/appserver.properties) already specifies an absolute URL.

server group

This parameter can be used to override the default server group. If unspecified, the first value from the intershop.server.assignedToServerGroup defined in the appserver.properties is default.

locale

This parameter can be used to override the default locale. If left unspecified, the following fallback is used:

1. Get the locale from the current request.
2. Get the lead locale.
3. Set the locale as missing parameter -.

content reference

References static content (e.g., /images/calc.gif).