<?php
/**
 * The dashboard edit screen and list, built on WordPress's own post screens.
 *
 * @package PulseCast
 */

namespace PulseCast\Admin;

use PulseCast\Domain\Dashboard;
use PulseCast\Domain\Dashboard_Post_Type;
use PulseCast\Domain\Dashboard_Repository;
use PulseCast\Feeds\Feed_Cache;
use PulseCast\Feeds\Refresh_Policy;
use PulseCast\Frontend\Display_Route;
use PulseCast\Support\Settings_Schema;

/**
 * Adds meta boxes (feeds, display settings, link), list columns and the save handler.
 *
 * Saving verifies a nonce and the user's capability, then validates every value through the
 * existing repository, URL validator and settings schema. No feed content is shown here, only
 * configuration and health.
 */
final class Dashboard_Screen {

	public const NONCE_ACTION   = 'pulsecast_save_dashboard';
	public const NONCE_FIELD    = 'pulsecast_nonce';
	public const BLANK_ROWS     = 2;
	public const LOADING_WINDOW = 300;

	/**
	 * Dashboards.
	 *
	 * @var Dashboard_Repository
	 */
	private Dashboard_Repository $dashboards;

	/**
	 * Feed cache.
	 *
	 * @var Feed_Cache
	 */
	private Feed_Cache $cache;

	/**
	 * Constructor.
	 *
	 * @param Dashboard_Repository $dashboards Dashboards.
	 * @param Feed_Cache           $cache      Feed cache.
	 */
	public function __construct( Dashboard_Repository $dashboards, Feed_Cache $cache ) {
		$this->dashboards = $dashboards;
		$this->cache      = $cache;
	}

	/**
	 * Hooks the screen into WordPress.
	 */
	public function register(): void {
		$type = Dashboard_Post_Type::NAME;

		add_action( 'add_meta_boxes_' . $type, array( $this, 'add_meta_boxes' ) );
		add_action( 'save_post_' . $type, array( $this, 'save' ), 5, 2 );
		add_action( 'admin_enqueue_scripts', array( $this, 'enqueue' ) );
		add_action( 'admin_notices', array( $this, 'show_notices' ) );
		add_filter( 'manage_' . $type . '_posts_columns', array( $this, 'columns' ) );
		add_action( 'manage_' . $type . '_posts_custom_column', array( $this, 'column' ), 10, 2 );
		add_filter( 'post_row_actions', array( $this, 'row_actions' ), 10, 2 );
		add_filter( 'enter_title_here', array( $this, 'title_placeholder' ), 10, 2 );
		add_filter( 'bulk_actions-edit-' . $type, array( $this, 'bulk_actions' ) );
	}

	/**
	 * Layout names shown to administrators.
	 *
	 * @return array<string,string>
	 */
	public static function layouts(): array {
		return array(
			'command' => __( 'Command Center', 'feedmarquee' ),
			'cards'   => __( 'Featured Cards', 'feedmarquee' ),
			'list'    => __( 'Headline Wall', 'feedmarquee' ),
		);
	}

	/**
	 * Colour palettes shown to administrators.
	 *
	 * @return array<string,string>
	 */
	public static function palettes(): array {
		return array(
			'midnight' => __( 'Midnight', 'feedmarquee' ),
			'ocean'    => __( 'Ocean', 'feedmarquee' ),
			'ember'    => __( 'Ember', 'feedmarquee' ),
			'forest'   => __( 'Forest', 'feedmarquee' ),
			'light'    => __( 'Light', 'feedmarquee' ),
		);
	}

	/**
	 * Queues a notice for the current user's next admin page.
	 *
	 * @param string $type    `success`, `warning` or `error`.
	 * @param string $message Plain-text message.
	 */
	public static function notify( string $type, string $message ): void {
		$key     = 'pulsecast_notices_' . get_current_user_id();
		$notices = get_transient( $key );
		$notices = is_array( $notices ) ? $notices : array();

		$notices[] = array(
			'type'    => $type,
			'message' => $message,
		);

		set_transient( $key, $notices, 5 * MINUTE_IN_SECONDS );
	}

	/**
	 * Prints and clears queued notices.
	 */
	public function show_notices(): void {
		$screen = get_current_screen();

		// Only on FeedMarquee's own screens, so nothing appears on unrelated admin pages.
		if ( null === $screen || Dashboard_Post_Type::NAME !== $screen->post_type ) {
			return;
		}

		$key     = 'pulsecast_notices_' . get_current_user_id();
		$notices = get_transient( $key );

		if ( ! is_array( $notices ) ) {
			return;
		}

		delete_transient( $key );

		foreach ( $notices as $notice ) {
			$type = in_array( $notice['type'], array( 'success', 'warning', 'error' ), true ) ? $notice['type'] : 'info';

			printf( '<div class="notice notice-%1$s is-dismissible"><p>%2$s</p></div>', esc_attr( $type ), esc_html( $notice['message'] ) );
		}
	}

	/**
	 * Adds the meta boxes.
	 */
	public function add_meta_boxes(): void {
		$type = Dashboard_Post_Type::NAME;

		add_meta_box( 'pulsecast_link', __( 'Display link', 'feedmarquee' ), array( $this, 'render_link' ), $type, 'side', 'high' );
		add_meta_box( 'pulsecast_display', __( 'Display', 'feedmarquee' ), array( $this, 'render_display' ), $type, 'side', 'default' );
		add_meta_box( 'pulsecast_feeds', __( 'RSS feeds', 'feedmarquee' ), array( $this, 'render_feeds' ), $type, 'normal', 'high' );
	}

	/**
	 * Placeholder for the title field.
	 *
	 * @param string   $text Default placeholder.
	 * @param \WP_Post $post Post.
	 */
	public function title_placeholder( string $text, \WP_Post $post ): string {
		return Dashboard_Post_Type::NAME === $post->post_type ? __( 'Dashboard name, for example Lobby TV', 'feedmarquee' ) : $text;
	}

	/**
	 * Loads the admin script and styles on FeedMarquee screens only.
	 *
	 * @param string $hook Admin page hook.
	 */
	public function enqueue( string $hook ): void {
		$screen = get_current_screen();

		if ( null === $screen || Dashboard_Post_Type::NAME !== $screen->post_type || ! in_array( $hook, array( 'post.php', 'post-new.php', 'edit.php' ), true ) ) {
			return;
		}

		// WordPress's bundled colour picker: no external dependency.
		wp_enqueue_style( 'wp-color-picker' );
		wp_enqueue_style( 'pulsecast-admin', plugins_url( 'assets/css/admin.css', PULSECAST_FILE ), array( 'wp-color-picker' ), PULSECAST_VERSION );
		wp_enqueue_script( 'pulsecast-admin', plugins_url( 'assets/js/admin.js', PULSECAST_FILE ), array( 'jquery', 'wp-color-picker' ), PULSECAST_VERSION, true );
	}

	/**
	 * Display link box: open button, copyable URL, or a clear "not public" message.
	 *
	 * @param \WP_Post $post Dashboard post.
	 */
	public function render_link( \WP_Post $post ): void {
		$dashboard = $this->dashboards->find( $post->ID );

		if ( null === $dashboard || ! $dashboard->enabled ) {
			echo '<p class="pulsecast-unpublished"><strong>' . esc_html__( 'Not public yet.', 'feedmarquee' ) . '</strong> '
				. esc_html__( 'This dashboard is unpublished, so nobody can open it. Add your feeds, then click Publish to get its display link.', 'feedmarquee' ) . '</p>';

			return;
		}

		$url   = Display_Route::url( $dashboard->key );
		$reset = wp_nonce_url( admin_url( 'admin-post.php?action=pulsecast_reset_link&dashboard=' . $post->ID ), 'pulsecast_reset_link_' . $post->ID );

		echo '<p><a class="button button-primary button-hero pulsecast-open" href="' . esc_url( $url ) . '" target="_blank" rel="noopener">' . esc_html__( 'Open dashboard', 'feedmarquee' ) . '</a></p>';
		echo '<p><label for="pulsecast-url" class="screen-reader-text">' . esc_html__( 'Display URL', 'feedmarquee' ) . '</label>'
			. '<input type="text" id="pulsecast-url" class="widefat" readonly value="' . esc_attr( $url ) . '"></p>';
		echo '<p><button type="button" class="button pulsecast-copy" data-target="pulsecast-url" data-done="' . esc_attr__( 'Copied!', 'feedmarquee' ) . '">' . esc_html__( 'Copy display URL', 'feedmarquee' ) . '</button></p>';
		echo '<p class="description">' . esc_html__( 'Open this address on a TV or browser. Anyone with the link can view the dashboard, so only share it where you want it shown.', 'feedmarquee' ) . '</p>';
		echo '<p class="description"><a href="' . esc_url( $reset ) . '" class="pulsecast-reset" data-confirm="' . esc_attr__( 'Create a new link? The current link will stop working immediately.', 'feedmarquee' ) . '">'
			. esc_html__( 'Create a new link', 'feedmarquee' ) . '</a></p>';
	}

	/**
	 * Display settings box.
	 *
	 * @param \WP_Post $post Dashboard post.
	 */
	public function render_display( \WP_Post $post ): void {
		$dashboard = $this->dashboards->find( $post->ID );
		$settings  = null === $dashboard ? Settings_Schema::defaults() : $dashboard->settings;
		$intervals = array( 5, 10, 15, 30, 60, 120, 360, 1440 );

		if ( ! in_array( (int) $settings['refresh_interval'], $intervals, true ) ) {
			$intervals[] = (int) $settings['refresh_interval'];
			sort( $intervals );
		}

		echo '<p><label for="pulsecast-layout"><strong>' . esc_html__( 'Layout', 'feedmarquee' ) . '</strong></label><br><select name="pulsecast_settings[layout]" id="pulsecast-layout" class="widefat">';
		foreach ( self::layouts() as $value => $label ) {
			printf( '<option value="%1$s"%2$s>%3$s</option>', esc_attr( $value ), selected( $settings['layout'], $value, false ), esc_html( $label ) );
		}
		echo '</select></p>';

		echo '<p><label for="pulsecast-palette"><strong>' . esc_html__( 'Colors', 'feedmarquee' ) . '</strong></label><br><select name="pulsecast_settings[palette]" id="pulsecast-palette" class="widefat">';
		foreach ( self::palettes() as $value => $label ) {
			printf( '<option value="%1$s"%2$s>%3$s</option>', esc_attr( $value ), selected( $settings['palette'], $value, false ), esc_html( $label ) );
		}
		echo '</select></p>';

		echo '<p><label for="pulsecast-interval"><strong>' . esc_html__( 'Check feeds every', 'feedmarquee' ) . '</strong></label><br><select name="pulsecast_settings[refresh_interval]" id="pulsecast-interval" class="widefat">';
		foreach ( $intervals as $minutes ) {
			/* translators: %d: number of minutes. */
			$label = $minutes >= 60 && 0 === $minutes % 60 ? sprintf( _n( '%d hour', '%d hours', intdiv( $minutes, 60 ), 'feedmarquee' ), intdiv( $minutes, 60 ) ) : sprintf( _n( '%d minute', '%d minutes', $minutes, 'feedmarquee' ), $minutes );
			printf( '<option value="%1$d"%2$s>%3$s</option>', (int) $minutes, selected( (int) $settings['refresh_interval'], $minutes, false ), esc_html( $label ) );
		}
		echo '</select></p>';

		echo '<p><label for="pulsecast-heading"><strong>' . esc_html__( 'Headlines heading', 'feedmarquee' ) . '</strong></label><br>'
			. '<input type="text" name="pulsecast_settings[headlines_heading]" id="pulsecast-heading" maxlength="40" class="widefat" value="' . esc_attr( (string) $settings['headlines_heading'] ) . '"><br>'
			. '<input type="hidden" name="pulsecast_settings[show_headlines_heading]" value="0">'
			. '<label><input type="checkbox" name="pulsecast_settings[show_headlines_heading]" value="1"' . checked( ! empty( $settings['show_headlines_heading'] ), true, false ) . '> ' . esc_html__( 'Show the heading', 'feedmarquee' ) . '</label>'
			. '<span class="description pulsecast-note">' . esc_html__( 'Command Center only.', 'feedmarquee' ) . '</span></p>';

		echo '<p><label for="pulsecast-max"><strong>' . esc_html__( 'Maximum articles', 'feedmarquee' ) . '</strong></label><br>'
			. '<input type="number" name="pulsecast_settings[max_items]" id="pulsecast-max" min="5" max="100" step="1" value="' . esc_attr( (string) $settings['max_items'] ) . '" class="small-text"></p>';
	}

	/**
	 * Feeds box: editable rows with health, and a refresh link.
	 *
	 * @param \WP_Post $post Dashboard post.
	 */
	public function render_feeds( \WP_Post $post ): void {
		$dashboard = $this->dashboards->find( $post->ID );
		$feeds     = null === $dashboard ? array() : $dashboard->feeds;
		$interval  = null === $dashboard ? 900 : (int) $dashboard->settings['refresh_interval'] * 60;
		$now       = time();
		$enabled   = null !== $dashboard && $dashboard->enabled;
		$age       = $now - (int) strtotime( $post->post_modified_gmt . ' UTC' );

		wp_nonce_field( self::NONCE_ACTION, self::NONCE_FIELD );

		echo '<p class="description">' . esc_html__( 'Add the address of each RSS or Atom feed you want to show. A label is optional and replaces the feed\'s own name on the display. To remove a feed, click Remove and then save.', 'feedmarquee' ) . '</p>';
		echo '<table class="widefat striped pulsecast-feeds"><thead><tr><th scope="col">' . esc_html__( 'Feed address', 'feedmarquee' ) . '</th><th scope="col">' . esc_html__( 'Label (optional)', 'feedmarquee' ) . '</th><th scope="col">' . esc_html__( 'Color', 'feedmarquee' ) . '</th><th scope="col">' . esc_html__( 'Status', 'feedmarquee' ) . '</th><th></th></tr></thead><tbody id="pulsecast-feed-rows">';

		$index = 0;
		foreach ( $feeds as $feed ) {
			$this->render_row( $index++, $feed['url'], $feed['label'], $feed['color'] ?? '', $this->health( $feed['url'], $interval, $now, $enabled, $age ) );
		}
		for ( $i = 0; $i < self::BLANK_ROWS; $i++ ) {
			$this->render_row( $index++, '', '', '', '' );
		}

		echo '</tbody></table>';

		echo '<template id="pulsecast-feed-template">';
		$this->render_row( '__i__', '', '', '', '' );
		echo '</template>';

		echo '<p><button type="button" class="button" id="pulsecast-add-feed" data-next="' . esc_attr( (string) $index ) . '">' . esc_html__( 'Add another feed', 'feedmarquee' ) . '</button>';

		if ( array() !== $feeds ) {
			$refresh = wp_nonce_url( admin_url( 'admin-post.php?action=pulsecast_refresh&dashboard=' . $post->ID ), 'pulsecast_refresh_' . $post->ID );
			echo ' <a class="button" href="' . esc_url( $refresh ) . '">' . esc_html__( 'Refresh feeds now', 'feedmarquee' ) . '</a>';
		}

		echo '</p>';
	}

	/**
	 * Saves feeds and settings when a dashboard is saved.
	 *
	 * @param int      $post_id Post ID.
	 * @param \WP_Post $post    Post.
	 */
	public function save( int $post_id, \WP_Post $post ): void {
		if ( ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) || wp_is_post_revision( $post_id ) || Dashboard_Post_Type::NAME !== $post->post_type ) {
			return;
		}

		$nonce = isset( $_POST[ self::NONCE_FIELD ] ) ? sanitize_text_field( wp_unslash( $_POST[ self::NONCE_FIELD ] ) ) : '';

		if ( '' === $nonce || ! wp_verify_nonce( $nonce, self::NONCE_ACTION ) || ! current_user_can( 'edit_post', $post_id ) ) {
			return;
		}

		// Each value is validated by the repository (feeds) and the settings schema before it is stored.
		$feeds    = isset( $_POST['pulsecast_feeds'] ) ? wp_unslash( $_POST['pulsecast_feeds'] ) : array(); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.NonceVerification.Missing -- Nonce verified above; sanitized in Dashboard_Repository::set_feeds().
		$settings = isset( $_POST['pulsecast_settings'] ) && is_array( $_POST['pulsecast_settings'] ) ? wp_unslash( $_POST['pulsecast_settings'] ) : array(); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.NonceVerification.Missing -- As above; Settings_Schema::sanitize() validates.

		$this->dashboards->set_settings( $post_id, $settings );
		$errors = $this->dashboards->set_feeds( $post_id, $feeds );

		/**
		 * Fires after a dashboard's feeds and settings are stored.
		 *
		 * @param int $post_id Dashboard ID.
		 */
		do_action( 'pulsecast_dashboard_saved', $post_id );

		$rows = is_array( $feeds ) ? array_values( $feeds ) : array();

		if ( 'publish' === $post->post_status ) {
			foreach ( null === $this->dashboards->find( $post_id ) ? array() : $this->dashboards->find( $post_id )->feeds as $feed ) {
				if ( null === $this->cache->get( $feed['url'] ) ) {
					self::notify( 'info', __( 'FeedMarquee is loading your feeds. This usually takes under a minute, and the status below will update on its own.', 'feedmarquee' ) );
					break;
				}
			}
		}

		foreach ( $errors as $index => $code ) {
			$url = is_array( $rows[ $index ] ?? null ) && is_string( $rows[ $index ]['url'] ?? null ) ? $rows[ $index ]['url'] : '';

			/* translators: 1: feed address, 2: explanation. */
			self::notify( 'error', sprintf( __( 'Feed not saved: %1$s. %2$s', 'feedmarquee' ), '' !== $url ? $url : __( '(no address)', 'feedmarquee' ), Messages::feed_error( $code ) ) );
		}
	}

	/**
	 * List columns.
	 *
	 * @param array<string,string> $columns Columns.
	 * @return array<string,string>
	 */
	public function columns( array $columns ): array {
		return array(
			'cb'                => $columns['cb'] ?? '',
			'title'             => __( 'Dashboard', 'feedmarquee' ),
			'pulsecast_layout'  => __( 'Layout', 'feedmarquee' ),
			'pulsecast_feeds'   => __( 'Feeds', 'feedmarquee' ),
			'pulsecast_health'  => __( 'Feed health', 'feedmarquee' ),
			'pulsecast_display' => __( 'Display', 'feedmarquee' ),
			'date'              => $columns['date'] ?? __( 'Date', 'feedmarquee' ),
		);
	}

	/**
	 * Column content.
	 *
	 * @param string $column  Column key.
	 * @param int    $post_id Post ID.
	 */
	public function column( string $column, int $post_id ): void {
		$dashboard = $this->dashboards->find( $post_id );

		if ( null === $dashboard ) {
			return;
		}

		switch ( $column ) {
			case 'pulsecast_layout':
				echo esc_html( self::layouts()[ $dashboard->settings['layout'] ] ?? '' );
				break;
			case 'pulsecast_feeds':
				echo esc_html( (string) count( $dashboard->feeds ) );
				break;
			case 'pulsecast_health':
				echo esc_html( $this->summary( $dashboard ) );
				break;
			case 'pulsecast_display':
				if ( $dashboard->enabled ) {
					echo '<a href="' . esc_url( Display_Route::url( $dashboard->key ) ) . '" target="_blank" rel="noopener">' . esc_html__( 'Open', 'feedmarquee' ) . '</a>';
				} else {
					echo '<span class="description">' . esc_html__( 'Not public', 'feedmarquee' ) . '</span>';
				}
				break;
		}
	}

	/**
	 * Row actions: no Quick Edit (there is no slug to edit), and an Open link when published.
	 *
	 * @param array<string,string> $actions Actions.
	 * @param \WP_Post             $post    Post.
	 * @return array<string,string>
	 */
	public function row_actions( array $actions, \WP_Post $post ): array {
		if ( Dashboard_Post_Type::NAME !== $post->post_type ) {
			return $actions;
		}

		unset( $actions['inline hide-if-no-js'] );

		$dashboard = $this->dashboards->find( $post->ID );

		if ( null !== $dashboard && $dashboard->enabled ) {
			$actions['pulsecast_open'] = '<a href="' . esc_url( Display_Route::url( $dashboard->key ) ) . '" target="_blank" rel="noopener">' . esc_html__( 'Open', 'feedmarquee' ) . '</a>';
		}

		return $actions;
	}

	/**
	 * Removes bulk edit, which would expose fields that do not apply.
	 *
	 * @param array<string,string> $actions Bulk actions.
	 * @return array<string,string>
	 */
	public function bulk_actions( array $actions ): array {
		unset( $actions['edit'] );

		return $actions;
	}

	/**
	 * One table row of the feeds box.
	 *
	 * @param int|string $index  Row index, or the template placeholder.
	 * @param string     $url    Feed URL.
	 * @param string     $label  Label.
	 * @param string     $color  Colour (`#rrggbb`) or an empty string for automatic.
	 * @param string     $health Pre-escaped health markup.
	 */
	private function render_row( $index, string $url, string $label, string $color, string $health ): void {
		echo '<tr class="pulsecast-feed-row"><td>'
			. '<input type="url" class="widefat" name="pulsecast_feeds[' . esc_attr( (string) $index ) . '][url]" value="' . esc_attr( $url ) . '" placeholder="https://example.com/feed.xml" aria-label="' . esc_attr__( 'Feed address', 'feedmarquee' ) . '"></td>'
			. '<td><input type="text" class="widefat" maxlength="60" name="pulsecast_feeds[' . esc_attr( (string) $index ) . '][label]" value="' . esc_attr( $label ) . '" aria-label="' . esc_attr__( 'Label', 'feedmarquee' ) . '"></td>'
			. '<td><input type="text" class="pulsecast-color" name="pulsecast_feeds[' . esc_attr( (string) $index ) . '][color]" value="' . esc_attr( $color ) . '" maxlength="7" aria-label="' . esc_attr__( 'Color', 'feedmarquee' ) . '"></td>'
			. '<td class="pulsecast-health">' . $health . '</td>' // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Built by health(), which escapes.
			. '<td><button type="button" class="button-link button-link-delete pulsecast-remove" aria-label="' . esc_attr__( 'Remove this feed', 'feedmarquee' ) . '">' . esc_html__( 'Remove', 'feedmarquee' ) . '</button></td></tr>';
	}

	/**
	 * Escaped health markup for a saved feed.
	 *
	 * @param string $url      Feed URL.
	 * @param int    $interval Refresh interval in seconds.
	 * @param int    $now      Current Unix time.
	 * @param bool   $enabled  Whether the dashboard is published.
	 * @param int    $age      Seconds since the dashboard was last saved.
	 */
	private function health( string $url, int $interval, int $now, bool $enabled, int $age ): string {
		$entry  = $this->cache->get( $url );
		$status = Refresh_Policy::status( $entry, $interval, $now );
		$label  = Messages::status_label( $status );
		$hint   = '';

		if ( Refresh_Policy::STATUS_PENDING === $status ) {
			if ( ! $enabled ) {
				$hint = __( 'Feeds load when you publish.', 'feedmarquee' );
			} elseif ( (bool) apply_filters( 'pulsecast_scheduled_tasks_disabled', defined( 'DISABLE_WP_CRON' ) && DISABLE_WP_CRON ) ) {
				$hint = __( 'Scheduled tasks are turned off on this site. Click Refresh feeds now.', 'feedmarquee' );
			} elseif ( $age < self::LOADING_WINDOW ) {
				$status = 'loading';
				$label  = __( 'Loading…', 'feedmarquee' );
				$hint   = __( 'Fetching this feed now. This usually takes under a minute.', 'feedmarquee' );
			} else {
				$hint = __( 'This is taking longer than expected. Click Refresh feeds now.', 'feedmarquee' );
			}
		}

		$html = '<span class="pulsecast-status pulsecast-status--' . esc_attr( $status ) . '">' . esc_html( $label ) . '</span>';

		if ( '' !== $hint ) {
			$html .= '<br><span class="description">' . esc_html( $hint ) . '</span>';
		}

		if ( null !== $entry && $entry['fetched_at'] > 0 ) {
			/* translators: 1: how long ago, 2: date and time. */
			$when  = sprintf( __( 'Last refreshed %1$s ago (%2$s)', 'feedmarquee' ), human_time_diff( $entry['fetched_at'], $now ), wp_date( get_option( 'date_format' ) . ' ' . get_option( 'time_format' ), $entry['fetched_at'] ) );
			$html .= '<br><span class="description">' . esc_html( $when ) . '</span>';
		}

		if ( null !== $entry && '' !== $entry['error'] ) {
			$html .= '<br><span class="pulsecast-error">' . esc_html( Messages::feed_error( $entry['error'] ) ) . '</span>';
		}

		return $html;
	}

	/**
	 * One-line health summary for the list.
	 *
	 * @param Dashboard $dashboard Dashboard.
	 */
	private function summary( Dashboard $dashboard ): string {
		if ( array() === $dashboard->feeds ) {
			return __( 'No feeds', 'feedmarquee' );
		}

		$interval = (int) $dashboard->settings['refresh_interval'] * 60;
		$counts   = array();

		foreach ( $dashboard->feeds as $feed ) {
			$status            = Refresh_Policy::status( $this->cache->get( $feed['url'] ), $interval, time() );
			$counts[ $status ] = ( $counts[ $status ] ?? 0 ) + 1;
		}

		if ( isset( $counts[ Refresh_Policy::STATUS_FAILING ] ) ) {
			/* translators: %d: number of feeds with a problem. */
			return sprintf( _n( '%d feed has a problem', '%d feeds have a problem', $counts[ Refresh_Policy::STATUS_FAILING ], 'feedmarquee' ), $counts[ Refresh_Policy::STATUS_FAILING ] );
		}

		if ( isset( $counts[ Refresh_Policy::STATUS_STALE ] ) ) {
			return __( 'Out of date', 'feedmarquee' );
		}

		return isset( $counts[ Refresh_Policy::STATUS_PENDING ] ) ? __( 'Not fetched yet', 'feedmarquee' ) : __( 'All working', 'feedmarquee' );
	}
}