Commerce Reference Store includes cross-site links to ATG Home products on the ATG Store site, and links to ATG Store products on the ATG Home site. Cross-site product links appear in the following places:
Search results
Recommended products on the home page
Promotional content items that contain target links
Related products on the product detail page
Recently viewed products on the product detail page
Gift and wish lists
Shopping cart
Product comparisons
Commerce Reference Store uses the servlet beans /atg/commerce/multisite/SiteIdForCatalogItem (of class atg.droplet.multisite.SiteIdForItemDroplet) and /atg/dynamo/droplet/multisite/SiteLinkDroplet (of class atg.droplet.multisite.SiteLinkDroplet) to create cross-site links. The following example is adapted from store.war/global/gadgets/crossSiteLinkGenerator.jsp:
<%-- Pass a product repository item to the SiteIdForCatalogItem droplet to
determine the best-matching site ID for the product. --%>
<dsp:droplet name="/atg/commerce/multisite/SiteIdForCatalogItem">
<dsp:param name="item" param="product" />
<dsp:oparam name="output">
<%-- Store the site ID obtained by SiteIdForCatalogItem in a productSiteId
variable. --%>
<dsp:getvalueof var="productSiteId" param="siteId" />
<%-- Pass the site ID and the product's template path to SiteLinkDroplet to
get a site-specific URL to the product template. --%>
<dsp:droplet name="/atg/dynamo/droplet/multisite/SiteLinkDroplet">
<dsp:param name="siteId" value="${productSiteId}" />
<dsp:param name="path" param="product.template.url" />
<dsp:oparam name="output">
<%-- Render the generated URL to the product template, appended with
the product ID. --%>
<dsp:getvaluof var="siteLinkUrl" param="url" />
<dsp:a href="${siteLinkUrl}">
<dsp:param name="productId" param="product.repositoryId" />
<dsp:valueof param="product.displayName" />
</dsp:a>
</dsp:oparam>
</dsp:droplet>
</dsp:oparam>
</dsp:droplet>This example generates the URL as follows:
The
SiteIdForCatalogItemservlet bean determines the best site ID to use for the product.The
SiteLinkDropletservlet bean uses thesiteIdreturned bySiteIdForCatalogItemto determine which site the URL should point to and it retrieves the value of theproductionURLproperty for that site. For example, if the link is to a product on ATG Store US, the value ofproductionURLis/crs/storeus. Note that, in this example,productionURLdoes not contain domain information, so the URL thatSiteLinkDropletproduces also does not include this information. Consequently, the browser will use the current page’s protocol, domain, and port information for the link.The product template portion is taken from the product’s
product.template.urlproperty, which is passed toSiteLinkDropletin itspathparameter.The
<dsp:a>tag appends theproductIdto the URL as a query parameter.
The resulting URL looks similar to this:
/crs/homeus/browse/productDetailSingleSku.jsp?productId=xprod2126
For more information about the SiteLinkDroplet and SiteIdForItemDroplet servlet bean classes, see the ATG Page Developer's Guide.
