kate522
c8f80806d8
Admin null shells for feature/highlights/cover/icon/combo/tilt/buttons and video player; feature intro lazy images + deferred inactive videos.
226 lines
8.7 KiB
PHP
226 lines
8.7 KiB
PHP
<?php
|
|
/**
|
|
* Graphic cover cards (zibll zib_widget_ui_graphic_cover → aksrt_graphic_card).
|
|
*
|
|
* @package AKSRT
|
|
*/
|
|
|
|
namespace AKSRT\Widgets;
|
|
|
|
defined('ABSPATH') || exit;
|
|
|
|
class WidgetCoverCards extends \WP_Widget {
|
|
|
|
public function __construct() {
|
|
parent::__construct(
|
|
'aksrt_cover_cards',
|
|
__('图文封面卡片', 'aksrt'),
|
|
['description' => __('图片/视频封面 + 文字叠加的图文卡片（共享 graphic_card）。', 'aksrt')]
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param array<string,mixed> $args
|
|
* @param array<string,mixed> $instance
|
|
*/
|
|
public function widget($args, $instance): void {
|
|
$title = !empty($instance['title']) ? (string) $instance['title'] : '';
|
|
$items = $this->normalize($instance['items'] ?? []);
|
|
if (!$items) {
|
|
if (current_user_can('manage_options')) {
|
|
echo $args['before_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
|
echo function_exists('aksrt_get_widget_null')
|
|
? aksrt_get_widget_null(__('请添加至少一张封面卡片', 'aksrt')) // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
|
: '<p class="widget-empty">' . esc_html__('请添加至少一张封面卡片', 'aksrt') . '</p>';
|
|
echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
|
}
|
|
return;
|
|
}
|
|
|
|
$pc_row = max(1, min(6, (int) ($instance['pc_row'] ?? $instance['columns'] ?? 2)));
|
|
$m_row = max(1, min(3, (int) ($instance['m_row'] ?? 1)));
|
|
$height_scale = max(30, min(120, (int) ($instance['height_scale'] ?? 70)));
|
|
$mask_opacity = max(0, min(80, (int) ($instance['mask_opacity'] ?? 20)));
|
|
$font_size_pc = max(12, min(32, (int) ($instance['font_size_pc'] ?? 18)));
|
|
$font_size_m = max(11, min(24, (int) ($instance['font_size_m'] ?? 14)));
|
|
$font_bold = !empty($instance['font_bold']);
|
|
$font_color = sanitize_hex_color((string) ($instance['font_color'] ?? '')) ?: '';
|
|
|
|
echo $args['before_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
|
|
|
if ($title !== '') {
|
|
echo $args['before_title'] . esc_html($title) . $args['after_title']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
|
}
|
|
|
|
$is_row = count($items) > 1;
|
|
$pc_span = max(1, (int) floor(12 / $pc_row));
|
|
$m_span = max(1, (int) floor(12 / $m_row));
|
|
$row_class = 'col-sm-' . $pc_span . ($m_row > 1 ? ' col-xs-' . $m_span : '');
|
|
|
|
$style = '';
|
|
if ($font_size_pc !== 14) {
|
|
$style .= '--font-size:' . $font_size_pc . 'px;';
|
|
}
|
|
if ($font_size_m !== 14) {
|
|
$style .= '--font-size-sm:' . $font_size_m . 'px;';
|
|
}
|
|
if ($font_bold) {
|
|
$style .= '--font-weight:bold;--font-weight-sm:bold;';
|
|
}
|
|
if ($font_color !== '') {
|
|
$style .= '--color:' . $font_color . ';--color-sm:' . $font_color . ';';
|
|
}
|
|
|
|
echo '<div class="widget-graphic-cover aksrt-cover-cards' . ($is_row ? ' mb10' : ' mb20') . '"' . ($style !== '' ? ' style="' . esc_attr($style) . '"' : '') . '>';
|
|
if ($is_row) {
|
|
echo '<div class="row gutters-5">';
|
|
}
|
|
|
|
foreach ($items as $item) {
|
|
$hide = sanitize_key((string) ($item['hide'] ?? ''));
|
|
if ($hide === 'pc' || $hide === 'm') {
|
|
$is_mobile = function_exists('wp_is_mobile') ? wp_is_mobile() : false;
|
|
if ((!$is_mobile && $hide === 'pc') || ($is_mobile && $hide === 'm')) {
|
|
continue;
|
|
}
|
|
}
|
|
$card_title = (string) ($item['title'] ?? '');
|
|
$more = $card_title !== ''
|
|
? '<div class="abs-center text-center graphic-text this-font">' . esc_html($card_title) . '</div>'
|
|
: '';
|
|
|
|
$card = [
|
|
'class' => 'noshadow mb10',
|
|
'img' => (string) ($item['image'] ?? ''),
|
|
'video' => (string) ($item['video'] ?? ''),
|
|
'alt' => wp_strip_all_tags($card_title),
|
|
'link' => [
|
|
'url' => (string) ($item['link'] ?? ''),
|
|
'target' => (string) ($item['target'] ?? ''),
|
|
],
|
|
'lazy' => true,
|
|
'more' => $more,
|
|
'height_scale' => !empty($item['height']) && is_numeric($item['height'])
|
|
? (int) $item['height']
|
|
: $height_scale,
|
|
'mask_opacity' => isset($item['mask']) ? (int) $item['mask'] : $mask_opacity,
|
|
];
|
|
|
|
if ($is_row) {
|
|
echo '<div class="' . esc_attr($row_class) . '">';
|
|
}
|
|
if (function_exists('aksrt_graphic_card')) {
|
|
echo aksrt_graphic_card($card); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
|
}
|
|
if ($is_row) {
|
|
echo '</div>';
|
|
}
|
|
}
|
|
|
|
if ($is_row) {
|
|
echo '</div>';
|
|
}
|
|
echo '</div>';
|
|
|
|
echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
|
}
|
|
|
|
/**
|
|
* @param mixed $raw
|
|
* @return array<int, array<string,mixed>>
|
|
*/
|
|
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;
|
|
}
|
|
$image = esc_url_raw(trim((string) ($row['image'] ?? '')));
|
|
$video = esc_url_raw(trim((string) ($row['video'] ?? '')));
|
|
if ($image === '' && $video === '') {
|
|
continue;
|
|
}
|
|
$out[] = [
|
|
'title' => sanitize_text_field((string) ($row['title'] ?? '')),
|
|
'desc' => sanitize_text_field((string) ($row['desc'] ?? '')),
|
|
'image' => $image,
|
|
'video' => $video,
|
|
'link' => esc_url_raw(trim((string) ($row['link'] ?? ''))),
|
|
'target' => sanitize_text_field((string) ($row['target'] ?? '')),
|
|
'hide' => sanitize_key((string) ($row['hide'] ?? '')),
|
|
'height' => isset($row['height']) ? (int) $row['height'] : 0,
|
|
'mask' => isset($row['mask']) ? (int) $row['mask'] : null,
|
|
];
|
|
if (count($out) >= 12) {
|
|
break;
|
|
}
|
|
}
|
|
return $out;
|
|
}
|
|
|
|
/**
|
|
* @param array<string,mixed> $instance
|
|
*/
|
|
public function form($instance): void {
|
|
$items = $this->normalize($instance['items'] ?? []);
|
|
$json = wp_json_encode($items, 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('PC 列', 'aksrt'); ?>
|
|
<input class="tiny-text" type="number" min="1" max="6" name="<?php echo esc_attr($this->get_field_name('pc_row')); ?>" value="<?php echo esc_attr((string) ((int) ($instance['pc_row'] ?? $instance['columns'] ?? 2))); ?>">
|
|
</label>
|
|
<label><?php esc_html_e('移动列', 'aksrt'); ?>
|
|
<input class="tiny-text" type="number" min="1" max="3" name="<?php echo esc_attr($this->get_field_name('m_row')); ?>" value="<?php echo esc_attr((string) ((int) ($instance['m_row'] ?? 1))); ?>">
|
|
</label>
|
|
</p>
|
|
<p>
|
|
<label><?php esc_html_e('高度占比 %', 'aksrt'); ?>
|
|
<input class="tiny-text" type="number" min="30" max="120" name="<?php echo esc_attr($this->get_field_name('height_scale')); ?>" value="<?php echo esc_attr((string) ((int) ($instance['height_scale'] ?? 70))); ?>">
|
|
</label>
|
|
<label><?php esc_html_e('遮罩 0-80', 'aksrt'); ?>
|
|
<input class="tiny-text" type="number" min="0" max="80" name="<?php echo esc_attr($this->get_field_name('mask_opacity')); ?>" value="<?php echo esc_attr((string) ((int) ($instance['mask_opacity'] ?? 20))); ?>">
|
|
</label>
|
|
</p>
|
|
<p>
|
|
<label><?php esc_html_e('卡片 JSON', 'aksrt'); ?>
|
|
<textarea class="widefat" rows="6" name="<?php echo esc_attr($this->get_field_name('items')); ?>" placeholder='[{"image":"https://...","title":"标题","link":"https://..."}]'><?php echo esc_textarea((string) $json); ?></textarea>
|
|
</label>
|
|
<small><?php esc_html_e('字段: image, video, title, link, target, hide(pc|m), height, mask', 'aksrt'); ?></small>
|
|
</p>
|
|
<?php
|
|
}
|
|
|
|
/**
|
|
* @param array<string,mixed> $new_instance
|
|
* @param array<string,mixed> $old_instance
|
|
* @return array<string,mixed>
|
|
*/
|
|
public function update($new_instance, $old_instance): array {
|
|
return [
|
|
'title' => sanitize_text_field((string) ($new_instance['title'] ?? '')),
|
|
'pc_row' => max(1, min(6, (int) ($new_instance['pc_row'] ?? 2))),
|
|
'm_row' => max(1, min(3, (int) ($new_instance['m_row'] ?? 1))),
|
|
'columns' => max(1, min(6, (int) ($new_instance['pc_row'] ?? $new_instance['columns'] ?? 2))),
|
|
'height_scale' => max(30, min(120, (int) ($new_instance['height_scale'] ?? 70))),
|
|
'mask_opacity' => max(0, min(80, (int) ($new_instance['mask_opacity'] ?? 20))),
|
|
'font_size_pc' => max(12, min(32, (int) ($new_instance['font_size_pc'] ?? 18))),
|
|
'font_size_m' => max(11, min(24, (int) ($new_instance['font_size_m'] ?? 14))),
|
|
'font_bold' => !empty($new_instance['font_bold']) ? 1 : 0,
|
|
'font_color' => sanitize_hex_color((string) ($new_instance['font_color'] ?? '')) ?: '',
|
|
'items' => $this->normalize($new_instance['items'] ?? []),
|
|
];
|
|
}
|
|
}
|