CatalogItemImageControl

CatalogItemImageControl displays a featured item image and, when enabled, item-detail images with a zoom interface.

CatalogItemImageControl item image

Configurable properties

Property	Default	Valid values or format	Effect
`Align` String	Empty string (`""`)		Sets image alignment.
`EnableZoom` Boolean	`false`	`true`, `false`	Controls the item-detail image zoom interface.
`ExpandedWindowText` String	Empty string (`""`)		Sets expanded-window text.
`FallbackToCategoryPhoto` Boolean	`true`	`true`, `false`	Controls category-photo fallback.
`FileBase` String	`"ComConfig.CustomImagesFolderPath"`		Sets the image file base.
`Item_ID` Integer	Not specified		Sets the item identifier.
`PhotoAltText` String	Empty string (`""`)		Sets image alternative text.
`PhotoCssClass` String	Empty string (`""`)		Sets the image CSS class.
`PhotoLocation` String	`"Photo1"`		Sets the photo location.
`PhotoWidth` Integer	`0`		Sets the photo width.
`PictureNotFoundCssClass` String	Empty string (`""`)		Sets the missing-image CSS class.
`PictureNotFoundImageUrl` String	`"~/images/photo-not-found.png"`		Sets the missing-image URL.
`StockCode` String	Empty string (`""`)		Sets the item stock code.
`UseOnlyCanonicalLinks` Boolean	`true`	`true`, `false`	Controls canonical image-link use.
`UsePhoto` String	`"Photo1"`	`"Photo1"`, `"Photo2"`	Selects the photo to use.
`ZoomWindowText` String	Empty string (`""`)		Sets zoom-window text.

SitePages.config example

The following example loads CatalogItemImageControl.ascx and applies the documented literal defaults. The following properties are omitted because they do not have documented literal defaults: Align, ExpandedWindowText, Item_ID, PhotoAltText, PhotoCssClass, PictureNotFoundCssClass, StockCode, ZoomWindowText.

<Control src="CatalogItemImageControl.ascx"
         EnableZoom="false"
         FallbackToCategoryPhoto="true"
         FileBase="ComConfig.CustomImagesFolderPath"
         PhotoLocation="Photo1"
         PhotoWidth="0"
         PictureNotFoundImageUrl="~/images/photo-not-found.png"
         UseOnlyCanonicalLinks="true"
         UsePhoto="Photo1" />

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

Inherited properties

CatalogItemImageControl inherits shared conditions from CyberStoreBaseControl.