CatalogItemImageZoomControl

CatalogItemImageZoomControl is a CatalogItemImageControl subcontrol that displays item-detail photos with thumbnail navigation and optional zoom. It was introduced in v2.5.

CatalogItemImageZoomControl zoomed image dimensions

Configurable properties

Property	Default	Valid values or format	Effect
`Align` String	Empty string (`""`)		Sets image alignment.
`EnableZoom` Boolean	`true`	`true`, `false`	Controls image zoom capability.
`ExpandedWindowText` String	Empty string (`""`)		Sets text for the expanded image window.
`FallbackToCategoryPhoto` Boolean	`true`	`true`, `false`	Controls fallback to the category photo when no item photo exists.
`FileBase` String	Not specified		Gets the base image file name.
`ImageHeight` Unit	`350`		Sets the displayed image height.
`ImageWidth` Unit	`350`		Sets the displayed image width.
`Item_ID` String	Not specified		Sets the item identifier.
`LargeImageHeight` Unit	`900`		Sets the large image height.
`LargeImageWidth` Unit	`900`		Sets the large image width.
`NoZoomImage` String	`"~/images/photo-not-found.png"`		Sets the image used when zoom is unavailable.
`PhotoAltText` String	Empty string (`""`)		Sets alternate text for the photo.
`PhotoCssClass` String	Empty string (`""`)		Sets the CSS class for the photo.
`PhotoLocation` String	`"Photo1"`		Sets the photo location.
`PhotoWidth` Integer	`0`		Not used by this control; use `ImageWidth` and `ImageHeight` instead.
`PictureNotFoundCssClass` String	Empty string (`""`)		Sets the CSS class for a missing picture.
`StockCode` String	Empty string (`""`)		Sets the item stock code.
`ThumbnailHeight` Unit	`75`		Sets the thumbnail height.
`ThumbnailWidth` Unit	`75`		Sets the thumbnail width.
`UseOnlyCanonicalLinks` Boolean	`true`	`true`, `false`	Controls use of canonical links for product-detail links.
`UsePhoto` String	`"Photo1"`	`"Photo1"`, `"Photo2"`	Selects the photo to display.
`ZoomPosition` Not specified	`"Right"`	`"Bottom"`, `"Left"`, `"Inside"`, `"Right"`, `"Top"`, `"None"`	Sets the mouse-over zoom position. `"None"` disables mouse-over zoom.
`ZoomWindowText` String	Empty string (`""`)		Sets text for the zoom window.

SitePages.config example

This control is loaded as a subcontrol of CatalogItemDetailControl.ascx. The example applies the documented literal defaults. The following properties are omitted because they do not have documented literal defaults: Align, ExpandedWindowText, FileBase, Item_ID, PhotoAltText, PhotoCssClass, PictureNotFoundCssClass, StockCode, ZoomWindowText.

<Control src="CatalogItemDetailControl.ascx"
         EnableZoom="true"
         FallbackToCategoryPhoto="true"
         ImageHeight="350"
         ImageWidth="350"
         LargeImageHeight="900"
         LargeImageWidth="900"
         NoZoomImage="~/images/photo-not-found.png"
         PhotoLocation="Photo1"
         PhotoWidth="0"
         ThumbnailHeight="75"
         ThumbnailWidth="75"
         UseOnlyCanonicalLinks="true"
         UsePhoto="Photo1"
         ZoomPosition="Right" />

Add this <Control> element to the appropriate page placeholder as described in The SitePages.config File.

Not specified in the Type or Default column means the dedicated legacy property page does not state that metadata. An empty Valid values or format cell means the source does not state a constrained value list; it does not mean that any value is accepted.

Inherited properties

CatalogItemImageZoomControl inherits shared conditions from CyberStoreBaseControl.