/// <summary>
/// Renders rating for a given entity if the Feedback feature is enabled and the entity is rateable and ratings are enabled for that entity type.
/// </summary>
/// <param name="html">Extension method target, provides support for HTML rendering and access to view context/data.</param>
/// <param name="entityReference">The <see cref="EntityReference"/> of the record for which to display rating.</param>
/// <param name="ratingInfo">The <see cref="IRatingInfo"/> that provides rating value and count if available. If not provided, it will be dynamically retrieved.</param>
/// <param name="panel">Indicates whether the rating should be wrapped in a bootstrap panel or not.</param>
/// <param name="panelTitleSnippetName">If panel is true, this is the name of a content snippet to display a title text in the panel heading.</param>
/// <param name="isReadonly">Indicates whether the rating is readonly (i.e. not editable).</param>
/// <param name="resetable">Indicates whether the rating can be reset.</param>
/// <param name="step">Step size value (default: 1)</param>
/// <param name="min">Minumum value (default: 0)</param>
/// <param name="max">Maximum value (default: 5)</param>
/// <param name="urlSave">The URL to the service to create/update a rating.</param>
/// <param name="roundNearestHalf">Indicates whether or not to round the rating value to the nearest half. Default is true.</param>
/// <returns>An HTML encoded string representing rating.</returns>
public static IHtmlString Rating(this HtmlHelper html, EntityReference entityReference, IRatingInfo ratingInfo = null, bool panel = false, string panelTitleSnippetName = "Rating Heading", bool isReadonly = false, bool resetable = false, string step = "1", string min = "0", string max = "5", string urlSave = null, bool roundNearestHalf = true)
{
if (!FeatureCheckHelper.IsFeatureEnabled(FeatureNames.Feedback))
{
return(new HtmlString(string.Empty));
}
if (entityReference == null)
{
return(new HtmlString(string.Empty));
}
if (!isReadonly && string.IsNullOrWhiteSpace(urlSave))
{
urlSave = html.GetPortalScopedRouteUrlByName("PortalRateit");
}
if (string.IsNullOrWhiteSpace(step))
{
step = "1";
}
if (string.IsNullOrWhiteSpace(min))
{
min = "0";
}
if (string.IsNullOrWhiteSpace(max))
{
max = "5";
}
if (ratingInfo == null)
{
var portal = PortalCrmConfigurationManager.CreatePortalContext();
var dataAdapterFactory = new RatingDataAdapterFactory(entityReference);
var dataAdapter = dataAdapterFactory.GetAdapter(portal, PortalExtensions.GetRequestContext());
if (!dataAdapter.RatingsEnabled)
{
return(new HtmlString(string.Empty));
}
ratingInfo = dataAdapter.GetRatingInfo() ?? new RatingInfo();
}
var ratingValue = roundNearestHalf ? ratingInfo.AverageRatingRounded : ratingInfo.AverageRating;
var ratingCount = ratingInfo.RatingCount;
var container = new TagBuilder("div");
container.AddCssClass("rating");
var rateit = new TagBuilder("div");
rateit.AddCssClass("rateit");
rateit.MergeAttribute("data-rateit-resetable", resetable.ToString().ToLower());
rateit.MergeAttribute("data-rateit-step", step);
rateit.MergeAttribute("data-rateit-min", min);
rateit.MergeAttribute("data-rateit-max", max);
rateit.MergeAttribute("data-rateit-ispreset", "true");
rateit.MergeAttribute("data-rateit-readonly", isReadonly.ToString().ToLower());
rateit.MergeAttribute("data-rateit-value", ratingValue.ToString(CultureInfo.InvariantCulture));
rateit.MergeAttribute("data-logicalname", entityReference.LogicalName);
rateit.MergeAttribute("data-id", entityReference.Id.ToString());
if (!isReadonly)
{
rateit.MergeAttribute("data-url-save", urlSave);
}
var count = new TagBuilder("span");
count.AddCssClass("rating-count badge");
count.InnerHtml = ratingCount.ToString();
if (panel)
{
container.AddCssClass("content-panel panel panel-default");
var heading = new TagBuilder("div");
heading.AddCssClass("panel-heading");
var title = new TagBuilder("h4");
var icon = new TagBuilder("span");
icon.AddCssClass("fa fa-star-o");
icon.MergeAttribute("aria-hidden", "true");
title.InnerHtml += icon.ToString();
if (string.IsNullOrWhiteSpace(panelTitleSnippetName))
{
panelTitleSnippetName = "Rating Heading";
}
var snippet = html.TextSnippet(panelTitleSnippetName, true, "span",
defaultValue: ResourceManager.GetString("Rate_This_Defaulttext"));
title.InnerHtml += snippet;
heading.InnerHtml += title;
var body = new TagBuilder("div");
body.AddCssClass("panel-body");
body.InnerHtml += rateit.ToString();
body.InnerHtml += count.ToString();
container.InnerHtml += heading.ToString();
container.InnerHtml += body.ToString();
}
else
{
container.InnerHtml += rateit.ToString();
container.InnerHtml += count.ToString();
}
return(new HtmlString(container.ToString()));
}
