<?php
/**
 * Öffentliche Funktionen für Themes.
 *
 * @package ThreeRB
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

if ( ! function_exists( 'threerb_get_score' ) ) {
	/**
	 * Note eines Beitrags für Themes, oder null, wenn er keine sichtbare Bewertung hat.
	 *
	 * Beispiel: $s = threerb_get_score(); if ( $s ) { echo esc_html( $s['display'] ); }
	 *
	 * @param int $post_id Beitrag, 0 = aktueller Beitrag.
	 * @return array{value:float, best:int, worst:int, share:float, scale:string, display:string, word:string}|null
	 */
	function threerb_get_score( $post_id = 0 ) {
		$post_id = $post_id ? (int) $post_id : (int) get_the_ID();
		if ( ! $post_id || ! ThreeRB_Render::visible( $post_id ) ) {
			return null;
		}
		$box = ThreeRB_Box::get( $post_id );
		if ( ! ThreeRB_Box::has_rating( $box ) ) {
			return null;
		}
		$gesamt = ThreeRB_Score::total( $box );
		return array(
			'value'   => (float) $gesamt['value'],
			'best'    => (int) ThreeRB_Score::max( $box['scale'] ),
			'worst'   => 0,
			'share'   => round( (float) $gesamt['share'], 4 ),
			'scale'   => $box['scale'],
			'display' => ThreeRB_Render::zahl( $gesamt['value'], $box ),
			'word'    => ThreeRB_Render::wort( $gesamt['share'] ),
		);
	}
}