Document Properties
Kbid
Z24793
Last Modified
25-Aug-2020
Added to KB
21-Jun-2013
Public Access
Everyone
Status
Online
Doc Type
References
Product
  • ICM 7.10
  • ICM 11
ISML Function - WebRootEx()

Name

WebRootEx()

Short Description

references static content within ISML templates, returns an absolute URL

Table of Contents

Product Version

6.5

Product To Version


Status

Introduction

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

Syntax

WebRootEx(<protocol>,<host>,<port>,<servergroup>,<locale>)

Example

The following ISML code:

<img src="#webrootEx('','foobar.com','','BOS','de_DE')#"/>

results in the the following HTML code:

<img src="http://foobar.com:80/INTERSHOP/static/BOS/PrimeTech-PrimeTechSpecials-Site/-/de_DE"/>

Parameters

The following parameters are required.

protocol

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

host, port

port = string
host = string
If these parameters are left unspecified, the values for intershop.WebServerURL(in case of HTTP) or intershop.WebServerSecureURL(in case of HTTPS) as specified in the appserver.properties are used.
The values for these parameters are ignored (even if set) if {intershop.template.WebRootURL}} or intershop.template.HTTPSWebRootURL(set in config/cluster/appserver.properties) already specify an absolute URL.

servergroup

servergroup = string
This parameter can be used to override the default server group. If not specified, the first value from the application server property intershop.server.assignedToServerGroup will be used.

locale

locale = string
This parameter can be used to override the default locale. If left unspecified, the following fallback values will be used:

  1. the request's current locale
  2. the lead locale
  3. the locale will be designated as a missing parameter -

Reference - ISML Functions

Disclaimer
The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.
The Intershop Knowledge Portal uses only technically necessary cookies. We do not track visitors or have visitors tracked by 3rd parties. Please find further information on privacy in the Intershop Privacy Policy and Legal Notice.
Home
Knowledge Base
Product Releases
Log on to continue
This Knowledge Base document is reserved for registered customers.
Log on with your Intershop Entra ID to continue.
Write an email to supportadmin@intershop.de if you experience login issues,
or if you want to register as customer.