using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; using Umbraco.Core; using Umbraco.Core.Models; using Umbraco.Web.Models; using Umbraco.Web.PropertyEditors; namespace Umbraco.Web { /// /// Provides extension methods for getting ImageProcessor Url from the core Image Cropper property editor /// public static class ImageCropperTemplateExtensions { /// /// Gets the ImageProcessor Url by the crop alias (from the "umbracoFile" property alias) on the IPublishedContent item /// /// /// The IPublishedContent item. /// /// /// The crop alias e.g. thumbnail /// /// /// The ImageProcessor.Web Url. /// public static string GetCropUrl(this IPublishedContent mediaItem, string cropAlias) { return mediaItem.GetCropUrl(cropAlias: cropAlias, useCropDimensions: true); } /// /// Gets the ImageProcessor Url by the crop alias using the specified property containing the image cropper Json data on the IPublishedContent item. /// /// /// The IPublishedContent item. /// /// /// The property alias of the property containing the Json data e.g. umbracoFile /// /// /// The crop alias e.g. thumbnail /// /// /// The ImageProcessor.Web Url. /// public static string GetCropUrl(this IPublishedContent mediaItem, string propertyAlias, string cropAlias) { return mediaItem.GetCropUrl(propertyAlias: propertyAlias, cropAlias: cropAlias, useCropDimensions: true); } /// /// Gets the ImageProcessor Url from the IPublishedContent item. /// /// /// The IPublishedContent item. /// /// /// The width of the output image. /// /// /// The height of the output image. /// /// /// Quality percentage of the output image. /// /// /// The image crop mode. /// /// /// The image crop anchor. /// /// /// Property alias of the property containing the Json data. /// /// /// The crop alias. /// /// /// Use focal point, to generate an output image using the focal point instead of the predefined crop /// /// /// Use crop dimensions to have the output image sized according to the predefined crop sizes, this will override the width and height parameters>. /// /// /// Add a random number at the end of the generated string /// /// /// The further options. /// /// /// The . /// public static string GetCropUrl( this IPublishedContent mediaItem, int? width = null, int? height = null, int? quality = null, ImageCropMode? imageCropMode = null, ImageCropAnchor? imageCropAnchor = null, string propertyAlias = Constants.Conventions.Media.File, string cropAlias = null, bool useFocalPoint = false, bool useCropDimensions = false, bool cacheBuster = true, string furtherOptions = null) { string imageCropperValue = null; string mediaItemUrl; if (mediaItem.HasProperty(propertyAlias) && mediaItem.HasValue(propertyAlias)) { imageCropperValue = mediaItem.GetPropertyValue(propertyAlias); // get the raw value (this will be json) var urlValue = mediaItem.GetPropertyValue(propertyAlias); mediaItemUrl = urlValue.DetectIsJson() ? urlValue.SerializeToCropDataSet().Src : urlValue; } else { mediaItemUrl = mediaItem.Url; } return mediaItemUrl != null ? GetCropUrl(mediaItemUrl, width, height, quality, imageCropMode, imageCropAnchor, imageCropperValue, cropAlias, useFocalPoint, useCropDimensions, cacheBuster, furtherOptions) : string.Empty; } /// /// Gets the ImageProcessor Url from the image path. /// /// /// The image url. /// /// /// The width of the output image. /// /// /// The height of the output image. /// /// /// Quality percentage of the output image. /// /// /// The image crop mode. /// /// /// The image crop anchor. /// /// /// The Json data from the Umbraco Core Image Cropper property editor /// /// /// The crop alias. /// /// /// Use focal point, to generate an output image using the focal point instead of the predefined crop /// /// /// Use crop dimensions to have the output image sized according to the predefined crop sizes, this will override the width and height parameters>. /// /// /// Add a random number at the end of the generated string /// /// /// The further options. /// /// /// The . /// public static string GetCropUrl( this string imageUrl, int? width = null, int? height = null, int? quality = null, ImageCropMode? imageCropMode = null, ImageCropAnchor? imageCropAnchor = null, string imageCropperValue = null, string cropAlias = null, bool useFocalPoint = false, bool useCropDimensions = false, bool cacheBuster = true, string furtherOptions = null) { if (string.IsNullOrEmpty(imageUrl) == false) { var imageResizerUrl = new StringBuilder(); if (string.IsNullOrEmpty(imageCropperValue) == false && imageCropperValue.DetectIsJson()) { var cropDataSet = imageCropperValue.SerializeToCropDataSet(); if (cropDataSet != null) { var cropUrl = cropDataSet.GetCropUrl(cropAlias, false, useFocalPoint, cacheBuster); // if crop alias has been specified but not found in the Json we should return null if (string.IsNullOrEmpty(cropAlias) == false && cropUrl == null) { return null; } imageResizerUrl.Append(cropDataSet.Src); imageResizerUrl.Append(cropDataSet.GetCropUrl(cropAlias, useCropDimensions, useFocalPoint, cacheBuster)); } } else { imageResizerUrl.Append(imageUrl); if (imageCropMode == null) { imageCropMode = ImageCropMode.Pad; } imageResizerUrl.Append("?mode=" + imageCropMode.ToString().ToLower()); if (imageCropAnchor != null) { imageResizerUrl.Append("&anchor=" + imageCropAnchor.ToString().ToLower()); } } if (quality != null) { imageResizerUrl.Append("&quality=" + quality); } if (width != null && useCropDimensions == false) { imageResizerUrl.Append("&width=" + width); } if (height != null && useCropDimensions == false) { imageResizerUrl.Append("&height=" + height); } if (furtherOptions != null) { imageResizerUrl.Append(furtherOptions); } return imageResizerUrl.ToString(); } return string.Empty; } } }