wp_star_rating( array $args = array() ): string

2746function wp_star_rating( $args = array() ) {2747	$defaults    = array(2748		'rating' => 0,2749		'type'   => 'rating',2750		'number' => 0,2751		'echo'   => true,2752	);2753	$parsed_args = wp_parse_args( $args, $defaults );2754 2755	// Non-English decimal places when the $rating is coming from a string.2756	$rating = (float) str_replace( ',', '.', $parsed_args['rating'] );2757 2758	// Convert percentage to star rating, 0..5 in .5 increments.2759	if ( 'percent' === $parsed_args['type'] ) {2760		$rating = round( $rating / 10, 0 ) / 2;2761	}2762 2763	// Calculate the number of each type of star needed.2764	$full_stars  = floor( $rating );2765	$half_stars  = ceil( $rating - $full_stars );2766	$empty_stars = 5 - $full_stars - $half_stars;2767 2768	if ( $parsed_args['number'] ) {2769		/* translators: Hidden accessibility text. 1: The rating, 2: The number of ratings. */2770		$format = _n( '%1$s rating based on %2$s rating', '%1$s rating based on %2$s ratings', $parsed_args['number'] );2771		$title  = sprintf( $format, number_format_i18n( $rating, 1 ), number_format_i18n( $parsed_args['number'] ) );2772	} else {2773		/* translators: Hidden accessibility text. %s: The rating. */2774		$title = sprintf( __( '%s rating' ), number_format_i18n( $rating, 1 ) );2775	}2776 2777	$output  = '<div class="star-rating">';2778	$output .= '<span class="screen-reader-text">' . $title . '</span>';2779	$output .= str_repeat( '<div class="star star-full" aria-hidden="true"></div>', $full_stars );2780	$output .= str_repeat( '<div class="star star-half" aria-hidden="true"></div>', $half_stars );2781	$output .= str_repeat( '<div class="star star-empty" aria-hidden="true"></div>', $empty_stars );2782	$output .= '</div>';2783 2784	if ( $parsed_args['echo'] ) {2785		echo $output;2786	}2787 2788	return $output;2789}