Files
wordpress-theme-aksrt/inc/helpers/aksrt-i18n-switch.php
T

150 lines
4.7 KiB
PHP

<?php
/**
* AKSRT i18n Switch — 多语言切换辅助函数
*
* 支持 Polylang、WPML 或 WordPress 内置语言切换。
*
* @package AKSRT
*/
defined('ABSPATH') || exit;
/**
* 获取可用语言列表
*
* @return array<array{code: string, name: string, url: string, flag: string, active: bool}>
*/
function aksrt_get_available_languages(): array {
$languages = [];
// Polylang
if (function_exists('pll_the_languages')) {
$pll_langs = pll_the_languages(['raw' => 1]);
if (is_array($pll_langs)) {
foreach ($pll_langs as $lang) {
$languages[] = [
'code' => $lang['slug'] ?? '',
'name' => $lang['name'] ?? '',
'url' => $lang['url'] ?? '#',
'flag' => $lang['flag'] ?? '',
'active' => !empty($lang['current_lang']),
];
}
}
return $languages;
}
// WPML
if (defined('ICL_LANGUAGE_CODE') && function_exists('icl_get_languages')) {
$wpml_langs = icl_get_languages('skip_missing=0');
if (is_array($wpml_langs)) {
foreach ($wpml_langs as $lang) {
$languages[] = [
'code' => $lang['language_code'] ?? '',
'name' => $lang['native_name'] ?? '',
'url' => $lang['url'] ?? '#',
'flag' => $lang['country_flag_url'] ?? '',
'active' => !empty($lang['active']),
];
}
}
return $languages;
}
// WordPress 内置:通过 filter 提供语言列表
$filtered = apply_filters('aksrt_available_languages', []);
if (is_array($filtered) && !empty($filtered)) {
return $filtered;
}
return [];
}
/**
* 检查是否有多语言插件可用
*/
function aksrt_has_multilingual(): bool {
if (function_exists('pll_the_languages')) return true;
if (defined('ICL_LANGUAGE_CODE')) return true;
if (!empty(apply_filters('aksrt_available_languages', []))) return true;
return false;
}
/**
* 获取当前语言代码
*/
function aksrt_get_current_language(): string {
if (function_exists('pll_current_language')) {
return pll_current_language('slug');
}
if (defined('ICL_LANGUAGE_CODE')) {
return ICL_LANGUAGE_CODE;
}
return get_locale();
}
/**
* 渲染语言切换器 HTML
*
* @param string $style dropdown | inline | flags
* @return string
*/
function aksrt_render_language_switcher(string $style = 'dropdown'): string {
$languages = aksrt_get_available_languages();
if (count($languages) < 2) return '';
$current = aksrt_get_current_language();
if ($style === 'flags') {
$html = '<div class="aksrt-lang-switch aksrt-lang-switch--flags">';
foreach ($languages as $lang) {
$active_class = $lang['active'] ? ' is-active' : '';
$html .= '<a href="' . esc_url($lang['url']) . '" class="aksrt-lang-switch__flag' . esc_attr($active_class) . '" title="' . esc_attr($lang['name']) . '">';
if ($lang['flag']) {
$html .= '<img src="' . esc_url($lang['flag']) . '" alt="' . esc_attr($lang['code']) . '" width="20" height="14">';
} else {
$html .= '<span>' . esc_html(strtoupper($lang['code'])) . '</span>';
}
$html .= '</a>';
}
$html .= '</div>';
return $html;
}
// dropdown style
$html = '<div class="aksrt-lang-switch">';
$html .= '<button type="button" class="aksrt-lang-switch__toggle" aria-haspopup="true" aria-expanded="false">';
// 当前语言
foreach ($languages as $lang) {
if ($lang['active'] || $lang['code'] === $current) {
if ($lang['flag']) {
$html .= '<img src="' . esc_url($lang['flag']) . '" alt="" width="18" height="12"> ';
}
$html .= '<span>' . esc_html($lang['name']) . '</span>';
break;
}
}
$html .= ' <i class="fas fa-chevron-down" style="font-size:10px;margin-left:4px;"></i>';
$html .= '</button>';
$html .= '<ul class="aksrt-lang-switch__dropdown" role="menu">';
foreach ($languages as $lang) {
$active_class = $lang['active'] ? ' is-active' : '';
$html .= '<li role="menuitem">';
$html .= '<a href="' . esc_url($lang['url']) . '" class="aksrt-lang-switch__item' . esc_attr($active_class) . '">';
if ($lang['flag']) {
$html .= '<img src="' . esc_url($lang['flag']) . '" alt="" width="18" height="12"> ';
}
$html .= esc_html($lang['name']);
$html .= '</a>';
$html .= '</li>';
}
$html .= '</ul>';
$html .= '</div>';
return $html;
}