esc_html__('显示一组自定义按钮,支持外链跳转与色系。', 'aksrt'), 'classname' => 'widget_aksrt_buttons', ]); } /** * @param array $args * @param array $instance */ public function widget($args, $instance): void { $buttons = isset($instance['buttons']) && is_array($instance['buttons']) ? $instance['buttons'] : []; // Also accept zibll-style `items`. if (!$buttons && isset($instance['items']) && is_array($instance['items'])) { $buttons = $instance['items']; } if (!$buttons) { 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 : '

' . esc_html__('请添加至少一个按钮', 'aksrt') . '

'; echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped } return; } $align = sanitize_key((string) ($instance['align'] ?? 'center')); if (!in_array($align, ['left', 'center', 'right'], true)) { $align = 'center'; } $radius = !empty($instance['radius']); $hollow = !empty($instance['hollow']); $go_link = !empty($instance['go_link']); $pc_gap = max(0, min(40, (int) ($instance['pc_gap'] ?? $instance['gap'] ?? 12))); $m_gap = max(0, min(30, (int) ($instance['m_gap'] ?? 6))); $pc_pad = sanitize_key((string) ($instance['pc_padding'] ?? 'large')); $m_pad = sanitize_key((string) ($instance['m_padding'] ?? 'medium')); if (!in_array($pc_pad, ['small', 'medium', 'large'], true)) { $pc_pad = 'large'; } if (!in_array($m_pad, ['small', 'medium', 'large'], true)) { $m_pad = 'medium'; } $pc_width = max(0, min(400, (int) ($instance['pc_width'] ?? 0))); $m_width = max(0, min(400, (int) ($instance['m_width'] ?? 0))); $but_class = 'but'; if ($radius) { $but_class .= ' radius'; } if ($hollow) { $but_class .= ' hollow'; } $buts = ''; foreach ($buttons as $btn) { if (!is_array($btn)) { continue; } $text = sanitize_text_field((string) ($btn['text'] ?? '')); if ($text === '') { continue; } $url = ''; $target = ''; if (is_array($btn['link'] ?? null)) { $url = esc_url_raw(trim((string) ($btn['link']['url'] ?? ''))); $target = sanitize_text_field((string) ($btn['link']['target'] ?? '')); } else { $url = esc_url_raw(trim((string) ($btn['url'] ?? ''))); $target = !empty($btn['new_window']) || !empty($btn['target']) ? '_blank' : ''; } if ($url !== '' && $go_link && function_exists('aksrt_go_link')) { $url = aksrt_go_link($url, true); } if ($url === '') { $url = 'javascript:void(0)'; } $color = sanitize_html_class((string) ($btn['color'] ?? $btn['style'] ?? '')); // Map legacy style keys to color classes. $style_map = [ 'primary' => 'c-blue', 'secondary' => 'c-blue-2', 'outline' => '', 'text' => '', 'pink' => 'c-red', 'blue' => 'c-blue', 'green' => 'c-green', 'yellow' => 'c-yellow', 'purple' => 'c-purple', ]; if (isset($style_map[$color])) { $color = $style_map[$color]; } $item_class = trim($but_class . ' ' . $color); $icon_left = sanitize_text_field((string) ($btn['icon'] ?? $btn['icon_left'] ?? '')); $icon_right = sanitize_text_field((string) ($btn['icon_right'] ?? '')); $left_html = $icon_left !== '' ? ' ' : ''; $right_html = $icon_right !== '' ? ' ' : ''; $tgt = $target !== '' && strpos($url, 'javascript:') !== 0 ? ' target="' . esc_attr($target) . '" rel="noopener noreferrer"' : ''; $buts .= '
' . $left_html . esc_html($text) . $right_html . ''; $buts .= '
'; } if ($buts === '') { return; } 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_attr = ''; if ($pc_width > 0) { $style_attr .= '--pc-width:' . $pc_width . 'px;'; } if ($m_width > 0) { $style_attr .= '--m-width:' . $m_width . 'px;'; } $style_attr .= '--pc-gap:' . $pc_gap . 'px;--m-gap:' . $m_gap . 'px;--btn-gap:' . $pc_gap . 'px;'; echo '
'; echo '
'; echo $buts; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped echo '
'; echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped } /** * @param array $instance */ public function form($instance): void { $buttons = isset($instance['buttons']) && is_array($instance['buttons']) ? $instance['buttons'] : []; while (count($buttons) < 4) { $buttons[] = ['text' => '', 'url' => '', 'style' => 'primary', 'icon' => '', 'icon_right' => '', 'new_window' => false]; } ?>

$btn) : ?>
" value="" placeholder=""> " value="" placeholder=""> " value="" placeholder=""> " value="" placeholder="">
$new_instance * @param array $old_instance * @return array */ public function update($new_instance, $old_instance): array { $buttons = []; if (isset($new_instance['buttons']) && is_array($new_instance['buttons'])) { foreach ($new_instance['buttons'] as $btn) { if (!is_array($btn)) { continue; } $text = sanitize_text_field((string) ($btn['text'] ?? '')); if ($text === '') { continue; } $buttons[] = [ 'text' => $text, 'url' => esc_url_raw(trim((string) ($btn['url'] ?? ''))), 'style' => sanitize_key((string) ($btn['style'] ?? 'primary')), 'icon' => sanitize_text_field((string) ($btn['icon'] ?? '')), 'icon_right' => sanitize_text_field((string) ($btn['icon_right'] ?? '')), 'new_window' => !empty($btn['new_window']), ]; if (count($buttons) >= 8) { break; } } } $business = [ 'title' => sanitize_text_field((string) ($new_instance['title'] ?? '')), 'align' => in_array(($new_instance['align'] ?? ''), ['left', 'center', 'right'], true) ? $new_instance['align'] : 'center', 'radius' => !empty($new_instance['radius']) ? 1 : 0, 'hollow' => !empty($new_instance['hollow']) ? 1 : 0, 'go_link' => !empty($new_instance['go_link']) ? 1 : 0, 'gap' => max(4, min(30, (int) ($new_instance['gap'] ?? 12))), 'pc_gap' => max(0, min(60, (int) ($new_instance['pc_gap'] ?? $new_instance['gap'] ?? 12))), 'm_gap' => max(0, min(60, (int) ($new_instance['m_gap'] ?? 6))), 'pc_padding' => in_array(($new_instance['pc_padding'] ?? 'large'), ['small', 'medium', 'large'], true) ? $new_instance['pc_padding'] : 'large', 'm_padding' => in_array(($new_instance['m_padding'] ?? 'medium'), ['small', 'medium', 'large'], true) ? $new_instance['m_padding'] : 'medium', 'pc_width' => max(0, min(500, (int) ($new_instance['pc_width'] ?? 0))), 'm_width' => max(0, min(500, (int) ($new_instance['m_width'] ?? 0))), 'buttons' => $buttons, ]; return $business; } }