feat(widgets): partners/iframe/combo/text/user + forum plate widgets

Close major zibll widget-more and bbs plate gaps: partners marquee, super embed, combo info cards, text title, user lists, and plate list/info/moderator sidebars with batch3 CSS registration.
2026-07-19 00:15:32 +08:00
1 parent 6a202f3eab
commit 81bf3193a4
@@ -0,0 +1,113 @@
+<?php
+/**
+ * Super embed / iframe widget (zibll zib_widget_ui_iframe).
+ *
+ * @package AKSRT
+ */
+
+namespace AKSRT\Widgets;
+
+defined('ABSPATH') || exit;
+
+class WidgetIframe extends \WP_Widget {
+
+	public function __construct() {
+		parent::__construct(
+			'aksrt_iframe',
+			esc_html__('AKSRT 超级嵌入', 'aksrt'),
+			[
+				'description' => esc_html__('嵌入在线视频/音乐播放器或任意 iframe 内容。', 'aksrt'),
+				'classname'   => 'widget_aksrt_iframe',
+			]
+		);
+	}
+
+	public function widget($args, $instance): void {
+		$raw = trim((string) ($instance['url'] ?? ''));
+		if ($raw === '') {
+			return;
+		}
+		$aspect = max(20, min(300, (int) ($instance['aspect'] ?? 55)));
+		$allow_fs = !empty($instance['allowfullscreen']);
+
+		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
+		}
+
+		$iframe_html = '';
+		if (stripos($raw, '<iframe') !== false && stripos($raw, '</iframe>') !== false) {
+			$iframe_html = wp_kses(
+				$raw,
+				[
+					'iframe' => [
+						'src'             => true,
+						'width'           => true,
+						'height'          => true,
+						'frameborder'     => true,
+						'allow'           => true,
+						'allowfullscreen' => true,
+						'loading'         => true,
+						'class'           => true,
+						'style'           => true,
+						'referrerpolicy'  => true,
+						'title'           => true,
+						'sandbox'         => true,
+						'data-src'        => true,
+					],
+				]
+			);
+		} else {
+			$url = esc_url($raw);
+			if ($url === '') {
+				echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+				return;
+			}
+			$fs = $allow_fs ? ' allowfullscreen="allowfullscreen"' : '';
+			$iframe_html = '<iframe class="aksrt-iframe-el" src="' . $url . '" loading="lazy" frameborder="0"' . $fs . '></iframe>';
+		}
+
+		echo '<div class="aksrt-iframe-embed">';
+		echo '<div class="aksrt-iframe-ratio" style="padding-bottom:' . esc_attr((string) $aspect) . '%">';
+		echo $iframe_html; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+		echo '</div></div>';
+
+		echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+	}
+
+	public function form($instance): void {
+		$title = (string) ($instance['title'] ?? '');
+		$url = (string) ($instance['url'] ?? '');
+		$aspect = (int) ($instance['aspect'] ?? 55);
+		?>
+		<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($title); ?>">
+			</label>
+		</p>
+		<p>
+			<label><?php esc_html_e('嵌入地址或 iframe 代码', 'aksrt'); ?>
+				<textarea class="widefat" rows="4" name="<?php echo esc_attr($this->get_field_name('url')); ?>"><?php echo esc_textarea($url); ?></textarea>
+			</label>
+		</p>
+		<p>
+			<label><?php esc_html_e('高度占比 %', 'aksrt'); ?>
+				<input class="tiny-text" type="number" min="20" max="300" step="5" name="<?php echo esc_attr($this->get_field_name('aspect')); ?>" value="<?php echo esc_attr((string) $aspect); ?>">
+			</label>
+		</p>
+		<p>
+			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('allowfullscreen')); ?>" value="1" <?php checked(!empty($instance['allowfullscreen'])); ?>> <?php esc_html_e('允许全屏', 'aksrt'); ?></label>
+		</p>
+		<?php
+	}
+
+	public function update($new_instance, $old_instance): array {
+		return [
+			'title'           => sanitize_text_field((string) ($new_instance['title'] ?? '')),
+			'url'             => trim((string) ($new_instance['url'] ?? '')),
+			'aspect'          => max(20, min(300, (int) ($new_instance['aspect'] ?? 55))),
+			'allowfullscreen' => !empty($new_instance['allowfullscreen']) ? 1 : 0,
+		];
+	}
+}