[],
'em' => [],
'b' => [],
'i' => [],
'br' => [],
'span' => [],
];
/** Format a number without a trailing `.0` (e.g. 4, 4.5). */
$fmt = static function ( $number ) {
return rtrim( rtrim( number_format( (float) $number, 1, '.', '' ), '0' ), '.' );
};
// Star row — static markup (no user input), safe to echo directly. Each star is
// an unmarked base with a marked overlay clipped to the per-star fill width.
$star_svg = '';
$stars = '';
for ( $i = 0; $i < $max_rating; $i++ ) {
$fill = max( 0.0, min( 1.0, $rating - $i ) ) * 100;
$pct = $fmt( $fill );
$stars .= ''
. $star_svg
. '' . $star_svg . ''
. '';
}
$aria_label = sprintf(
/* translators: 1: rating value, 2: maximum rating. */
esc_attr__( 'Rated %1$s out of %2$s', 'flexa-block' ),
$fmt( $rating ),
$fmt( $max_rating )
);
$stars_html = '' . $stars . '';
// Optional title.
$title_html = '';
if ( $show_title && '' !== trim( $title ) ) {
$title_html = '' . wp_kses( $title, $inline_allowed ) . '';
}
// Assemble in visual order.
$inner = '';
if ( 'before' === $title_position ) {
$inner .= $title_html . $stars_html;
} else {
$inner .= $stars_html . $title_html;
}
// Wrapper classes + attributes.
$classes = [ 'flexa-star-rating', 'flexa-star-rating--' . $layout ];
if ( '' !== $block_id ) {
$classes[] = 'flexa-star-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' : '';
// Optional aggregateRating schema (printed once, before the stars).
$schema_html = '';
if ( $enable_schema ) {
$schema = [
'@context' => 'https://schema.org',
'@type' => 'AggregateRating',
'ratingValue' => $rating,
'bestRating' => $max_rating,
'worstRating' => 0,
'ratingCount' => 1,
];
$name = trim( wp_strip_all_tags( $title ) );
if ( '' !== $name ) {
$schema['itemReviewed'] = [
'@type' => 'Thing',
'name' => $name,
];
}
$json = wp_json_encode( $schema, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE );
if ( false !== $json ) {
$schema_html = '';
}
}
printf(
'<%1$s %2$s%3$s%4$s>%5$s%6$s',
esc_html( $html_tag ),
$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.
$schema_html, // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- wp_json_encode output, script tag static.
$inner // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- star markup static, title wp_kses'd, width/aria escaped above.
);