get_average_rating();
$count = (int) $product->get_review_count();
// Off unless the product is rated (or the user opted to show it while unrated).
if ( $average <= 0 && empty( $attributes['showEmptyRating'] ) ) {
return;
}
$block_id = $attributes['blockId'] ?? '';
$anchor = $attributes['anchor'] ?? '';
$display_type = in_array( $attributes['displayType'] ?? 'stars', [ 'stars', 'stars-number', 'number' ], true ) ? $attributes['displayType'] : 'stars';
$show_count = ! isset( $attributes['showReviewCount'] ) || ! empty( $attributes['showReviewCount'] );
$show_stars = 'stars' === $display_type || 'stars-number' === $display_type;
$show_number = 'number' === $display_type || 'stars-number' === $display_type;
$max_stars = 5;
$average = max( 0.0, min( (float) $max_stars, $average ) );
/** Format a rating without a trailing `.0` (e.g. 4, 4.5). */
$fmt = static function ( $number ) {
return rtrim( rtrim( number_format( (float) $number, 1, '.', '' ), '0' ), '.' );
};
// A single star glyph, reused for the base (empty) and fill (marked) rows.
$star_svg = '';
$star_row = str_repeat( $star_svg, $max_stars );
// Star row — an empty base with a marked overlay clipped to the fill width.
$stars_html = '';
if ( $show_stars ) {
$fill_pct = $fmt( ( $average / $max_stars ) * 100 );
$aria = sprintf(
/* translators: 1: rating value, 2: maximum rating. */
esc_attr__( 'Rated %1$s out of %2$s', 'flexa-block' ),
$fmt( $average ),
$max_stars
);
$stars_html = ''
. '' . $star_row . ''
. '' . $star_row . ''
. '';
}
// Numeric score.
$number_html = '';
if ( $show_number ) {
$number_html = '' . esc_html( $fmt( $average ) ) . '';
}
// Optional review count.
$count_html = '';
if ( $show_count ) {
$count_text = sprintf(
/* translators: %s: number of reviews. */
_n( '(%s review)', '(%s reviews)', $count, 'flexa-block' ),
number_format_i18n( $count )
);
$count_html = '' . esc_html( $count_text ) . '';
}
$inner = $stars_html . $number_html . $count_html;
$classes = [ 'flexa-product-rating' ];
if ( '' !== $block_id ) {
$classes[] = 'flexa-product-rating-' . sanitize_html_class( $block_id );
}
$classes = HTML_Helpers::build_wrapper_classes( $classes, $attributes );
$wrapper_args = [ 'class' => implode( ' ', $classes ) ];
if ( $anchor ) {
$wrapper_args['id'] = sanitize_html_class( $anchor );
}
$wrapper_attributes = get_block_wrapper_attributes( $wrapper_args );
$data_attrs = HTML_Helpers::build_data_attrs( $attributes );
// Lazy background: mark the wrapper so view.js reveals the image near the viewport.
$background = $attributes['background'] ?? [];
$is_lazy_bg = ! empty( $background['lazyLoad'] ) && 'image' === ( $background['type'] ?? 'none' ) && '' !== ( $background['image']['url'] ?? '' );
$lazy_marker = $is_lazy_bg ? ' data-flexa-lazy-bg' : '';
printf(
'%4$s
',
$wrapper_attributes, // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- built via get_block_wrapper_attributes.
$data_attrs, // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- keys sanitized, values escaped in helper.
$lazy_marker, // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- static literal.
$inner // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- star markup static, width/aria escaped, count text esc_html'd above.
);