wordpress-theme-aksrt/src/AKSRT/Widgets/WidgetReviews.php

<?php
/**
 * Testimonials / virtual reviews carousel (zibll zib_widget_reviews lite).
 *
 * @package AKSRT
 */

namespace AKSRT\Widgets;

defined('ABSPATH') || exit;

class WidgetReviews extends \WP_Widget {

	public function __construct() {
		parent::__construct(
			'aksrt_reviews',
			esc_html__('AKSRT 用户评价', 'aksrt'),
			[
				'description' => esc_html__('虚拟用户评价卡片横向滚动。', 'aksrt'),
				'classname'   => 'widget_aksrt_reviews',
			]
		);
	}

	public function widget($args, $instance): void {
		$reviews = $this->normalize($instance['reviews'] ?? []);
		if (!$reviews) {
			return;
		}
		$pc = max(1, min(6, (float) ($instance['desktop_per_view'] ?? 3)));
		$m  = max(1, min(3, (float) ($instance['mobile_per_view'] ?? 1.2)));

		echo $args['before_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
		$title = apply_filters('widget_title', (string) ($instance['title'] ?? ''), $instance, $this->id_base);
		if ($title !== '') {
			echo $args['before_title'] . esc_html($title) . $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
		}

		$style = sprintf('--aksrt-rev-pc:%s;--aksrt-rev-m:%s;', rtrim(rtrim(number_format($pc, 2, '.', ''), '0'), '.'), rtrim(rtrim(number_format($m, 2, '.', ''), '0'), '.'));
		echo '<div class="aksrt-reviews" style="' . esc_attr($style) . '">';
		echo '<div class="aksrt-reviews__track">';
		foreach ($reviews as $r) {
			echo '<div class="aksrt-reviews__slide"><div class="aksrt-reviews__card">';
			echo '<div class="aksrt-reviews__head">';
			if ($r['avatar'] !== '') {
				echo '<img class="aksrt-reviews__avatar" src="' . esc_url($r['avatar']) . '" alt="" loading="lazy" width="44" height="44" />';
			} else {
				echo '<span class="aksrt-reviews__avatar is-placeholder"><i class="fa fa-user" aria-hidden="true"></i></span>';
			}
			echo '<div class="aksrt-reviews__meta">';
			if ($r['name'] !== '') {
				$name_html = esc_html($r['name']);
				if ($r['url'] !== '') {
					$name_html = '<a href="' . esc_url($r['url']) . '" target="_blank" rel="noopener noreferrer">' . $name_html . '</a>';
				}
				echo '<div class="aksrt-reviews__name">' . $name_html . '</div>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
			}
			if ($r['role'] !== '') {
				echo '<div class="aksrt-reviews__role">' . esc_html($r['role']) . '</div>';
			}
			echo '</div></div>';
			echo '<div class="aksrt-reviews__stars" aria-label="' . esc_attr(sprintf(__('%d 星', 'aksrt'), $r['rating'])) . '">';
			for ($i = 1; $i <= 5; $i++) {
				echo '<i class="fa fa-star' . ($i <= $r['rating'] ? ' is-on' : ' is-off') . '" aria-hidden="true"></i>';
			}
			echo '</div>';
			if ($r['content'] !== '') {
				echo '<p class="aksrt-reviews__content">' . nl2br(esc_html($r['content'])) . '</p>';
			}
			echo '<i class="fa fa-quote-right aksrt-reviews__quote" aria-hidden="true"></i>';
			echo '</div></div>';
		}
		echo '</div></div>';

		echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
	}

	/**
	 * @param mixed $raw
	 * @return array<int, array{name:string,role:string,avatar:string,content:string,rating:int,url:string}>
	 */
	private function normalize($raw): array {
		if (is_string($raw)) {
			$decoded = json_decode($raw, true);
			$raw = is_array($decoded) ? $decoded : [];
		}
		if (!is_array($raw)) {
			return [];
		}
		$out = [];
		foreach ($raw as $row) {
			if (!is_array($row)) {
				continue;
			}
			$name = sanitize_text_field((string) ($row['name'] ?? ''));
			$content = sanitize_textarea_field((string) ($row['content'] ?? ''));
			if ($name === '' && $content === '') {
				continue;
			}
			$out[] = [
				'name'    => $name,
				'role'    => sanitize_text_field((string) ($row['role'] ?? '')),
				'avatar'  => esc_url_raw(trim((string) ($row['avatar'] ?? ''))),
				'content' => $content,
				'rating'  => max(0, min(5, (int) ($row['rating'] ?? 5))),
				'url'     => esc_url_raw(trim((string) ($row['url'] ?? ''))),
			];
			if (count($out) >= 20) {
				break;
			}
		}
		return $out;
	}

	public function form($instance): void {
		$json = is_string($instance['reviews'] ?? null)
			? (string) $instance['reviews']
			: wp_json_encode($this->normalize($instance['reviews'] ?? []), JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
		?>
		<p>
			<label><?php esc_html_e('标题', 'aksrt'); ?>
				<input class="widefat" type="text" name="<?php echo esc_attr($this->get_field_name('title')); ?>" value="<?php echo esc_attr((string) ($instance['title'] ?? '')); ?>">
			</label>
		</p>
		<p>
			<label><?php esc_html_e('评价 JSON', 'aksrt'); ?>
				<textarea class="widefat" rows="8" name="<?php echo esc_attr($this->get_field_name('reviews')); ?>" placeholder='[{"name":"张三","role":"站长","rating":5,"content":"很好用","avatar":""}]'><?php echo esc_textarea((string) $json); ?></textarea>
			</label>
		</p>
		<p>
			<label><?php esc_html_e('PC 每屏', 'aksrt'); ?>
				<input class="tiny-text" type="number" min="1" max="6" step="0.1" name="<?php echo esc_attr($this->get_field_name('desktop_per_view')); ?>" value="<?php echo esc_attr((string) ($instance['desktop_per_view'] ?? '3')); ?>">
			</label>
			<label><?php esc_html_e('移动每屏', 'aksrt'); ?>
				<input class="tiny-text" type="number" min="1" max="3" step="0.1" name="<?php echo esc_attr($this->get_field_name('mobile_per_view')); ?>" value="<?php echo esc_attr((string) ($instance['mobile_per_view'] ?? '1.2')); ?>">
			</label>
		</p>
		<?php
	}

	public function update($new_instance, $old_instance): array {
		return [
			'title'            => sanitize_text_field((string) ($new_instance['title'] ?? '')),
			'reviews'          => $this->normalize($new_instance['reviews'] ?? []),
			'desktop_per_view' => max(1, min(6, (float) ($new_instance['desktop_per_view'] ?? 3))),
			'mobile_per_view'  => max(1, min(3, (float) ($new_instance['mobile_per_view'] ?? 1.2))),
		];
	}
}