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

<?php
/**
 * Language switcher widget (Polylang / WPML / filter).
 *
 * @package AKSRT
 */

namespace AKSRT\Widgets;

use AKSRT\Widgets\Traits\CommonWidgetFields;

defined('ABSPATH') || exit;

class WidgetLangSwitch extends \WP_Widget {
	use CommonWidgetFields;


	public function __construct() {
		parent::__construct(
			'aksrt_lang_switch',
			__('语言切换器', 'aksrt'),
			[
				'description' => __('在侧栏显示多语言切换按钮。', 'aksrt'),
				'classname'   => 'widget_aksrt_lang_switch',
			]
		);
	}

	/**
	 * @param array<string,mixed> $args
	 * @param array<string,mixed> $instance
	 */
	public function widget($args, $instance): void {
		$title = !empty($instance['title']) ? (string) $instance['title'] : '';
		$style = sanitize_key((string) ($instance['style'] ?? 'dropdown'));
		if (!in_array($style, ['dropdown', 'flags', 'inline'], true)) {
			$style = 'dropdown';
		}
		$show_name = !isset($instance['show_name']) || !empty($instance['show_name']);
		$hide_current = !empty($instance['hide_current']);

		if (!function_exists('aksrt_has_multilingual') || !aksrt_has_multilingual()) {
			if (current_user_can('manage_options')) {
				echo $args['before_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
				echo '<div class="c-red muted-box mb10"><b>' . esc_html__('语言切换：', 'aksrt') . '</b>' .
					esc_html__('未检测到多语言插件（Polylang/WPML）或可用语言不足。', 'aksrt') . '</div>';
				echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
			}
			return;
		}

		// inline style: treat as flags row without dropdown chrome.
		$render_style = $style === 'inline' ? 'flags' : $style;
		$html = function_exists('aksrt_render_language_switcher') ? aksrt_render_language_switcher($render_style) : '';
		if ($html === '') {
			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;
		}

		// Optional modifiers via wrapper classes.
		$wrap = 'aksrt-lang-switch-widget style-' . esc_attr($style);
		if (!$show_name) {
			$wrap .= ' hide-name';
		}
		if ($hide_current) {
			$wrap .= ' hide-current';
		}

		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
		}
		echo '<div class="' . esc_attr($wrap) . '">' . $html . '</div>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
		echo $args['after_widget']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
	}

	/**
	 * @param array<string,mixed> $instance
	 */
	public function form($instance): void {
		$title = !empty($instance['title']) ? (string) $instance['title'] : '';
		$style = !empty($instance['style']) ? (string) $instance['style'] : 'dropdown';
		?>
		<p>
			<label for="<?php echo esc_attr($this->get_field_id('title')); ?>"><?php esc_html_e('标题（可选）:', 'aksrt'); ?></label>
			<input class="widefat" id="<?php echo esc_attr($this->get_field_id('title')); ?>" name="<?php echo esc_attr($this->get_field_name('title')); ?>" type="text" value="<?php echo esc_attr($title); ?>">
		</p>
		<p>
			<label for="<?php echo esc_attr($this->get_field_id('style')); ?>"><?php esc_html_e('样式:', 'aksrt'); ?></label>
			<select class="widefat" id="<?php echo esc_attr($this->get_field_id('style')); ?>" name="<?php echo esc_attr($this->get_field_name('style')); ?>">
				<option value="dropdown" <?php selected($style, 'dropdown'); ?>><?php esc_html_e('下拉菜单', 'aksrt'); ?></option>
				<option value="flags" <?php selected($style, 'flags'); ?>><?php esc_html_e('国旗图标', 'aksrt'); ?></option>
				<option value="inline" <?php selected($style, 'inline'); ?>><?php esc_html_e('横向排列', 'aksrt'); ?></option>
			</select>
		</p>
		<p>
			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('show_name')); ?>" value="1" <?php checked(!isset($instance['show_name']) || !empty($instance['show_name'])); ?>> <?php esc_html_e('显示语言名', 'aksrt'); ?></label><br>
			<label><input type="checkbox" name="<?php echo esc_attr($this->get_field_name('hide_current')); ?>" value="1" <?php checked(!empty($instance['hide_current'])); ?>> <?php esc_html_e('隐藏当前语言', 'aksrt'); ?></label>
		</p>
		<p><small><?php esc_html_e('需要安装 Polylang 或 WPML 等多语言插件才能生效。', 'aksrt'); ?></small></p>
		<?php
			$this->render_common_form_section($instance);
}

	/**
	 * @param array<string,mixed> $new_instance
	 * @param array<string,mixed> $old_instance
	 * @return array<string,mixed>
	 */
	public function update($new_instance, $old_instance): array {
		$style = sanitize_key((string) ($new_instance['style'] ?? 'dropdown'));
		if (!in_array($style, ['dropdown', 'flags', 'inline'], true)) {
			$style = 'dropdown';
		}
		$business = [
			'title'        => sanitize_text_field((string) ($new_instance['title'] ?? '')),
			'style'        => $style,
			'show_name'    => !empty($new_instance['show_name']) ? 1 : 0,
			'hide_current' => !empty($new_instance['hide_current']) ? 1 : 0,
		]; return $this->update_common_fields($new_instance, $old_instance, $business);
	}
}