esc_html__('横向图标 + 标题/描述的导航卡片。', 'aksrt'), 'classname' => 'widget_aksrt_icon_cover_cards', ] ); } /** * @param array $args * @param array $instance */ public function widget($args, $instance): void { $cards = $this->normalize($instance['cards'] ?? []); if (!$cards) { 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 : ''; echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped } return; } $pc_row = max(1, min(4, (int) ($instance['pc_row'] ?? 2))); $m_row = max(1, min(2, (int) ($instance['m_row'] ?? 1))); $icon_size = max(16, min(48, (int) ($instance['icon_size'] ?? 25))); $radius = !empty($instance['icon_radius4']); $go_link = !empty($instance['go_link']); $show_bg = !empty($instance['show_widget_bg']); 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 } $is_row = count($cards) > 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 : ''); echo $show_bg ? '

' : '

'; if ($is_row) { echo '

'; } foreach ($cards as $card) { $url = (string) ($card['url'] ?? ''); if ($url !== '' && $go_link && function_exists('aksrt_go_link')) { $url = aksrt_go_link($url, true); } $card_args = [ 'class' => $show_bg ? 'padding-10' : 'zib-widget mb10', 'icon' => (string) ($card['icon'] ?? ''), 'icon_image' => (string) ($card['icon_image'] ?? ''), 'icon_size' => $icon_size, 'icon_class' => $radius ? 'radius4' : '', 'icon_color' => (string) ($card['icon_color'] ?? ''), 'title' => (string) ($card['title'] ?? ''), 'desc' => (string) ($card['desc'] ?? ''), 'link' => [ 'url' => $url, 'target' => (string) ($card['target'] ?? ''), ], ]; if ($is_row) { echo '

'; } if (function_exists('aksrt_icon_cover_card')) { echo aksrt_icon_cover_card($card_args); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped } if ($is_row) { echo '

'; } } if ($is_row) { echo '

'; } echo '

'; echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped } /** * @param mixed $raw * @return array> */ 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; } $title = sanitize_text_field((string) ($row['title'] ?? '')); $icon = sanitize_text_field((string) ($row['icon'] ?? '')); $icon_image = esc_url_raw(trim((string) ($row['icon_image'] ?? $row['customize_icon'] ?? ''))); if ($title === '' && $icon === '' && $icon_image === '') { continue; } $url = ''; $target = ''; if (is_array($row['link'] ?? null)) { $url = esc_url_raw(trim((string) ($row['link']['url'] ?? ''))); $target = sanitize_text_field((string) ($row['link']['target'] ?? '')); } else { $url = esc_url_raw(trim((string) ($row['url'] ?? $row['link'] ?? ''))); $target = sanitize_text_field((string) ($row['target'] ?? '_blank')); } $out[] = [ 'title' => $title, 'desc' => sanitize_text_field((string) ($row['desc'] ?? '')), 'icon' => $icon, 'icon_image' => $icon_image, 'icon_color' => sanitize_html_class((string) ($row['icon_color'] ?? '')), 'url' => $url, 'target' => $target, ]; if (count($out) >= 16) { break; } } return $out; } /** * @param array $instance */ public function form($instance): void { $json = is_string($instance['cards'] ?? null) ? (string) $instance['cards'] : wp_json_encode($this->normalize($instance['cards'] ?? []), JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); ?>

<?php echo esc_textarea((string) $json); ?>

>
>
>

render_common_form_section($instance); } /** * @param array $new_instance * @param array $old_instance * @return array */ public function update($new_instance, $old_instance): array { $business = [ 'title' => sanitize_text_field((string) ($new_instance['title'] ?? '')), 'cards' => $this->normalize($new_instance['cards'] ?? []), 'pc_row' => max(1, min(4, (int) ($new_instance['pc_row'] ?? 2))), 'm_row' => max(1, min(2, (int) ($new_instance['m_row'] ?? 1))), 'icon_size' => max(16, min(48, (int) ($new_instance['icon_size'] ?? 25))), 'icon_radius4' => !empty($new_instance['icon_radius4']) ? 1 : 0, 'show_widget_bg' => !empty($new_instance['show_widget_bg']) ? 1 : 0, 'go_link' => !empty($new_instance['go_link']) ? 1 : 0, ]; return $this->update_common_fields($new_instance, $old_instance, $business); } }