The class represents a content snippet with markup. This is typically a HTML content snippet. The class also processes the special links from Commerce Cloud Digital content management and automatically rewrites them into links for use in the storefront.

The following special links can be used inside of a MarkupText:

• $url('<pipeline>' [, '<key1>', '<value1>', '<key2>', '<value2>', ...])$

Description:
The $url()$ function creates and absolute URL and retains the protocol incoming request.

Example:
MarkupText:
   $url('MyLinkPipeline-Start', 'key1', 'value1', 'key2', 'value2')$
is rewritten to:
   http://<host>:<port>/on/demandware.store/<current site>/default/MyLinkPipeline-Start?key1=value1&key2=value2
Note that the incoming protocol was http in the example above.

• $httpUrl('<pipeline>' [, '<key1>', '<value1>', '<key2>', '<value2>', ...])$

Description:
The $httpUrl()$ function creates an absolute URL but always with the fix protocol "http". The protocol type of the incomming request is ignored.


Example:
MarkupText:
   $httpUrl('MyLinkPipeline-Start', 'key1', 'value1', 'key2', 'value2')$
is rewritten to:
   http://<host>:'<port>/on/demandware.store/<current site>/default/MyLinkPipeline-Start?key1=value1&key2=value2

• $httpsUrl('<pipeline>' [, '<key1>', '<value1>', '<key2>', '<value2>', ...])$

Description:
The $httpsUrl()$ function creates an absolute URL but always with the fix protocol "https". The protocol type of the incomming request is ignored.

Example:
MarkupText:
   $httpsUrl('MyLinkPipeline-Start', 'key1', 'value1', 'key2', 'value2')$
is rewritten to:
   https://<host>:<port>/on/demandware.store/<current site>/default/MyLinkPipeline-Start?key1=value1&key2=value2

• $include('<pipeline>' [, '<key1>', '<value1>', '<key2>', '<value2>', ...])$

Description:
The $include()$ function creates a relative URL which is post processed by the Commerce Cloud Digital Webadapter. The result is the content generated by the given pipeline call.

Example:
MarkupText:
   $include('MyIncludePipeline-Start','key1', 'value1', 'key2' ,'value2')$
results in the content delivered by the 'MyIncludePipeline-Start' pipeline.

• ...?$staticlink$

Description:
The $staticlink$ function can be used to create a URL to a static resource (such as an image). The URL being generated depends on the owner of the MarkupText instance. For example, a product's long description (which is a MarkupText) will generate links to static resources within the catalog. Possible URL targets are catalogs (for catalog related objects like products and categories), the content library (for library related objects like folders and assets) or the organization (for all objects that are not catalog or library related).

Example:
MarkupText: (owned by a content asset)
   <img src="demo/content/bullet.gif?$staticlink$">
is rewritten to:
   <img src="/on/demandware.static/<current site>/<library>/default/v1178201405900/demo/content/bullet.gif">

Note: The comma symbol , is not supported in parameter values for the link functions.